项目作者： majikang
项目描述 ：
基于lumen+dingo+jwt，前后端分离的一个博客
高级语言： PHP
项目地址: git://github.com/majikang/lumen-dingo-jwt-blog.git
lumen-api-demo
这是一个比较完整用 lumen 5.3 写的的 REST API 例子，如果你正在做相同的事，那么这个例子或许能帮助你。这个例子使用了 dingo/api 写 rest 风格的 api，jwt 实现登录，功能上很简单，登录，注册，发帖，评论，还写了单元测试。
lumen5.1看这里 (不更新了)
lumen5.2看这里
升级到 5.3 后单元测试错误，应该是容器的问题，可能是 bug，慢慢解决
有需要随时联系我
ENGLISH README
USEFUL LINK
读文档很重要，请先仔细读读 dingo/api，jwt，fractal 的文档。
USAGE
$ git clone git@github.com:liyu001989/lumen-api-demo.git$ composer install$ cp .env.example .env$ vim .env DB_* 填写数据库相关配置 your database configuration JWT_SECRET php artisan jwt:secret APP_KEY lumen 取消了key:generate 所以随便找个地方生成一下吧 md5(uniqid())，str_random(32) 之类的，或者用jwt:secret生成两个copy一下$ php artisan migrate$ 生成文档我是这么写的 apidoc -i App/Http/Controller/Api/v1 -o public/apidoc$ api文档在public/apidoc里面, 也可以看上面的 `在线api文档`
如果访问一直不对，可以进入public 目录执行php -S localhost:8080，然后尝试调用几个接口，从而确定是否为web服务器的配置问题。
REST API DESIGN
大概举个例子说明一下 rest api 吧
github 的 api 真的很有参考价值 github-rest-api
例子： 用户，帖子，评论 get /api/posts 帖子列表 post /api/posts 创建帖子 get /api/posts/5 id为5的帖子详情 put /api/posts/5 替换帖子5的全部信息 patch /api/posts/5 修改部分帖子5的信息 delete /api/posts/5 删除帖子5 get /api/posts/5/comments 帖子5的评论列表 post /api/posts/5/comments 添加评论 get /api/posts/5/comments/8 id为5的帖子的id为8的评论详情 put /api/posts/5/comments/8 替换帖子评论内容 patch /api/posts/5/comments/8 部分更新帖子评论 delete /api/posts/5/comments/8 删除某个评论 get /api/users/4/posts id为4的用户的帖子列表 get /api/user/posts 当前用户的帖子列表
问题总结
lumen 5.1 升级到 5.2
- fix compose.json
“laravel/lumen-framework”: “5.2.*”,
“vlucas/phpdotenv”: “~2.2” // 这是个坑啊
将5.2的composer.json拿过来对比一下吧
- fix bootstrap/app.php
- Illuminate\Contracts\Foundation\Application 改为了Laravel\Lumen\Application，所以修改一下app\providers\EventServiceProvider.php
- 可以从 5.2 的项目中，把 Middleware cp 过来
jwt 使用
lumen 5.2 取消了session，没有了 auth 的实例，所以使用jwt的时候需要配置一下，注意 config/auth.php 中的配置，而且 user 的 model 需要实现 Tymon\JWTAuth\Contracts\JWTSubject;
使用mail
写了个例子，注册之后给用户发送邮件, 可以参考一下。
- composer 加 illuminate/mail 和 guzzlehttp/guzzle 这两个库
- 在 bootstrap/app.php 或者 provider 中注册 mail 服务
- 增加配置 mail 和 services, 从 laravel 项目里面 cp 过来
- 在 env 中增加 MAIL_DRIVER，账户，密码等配置
transformer 的正确使用
transformer 是个数据转换层，帮助你格式化资源。还可以帮助你处理资源之间的引用关系。
试着体会一下以下几个url的也许就明白了
- https://lumen-new.lyyw.info/api/posts 所有帖子列表
- https://lumen-new.lyyw.info/api/posts?include=user 所有帖子列表及发帖用户
- https://lumen-new.lyyw.info/api/posts?include=user,comments 帖子列表及发帖的用户和发帖的评论
- https://lumen-new.lyyw.info/api/posts?include=user,comments:limit(1)) 帖子列表及发帖的用户和发帖的1条评论
- https://lumen-new.lyyw.info/api/posts?include=user,comments.user 帖子列表及发帖的用户和发帖的评论，及评论的用户信息
- https://lumen-new.lyyw.info/api/posts?include=user,comments:limit(1),comments.user,comments.user) 帖子列表及发帖的用户和发帖的1条评论，及评论的用户信息，及评论的用户信息
是不是很强大，我们只需要提供资源，及资源之间的引用关系，省了多少事
transformer 如何自定义格式化资源
dingo/api 使用了 Fractal 做数据转换，fractal 提供了3种基础的序列化格式，Array，DataArray，JsonApi，在这里有详细的说明 http://fractal.thephpleague.com/serializers/。DataArray 是默认的，也就是所有资源一定有data和meta。当然也可以按下面这样自定义：
只需要在 bootstrap/app.php 中设置 serializer 就行了。具体见 bootstrap/app.php 有注释
$app[‘Dingo\Api\Transformer\Factory’]->setAdapter(function ($app) {
$fractal = new League\Fractal\Manager;
// 自定义的和fractal提供的
// $serializer = new League\Fractal\Serializer\JsonApiSerializer();
$serializer = new League\Fractal\Serializer\ArraySerializer();
// $serializer = new ApiDemo\Serializers\NoDataArraySerializer();
$fractal->setSerializer($serializer);,
return new Dingo\Api\Transformer\Adapter\Fractal($fractal);
});
个人认为默认的 DataArray 就很好用了，基本满足了 API 的需求
repository 的使用
仓库很好的帮我们解耦 controller 和 model，controller 只需要通过仓库操作数据，而并不关心具体是如何操作的，这些完全交给仓库。所以只要定义好接口，然后我们就可以实现orm仓库，DB仓库，xxxorm仓库，并且可以通过仓库增加缓存，非常方便。但是不应该将大段的业务逻辑封装在仓库里面，仓库就是仓库，逻辑交给 controller 和 service。
例子中我是随便写的，rinvex/repository 和 prettus/l5-repository 这两个库都不错，大家可以试试
TODO
坑
License
MIT license
