Swoole PHP代码修改不生效及Docker镜像构建失败求助

一、代码修改后页面不刷新的问题 #

原因 #

Swoole是常驻内存型服务，启动时会将代码加载到内存中运行，后续修改本地文件不会触发内存中代码的更新，必须重启服务才能生效。

解决方法 #

• 手动重启：每次修改代码后，按Ctrl+C停止当前服务，再重新执行php index.php启动。
• 开发环境自动重启：使用文件监听工具（如inotifywait）监听代码文件变化，自动触发服务重启。示例命令：

  # Debian/Ubuntu环境先安装依赖
  apt-get install inotify-tools
  # 启动监听脚本
  while true; do
      inotifywait -e modify,create,delete -r ./ && pkill -f "php index.php" && php index.php &
  done
  

• Swoole热重载：通过配置reload_async等参数配合进程管理实现热重载，适合生产环境，开发阶段手动重启更简便。

二、Docker镜像构建失败的问题 #

报错分析 #

构建失败源于Swoole编译步骤执行异常，exit code 2通常是编译依赖缺失或网络问题导致克隆/编译无法完成。

修复步骤 #

1. 补充编译依赖

原Dockerfile缺少gcc、make等基础编译工具，需添加build-essential包。

2. 优化克隆逻辑

用--depth 1减少克隆体积，若访问GitHub网络不畅，可替换为国内镜像源（如Gitee）。

3. 简化扩展配置

删除冗余的touch openswoole.ini操作，直接写入扩展配置即可。

修改后的Dockerfile #

FROM php:8.1.0-cli

# 安装基础工具与编译依赖
RUN apt-get update && apt-get install -y \
    vim openssl libssl-dev wget git procps htop build-essential \
    && rm -rf /var/lib/apt/lists/*

# 克隆并编译Swoole（使用Gitee镜像加速，可选）
RUN cd /tmp && \
    git clone --depth 1 -b v4.11.0 https://gitee.com/openswoole/swoole-src.git && \
    cd swoole-src && \
    phpize && \
    ./configure --enable-openssl --enable-swoole-curl --enable-http2 --enable-mysqlnd && \
    make -j$(nproc) && make install

# 配置Swoole扩展
RUN echo 'extension=openswoole.so' > /usr/local/etc/php/conf.d/zzz_openswoole.ini

# 安装dumb-init
RUN wget -O /usr/local/bin/dumb-init https://github.com/Yelp/dumb-init/releases/download/v1.2.2/dumb-init_1.2.2_amd64 && \
    chmod +x /usr/local/bin/dumb-init && \
    apt-get autoremove -y && rm -rf /var/lib/apt/lists/*

ENTRYPOINT ["/usr/local/bin/dumb-init", "--", "php"]

额外排查点 #

• 若克隆仍失败，检查Docker容器网络是否能访问外部网络，可在宿主机测试git clone https://github.com/openswoole/swoole-src.git。
• 若phpize命令不存在，需在apt安装列表中添加php-dev包（PHP 8.1-cli镜像默认已包含，缺失则补充）。

内容的提问来源于stack exchange，提问作者milica98