title: Auto documenting REST API in PHP
body: <p>phpDocumentor seems to be the standard for documenting PHP code, though I have to wonder why it hasn't been updated in years..?</p>
  
  <p>However, it does not seem suitable for documenting the entry points for a REST API; IE, externally accessible entry points that an end user of your system would be interested in, as opposed to documenting all the internal classes and such - something only of interest to the developers of the api.</p>
  
  <p>I am looking for something where I could say, hey this method here is externally accessible through REST at this URL, here's the GET or POST arguments it takes, it supports GET/POST/etc HTTP methods, it returns JSON or XML or whatever.</p>
  
  <p>This information would be able to produce an API document.  It could also be used by the code internally to automatically filter inputs, validate output, create basic unit tests, etc.</p>