fc9 / blueprint
API Blueprint documentation generator.
v4.1
2020-03-21 20:49 UTC
Requires
- php: ~7.2.5
- doctrine/annotations: ~1.8.0
- illuminate/filesystem: ~7.1
- illuminate/support: ~7.1
- phpdocumentor/reflection-docblock: ~5.1.0
Requires (Dev)
- phpunit/phpunit: ~8.0
- squizlabs/php_codesniffer: ~3.5.4
README
This package generates a valid API Blueprint 1A document from a collection of classes.
Usage
Some index method phpdoc example:
<?php /** * Products * * @Resource("Products", uri="/products") */ class ProductsController extends ApiController { /** * Products list * * Get current products list * * @Get("/") * @Versions({"v1"}) * @Transaction({ * @Request(identifier="/?state=synced"), * @Response(200, body={"data":{{"id":"rkoVJ7qa4Z6lzXdVnldgx9LmpBP0DQ3e","name":"Product name","status":"active"}},"meta":{"pagination":{"total":1,"count":1,"per_page":1,"current_page":1,"total_pages":1,"links":{}}}}) * }) * @Parameters({ * @Parameter("api_token", type="string", required=true, description="API Token", default=null), * @Parameter("page", type="integer", required=false, description="Pagination page", default=1), * @Parameter("state", type="string", required=false, description="Product status filter", default="synced", members={ * @Member(value="synced", description="Products synced"), * @Member(value="pending", description="Products pending") * }) * }) */ public function index(Request $request) {} }
License
This package is licensed under the BSD 3-Clause license.