afroware / blueprint
API Blueprint 文档生成器。
    v1.0.0
    2017-09-09 17:59 UTC
Requires
- php: ^7.1
- doctrine/annotations: ^1.5
- illuminate/filesystem: ^5.5
- illuminate/support: ^5.5
- phpdocumentor/reflection-docblock: ^4.1
Requires (Dev)
- phpunit/phpunit: ^6.3
- squizlabs/php_codesniffer: ^3.0
This package is not auto-updated.
Last update: 2024-09-18 21:05:10 UTC
README
此包可以从一组类生成有效的 API Blueprint 1A 文档。
用法
一些索引方法 phpdoc 示例
<?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)
    {}
}
许可证
此包根据BSD 3-Clause 许可证授权。