Download the PHP package crada/php-apidoc without Composer
On this page you can find all versions of the php package crada/php-apidoc. It is possible to download/install these versions without Composer. Possible dependencies are resolved automatically.
Download crada/php-apidoc
More information about crada/php-apidoc
Files in crada/php-apidoc
Package php-apidoc
Short Description Generate documentation for php API based application. No dependency. No framework required.
License MIT
Homepage https://github.com/calinrada/php-apidoc
Informations about the package php-apidoc
php-apidoc
Generate documentation for php API based application. No dependency. No framework required.
- Requirements
- Installation
- Usage
- Available Methods
- Preview
- Tips
- Known issues
- TODO
Requirements
PHP >= 5.3.2
Installation
The recommended installation is via composer. Just add the following line to your composer.json:
Usage
Create an apidoc.php file in your project root folder as follow:
Then, execute it via CLI
Available Methods
Here is the list of methods available so far :
- @ApiDescription(section="...", description="...")
- @ApiMethod(type="(get|post|put|delete|patch")
- @ApiRoute(name="...")
- @ApiParams(name="...", type="...", nullable=..., description="...", [sample=".."])
- @ApiHeaders(name="...", type="...", nullable=..., description="...")
- @ApiReturnHeaders(sample="...")
- @ApiReturn(type="...", sample="...")
- @ApiBody(sample="...")
Preview
You can see a dummy generated documentation on http://calinrada.github.io/php-apidoc/
Tips
To generate complex object sample input, use the ApiParam "type=(object|array(object)|array)":
Known issues
I don't know any, but please tell me if you find something. PS: I have tested it only in Chrome !
TODO
- Implement options for JSONP
- Implement "add fields" option