常见问题

常见问题

Class swoole does not exist

在LaravelS中，Swoole是以cli模式启动的Http Server，替代了FPM。
投递任务、触发异步事件都会调用app('swoole')，从Laravel容器中获取Swoole\http\server实例。只有在LaravelS启动时，才会注入这个实例到容器中。
所以，一旦脱离LaravelS，由于跨进程，以下情况，你将无法成功调用app('swoole')：
- 以各种命令行方式运行的代码，例如Artisan命令行、PHP脚本命令行。
- 运行在FPM/Apache PHP Module下的代码。

使用包 jenssegers/agent

监听系统事件

// 重置Agent
\Event::listen('laravels.received_request', function (\Illuminate\Http\Request $req, $app) {
    $app->agent->setHttpHeaders($req->server->all());
    $app->agent->setUserAgent();
});

使用包 barryvdh/laravel-debugbar

官方不支持cli模式，需手动注释掉此判断，但启用后不排除会有其他问题。

// 搜索 runningInConsole()，并注释掉该判断
$this->enabled = $configEnabled /*&& !$this->app->runningInConsole()*/ && !$this->app->environment('testing');

使用包 overtrue/wechat

easywechat包会出现异步通知回调失败的问题，原因是$app['request']是空的，给其赋值即可。

//回调通知
public function notify(Request $request)
{
    $app = $this->getPayment();//获取支付实例
    $app['request'] = $request;//在原有代码添加这一行，将当前Request赋值给$app['request']
    $response = $app->handlePaidNotify(function ($message, $fail) use($id) {
        //...
    });
    return $response;
}

使用包 laracasts/flash

常驻内存后，每次调用flash()会追加消息提醒，导致叠加展示消息提醒。有以下两个方案。

1.通过中间件在每次请求处理前或处理后重置$messages app('flash')->clear();。

2.每次请求处理后重新注册FlashServiceProvider，配置register_providers。

单例的控制器

1.错误用法。

namespace App\Http\Controllers;
class TestController extends Controller
{
    protected $userId;
    public function __construct()
    {
        // 错误的用法：因控制器是单例，会常驻于内存，$userId只会被赋值一次，后续请求会误读取之前请求$userId
        $this->userId = session('userId');
    }
    public function testAction()
    {
        // 读取$this->userId;
    }
}

2.正确用法。

namespace App\Http\Controllers;
class TestController extends Controller
{
    protected function getUserId()
    {
        return session('userId');
    }
    public function testAction()
    {
        // 通过调用$this->getUserId()读取$userId
    }
}

不能使用这些函数

flush/ob_flush/ob_end_flush/ob_implicit_flush：swoole_http_response不支持flush。
dd()/exit()/die(): 将导致Worker/Task/Process进程立即退出，建议通过抛异常跳出函数调用栈，Swoole文档。
header()/setcookie()/http_response_code()：HTTP响应只能通过Laravel/Lumen的Response对象。

不能使用的全局变量

$_GET、$_POST、$_FILES、$_COOKIE、$_REQUEST、$_SESSION、$GLOBALS，$_ENV是可读的，$_SERVER是部分可读的。

大小限制

Swoole限制了GET请求头的最大尺寸为8KB，建议Cookie的不要太大，不然Cookie可能解析失败。
POST数据或文件上传的最大尺寸受Swoole配置package_max_length影响，默认上限2M。

Inotify监听文件数达到上限

Warning: inotify_add_watch(): The user limit on the total number of inotify watches was reached

Linux中Inotify监听文件数默认上限一般是8192，实际项目的文件数+目录树很可能超过此上限，进而导致后续的监听失败。
增加此上限到524288：echo fs.inotify.max_user_watches=524288 | sudo tee -a /etc/sysctl.conf && sudo sysctl -p，注意Docker时需设置启用privileged。

注意include/require与(include/require)_once

看看鸟哥这篇文章再一次, 不要使用(include/require)_once

引入类、接口、trait、函数时使用(include/require)_once，其他情况使用include/require。
在多进程模式下，子进程会继承父进程资源，一旦父进程引入了某个需要被执行的文件，子进程再次require_once()时会直接返回true，导致该文件执行失败。此时，你应该使用include/require。

对于Swoole < 1.9.17的环境

开启handle_static后，静态资源文件将由LaravelS组件处理。由于PHP环境的原因，可能会导致MimeTypeGuesser无法正确识别MimeType，比如会Javascript与CSS文件会被识别为text/plain。

解决方案：

1.升级Swoole到1.9.17+

2.注册自定义MIME猜测器

// MyGuessMimeType.php
use Symfony\Component\HttpFoundation\File\MimeType\MimeTypeGuesserInterface;
class MyGuessMimeType implements MimeTypeGuesserInterface
{
    protected static $map = [
        'js'  => 'application/javascript',
        'css' => 'text/css',
    ];
    public function guess($path)
    {
        $ext = pathinfo($path, PATHINFO_EXTENSION);
        if (strlen($ext) > 0) {
            return Arr::get(self::$map, $ext);
        } else {
            return null;
        }
    }
}

// AppServiceProvider.php
use Symfony\Component\HttpFoundation\File\MimeType\MimeTypeGuesser;
public function boot()
{
    MimeTypeGuesser::getInstance()->register(new MyGuessMimeType());
}