PHP 微框架 Lumen 使用全纪录

lumen.jpeg

本文将介绍Lumen的使用和遇到的问题,重点是官方文档中没太详细介绍的内容,不定期更新。

Lumen框架使用Laravel模块构建而成。

与Laravel臃肿不同,Lumen是微框架,去繁就简,专注于构建无状态API。

在使用中依然能感受到Laravel一样的艺术感,

Lumen的性能表现也值得称赞。

如果你在构建API应用,请关注Lumen。

安装Lumen框架

  • 全局安装Composer
curl -sS https://getcomposer.org/installer | php
mv composer.phar /usr/local/bin/composer
  • 配置Composer中国镜像,国内用户都懂得。
composer config -g repo.packagist composer https://packagist.phpcomposer.com
  • 建立一个目录为lumen的项目
composer create-project --prefer-dist laravel/lumen lumen

一些简单的配置

配置web服务器,支持单入口(优雅链接)

Apache配置:

  • 打开mod_rewrite模块
  • 配置public/.htaccess
Options +FollowSymLinks
RewriteEngine On

RewriteCond %{REQUEST_FILENAME} !-d
RewriteCond %{REQUEST_FILENAME} !-f
RewriteRule ^ index.php [L]

Nginx:

nginx.conf

location / {
    try_files $uri $uri/ /index.php?$query_string;
}

配置开发环境

Lumen把配置放到.env文件中. 根目录下包含一个.env.example文件

cp .env.example .env

.env 示例

APP_ENV=local
APP_DEBUG=false
APP_KEY=

如何判断当前程序运行环境?

$environment = app()->environment();

if (app()->environment('local')) {
    // 环境是 local
    // 加载 local 配置
}

if (app()->environment('local', 'staging')) {
    // 环境是 local 或 staging...
}
  • 第一个页面 hello world

在routes中添加路由规则 /app/Http/routes.php

方法1:接收闭包函数

$app->get('/hello', function() use ($app) {
    return 'Hello World!';
});

方法2:指定路由到控制器方法处理

$app->get('/hello', 'HelloController@index');

一个简单的控制器动作

/app/Http/Controllers/HelloController.php

<?php

namespace App\Http\Controllers;

class HelloController extends Controller
{
    public function index()
    {
        return 'Hello World!';
    }
}

Lumen异常处理 修改异常报告

为什么引入这个问题呢?我们一般用Lumen写API接口,返回格式为JSON或XML。

Lumen默认报错是这个样子的, 不满足我们的要求了,我们想实现浏览器呈现的错误信息为JSON格式怎么办呢?

lumen-exception-default.png

首先Lumen输出JSON 响应很简单。

return response()->json(['name' => 'Abigail', 'state' => 'CA']);

再来看异常处理如何修改。

Lumen中的异常都交给App\Exceptions\Handler这个类处理

render 方法负责将指定的异常转换成HTTP响应再发送到浏览器。

我们把报错的行号,文件和错误消息都通过JSON返回:

<?php

/**
 * Render an exception into an HTTP response.
 *
 * @param  \Illuminate\Http\Request  $request
 * @param  \Exception  $e
 * @return \Illuminate\Http\Response
 */
public function render($request, Exception $e)
{
    $code = $e->getCode() == 0 ? 500 : $e->getCode();
    $msg = sprintf("%s:%s:%s", $e->getFile(), $e->getLine(), $e->getMessage());
    return response()->json(array('errorNo' => $code, 'errorMsg' => $msg));
}

刚才的错误消息变成了这样

{"errorNo":500,"errorMsg":"\/home\/vagrant\/Code\/www_data\/lumen\/app\/Http\/routes.php:18:Parse error: syntax error, unexpected '$app' (T_VARIABLE)"}

Lumen操作phpredis?

phpredis 是PHP的Redis扩展。
predis是PHP实现的Redis操作库,
由于phpredis的性能更好,所以我们有必要折腾一下。

/bootstrap/app.php中,把phpredis注入到Lumen容器中


//Lumen中使用PhpRedis
$app->singleton('redis', function() {
    try {
        $redis = new \Redis();
        $redis->connect('127.0.0.1', 6379);
        return $redis;
    } catch (Exception $e) {
        echo $e->getMessage();
    }

});
unset($app->availableBindings['redis']);

绑定后即可通过 app('redis') 操作Redis了。

Lumen怎么添加自定义配置?

我们看到上面的代码 $redis->connect('127.0.0.1', 6379);
像这种代码把配置信息硬编码到代码中,以后维护起来不是很好的。
我们把Redis连接修改为配置文件怎么办?

方法1:.env

