如何使用PHP_CLI_SERVER_WORKERS让PHP内置服务多线程运行,解决Laravel artisan serve配置不生效问题
问题解决方案
核心原因说明
你遇到的两个问题直接关联:
- PHP内置开发服务器默认是单进程同步阻塞运行,同一时间只能处理1个请求。当你在一个请求的处理逻辑中用Guzzle向同一服务器的localhost发起请求时,会触发进程死锁:当前进程正在等待Guzzle请求返回,而Guzzle请求又在等待空闲进程处理,最终只会超时失败,这是你Guzzle请求异常的根本原因。
- 你在
docker-compose.yaml中添加的环境变量不生效,是因为Laravel的php artisan serve命令默认启动时不会自动继承上层进程的PHP_CLI_SERVER_WORKERS环境变量,需要手动传递才会生效。
修复步骤
1 配置环境变量
在项目根目录的docker-compose.yml中,找到laravel.test服务的environment配置段,添加对应的环境变量:
services: laravel.test: # 其他配置保持不变 environment: # 其他原有环境变量保持不变 - PHP_CLI_SERVER_WORKERS=4 # 进程数可根据需求调整,建议4~8即可
2 重新启动服务使配置生效
不要使用默认的sail artisan serve启动,用以下任意一种方式启动即可生效:
- 方案1:直接调用PHP内置服务器命令
sail exec laravel.test php -S 0.0.0.0:8000 -t public - 方案2:手动传递环境变量调用artisan serve
sail exec laravel.test bash -c "PHP_CLI_SERVER_WORKERS=4 php artisan serve --host=0.0.0.0 --port=8000"
3 验证配置是否生效
服务启动后,在容器内执行进程查看命令:
ps aux | grep php
如果输出结果中有多个php -S开头的进程,就说明多进程配置已经生效,此时再用Guzzle请求localhost就不会出现死锁问题。
注意事项
PHP_CLI_SERVER_WORKERS仅支持PHP 7.4及以上版本,且仅在非Windows系统下生效,Sail使用的Linux镜像完全兼容该配置。- PHP内置服务器仅用于开发环境测试,不要在生产环境使用。
内容的提问来源于stack exchange,提问作者varuog
相关产品推荐
相关产品推荐

