eleven26

1. 在修改 queue 相关代码后，必须要使用 php artisan queue:restart 来重启队列服务，否则所做的修改可能不会生效(没法重现了，按理说应该和使用 queue:listen 或 queue:work 有关，不过最好还是重启；可能和 supervisor 开启多个 queue:work 进程也有关系，本地测试的时候只有一个进程)。

文档：

2、开发环境下以同步的方式执行队列，将 queue driver 的值改为 sync，注意，如果 queue 有输出的话，可能会导致一些问题，如：本来应该只返回 json 串的，然后 queue 里面有输出，导致前端 json 解析失败。

3、什么时候使用 queue:listen ？什么时候使用 queue:work ？

官网文档有一段描述是：

在 queue:work Artisan 命令里包含了 --daemon 选项，强制队列服务器持续处理任务，而不需要重新启动整个框架。比起 queue:listen 命令，这将明显的减少 CPU 的用量。

使用 queue:work 的时候不需要重现启动整个框架，这可能是 1 中可能修改 Job 后不生效的问题。

4、多个项目同时部署时候的冲突

Laravel 中队列任务使用 redis 驱动情况下保存的时候的缓存 key 是不带前缀的，比如 A 项目 dispatch 了一个 a job，保存在了 queues:default，然后我们去 B 项目 dispatch 另一个 job，我们发现它们保存在了相同的 redis key 中

这样会导致的问题是：在一个项目中跑 php artisan queue:work 会拿到另外一个项目的 job，这样就会导致一些不必要的异常，因为在反序列化的过程中会找不到对应的类。

原因：config/queue.php 中配置的默认 queue 都是 default：

1
2
3
4
5
6

'redis' => [
    'driver' => 'redis',
    'connection' => 'default',
    'queue' => 'default',
    'expire' => 60,
]

解决办法：

a、自己用的是 5.1 版本，网上有说可以修改 cache prefix 解决，但是 laravel 5.1 行不通，可能新版本可以

b、为 job 指定不同的 queue，如 dispatch job 的时候可以 dispatch((new xxJob())->onQueue('xxQueue'))，这样一来，job 就保存在了 queues:xxQueue 中， 但是还是得注意，如果还有其他项目，不要取相同名字。同时，这样一来，我们的 queue:work 或者 queue:listen 命令也要加上 --queue 参数了， 如 php artisan queue:work --queue=testQueue，否则还是会去 queues:default 里面找。如下：

c、直接修改 config/queue.php，修改 redis.queue 为一个唯一的名字。如：

1
2
3
4
5
6

'redis' => [
    'driver' => 'redis',
    'connection' => 'default',
    'queue' => 'peper',
    'expire' => 60,
]

这样一来，我们的 job 就不会和其他项目的混在一起了。

个人看法：最好的实践应该还是，不同的队列使用不同的名字（即使是同一个项目），这样会更便于管理。

5. 给队列的 Job 对象设置模型对象属性的时候，最后处理队列的时候会重新查询这个模型的数据。

详细见：\Illuminate\Queue\SerializesModels

也就是说，我们如果想在新建 Job 实例的时候，通过 setAttribute 设置了一个模型实例的属性，想在 handle 里面获取这个属性的话，是获取不到的。因为序列化队列任务的时候只会保存模型实例的几个关键属性，详细见：\Illuminate\Contracts\Database\ModelIdentifier

扩展：

1、监控 redis：

1

redis-cli > monitor

2、关于 Laravel 队列基本工作方式：dispatch 一个 job 的时候，Laravel 把 job 序列化保存到相应的 driver 中（redis、database、file...），然后 queue:listen 或 queue:work 的时候会从对应的 driver 里面取出这个 job，对 payload 反序列化，然后调用 job 里面的 handle 方法进行 job 的处理。

在 Laravel 中，有时候我们想修改模型对象的某个属性的时候，可能会报错 Indirect modification of overloaded property User::$info has no effect。

这是因为我们给模型设置的属性获取我们通过属性的方式获取对象信息的时候，实际上是通过 Model 的 __get 魔术方法获取的。在模型的 $attributes 属性数组里面，保存了我们设置的对象属性，比如下面的操作：

定义模型

1
2

class User extends \Illuminate\Database\Eloquent\Model
{}

1
2

$user = new User;
$user->age = 26;

实际上是通过 Model 的 __set 方法在 Model 的 $attributes 数组属性里面加了一个属性：

