Symfony应用在Google Cloud PHP 8.2弹性运行时启动失败

问题现象 #

部署过程中composer安装、资源配置等步骤执行成功，但最终停滞数分钟后报错：

ERROR: (gcloud.app.deploy) Error Response: [9] An internal error occurred while processing task /app-engine-flex/flex_await_healthy/flex_await_healthy>2024-04-19T05:17:11.229Z7995.fs.2: ERROR: failed to launch: determine start command: when there is no default process a command is required

当前使用的app.yaml配置：

runtime: php
env: flex

runtime_config:
  operating_system: "ubuntu22"
  runtime_version: "8.2"
  document_root: public

原因分析 #

PHP 8.x版本的GAE弹性环境（基于Ubuntu22镜像）不再像PHP7的旧运行时那样自动配置默认启动流程，必须显式指定Web服务器的启动命令，否则GAE无法确定要启动的进程。

解决方案 #

在app.yaml中添加entrypoint配置，指定适合Symfony的启动命令，以下是两种常见方案：

方案1：使用PHP-FPM（生产环境推荐） #

修改后的app.yaml：

runtime: php
env: flex

runtime_config:
  operating_system: "ubuntu22"
  runtime_version: "8.2"
  document_root: public

entrypoint: "php-fpm -y /etc/php/8.2/fpm/php-fpm.conf -R"

方案2：使用Apache #

如果项目依赖Apache环境，可指定：

runtime: php
env: flex

runtime_config:
  operating_system: "ubuntu22"
  runtime_version: "8.2"
  document_root: public

entrypoint: "apache2-foreground"

额外检查项 #

• 确认Symfony版本兼容PHP8.2：Symfony 5.4、6.x、7.x版本均支持PHP8.2，若使用旧版本需先升级Symfony
• 本地验证启动命令：在本地环境（或Docker容器中）测试指定的entrypoint命令，确保能正常启动服务无报错

内容的提问来源于stack exchange，提问作者Edska