通过配置Docker的Volume挂载、inotify监听、Swoole热重载、Webpack Encore及Laravel Sail，可实现PHP开发中代码修改后自动刷新，提升开发效率。

如果您正在使用Docker进行PHP开发，但每次代码更改都需要重启容器才能生效，这会严重影响开发效率。通过配置热重载机制，可以在文件变更时自动刷新服务或重新加载PHP进程，从而实现即时反馈。以下是实现该功能的具体方法。

本文运行环境：MacBook Pro，macOS Sonoma

一、使用Volume挂载实现代码同步

通过Docker的bind mount功能，将本地开发目录挂载到容器内的项目路径，使得本地文件的修改能实时反映在容器中。

1、在项目根目录创建 docker-compose.yml 文件，并添加如下内容：

version: '3.8'

services:

  php:

    image: php:8.2-fpm

    volumes:

      - ./:/var/www/html

2、保存文件后，在终端执行 docker-compose up -d 启动容器。

3、修改本地PHP文件并保存，进入容器内部验证文件是否同步更新。

二、结合inotify实现PHP-FPM自动重载

利用inotify监听文件变化，并触发PHP-FPM进程重启，确保配置或代码变更立即生效。

1、修改Docker镜像的Dockerfile，安装inotify-tools工具包：

FROM php:8.2-fpm

RUN apt-get update && apt-get install -y inotify-tools

2、创建一个监控脚本 watch.sh，内容如下：

#!/bin/bash

inotifywait -m -r -e modify,create,delete /var/www/html --format '%f' | while read file; do

  echo "File $file changed, reloading PHP-FPM..."

  kill -USR2 1

done

3、赋予脚本可执行权限：chmod +x watch.sh，并在容器启动时运行该脚本。

三、使用Swoole Server实现原生热重载

Swoole内置了热重载支持，可通过其Server组件监听文件变化并自动重启工作进程。

1、在容器中安装Swoole扩展：

docker-php-ext-install swoole

2、编写基于Swoole的HTTP服务启动脚本 server.php：

$server = new Swoole\HTTP\Server("0.0.0.0", 9501);

$server->set(['enable_reload' => true, 'worker_num' => 1]);

3、设置环境变量启用文件监听：export INOTIFY_ENABLE=1，然后启动服务：php server.php。

四、集成Symfony Webpack Encore与Docker

针对前端资源配合PHP开发的情况，可使用Webpack Encore监听静态资源变化并自动编译输出。

1、在项目中初始化Encore：

composer require symfony/webpack-encore-bundle

yarn install --force

2、启用开发模式监听：

docker-compose exec php yarn dev-server --hot --host 0.0.0.0 --port 8080 --public http://localhost:8080

3、在浏览器中访问 http://localhost:8080 查看实时更新的前端页面。

五、使用Laravel Sail配置热重载

Laravel Sail是官方推荐的Docker开发环境，天然支持部分热重载功能。

1、在Laravel项目中启用Sail：

php artisan sail:install

2、启动服务并开启Tinker或队列监听：

sail up -d

sail artisan tinker

3、对于视图或配置变更，可结合 cache:clear 命令手动刷新缓存以达到近似热重载效果。