快速查看 Laravel 已安装 Packages 的 Readme 文档小工具

Coding的时候,经常需要查阅各个Package的文档。在以前,去每个Package的官网查找各自的文档,比较麻烦。所以我做了一个小工具,可以把所有Packages的文档放在一个页面里面查阅,欢迎各位品尝。

预览

Packages Readmes Viewer

原理

  • 每个Package在其安装目录下都会有一个README.MD文件;
  • 首先读取composer.json,获取require和require-dev的Package列表;
  • 读取README.MD文件,并由Markdown转化为Html;
  • 使用了GithubMarkdown以及GithubMarkdownCSS。

安装方法

使用composer安装至dev环境:

composer require --dev seekerliu/packagesreadmes

注册ServiceProvider至本地环境:

public function register()
{
    if ($this->app->environment() == 'local') {
        $this->app->register('Seekerliu\Readme\Providers\ReadmeServiceProvider');
    }
    // ...
}

使用方法

现在你就可以通过下面的Url来查看所有Packages的Readme文档了:

http://yoursite.app/readme

自定义路由

如果你需要自定义路由,需要先publish配置文件:

php artisan vendor:publish --tag=readme

然后编辑 '/config/readme.php'中的route部分:

'route' => [
        'prefix' => '/readme/{packageName?}',
        'action' => 'Seekerliu\Readme\Controllers\ReadmeController@index',
        'name' => 'readme.index',
],

即可修改路由。

项目源码

https://github.com/seekerliu/packagesreadm...

原创。 所有 Laravel 文章均已收录至 Github laravel-tips 项目。
Ίκαρος
《L03 构架 API 服务器》
你将学到如 RESTFul 设计风格、PostMan 的使用、OAuth 流程,JWT 概念及使用 和 API 开发相关的进阶知识。
《G01 Go 实战入门》
从零开始带你一步步开发一个 Go 博客项目,让你在最短的时间内学会使用 Go 进行编码。项目结构很大程度上参考了 Laravel。
讨论数量: 2
leo

建议route可配

7年前 评论
Ίκαρος

@leo 已更新,可以自定义路由 :smile:

7年前 评论

讨论应以学习和精进为目的。请勿发布不友善或者负能量的内容,与人为善,比聪明更重要!