lumen + dingo 搭建api服务器

网上现在关于lumen的教程还是蛮少的，不过很少有初级PHP人员直接接触lumen，估计这也是一个问题吧！作为一个菜鸟，因为公司项目重构，所以我走上了lumen的流行

lumen lumen git地址全部关于lumen的介绍以及说明都有

至于 dingo/api 是一个基于larveral和lumen的api工具可以帮助我们快速构建api服务

dingo/api dingo/api git地址全部关于dingo组件

安装

首先，通过使用composer安装laravel安装器：

1	composer global require "laravel/lumen-installer"

然后我们通过安装器进行安装

1	lumen new blog

其次我们也可以通过composer创建项目

1	composer create-project --prefer-dist laravel/lumen blog

本地开发环境

如果你本地安装了PHP，并且你想使用PHP内置的服务器来为你提供应用服务，php -S localhost:8000 -t public命令。该命令会在 http://localhost:8000上启动开发服务器

lumen 和 laravel 虽然是同一个框架系列但是不属于同样的结构 lumen更像是一个laravel的儿子，一个专属于api开发的框架所以在文件结构上的处理和方式也有很多不同

Lumen 框架所有的配置信息都是存在 .env 文件中。一旦 Lumen 成功安装，你同时也要配置本地环境。

dingo install

首先去dingo的git上面查看当前版本我这里安装的是2.2以上的版本

至于dingo的版本安装失败请参考https://learnku.com/courses/laravel-package/api-development-kit-dingoapi/

安装dingo 有两种方法这两种方法基本上百度都能找到

一种是在composer.json文件中进行修改然后composer update：

1
2
3

"require": {
    "dingo/api": "^2.2"
    }

另一种就是直接使用 composer 直接将包引入

1	composer require dingo/api

当我们安装 dingo 之后我们需要对dingo进行注册我们使用 laravel 需要将配置文件引入进来，当然我们当前使用的是lumen

1	$app->register(Dingo\Api\Provider\LumenServiceProvider::class);

关于Facades

API 自带了两个 Facade ，你可以自己选择使用

Dingo\Api\Facade\API

这个调度器的 Facade ，并提供了一些好用的辅助方法

Dingo\Api\Facade\Route

你可以使用这个 Facade 来获取API的当前路由、请求、检查当前的路由名称等

Dingo 配置

大部分的配置信息都是预先配置好了的，为的是让你能快速上手你的 API 项目。你可以通过 ·env 文件来自定义大部分配置。但是，有一些配置微调需要你发布配置文件（Laravel）或者在 bootstrap/app.php 文件中配置（Lumen）。你也可以使用 AppServiceProvider 中的 boot 方法来做设置。

Standards Tree 标准树

这有三个不同的树x,prs,和,vnd.你使用的标准树需要取决于你开发的项目

关于版本描述，请自行参考官网配置

配置.env

1	API_STANDARDS_TREE=vnd

子类型通常是应用程序或项目的短名称，都是小写的。

1	API_SUBTYPE=myapp

前缀和子域

1 2	API_PREFIX=api API_DOMAIN=api.myapp.com

当然域名和前缀只能用一个

版本号

1	API_VERSION=v1

最后配置格式

# dingo 
API_STANDARDS_TREE=prs 
API_SUBTYPE=package 
API_PREFIX=api 
API_VERSION=v1 
API_DEBUG=true

这几个配置非常的重要， API 版本的切换会利用到这些配置，不配置是会报错的。

接下来就可以进行接口测试了。具体测试基本上官网文档都讲解的非常明白。具体请自行参考官网配置