WebPageTest Docker环境中PHP配置加载问题的分析与解决

问题背景

在使用WebPageTest的Docker环境(21.07版本)部署时，发现PHP配置文件(php.ini)未能正确加载，特别是在使用'php'用户运行时。这导致系统检查时显示多个PHP配置参数不符合要求，如upload_max_filesize、post_max_size和memory_limit等值都低于推荐设置。

问题现象

通过Docker-compose启动WebPageTest的web/php容器后，系统安装验证显示以下PHP配置问题：

• APC扩展未安装
• upload_max_filesize仅为2M(推荐≥100M)
• post_max_size仅为8M(推荐≥100M)
• memory_limit仅为128M(推荐>256M或设为-1禁用)

进一步检查发现，当以root用户身份运行时，php.ini配置能够正常加载；但切换到php用户运行时，PHP无法加载任何配置文件。

技术分析

这个问题本质上是一个权限问题。在Docker容器中，PHP服务通常以非root用户(如'php'用户)运行以提高安全性。然而，PHP配置目录/usr/local/etc/php/的默认权限设置可能不允许非root用户读取配置文件。

具体表现为：

1. root用户可以正常读取php.ini配置
2. php用户由于缺少读取权限，导致PHP运行时无法加载任何配置
3. 系统因此使用PHP的默认配置值，而非我们期望的自定义值

解决方案

修改Docker构建文件(local/Dockerfile-php)，调整PHP配置目录的权限，确保php用户有足够的读取权限：

1. 在Dockerfile中添加权限修改指令：

RUN chmod 755 /usr/local/etc/php/

2. 这将赋予php用户读取配置文件的权限，同时保持适当的安全限制

实施建议

对于使用WebPageTest Docker环境的用户，建议：

1. 检查当前PHP配置加载情况：

php -i | grep "Loaded Configuration File"

2. 验证不同用户下的配置加载差异：

su - php -c "php -i | grep 'Loaded Configuration File'"

3. 如果确认是权限问题，按照上述方案修改Dockerfile并重建容器

安全考虑

在解决此问题时，需要注意：

1. 不要简单地赋予777权限，这会降低系统安全性
2. 755权限已经足够让php用户读取配置，同时防止非授权写入
3. 考虑在Dockerfile中明确设置配置文件的用户和组所有权

总结

这个案例展示了在容器化环境中权限管理的重要性。即使是配置文件，也需要确保服务运行用户有适当的访问权限。通过合理的权限设置，我们既解决了功能问题，又保持了系统的安全性。对于WebPageTest用户来说，这个修复确保了PHP能够按照预期配置运行，特别是对于文件上传等需要较大内存和文件大小限制的功能。