Laravelドキュメントツール
laravel-doc
⛵laravel-doc
は、ドキュメントの生成、マークダウンによるドキュメントの作成、ドキュメントへの Web アクセスの提供に使用されるツールです。プロジェクト
インストール要件
- PHP >= 7.0.0
- Laravel >= 5
インストール
composer require foryoufeng/laravel-doc
Laravel 5.5 以前を実行している場合は、config/app.php
にサービス プロバイダーを追加する必要があります:
Foryoufeng\Doc\DocServiceProvider::class
次のコマンドを実行してリソース ファイルを公開します
php artisan doc:install
リソースを公開すると、さらに多くのファイルが表示されます
/public/vendor/laravel-doc //样式文件 /resources/views/docs //界面文件 /resources/mds/docs //文档文件 /resources/mds/apidocs //api文件 /app/Http/Controllers/Docs //增加了控制器文件 config/laravel_doc.php //文档配置文件 routes/web.php中增加了路由文件
Visit /doc
、このプロジェクトのドキュメントを参照できます
Visit /apidoc
では、このプロジェクトのインターフェイス説明ドキュメントが表示されます。
使用方法
一般的なドキュメントの作成
resources/mds/docs# にあります。 ##demo.md
などの md ファイルを作成し、必要なコンテンツを追加して、app/Http/Controllers/Docs/LaravelDocController.php# の
に移動します。 ## データを index_md
に追加してアクセスします。例: <div class="code" style="position:relative; padding:0px; margin:0px;"><pre class="brush:php;toolbar:false">//默认已经加入了2个例子
private function index_md()
{
return [
[
'name' => config('laravel_doc.languages.install'),
'doc_link' => 'install.md',
],
[
'name' => config('laravel_doc.languages.how_use'),
'doc_link' => 'how_use.md',
],
[
'name' => 'demo',
'doc_link' => 'demo.md',
],
];
}</pre><div class="contentsignin">ログイン後にコピー</div></div>
次に、/doc
にアクセスして効果を確認します。
コントローラーの説明デフォルトのドキュメント パス
$this->mds_path=resource_path('mds/docs/');
内部のコードはドキュメントに表示されるメニューです。これはドキュメントの作成に必要なものです。
複数のメニューの構成例<div class="code" style="position:relative; padding:0px; margin:0px;"><pre class="brush:php;toolbar:false">protected function getMenu()
return [
[
'name'=>config('laravel_doc.languages.project_doc'),
'spread'=>true,//菜单是否展开,false不展开
'children'=>[
'name'=>config('laravel_doc.languages.install'),
'doc_link'=>'install.md',
],
],
[
'name'=>config('laravel_doc.languages.project_doc'),
'spread'=>false,//不展开菜单
'children'=>[
'name'=>config('laravel_doc.languages.install'),
'doc_link'=>'install.md',
],
],
];
}</pre><div class="contentsignin">ログイン後にコピー</div></div>
- resources/mds/docs
- の doc_link
- で指定された新しい md ファイルを作成し、ドキュメントを書き込むことができます
API インターフェイス ドキュメントの作成
resources/mds/apidocs
に
demo.md などの md ファイルを作成します。必要なコンテンツを追加します。 次に、アクセスするために
app/Http/Controllers/Docs/LaravelApiDocController.php の
index_md
にデータを追加します。例: <div class="code" style="position:relative; padding:0px; margin:0px;"><pre class="brush:php;toolbar:false">private function index_md()
{
return [
[
'name' => 'apidoc_html',
'doc_link' => 'apidoc_html.md',
//可自行修改你的$this->host来使用你自己定义的访问地址
'url' => $this->host.'apidoc/html',
'request_type' => 'get',//请求方式 get或者post
//请求参数
'params'=>[
'name'=>'apidoc_html.md',
]
],
[
'name' => 'demo',
'doc_link' => 'demo.md',
'url' => $this->host.'apidoc/html',
'request_type' => 'get',//请求方式 get或者post
//给定一些需要请求的参数
'params'=>[
'name'=>'',
'user_id'=>'',
]
],
];
}</pre><div class="contentsignin">ログイン後にコピー</div></div>
その後、/apidoc
にアクセスすると、その効果がわかります。
提供されたデモ:apidoc_html
をクリックすると、上記のリクエストが表示されますパスと必要なリクエストパラメータ、および次のパラメータドキュメント
Send request
ボタンをクリックして ajax リクエストを実行すると、インターフェースに問題がなければ、ajax データが返されます。
をクリックしてドキュメント を生成すると、
markdown
の編集ボックスが表示され、右側のレンダリングが開き、リクエストのパス、パラメータ、戻り値を取得するインターフェースです。 、現在クリックされているページ で定義されているものなど、プレビュー効果で
Interface Person、
Parameter description
を変更して、各パラメータ、、および戻り値の説明を説明できます。などを入力して、
Generate ボタンをクリックすると、定義した
$this->mds_path
に従って、構成した doc_link
、例:
resources/mds/apidocs/demo.md、ファイルを生成するためのファイル
laravel_doc.php
//laravel-doc的名字 'name' => 'Laravel-doc', //用在了定义撰写接口人的名字 'author' => env('DOC_AUTHOR','foryoufeng'), //接口请求发送了这个token 'token' => env('DOC_TOKEN','doc'), //做国际化时可以用到 'languages'=>[ 'search'=>'搜索', 'search_result'=>'搜索结果', 'project_doc'=>'项目文档', 'doc_name'=>'文档名称', 'install'=>'安装', 'how_use'=>'使用说明', 'request_type'=>'http请求方式', 'request_url'=>'请求地址', 'send_request'=>'发送请求', 'generate_doc'=>'生成文档', 'welcome_use'=>'欢迎使用', 'param'=>'参数', 'value'=>'值', 'generate'=>'生成', ]
上級
複数のプロジェクトプロジェクトが比較的小規模で、1 つのドキュメントと 1 つの API インターフェイス ドキュメントのみを作成する必要がある場合は、- app/Http/Controllers に記述します。 /Docs/LaravelApiDocController.php
- および
app/Http/Controllers/Docs ドキュメントを /LaravelDocController.php
に追加すると、基本的に要件を満たしているはずです
,#複数のプロジェクトがある場合は、
app/Http/Controllers/Docs resources/views/docs
resources/mds に新しいディレクトリを作成できます/ ドキュメントを作成する予定のディレクトリ
を作成し、ルーティング ファイルに必要なルートを定義します。次のルートをコピーする必要があります<div class="code" style="position:relative; padding:0px; margin:0px;"><pre class="brush:php;toolbar:false">//doc route
Route::group(['namespace'=>'Docs'],function (){
Route::get('doc', 'LaravelDocController@index')->name('doc.index');
//md文件返回到html
Route::get('doc/html', 'LaravelDocController@html')->name('doc.html');
Route::get('apidoc', 'LaravelApiDocController@index')->name('doc.apidoc');
//md文件返回到html
Route::get('apidoc/html', 'LaravelApiDocController@html')->name('doc.apidoc.html');
//预览api文档
Route::post('apidoc/markdown', 'LaravelApiDocController@markdown')->name('doc.apidoc.markdown');
//生成api文档
Route::post('apidoc/save', 'LaravelApiDocController@save')->name('doc.apidoc.save');
});</pre><div class="contentsignin">ログイン後にコピー</div></div>
Internationalization
- config/laravel_doc.php
- の
langages
を変更できます。言語を変更します。デフォルトは中国語
です。インターフェイスインターセプト
config/laravel_doc.php - ##token
設定に#があり、インターフェイスがAjaxリクエストを行うと、
Access-Tokenが含まれます
header
インターフェイスは、この設定に基づいてmiddle を作成できます。たとえば、指定された
tokenを使用してファイル
を処理すると、次のように取得できます。対応するユーザー情報の取得、インターフェイスのリクエストと割り当ての実行など。ヒント
ユニバーサル プロジェクトのために、私は次のことを行いました。ドキュメントやインターフェイスを傍受するミドルウェアは提供しません。セキュリティ上の理由から、ユーザーがドキュメントを保護するために自分のニーズに応じてミドルウェアを作成できるようにすることをお勧めします - Laravel 関連の技術記事の詳細については、## を参照してください。 #Laravel チュートリアル 学ぶべきコラム!
以上がLaravelドキュメントツールの詳細内容です。詳細については、PHP 中国語 Web サイトの他の関連記事を参照してください。

