如何在Docker Compose中为PHP镜像添加Inotify扩展？

问题分析 #

你之前的Dockerfile存在几个核心问题：

• 仅通过pecl install inotify安装了扩展，但未启用该扩展，PHP无法识别它
• 使用的基础镜像版本（php:8.0-apache）和docker-compose中指定的（php:8.2.10-apache-bullseye）不一致，可能引发环境兼容问题
• 缺少编译inotify所需的依赖包，大概率会导致安装过程失败

修正后的Dockerfile #

创建名为Dockerfile的文件，内容如下：

# 使用和docker-compose一致的基础镜像
FROM php:8.2.10-apache-bullseye

# 安装编译inotify所需的依赖
RUN apt-get update && apt-get install -y \
    gcc \
    make \
    libc-dev \
    && rm -rf /var/lib/apt/lists/*

# 安装并启用inotify扩展
RUN pecl install inotify \
    && docker-php-ext-enable inotify

# 设置工作目录，和原配置保持一致
WORKDIR /var/www/html

# 复制本地PHP代码到容器内
COPY index.php index.php

# 继承原镜像的Apache启动命令，无需额外指定
EXPOSE 80

修改docker-compose.yml #

将原来的image字段替换为build: .，让Docker Compose使用自定义镜像：

version: '3.8' # 注意：Docker Compose版本号为x.y格式，修正为兼容版本
services:
    www:
        build: . # 使用当前目录的Dockerfile构建镜像
        volumes:
            - "./:/var/www/html"
        ports:
         - 80:80

验证Inotify功能 #

1. 启动容器：运行docker-compose up -d
2. 进入容器：docker-compose exec www bash
3. 验证扩展启用：执行php -m | grep inotify，若输出inotify则表示扩展生效
4. 功能测试：创建test_inotify.php脚本

<?php
$watchDir = '/var/www/html';
$fd = inotify_init();
$watchDescriptor = inotify_add_watch($fd, $watchDir, IN_CREATE | IN_DELETE);

echo "监控目录 $watchDir 中...\n";
while (true) {
    $events = inotify_read($fd);
    if ($events) {
        foreach ($events as $event) {
            echo "检测到事件: " . print_r($event, true) . "\n";
        }
    }
}
fclose($fd);
?>

在容器内运行php test_inotify.php，随后在宿主机挂载目录下创建/删除文件，即可看到事件输出。

容器退出码0的说明 #

退出码0表示进程正常终止，之前的情况可能是：

• 未保持前台运行的进程（原镜像的Apache默认前台运行，除非覆盖了CMD/ENTRYPOINT）
• 扩展安装失败导致后续命令中断，容器启动后无进程运行而退出

使用修正后的配置，Apache会作为前台进程持续运行，容器不会意外退出。

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