需在Docker容器中安装Composer并配置inotify-tools或Symfony CLI实现热加载：一、手动安装Composer；二、用inotify-tools监听文件变更并重启PHP服务器；三、通过docker-compose挂载代码并优化自动加载；四、推荐使用Symfony CLI的watch功能；五、封装entrypoint.sh统一初始化与启动流程。
如果您希望在 Docker 容器中使用 Composer 管理 PHP 依赖，并实现代码修改后无需重启容器即可生效的热加载效果，则需在容器运行时正确安装 Composer，并配置支持文件变更监听与自动重载的机制。以下是具体实施步骤：
一、在 Docker 容器内安装 Composer
Composer 不是系统级预装工具，需在容器启动阶段或构建镜像时手动安装，确保其二进制文件可被全局调用且具备执行权限。
1、进入正在运行的 PHP 容器：docker exec -it your-php-container-name /bin/sh
2、下载 Composer 安装脚本：php -r "copy('https://getcomposer.org/installer', 'composer-setup.php');"
3、校验安装脚本签名：php -r "if (hash_file('sha384', 'composer-setup.php') === 'e0012edf3e80b6978849f5eff0d4b4e4c79ff1609dd1f8281cd1b920158a147e24cc13824f114316c276363ec5bdc6d9c8de') { echo 'Installer verified'; } else { echo 'Installer corrupt'; unlink('composer-setup.php'); } echo PHP_EOL;"
4、执行安装并移动至全局路径：php composer-setup.php && mv composer.phar /usr/local/bin/composer
5、验证安装结果：composer --version
二、基于 inotify-tools 实现文件变更监听与自动重载
PHP CLI 模式本身不支持热加载，需借助 inotify-tools 监听源码目录变化，并触发服务重启或脚本重执行，从而模拟热加载行为。
1、在 Dockerfile 中安装 inotify-tools：RUN apt-get update && apt-get install -y inotify-tools
2、创建监听脚本 reload.sh 并赋予执行权限：chmod +x /app/reload.sh
3、脚本内容为持续监听 app/ 目录下 .php 文件变更：inotifywait -m -e modify,create,delete,move ./app/ -e modify,create,delete,move ./app/src/ | while read path action file; do if [[ "$file" == *.php ]]; then echo "Detected change: $file"; pkill -f "php -S"; php -S 0.0.0.0:8000 -t /app/public/ & fi; done
4、在容器启动命令中同时运行监听脚本与内置服务器：sh -c "php -S 0.0.0.0:8000 -t /app/public/ & sh /app/reload.sh"
三、使用 docker-compose.yml 配置挂载与开发环境联动
通过绑定挂载将宿主机代码实时同步至容器内部，配合 Composer 自动加载机制（如 autoload-dev），使 require_once 或 class autoloading 能即时响应新增/修改的类文件。
1、在 docker-compose.yml 的 service 下添加 volumes 挂载：volumes: - ./src:/app/src:cached
2、确保 composer.json 中已声明自动加载规则：{ "autoload": { "psr-4": { "App\\": "src/" } }, "autoload-dev": { "psr-4": { "App\\Tests\\": "tests/" } } }
3、执行 composer dump-autoload --optimize-autoloader --classmap-authoritative 在容器内生成高效映射表
4、在容器内启用 opcache.enable_cli=1 以提升 CLI 模式下类加载性能
5、确认 PHP 配置中 disable_functions 未禁用 symlink、pcntl_fork 等关键函数
四、使用 Symfony CLI 工具替代原生 PHP 内置服务器
Symfony CLI 内置 watch 功能，可自动检测 PHP 文件变动并重启 Web 服务器，无需手动编写监听逻辑，兼容标准 Composer 项目结构。
1、在容器内下载 Symfony CLI：curl -sS https://get.symfony.com/cli/installer | bash
2、将二进制文件移至 PATH：mv /root/.symfony/bin/symfony /usr/local/bin/symfony
3、赋予执行权限：chmod a+x /usr/local/bin/symfony
4、在项目根目录执行启动命令：symfony server:start --no-tls --watch=src/,config/
5、确认输出中包含 Watching files in "src/,config/" for changes… 字样
五、利用 Entrypoint 脚本整合 Composer 初始化与热加载启动流程
将 Composer 安装、依赖安装、自动加载优化及热加载服务启动封装为单一入口脚本，确保每次容器启动均处于一致就绪状态。
1、创建 entrypoint.sh 脚本并设为可执行：chmod +x /app/entrypoint.sh
2、脚本首行指定解释器：#!/bin/sh
3、检查 vendor 目录是否存在，若不存在则执行 composer install：[ ! -d "/app/vendor" ] && composer install --no-interaction --optimize-autoloader
4、启动 Symfony Server 并后台运行：symfony server:start --no-tls --watch=src/,config/ &
5、保持前台进程活跃以防止容器退出：tail -f /dev/null