1
2
3
4

$user = new User;
$user->age = 26;

dd($user->toArray(), $user->getAttributes()); // ['age' => 26], ['age' => 26]

::__get 方法定义

1
2
3
4
5
6
7
8
9
10

/**
 * Dynamically retrieve attributes on the model.
 *
 * @param  string  $key
 * @return mixed
 */
public function __get($key)
{
    return $this->getAttribute($key);
}

前面我们设置了 $user->age = 26; 但是 property_exists($user, 'age') 会是 false。

我们获取这个属性的时候 $user->age，实际上等同于 $user->__get('age')，也就是说，我们想修改里面属性的时候比如 $user->info['job'] = 'PHP';，实际上等同于：

1

$user->__get('info')['job'] = 'PHP';

也就是说，等同于：

1
2

$temp = $user->__get('info');
$temp['job'] = 'PHP';

也就是说，我们在设置有层级的属性的时候，中间产生了临时变量。

假设大家知道了值传递、引用传递的区别。

这个时候问题就来了，如果这个 $user->info 是一个数组，我们最终修改的是一个临时数组，而 $user->info 还是不变。这个时候就报错了，因为这个修改是完全没有意义的。

而如果 $user->info 是一个对象的时候，我们临时变量也是一个对象，而对象是通过引用传递的，我们修改了这个对象的时候，实际上也修改了 $user->info，因为这个临时变量指向了原始对象。

完整例子

1
2
3
4
5
6
7
8
9
10
11
12
13
14

$user = app(User::class);

$user->infoObj = new stdClass;
$user->infoObj->age = 26;
$user->infoObj->job = 'PHP';

// dd($user->toArray());

// Indirect modification of overloaded property User::$info has no effect
$user->info = [
    'age' => 26,
];
$user->info['job'] = 'PHP';

自定义一个 Dispatcher

.php

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21

<?php

namespace App;

use Dingo\Api\Http\Request;

class Dispatcher
{
    /**
     * Dispatch a request.
     *
     * @param $request
     * @return mixed
     */
    public function dispatch($request)
    {
        $version = Request::getAcceptParser()->parse($request)['version'];

        return app('api.router.adapter')->dispatch($request, $version);
    }
}

修改 \Hhxsv5\LaravelS\Illuminate\Laravel::handleDynamic 方法，把 $response = $this->app->dispatch($request); 替换成 $response = app(\App\Dispatcher::class)->dispatch($request);。

原因

使用 $response = $this->app->dispatch($request); 的时候，实际上没有处理 http 头里面的版本信息

源码： https://github.com/hhxsv5/laravel-s/blob/v3.5.7/src/Illuminate/Laravel.php#L146

默认情况下，toSql 获取到的 sql 里面的参数使用 "?" 代替的，如下：

1

DB::table('users')->where('id', 1)->toSql();

获取到的 sql 语句是：

1

select * from `users` where `id` = ?

有时候我们想要得到具体的语句，可以利用 builder 的 getBindings 方法：

1
2
3
4
5

$builder = DB::table('users')->where('id', 1);
$bindings = $builder->getBindings();
$sql = str_replace('?', '%s', $builder->toSql());
$sql = sprintf($sql, ...$bindings);
dd($sql);

获取到的 sql 语句是：

1

select * from `tb_user` where `id` = 1

如果经常使用可以考虑使用 Builder 的 macro 方法加进 Builder 里面：

1
2
3
4
5
6
7

\Illuminate\Database\Query\Builder::macro('sql', function () {
    $bindings = $this->getBindings();
    $sql = str_replace('?', '%s', $this->toSql());
 
    return sprintf($sql, ...$bindings);
});
dd(DB::table('users')->where('id', 1)->sql());

说明

性能一直是 Laravel 框架为人诟病的一个点，所以调优 Laravel 程序算是一个必学的技能。

接下来分享一些开发的最佳实践，还有调优技巧，大家有别的建议也欢迎留言讨论。

这里是简单的列表：

• 配置信息缓存 artisan config:cache
• 路由缓存 artisan route:cache
• 类映射加载优化 artisan optimize
• 自动加载优化 composer dumpautoload
• 使用 Memcached 来存储会话 config/session.php
• 使用专业缓存驱动器 config/cache.php
• 数据库请求优化
• 为数据集书写缓存逻辑
• 使用即时编译器（JIT），如：HHVM
• 开启 OpCache
• 前端资源合并 Elixir

