Swoole项目上线前需要完成哪些配置-Swoole-PHP中文网

必须完成系统内核、php扩展、服务进程到健康监控的全链路配置：加固tcp参数与文件句柄，校验php/swoole版本一致性，设worker_num≤cpu核数、max_request=3000、daemonize=true，预置日志/pid权限，用systemd管理并curl验证/health端点返回200。

swoole项目上线前需要完成哪些配置

确保Swoole项目在生产环境稳定运行、不因配置疏漏导致服务中断或性能崩溃，必须完成从系统内核、PHP扩展、服务进程到健康监控的全链路配置。

系统级内核参数加固

高并发场景下，Linux默认网络参数极易引发TIME_WAIT堆积、端口耗尽或文件句柄不足。这一步不做，服务上线后可能在第3小时就出现连接拒绝。

执行以下命令写入并生效：

echo 'net.ipv4.tcp_tw_reuse = 1' >> /etc/sysctl.conf
echo 'net.ipv4.tcp_fin_timeout = 30' >> /etc/sysctl.conf
echo '* soft nofile 65536' >> /etc/security/limits.conf
echo '* hard nofile 65536' >> /etc/security/limits.conf
sysctl -p

【必须重启当前shell或重新登录用户，否则nofile限制不生效】

PHP环境与Swoole扩展校验

三者版本必须严格一致：项目所用PHP CLI版本、Web服务器（如php-fpm）所用PHP版本、Swoole扩展编译时绑定的php-config路径指向的PHP版本。任意一项错位，都会导致swoole.so加载失败或运行时崩溃。

第一步：确认PHP CLI版本
php -v

第二步：定位对应php-config路径（常见位置：/usr/bin/php-config、/www/server/php/80/bin/php-config、/opt/php/bin/php-config）
第三步：用该php-config路径重新编译Swoole（若已安装但异常）：
cd /path/to/swoole-src && ./configure --with-php-config=/correct/path/to/php-config && make clean && make && sudo make install

第四步：检查php.ini是否启用且路径正确
php --ini 显示Loaded Configuration File路径 → 编辑该文件 → 确保含 extension=swoole.so 且未被分号注释

第五步：验证扩展加载
php -m | grep swoole —— 输出 swoole 即为成功

Swoole主服务核心参数设置

worker_num不能简单设为CPU核数×2，必须按实际负载类型决策：CPU密集型服务（如图像处理）应≤物理核心数；I/O密集型（如API网关）可设为物理核心数×1.5～2，但不得超过16（避免调度抖动）。

方法一：基础安全配置（推荐8核服务器）

Swoole 6.1.1

Swoole 6.1.1 是一个专为 PHP 设计的高性能事件驱动并发网络引擎。作为稳定版，它修复了编译时对 zlib 依赖的缺失及 curl 模块的内存安全风险。该版本支持协程、多线程与多进程架构，内置 TCP/HTTP/WebSocket 服务器，能够显著提升 PHP 在微服务、实时通信等场景下的执行效率与并发能力。

下载

$server = new Swoole\Http\Server('0.0.0.0', 9501, SWOOLE_PROCESS);
$server->set([
  'worker_num' => 8,
  'task_worker_num' => 4,
  'max_request' => 3000,
  'open_tcp_nodelay' => true,
  'daemonize' => true,
  'log_file' => '/var/log/swoole/error.log',
  'pid_file' => '/var/run/swoole.pid',
  'reload_async' => true,
]);

方法二：内存敏感型调整（适用于协程中频繁创建大对象）

将 'max_coroutine' 显式设为 2000～2500，防止协程栈溢出触发SIGSEGV；同时把 'max_request' 降至 2000，强制进程更早回收内存。

日志与PID权限预置

部署前必须手动创建日志目录并赋权，否则Swoole以www-data用户启动时会因无写入权限静默失败，进程看似运行实则未监听端口。

mkdir -p /var/log/swoole /var/run/swoole
chown www-data:www-data /var/log/swoole /var/run/swoole
chmod 755 /var/log/swoole /var/run/swoole

【/var/run/swoole.pid 文件路径必须与代码中 pid_file 值完全一致，否则systemd无法获取主进程PID】

systemd服务单元配置与健康检查

第一步：创建 /etc/systemd/system/swoole.service

[Unit]
Description=Swoole HTTP Server
After=network.target

[Service]
Type=simple
User=www-data
Group=www-data
WorkingDirectory=/var/www/myapp
ExecStart=/usr/bin/php /var/www/myapp/server.php
Restart=on-failure
RestartSec=5
StartLimitIntervalSec=60
LimitNOFILE=65536

[Install]
WantedBy=multi-user.target

第二步：重载配置并启用服务
sudo systemctl daemon-reload
sudo systemctl enable swoole
sudo systemctl start swoole

第三步：验证服务状态与端口监听
sudo systemctl status swoole
sudo lsof -i :9501

第四步：执行健康检查
curl -I http://127.0.0.1:9501/health —— 必须返回 HTTP/1.1 200 OK，且响应头含 Server: swoole