2.13. 命令行工具

Dingo API 同时支持 Laravel 和 Lumen 两个框架，但是因为框架的用途不一样，命令的支持也不一样，支持情况请见下表：

api:routes

只有 Laravel 5.1 及以上版本可以使用

这个命令将生成你的 API 路由列表。这个命令的效果类似 Laravel 中的 route:list 命令。除了标准的使用方法，你还可以使用以下的过滤器：--versions 和 --scopes。

例子

$ php artisan api:routes

$ php artisan api:routes --versions v1

$ php artisan api:routes --scopes read_user_data --scopes write_user_data

api:cache

只有 Laravel 5.1 及以上版本可以使用

这个命令将缓存你的 API 路由，和你主要应用的路由一起。当执行这个命令的时候会自动执行 route:cache 命令。所以执行完这个命令后就不要在执行 route:cache 了。

你的路由需要出现在你的 app/Http/routes.php 文件中或者被这个文件引入的文件中，从而让缓存个生效。

Important: Running route:cache by itself will prevent your API routes from being accessible.

例子

$ php artisan api:cache

api:docs

只有 Laravel 5.1 及以上版本和 Lumen 5.1及以上版本可以使用

这个命令将从你的控制器注释中生成文档到一个符合标准的 api 文档中。更多的如何注释你的控制器请看 API Blueprint Documentation 章节。

默认的，这个命令将把文档输出到 stdout 中，你可以使用管道将这个文件存储到一个文件中或者推送到服务器上。

例子

$ php artisan api:docs --name Example --use-version v2

文件的输出目录 使用 --output-file。

$ php artisan api:docs --name Example --use-version v2 --output-file /path/to/documentation.md

为了避免手动定义名字和版本，你可以自定义配置到你的配置文件或者环境文件中。详情请看 配置信息 章节。