部署Symfony到AWS Elastic Beanstalk时遇PHP路径错误求助

问题原因 #

AWS Elastic Beanstalk的部署进程环境变量PATH中未包含PHP的安装路径，导致#!/usr/bin/env php无法定位到PHP执行文件；而通过SSH切换到webapp用户时，环境变量已自动加载PHP路径，因此手动执行composer install可正常运行。

解决方案 #

方法一：替换requirements-checker的Shebang为绝对路径 #

1. 通过SSH连接EB实例，执行which php获取PHP绝对路径（Amazon Linux 2的PHP 8.1环境通常为/usr/bin/php）。
2. 在项目根目录的.ebextensions文件夹下创建01-fix-shebang.config文件，内容如下：

container_commands:
  01_update_requirements_checker_shebang:
    command: "sed -i 's|#!/usr/bin/env php|#!/usr/bin/php|' /var/app/staging/vendor/symfony/requirements-checker/bin/requirements-checker"
    leader_only: false

该配置会在部署阶段自动替换脚本的Shebang为PHP绝对路径，直接解决路径查找问题。

方法二：为部署进程添加PHP路径到PATH #

在.ebextensions下创建02-set-path.config文件，通过容器命令为部署环境注入PHP路径：

container_commands:
  01_add_php_to_path:
    command: 'export PATH=$PATH:/usr/bin && composer install'
    cwd: /var/app/staging
    leader_only: false

或者直接在composer.json中指定PHP二进制文件路径：

{
  "config": {
    "php-bin": "/usr/bin/php"
  }
}

方法三：跳过requirements-checker脚本（可选） #

若不需要执行环境检查，可修改composer.json的auto-scripts配置，确保脚本执行失败不终止部署：

{
  "scripts": {
    "auto-scripts": {
      "cache:clear": "symfony-cmd",
      "assets:install public": "symfony-cmd",
      "requirements-checker": "@php vendor/symfony/requirements-checker/bin/requirements-checker || true"
    }
  }
}

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