当前位置：首页 > news >正文

Yii2-Swoole 快速入门 - dacheng

news 2026/6/10 17:08:20

Yii2-Swoole 快速入门

让你的 Yii2 应用性能提升 10-100 倍！本教程将教你如何在 yii2-app-basic 中快速集成 yii2-swoole。

为什么使用 yii2-swoole？

⚡ 比 PHP-FPM 快 10-100 倍
🔄 数据库和 Redis 连接池自动管理
🚀 协程并发处理请求
💻 代码几乎不需要修改

系统要求

PHP >= 8.1
Swoole >= 6.0
Yii2 >= 2.0

安装 Swoole

pecl install swoole

在 php.ini 中添加：

extension=swoole.so

验证：

php --ri swoole

快速开始

1. 安装扩展

composer require dacheng-php/yii2-swoole

2. 创建配置文件

创建 config/swoole.php：

<?phpreturn ['bootstrap' => [['class' => \Dacheng\Yii2\Swoole\Bootstrap::class,'componentId' => 'swooleHttpServer','memoryLimit' => '2G',],],'components' => ['swooleHttpServer' => ['class' => \Dacheng\Yii2\Swoole\Server\HttpServer::class,'host' => '127.0.0.1','port' => 9501,'documentRoot' => __DIR__ . '/../web','settings' => ['max_coroutine' => 100000,'log_level' => SWOOLE_LOG_WARNING,],'dispatcher' => new \Dacheng\Yii2\Swoole\Server\RequestDispatcher(__DIR__ . '/web.php'),],],
];

3. 修改 Web 配置

编辑 config/web.php，在 return $config; 之前添加：

// 合并 Swoole 配置
$swooleConfig = require __DIR__ . '/swoole.php';
$config = \yii\helpers\ArrayHelper::merge($swooleConfig, $config);

4. 启动服务器

php yii swoole/start

访问 http://127.0.0.1:9501 即可！

停止服务器：

php yii swoole/stop
# 或按 Ctrl+C

进阶功能

数据库连接池

在 config/swoole.php 中添加：

'db' => ['class' => \Dacheng\Yii2\Swoole\Db\CoroutineDbConnection::class,'dsn' => 'mysql:host=127.0.0.1;dbname=your_database','username' => 'root','password' => '','charset' => 'utf8mb4','poolMaxActive' => 20,'poolWaitTimeout' => 5.0,
],

使用方式与标准 Yii2 完全相同，连接池自动管理。

Redis 连接池

composer require yiisoft/yii2-redis

在 config/swoole.php 中添加：

'redis' => ['class' => \Dacheng\Yii2\Swoole\Redis\CoroutineRedisConnection::class,'hostname' => '127.0.0.1','port' => 6379,'poolMaxActive' => 20,'poolWaitTimeout' => 5.0,
],'cache' => ['class' => \Dacheng\Yii2\Swoole\Cache\CoroutineRedisCache::class,'redis' => 'redis',
],'session' => ['class' => \Dacheng\Yii2\Swoole\Session\CoroutineSession::class,'redis' => 'redis',
],

异步队列

composer require yiisoft/yii2-queue

配置：

'bootstrap' => [// ...'queue',
],
'components' => ['queue' => ['class' => \Dacheng\Yii2\Swoole\Queue\CoroutineRedisQueue::class,'redis' => 'redis','channel' => 'queue','concurrency' => 10,],
],

创建任务 jobs/EmailJob.php：

<?php
namespace app\jobs;class EmailJob extends \yii\base\BaseObject implements \yii\queue\JobInterface
{public $to;public $subject;public function execute($queue){// 发送邮件\Yii::$app->mailer->compose()->setTo($this->to)->setSubject($this->subject)->send();}
}

使用：

Yii::$app->queue->push(new EmailJob(['to' => 'user@example.com','subject' => '测试',
]));

协程 HTTP 客户端

配置：

'httpClient' => ['class' => \Dacheng\Yii2\Swoole\HttpClient\CoroutineClient::class,'transport' => ['class' => \Dacheng\Yii2\Swoole\HttpClient\CoroutineTransport::class,],
],

使用：

// 单个请求
$response = Yii::$app->httpClient->get('https://api.example.com/users')->send();// 批量并发请求
$requests = ['users' => Yii::$app->httpClient->get('https://api.example.com/users'),'posts' => Yii::$app->httpClient->get('https://api.example.com/posts'),
];
$responses = Yii::$app->httpClient->batchSend($requests);

完整配置

config/swoole.php 示例：

<?phpreturn ['bootstrap' => [['class' => \Dacheng\Yii2\Swoole\Bootstrap::class,'componentId' => 'swooleHttpServer',],'queue',],'components' => ['swooleHttpServer' => ['class' => \Dacheng\Yii2\Swoole\Server\HttpServer::class,'host' => '127.0.0.1','port' => 9501,'documentRoot' => __DIR__ . '/../web','dispatcher' => new \Dacheng\Yii2\Swoole\Server\RequestDispatcher(__DIR__ . '/web.php'),],'db' => ['class' => \Dacheng\Yii2\Swoole\Db\CoroutineDbConnection::class,'dsn' => 'mysql:host=127.0.0.1;dbname=myapp','username' => 'root','password' => '','poolMaxActive' => 20,],'redis' => ['class' => \Dacheng\Yii2\Swoole\Redis\CoroutineRedisConnection::class,'hostname' => '127.0.0.1','poolMaxActive' => 20,],'cache' => ['class' => \Dacheng\Yii2\Swoole\Cache\CoroutineRedisCache::class,'redis' => 'redis',],'session' => ['class' => \Dacheng\Yii2\Swoole\Session\CoroutineSession::class,'redis' => 'redis',],'queue' => ['class' => \Dacheng\Yii2\Swoole\Queue\CoroutineRedisQueue::class,'redis' => 'redis',],],
];

常见问题

代码修改后不生效？
重启服务器：Ctrl+C 停止后重新启动（Swoole 常驻内存）

无法启动？

检查 Swoole 是否安装：php --ri swoole
检查端口占用：lsof -i:9501

连接超时？
增加 poolMaxActive 和 poolWaitTimeout 参数

静态文件 404？
确认 documentRoot 指向正确的 web 目录

生产部署

Systemd 服务

创建 /etc/systemd/system/yii2-app.service：

[Unit]
Description=Yii2 Swoole
After=network.target[Service]
Type=simple
User=www-data
WorkingDirectory=/var/www/my-app
ExecStart=/usr/bin/php /var/www/my-app/yii swoole/start
Restart=on-failure[Install]
WantedBy=multi-user.target

启动：

sudo systemctl daemon-reload
sudo systemctl enable yii2-app
sudo systemctl start yii2-app

Nginx 反向代理

server {listen 80;server_name example.com;location / {proxy_pass http://127.0.0.1:9501;proxy_set_header Host $host;proxy_set_header X-Real-IP $remote_addr;}
}