ホットAIツール

Undresser.AI Undress
リアルなヌード写真を作成する AI 搭載アプリ

AI Clothes Remover
写真から衣服を削除するオンライン AI ツール。

Undress AI Tool
脱衣画像を無料で

Clothoff.io
AI衣類リムーバー

Video Face Swap
完全無料の AI 顔交換ツールを使用して、あらゆるビデオの顔を簡単に交換できます。

人気の記事

ホットツール

メモ帳++7.3.1
使いやすく無料のコードエディター

SublimeText3 中国語版
中国語版、とても使いやすい

ゼンドスタジオ 13.0.1
強力な PHP 統合開発環境

ドリームウィーバー CS6
ビジュアル Web 開発ツール

SublimeText3 Mac版
神レベルのコード編集ソフト(SublimeText3)

ホットトピック









Laravelの電子メールの送信が失敗したときに戻りコードを取得する方法。 Laravelを使用してアプリケーションを開発する場合、検証コードを送信する必要がある状況に遭遇することがよくあります。そして実際には...

LaravelスケジュールタスクRAN RANSPONSIVEトラブルシューティングRALAVELのスケジュールタスクスケジューリングを使用すると、多くの開発者がこの問題に遭遇します。スケジュール:実行...

Laravelの電子メールの検証コードの送信の障害を処理する方法は、Laravelを使用することです...

DCATを使用するときにDCATADMIN(Laravel-Admin)にデータを追加するためにカスタムクリックのテーブル関数を実装する方法...

Laravel - ダンプサーバー - Laravel ダンプサーバーには、Laravel 5.7 のバージョンが付属しています。以前のバージョンにはダンプ サーバーが含まれていません。ダンプサーバーはlaravel/laravelコンポーザーファイルの開発依存関係になります。

Laravel FrameworkでRedis接続の共有の影響とLaravelフレームワークとRedisを使用する際のメソッドを選択すると、開発者は問題に遭遇する可能性があります。

Laravel Multi-Tenant拡張機能パッケージStancl/Tenancyのカスタムテナントデータベース接続Laravel Multi-Tenant ExtensionパッケージStancl/Tenancyを使用したマルチテナントアプリケーションを構築する際の...

Laravel - アクション URL - Laravel 5.7 では、「呼び出し可能なアクション URL」と呼ばれる新機能が導入されています。この機能は、アクションメソッドで文字列を受け入れるLaravel 5.6の機能に似ています。 Laravel 5.7 で導入された新しい構文の主な目的は、
