PHPackages                             mouyong/laravel-doc - PHPackages - PHPackages  [Skip to content](#main-content)[PHPackages](/)[Directory](/)[Categories](/categories)[Trending](/trending)[Leaderboard](/leaderboard)[Changelog](/changelog)[Analyze](/analyze)[Collections](/collections)[Log in](/login)[Sign up](/register)

1. [Directory](/)
2. /
3. [Utility & Helpers](/categories/utility)
4. /
5. mouyong/laravel-doc

Abandoned → [plugins-world/laravel-doc](/?search=plugins-world%2Flaravel-doc)Library[Utility & Helpers](/categories/utility)

mouyong/laravel-doc
===================

A laravel global config package.

v1.0.11(3y ago)3421MITPHPPHP >=8.0

Since Jul 19Pushed 2y ago1 watchersCompare

[ Source](https://github.com/mouyong/laravel-doc)[ Packagist](https://packagist.org/packages/mouyong/laravel-doc)[ Docs](https://github.com/mouyong/laravel-doc)[ GitHub Sponsors](https://github.com/mouyong)[ RSS](/packages/mouyong-laravel-doc/feed)WikiDiscussions master Synced 1mo ago

READMEChangelog (9)Dependencies (8)Versions (12)Used By (0)

laravel-doc
===========

[](#laravel-doc)

用于生成 swagger 2.0 文档的扩展包。可根据配置自动同步 yapi 文档。可开启 apifox 文档定时同步功能

[![Sponsor me](https://github.com/plugins-world/plugins-world/raw/master/sponsor-me-button-s.svg?raw=true)](https://github.com/sponsors/mouyong)

安装
--

[](#安装)

```
$ composer require plugins-world/laravel-doc -vvv
```

使用
--

[](#使用)

### 1. 配置文件修改

[](#1-配置文件修改)

```
// yapi.php
base_url 是 yapi 的 url.
project_id 是 yapi 的项目 id
token 是项目的 token

openapi 可以配置与 openapi 的路由信息。以及是否生成 openapi 文档。

openapi 文档的访问路由，默认是 /openapi
```

### 2. 单元测试与文档生成

[](#2-单元测试与文档生成)

文档生成目录：`storage/app/yapi/`

使用示例：

`routes/tenant.php`

```
// 定义路由，实际开发时替换为正式的 method、uri、controller、action
Route::any('/api/oem-info', [\MouYong\LaravelDoc\Http\Controllers\OpenapiController::class, 'example']);
Route::get('/api/patients', [\MouYong\LaravelDoc\Http\Controllers\OpenapiController::class, 'example']);
Route::post('/api/patients', [\MouYong\LaravelDoc\Http\Controllers\OpenapiController::class, 'example']);

```

`tests/TestCase.php`

```