如何使用.ebextensions修改ElasticBeanstalk的php-fpm配置

问题原因 #

1. 第一种配置不生效是因为ElasticBeanstalk部署流程中，平台会在你写入/etc/php-fpm.d/www.conf之后，重写该文件的默认配置，你自定义的参数会被直接覆盖。
2. 第二种配置报错是因为pm.*属于PHP-FPM的池级配置参数，必须归属到对应的池（默认是[www]）定义块下，你直接在配置文件中写参数属于全局配置域，不符合PHP-FPM配置语法，导致服务启动校验失败。

正确配置方案 #

在你的.ebextensions目录下新建配置文件（比如01-custom-php-fpm.config），写入以下内容即可：

files:
  "/etc/php-fpm.d/z-99-custom-www.conf":
    mode: "000644"
    owner: root
    group: root
    content: |
      [www]
      pm.max_children = 500
      pm.start_servers = 5
      # 其他需要自定义的[www]池参数都可以在此处追加

container_commands:
  01_reload_php_fpm:
    command: "systemctl reload php-fpm"
    ignoreErrors: false

配置说明 #

• 配置文件名使用z-前缀：PHP-FPM会按字典序加载/etc/php-fpm.d/目录下所有.conf后缀的文件，z开头的文件加载顺序晚于默认的www.conf，同字段配置会覆盖前面的默认值，不会被平台默认配置覆盖。
• 必须添加[www]标识：明确参数归属到默认的www池，符合PHP-FPM配置语法要求。
• container_commands段的重载命令会在部署流程末尾主动触发PHP-FPM配置重载，确保修改立即生效。

如果你的ElasticBeanstalk使用的是老版本Amazon Linux AMI（非Amazon Linux 2/2023），将重载命令替换为service php-fpm reload即可。

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