ホームページ  >  記事  >  バックエンド開発  >  PHP は Swagger を使用して API ドキュメントを自動的に生成します

PHP は Swagger を使用して API ドキュメントを自動的に生成します

不言
不言オリジナル
2018-05-28 15:52:338546ブラウズ

Swagger を使用して API ドキュメントを自動的に生成します

Swagger を使用して API ドキュメントを自動的に生成します。必要な友人はそれを参照できます。

1. swagger-ui をダウンロードし、サーバーに直接アップロードします

2. swagger-php をダウンロードし、ドキュメントに従ってインストールします

3. コメントコードを追加しますPHP ファイル

/** 
* @SWG/Resource ( 
* apiVersion = "版本号", 
* basePath = "API地址", 
* resourcePath ="项目名称", 
* @SWG/Api ( 
* path = "API文件名", 
* description = "功能描述", 
* @SWG/Operation ( 
* method="POST", summary="操作描述", nickname = "显示名", 
* @SWG/Parameter (name="参数名", description="参数说明", required = true, paramType = "query", type="string"), 
* @SWG/ResponseMessage (code=200, message="返回说明") 
* ) 
* ) 
*) 
*/

4. swager-php を使用して JSON アドレスを生成します

php ../composer/vendor/zircote/swagger-php/swagger.phar /apifolder -o / docfolder

5. swagger-ui のデフォルト データ アドレスを変更

6. 完了

声明:
この記事の内容はネチズンが自主的に寄稿したものであり、著作権は原著者に帰属します。このサイトは、それに相当する法的責任を負いません。盗作または侵害の疑いのあるコンテンツを見つけた場合は、admin@php.cn までご連絡ください。