解决serversideup/php镜像中Debug模式的权限问题

在使用serversideup/php Docker镜像时，当设置LOG_OUTPUT_LEVEL环境变量为debug时，会出现权限拒绝的错误。这个问题主要影响7.4版本的cli和fpm-nginx Alpine镜像。

问题现象

当启用debug模式时，系统会尝试修改PHP配置文件，但操作失败并显示以下错误信息：

/etc/s6-overlay/scripts/1-debug-mode: line 11: can't create /usr/local/etc/php/php.ini: Permission denied
/etc/s6-overlay/scripts/1-debug-mode: line 16: can't create /usr/local/etc/php-fpm.d/zzz-fpm-debug.conf: Permission denied

这些错误表明脚本尝试修改PHP配置文件和FPM配置文件时缺乏必要的写入权限。

问题原因

深入分析后发现，这个问题源于容器内用户权限配置。默认情况下，容器以www-data用户(UID 82)运行，而这个用户对PHP配置文件目录没有写入权限。当debug模式需要修改以下文件时就会失败：

1. /usr/local/etc/php/php.ini - PHP主配置文件
2. /usr/local/etc/php-fpm.d/zzz-fpm-debug.conf - FPM调试配置文件

解决方案

开发团队已经修复了这个问题，解决方案包括：

1. 确保在修改配置文件前检查并设置正确的文件权限
2. 优化脚本执行流程，避免不必要的权限问题
3. 改进错误处理机制，提供更友好的错误提示

最佳实践

为了避免类似问题，在使用serversideup/php镜像时建议：

1. 对于生产环境，考虑预先配置好所有PHP设置，避免运行时修改
2. 如果需要动态修改配置，确保运行用户有必要的权限
3. 使用最新版本的镜像，其中包含了这个问题的修复

技术细节

修复后的实现会：

1. 在容器启动阶段检查并设置必要的文件权限
2. 使用更安全的文件操作方式
3. 提供更详细的日志输出，帮助诊断权限相关问题

这个修复已经合并到项目的主分支，将在下一个正式版本中发布。对于需要立即使用的用户，可以暂时使用开发版镜像，其中已经包含了这个修复。

通过这个问题的解决，serversideup/php镜像的debug模式功能变得更加稳定可靠，为开发者提供了更好的调试体验。