Lumem(一)：入门介绍

Lumen是Laravel框架作者Taylor Otwell为无状态API微服务而专门基于Laravel开发的框架。
Lumen名字来源：Illuminate，这是Laravel中主要实现包。
使用Lumen，你可以做到：

  • Laravel各种优雅的用法
  • 专注后端、无状态Stateless、微服务micro-service
  • 性能比Laravel提升一倍
    相比Laravel，去除了下列包依赖，使得包依赖由53降到28。
  • Illuminate：console、cookie、exception、log、mail、redis、routing、session
  • Symfony：routing、translation、process、console、debug、finder
  • league：flysystem
  • Jeremeamia：superclosure

Lumen 创建项目步骤

1. composer创建lumen项目

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

2. lumen初始化配置

这里采用Nginx作为http server，确认Nginx配置没问题，默认访问Lumen会显示Lumen版本信息。

Lumen (5.2.7) (Laravel Components 5.2.*)

  • 修改区域和时区
    1
    2
    3
    4
    vendor/laravel/lumen-framework/config/app.php
    'locale' => env('APP_LOCALE', 'cn'),
    vendor/laravel/lumen-framework/src/Application.php
    date_default_timezone_set(env('APP_TIMEZONE', 'Asia/Shanghai'));

由于Lumen建议统一采用.env方式管理配置，在Application.php中也是根据APP_TIMEZONE设置的，但我们的项目里将config外提到项目根目录下，且通过部署脚本在config和config.sandbox目前间切换配置文件，因此，这里直接修改Application.php源码。

3. 路由定义

默认路由文件：app/Http/routes.php

1
2
3
4
5
6
7
8
9
bootstrap/app.php
$app->group(['namespace' => 'App\Http\Controllers'], function ($app) {
    require __DIR__.'/../app/Http/routes.php';
});

app/Http/routes.php
$app->get('/', function () use ($app) {
    return $app->version();
});

注：5.2版本Lumen已修复之前Controller命名空间缺失的问题。
新增路由：$app->get('/', 'ExampleController@helloworld');

4. Log按日分割配置

增加LogServiceProvider，实现按日分割日志。

  • 新增app/Providers/LogServiceProvider.php

    1
    2
    3
    4
    5
    6
    7
    8
    9
    10
    11
    12
    13
    14
    15
    16
    17
    18
    19
    20
    21
    22
    23
    24
    25
    26
    27
    28
    29
    30
    31
    32
    33
    34
    35
    36
    37
    38
    <?php
     
    namespace App\Providers;
     
    use Illuminate\Support\ServiceProvider;
     
    use Monolog\Formatter\LineFormatter;
    use Monolog\Handler\RotatingFileHandler;
     
    class LogServiceProvider extends ServiceProvider
    {
        /**
         * 扩展Lumen支持按日分割保存日志
         * Configure logging on boot.
         *
         * @return void
         */
        public function boot()
        {
            // max files to be saved
            $maxFiles = 30;
     
            $handlers[] = (new RotatingFileHandler(storage_path('logs/lumen.log'), $maxFiles))
                ->setFormatter(new LineFormatter(null, null, true, true));
     
            $this->app['log']->setHandlers($handlers);
        }
     
        /**
         * Register the log service.
         *
         * @return void
         */
        public function register()
        {
            // Log binding already registered in vendor/laravel/lumen-framework/src/Application.php.
        }
    }

  • 向容器注册ServiceProvider，修改文件：bootstrap/app.php

    1
    $app->register(App\Providers\LogServiceProvider::class);

5. 如何读取配置文件？

  • bootstrap/app.php增加：$app->configure('app');
  • 程序中通过全局的辅助函数：$test = config('app.cipher');读取相应配置项

6. Redis使用

由于Lumen默认去除了Laravel中predis和illuminate/redis包依赖，所以Lumen默认无法直接支持Redis。
为Lumen添加Redis支持的步骤：

  • composer安装predis和illuminate/redis包：composer require predis/predis ~1.0和illuminate/redis 5.2.*
  • 开启Facades支持（bootstrap/app.php）：$app->withFacades()
  • 注册redisServiceProvider（bootstrap/app.php）：$app->register(Illuminate\Redis\RedisServiceProvider::class);
  • Facades增加Redis别名(vendor/laravel/lumen-framework/src/Application.php, withFacades函数)：class_alias(‘Illuminate\Support\Facades\Redis’, ‘Redis’);

注：predis为PHP实现的Redis客户端，如考虑性能，可考虑采用PhpRedis扩展方式替代predis。