Document getFields() and clean up getPostParameters().

git-svn-id: https://svn.php.net/repository/pear/packages/Services_Akismet2/trunk@273308 c90b9560-bf6c-de11-be94-00142212c4b1

Services/Akismet2/Comment.php

@@ -277,13 +277,6 @@ public function __toString()
      */
     public function getPostParameters()
     {
-        foreach (self::$_requiredFields as $field) {
-            if (!array_key_exists($field, $this->_fields)) {
-                throw new Services_Akismet2_InvalidCommentException('Comment ' .
-                    'is missing required field: "' . $field . '".', 0, $this);
-            }
-        }
-
         $values = array();
 
         foreach ($this->_fields as $key => $value) {
@@ -297,6 +290,14 @@ public function getPostParameters()
             }
         }
 
+        // make sure all required fields are set
+        foreach (self::$_requiredFields as $field) {
+            if (!array_key_exists($field, $values)) {
+                throw new Services_Akismet2_InvalidCommentException('Comment ' .
+                    'is missing required field: "' . $field . '".', 0, $this);
+            }
+        }
+
         return $values;
     }
 
@@ -323,11 +324,6 @@ public function setField($name, $value)
     }
 
     // }}}
-
-    public function getFields() {
-        return $this->_fields;
-    }
-
     // {{{ setFields()
 
     /**
@@ -353,6 +349,22 @@ public function setFields(array $fields)
         return $this;
     }
 
+    // }}}
+    // {{{ getFields()
+
+    /**
+     * Gets the fields that are set for this comment
+     *
+     * Note: This method does not include extra server-related fields that are
+     * included in {@link Services_Akismet2_Comment::getPostParameters()}.
+     *
+     * @return array an array containing the fields set for this comment.
+     */
+    public function getFields()
+    {
+        return $this->_fields;
+    }
+
     // }}}
     // {{{ setType()