在serversideup/docker-php项目中添加自定义启动脚本的正确方法

在使用serversideup/docker-php项目构建PHP容器时，开发者经常需要添加自定义启动脚本以满足特定需求。本文将详细介绍如何正确地在容器启动时执行自定义脚本。

问题背景

许多开发者按照官方文档添加自定义启动脚本时，会遇到权限被拒绝的问题。这是因为文档中的示例缺少了关键步骤，导致脚本无法正常执行。

解决方案

正确的做法需要以下几个关键步骤：

1. 创建entrypoint.d目录：这是存放自定义脚本的标准位置
2. 编写自定义脚本：脚本需要具有可执行权限
3. 修改Dockerfile：需要特别注意权限设置和用户切换

详细实现步骤

1. 准备自定义脚本

首先创建一个名为entrypoint.d的目录，并在其中添加你的自定义脚本，例如99-custom.sh。确保脚本具有可执行权限：

mkdir -p entrypoint.d
touch entrypoint.d/99-custom.sh
chmod +x entrypoint.d/99-custom.sh

2. 编写Dockerfile

以下是经过验证的正确Dockerfile配置：

FROM serversideup/php:8.3-fpm-nginx

# 设置环境变量，确保服务启动顺序正确
ENV S6_CMD_WAIT_FOR_SERVICES=1

# 复制脚本并设置权限
COPY --chmod=755 ./entrypoint.d/ /etc/entrypoint.d/

# 切换到root用户以执行初始化操作
USER root

# 运行初始化脚本
RUN docker-php-serversideup-s6-init

# 切换回www-data用户以确保安全
USER www-data

3. 关键点说明

1. 权限设置：--chmod=755参数确保复制的脚本具有可执行权限
2. 用户切换：必须切换到root用户才能执行初始化操作，完成后应切换回www-data用户
3. 环境变量：S6_CMD_WAIT_FOR_SERVICES=1确保服务按正确顺序启动

常见问题排查

如果仍然遇到问题，可以检查以下几点：

1. 确认脚本文件确实具有可执行权限
2. 检查脚本内容是否包含有效的shebang（如#!/bin/bash）
3. 确保脚本文件名以数字开头，如99-custom.sh，这决定了执行顺序
4. 验证Docker构建过程中没有其他错误

最佳实践建议

1. 在脚本中添加适当的日志输出，便于调试
2. 保持脚本简洁，只包含必要的初始化操作
3. 考虑使用set -e使脚本在遇到错误时立即退出
4. 对于复杂的初始化逻辑，可以考虑拆分为多个小脚本

通过遵循上述步骤和最佳实践，开发者可以可靠地在serversideup/docker-php容器中添加自定义启动脚本，满足各种定制化需求。