$redis->connect(env('REDIS_HOST', env('REDIS_PORT')));

方法2:Laravel风格的config文件

  • 添加文件 /config/redis.php
<?php

return [
    'REDIS_HOST' => '127.0.0.1',
    'REDIS_PORT' => 6379,
];
  • 修改bootstrap/app.php, 让配置文件生效
// ... 
$app->configure('redis');
return $app;
  • 使用 config()函数来获取配置值
$redis->connect(config('redis.REDIS_HOST'), config('redis.REDIS_PORT'));

Lumen请求相关方法

Lumen Request类由Illuminate\Http\Request实现

// 所有的路由规则
app()->getRoutes();

// 当前REQUEST_URI
// app('request') 是 Illuminate\Http\Request类的实例
app('request')->getRequestUri();

// 当前route

app('request')->route();

怎么得到当前Uri的控制器、Action、路由规则


<?php

namespace App\Http\Controllers;

class HelloController extends Controller
{
    public function index()
    {
     // 当前path
        $router = explode("?", $request->getRequestUri())[0];
        // 所有的router
        $rts = app()->getRoutes();
        // 当前route
        $routeInfo = app('request')->route();
        $rows = [];
        foreach ($rts as $rt => $route ) {
            $rows[$route['uri']] = [
                'verb' => $route['method'],
                'uri' => $route['uri'],
                'uses' => isset($route['action']['uses']) ? $route['action']['uses'] : 'Closure',
                'controller' => $this->getController($route['action']),
                'action' => $thiw->getAction($route['action']),
            ];
        }

        print_r($rows);
        return;
    }

    /**
     * @param array $action
     * @return mixed|string
     */
    protected function getAction(array $action)
    {
        if (!empty($action['uses'])) {
            $data = $action['uses'];
            if (($pos = strpos($data, "@")) !== false) {
                return substr($data, $pos + 1);
            } else {
                return "METHOD NOT FOUND";
            }
        } else {
            return 'Closure';
        }
    }

    /**
     * @param array $action
     * @return mixed|string
     */
    protected function getController(array $action)
    {
        if (empty($action['uses'])) {
            return 'Closure';
        }

        return current(explode("@", $action['uses']));
    }

 }   

得到的所有路由规则数组

Array
(
    [/] => Array
        (
            [verb] => GET
            [uri] => /
            [uses] => Closure
            [controller] => Closure
            [action] => Closure
        )

    [/hello] => Array
        (
            [verb] => GET
            [uri] => /hello
            [uses] => App\Http\Controllers\HelloController@index
            [controller] => App\Http\Controllers\HelloController
            [action] => index
        )
)

Lumen 实现自定义LOG目录

由于篇幅较长,单独成一篇文章 Lumen 实现自定义LOG目录

今天先写到这里,由于本人水平有限,如果文章中有错误,还请大神指点。

大家遇到Lumen使用问题欢迎和我交流,有问题可以在评论区留言。

本文会持续更新。大家可以把这篇文章添加到收藏。


备注

laravel-china, 是平时逛得最多的Laravel社区。

本文首先发布在简书,转发到这里,希望认识更多的Laravel & Lumen爱好者,让更多的朋友喜欢上Laravel & Lumen, 共同学习进步 。

《L01 基础入门》
我们将带你从零开发一个项目并部署到线上,本课程教授 Web 开发中专业、实用的技能,如 Git 工作流、Laravel Mix 前端工作流等。
《L05 电商实战》
从零开发一个电商项目,功能包括电商后台、商品 & SKU 管理、购物车、订单管理、支付宝支付、微信支付、订单退款流程、优惠券等
讨论数量: 3

@tablecell Lumen中可以使用查询构造器。


$results = DB::select("SELECT users.*, contacts.phone FROM users LEFT JOIN contacts  where users.id = contracts.id");

$users = DB::table('users')
            ->join('contacts', 'users.id', '=', 'contacts.user_id')
            ->join('orders', 'users.id', '=', 'orders.user_id')
            ->select('users.*', 'contacts.phone', 'orders.price')
            ->get();

$users = DB::table('users')
            ->leftJoin('posts', 'users.id', '=', 'posts.user_id')
            ->get();

具体的方法还请参考Lumen中文文档。

7年前 评论

@tablecell 在bootstrap中开启$app->withFacades();门面可以直接使用, 是不是自己改动了Illuminate\Support\Facades\DB 类的代码。

7年前 评论

您好,我用另外一种方式拿到了URI:

$request->route()[1]["uses"]

不过感觉都挺傻的,不知道还有没有其他方法,在laravel里可以使用Root类的方法

4年前 评论

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