title: Request params and phpdoc
body: <blockquote>
    <p><strong>Possible Duplicate:</strong><br>
    <a href="https://stackoverflow.com/questions/2121710/is-there-a-standard-for-documenting-get-post-parameters">Is there a standard for documenting GET/POST parameters?</a>  </p>
  </blockquote>
  
  
  
  <p>Trying to figure out the best way to document request parameters via phpdoc in a manner that makes sense. Specifically, I've got some Zend Framework controller actions that receive parameters via GET/POST, but aren't functional params. Does this make sense?</p>
  
  <pre><code>/**
   * Display a pagination/grid list of rows.
   *
   * @param string $_GET['order']  What field to sort on
   * @param string $_GET['dir']    Direction to sort; either ASC|DESC
   * 
   * @return void
   */
  public function listAction()
  {
      $order = $this-&gt;_request-&gt;order;
      ...
  </code></pre>
  
  <p>If I generated docs for this method, there wouldn't be an indication that "order" and "dir" can be passed via a url string to this method. Would it make more sense to just do</p>
  
  <pre><code>@param string $order
  </code></pre>
  
  <p>Should I use @var instead? </p>
  
  <p>Thoughts welcome.</p>