You need to enable JavaScript to run this app. 如何使用PHP_CLI_SERVER_WORKERS让PHP内置服务多线程运行,解决Laravel artisan serve配置不生效问题
优惠活动
大模型
产品
解决方案
定价
更多

如何使用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

相关产品推荐
方舟 Agent Plan

超全模态模型 × Harness 升级,最新支持 Deepseek-V4.1-Flash、GLM-5.3 系列、Doubao-Seedream-5.0-pro、Kimi-K3 (部分), 限时 9.9 元起

最近更新时间:2026.10.18 06:36:10