在Alpine Docker容器中安装php-imagick扩展失败求助

问题原因 #

你遇到的Unterminated preprocessor conditions错误，是因为Imagick 3.7.0版本的代码与PHP 8.3不兼容，其Imagick.stub.php文件中的预处理条件存在语法问题，导致编译流程中断。

解决方案 #

修改Dockerfile，指定安装兼容PHP 8.3的Imagick版本（3.7.1及以上），具体代码如下：

FROM php:8.3-fpm-alpine AS base

RUN apk add --update --no-cache --virtual .build-deps $PHPIZE_DEPS imagemagick imagemagick-dev \
    && pecl install imagick-3.7.1 \
    && docker-php-ext-enable imagick \
    && rm -rf /tmp/pear \
    && apk del .build-deps

关键说明 #

• 指定imagick-3.7.1版本：该版本专门修复了PHP 8.3编译时的预处理条件语法问题
• 若想安装最新稳定版，也可直接使用pecl install imagick（当前最新稳定版已全面兼容PHP 8.3），但指定具体版本能避免后续版本迭代带来的兼容风险
• 保留原有依赖安装、缓存清理步骤，确保镜像体积最小化

验证方式 #

镜像构建完成后，进入容器执行命令：

php -m | grep imagick

若输出imagick，则证明扩展安装成功。

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