thinkphp启用swoole后服务异常，需四步配置：一、安装swoole扩展（≥4.8.0）并启用协程；二、database.php中改type为mysql、deploy=0、禁用环境变量；三、swoole.php开启enable_coroutine、host设127.0.0.1、worker_num适配cpu；四、redis改用swoolecoroutine edis，静态文件与websocket需独立路由注册。
如果您在ThinkPHP项目中启用Swoole扩展后服务无法启动、数据库查询卡死或静态资源无法访问，则可能是由于Swoole配置未适配协程环境或关键参数缺失。以下是完成Swoole扩展支持配置的多种方法：
一、安装并启用Swoole扩展
必须确保PHP环境中已正确加载Swoole扩展，且版本不低于4.8.0，否则协程MySQL与Redis将不可用。
1、执行pecl install swoole或从源码编译安装，确认swoole.so已写入php.ini；
2、重启PHP进程（如php-fpm）或Web服务器；
3、运行php --ri swoole验证扩展加载状态，输出中必须包含“enable coroutine => true”；
4、在ThinkPHP项目根目录执行composer require topthink/think-swoole安装适配包。
二、修改database.php启用协程MySQL
传统PDO驱动在Swoole协程环境下会阻塞调度，必须切换为Swoole原生协程MySQL客户端，并禁用非协程特性。
1、打开config/database.php；
2、将'type' => 'pdo'改为'type' => 'mysql'；
3、设置'deploy' => 0，关闭读写分离，防止混入非协程连接；
4、显式填写'hostname'、'username'、'password'，禁止使用getenv()或$_ENV动态获取；
5、删除所有在模型__construct()或全局初始化中执行的数据库查询语句。
三、配置swoole.php启用协程与服务参数
该配置文件控制Swoole服务启动行为，需显式开启协程支持并规避多进程端口冲突风险。
1、确认config/swoole.php中'enable_coroutine' => true已启用；
2、将'host'设为'127.0.0.1'而非'0.0.0.0'，避免IPv6双栈握手异常；
3、设置'options'=>['daemonize'=>false]用于调试，错误堆栈可直出终端；
4、增加'worker_num' => swoole_cpu_num()，提升并发处理能力；
5、若使用Docker，确保容器内/proc/sys/net/core/somaxconn值≥1024。
四、启用协程Redis客户端
ThinkPHP默认Redis驱动基于phpredis，不兼容协程，必须替换为Swoole内置协程客户端。
1、在config/cache.php或config/redis.php中，将驱动类指向SwooleCoroutineRedis；
2、移除所有new Redis()或Cache::store('redis')等同步调用；
3、改用协程方式创建连接：$redis = new SwooleCoroutineRedis(); $redis->connect('127.0.0.1', 6379);；
4、禁止在协程外调用$redis->connect()或任何query方法，否则报“must be called in the coroutine”。
五、静态文件与WebSocket路由适配
协程HTTP服务器默认不解析public目录，且WebSocket需独立路由注册，否则404或101升级失败。
1、在route/app.php中添加静态文件路由：
Route::get('static/:path', function (string $path) {
$filename = public_path() . $path;
return new hinkswoole
esponseFile($filename);
})->pattern(['path' => '.*.w+$']);
2、启用WebSocket需在config/swoole.php中设置'websocket'=>['enabled'=>true]；
3、创建config/websocket.php并定义路由映射，例如['/ws' => 'app\controller\WsController']；
4、WebSocket控制器中所有业务逻辑必须置于onOpen/onMessage回调内，不可在构造函数中操作连接实例。
php免费学习视频：立即使用
踏上前端学习之旅，开启通往精通之路！从前端基础到项目实战，循序渐进，一步一个脚印，迈向巅峰！
