问题现象

在1Panel管理面板中使用PHP运行Swoole常驻服务时，经常遇到类似“Class 'Swoole\Server' not found”或“Call to undefined function swoole_...”等报错。这通常是因为PHP环境未正确加载Swoole扩展，或运行模式不符合Swoole常驻进程的要求。

原因分析

• 扩展未安装/未启用：1Panel默认PHP环境未包含Swoole扩展，需要手动编译安装并启用。
• CLI模式未配置：Swoole常驻服务需要通过PHP CLI模式运行，Web模式（如FPM）下无法正常启动或会报错。
• PHP版本不匹配：Swoole扩展与PHP版本存在兼容性要求，需选择对应的Swoole版本。
• 端口/进程冲突：常驻服务监听端口被占用，或进程管理权限不足也会导致启动失败。

解决方案

1. 安装Swoole扩展

1. 在1Panel中进入“软件商店”→“PHP”对应版本，选择“安装扩展”，找到Swoole并一键安装。若商店未提供，可通过命令行编译安装：pecl install swoole 或在源码目录执行 phpize && ./configure --enable-openssl --enable-swoole-curl && make && make install。
2. 修改php.ini，添加 extension=swoole.so，并通过 php -m | grep swoole 确认扩展已加载。

2. 配置CLI环境变量

在1Panel中创建网站时，尽量选择“反向代理”模式，将外部请求转发至Swoole监听端口。常驻服务启动脚本需使用CLI方式运行，例如：

php /www/wwwroot/your_project/server.php

建议在启动前执行 php -v 确认使用的是同一PHP版本。

3. 优化进程与端口设置

• 检查监听端口是否被占用：netstat -tlnp | grep 9501，如有冲突则修改Swoole配置中的 host 和 port。
• 设置合理的进程用户和组，确保有权限写日志和创建进程。
• 在1Panel防火墙中放行Swoole对应端口（如9501），防止外网无法访问。

4. 常见报错处理

• “No such file or directory”：检查PHP可执行文件路径是否正确，使用 which php 定位。
• “Swoole requires PHP >= 7.2”：升级PHP版本或使用兼容的Swoole旧版本。
• “Unable to open socket”：检查SELinux或AppArmor限制，适当调整安全策略。

验证与测试

启动常驻服务后，在1Panel终端执行 curl 127.0.0.1:9501 查看响应。若返回预期结果，则说明Swoole环境适配成功。同时可配合1Panel的日志监控功能，实时观察PHP错误日志，进一步排查潜在问题。