1. 配置信息缓存

使用以下 Artisan 自带命令，把 config 文件夹里所有配置信息合并到一个文件里，减少运行时文件的载入数量：

1

php artisan config:cache

上面命令会生成文件 bootstrap/cache/config.php，可以使用以下命令来取消配置信息缓存：

1

php artisan config:clear

此命令做的事情就是把 bootstrap/cache/config.php 文件删除。

注意：配置信息缓存不会随着更新而自动重载，所以，开发时候建议关闭配置信息缓存，一般在生产环境中使用，可以配合 Envoy 任务运行器 一起使用。

2. 路由缓存

路由缓存可以有效的提高路由器的注册效率，在大型应用程序中效果越加明显，可以使用以下命令：

1

php artisan route:cache

以上命令会生成 bootstrap/cache/routes.php 文件，需要注意的是，路由缓存不支持路由匿名函数编写逻辑，详见：文档 - 路由缓存。

可以使用下面命令清除路由缓存：

1

php artisan route:clear

此命令做的事情就是把 bootstrap/cache/routes.php 文件删除。

注意：路由缓存不会随着更新而自动重载，所以，开发时候建议关闭路由缓存，一般在生产环境中使用，可以配合 Envoy 任务运行器 一起使用。

3. 类映射加载优化

optimize 命令把常用加载的类合并到一个文件里，通过减少文件的加载，来提高运行效率：

1

php artisan optimize --force

会生成 bootstrap/cache/compiled.php 和 bootstrap/cache/services.json 两个文件。

你可以可以通过修改 config/compile.php 文件来添加要合并的类。

在 production 环境中，参数 --force 不需要指定，文件就会自动生成。

要清除类映射加载优化，请运行以下命令：

1

php artisan clear-compiled

此命令会删除上面 optimize 生成的两个文件。

注意：此命令要运行在 php artisan config:cache 后，因为 optimize 命令是根据配置信息（如：config/app.php 文件的 providers 数组）来生成文件的。

4. 自动加载优化

此命令不止针对于 Laravel 程序，适用于所有使用 composer 来构建的程序。此命令会把 PSR-0和 PSR-4 转换为一个类映射表，来提高类的加载速度。

1

composer dumpautoload -o

注意：php artisan optimize --force 命令里已经做了这个操作。

5. 使用 Memcached 来存储会话

每一个 Laravel 的请求，都会产生会话，修改会话的存储方式能有效提高程序效率，会话的配置信息是 config/session.php，建议修改为 Memcached 或者 Redis 等专业的缓存软件：

1

'driver' => 'memcached',

6. 使用专业缓存驱动器

「缓存」是提高应用程序运行效率的法宝之一，默认缓存驱动是 file 文件缓存，建议切换到专业的缓存系统，如 Redis 或者 Memcached，不建议使用数据库缓存。

1

'default' => 'redis',

7. 数据库请求优化

数据关联模型读取时使用 延迟预加载 和 预加载 ；

使用 Laravel Debugbar 或者 Clockwork 留意每一个页面的总数据库请求数量；

这里的篇幅只写到与 Laravel 相关的，其他关于数据优化的内容，请自行查阅其他资料。

8. 为数据集书写缓存逻辑

合理的使用 Laravel 提供的缓存层操作，把从数据库里面拿出来的数据集合进行缓存，减少数据库的压力，运行在内存上的专业缓存软件对数据的读取也远远快于数据库。

1
2
3
4

$posts = Cache::remember('index.posts', $minutes = 30, function()
{
    return Post::with('comments', 'tags', 'author', 'seo')->whereHidden(0)->get();
});

remember 甚至连数据关联模型也都一并缓存了，多么方便呀。

9. 使用即时编译器（JIT）

HHVM 是目前比较好的 JIT 实现，能轻轻松松的让你的应用程序在不用做任何修改的情况下，直接提高 50% 或者更高的性能。

10. 开启 OpCache

PHPhub 之前做个一个实验，具体请见：使用 OpCache 提升 PHP 5.5+ 程序性能。

11. 前端资源合并

作为优化的标准，一个页面只应该加载一个 CSS 和 一个 JS 文件，并且文件要能方便走 CDN，需要文件名随着修改而变化。

Laravel Elixir 提供了一套简便实用的方案，详细请见文档：`Laravel Elixir 文档。

原文地址: https://laravel-china.org/articles/2020/ten-laravel-5-program-optimization-techniques