php扩展安装失败主因是镜像类型混淆：alpine用apk add php82-xxx，debian系优先用docker-php-ext-install或pecl install+docker-php-ext-enable；编译扩展需先装对应依赖，alpine的gd/mbstring通常已内置只需启用。
PHP 扩展在 Docker 容器里装不上？先看你是用的哪种基础镜像
绝大多数问题出在镜像类型上：php:alpine 和 php:apache（或 php:fpm）的扩展安装方式完全不同，不能套用同一套命令。
Alpine 镜像用的是 apk 包管理器，扩展名带 php82- 前缀（如 php82-curl）；Debian/Ubuntu 系镜像用 apt，但更推荐用 PHP 自带的 docker-php-ext-install 或 pecl install —— 因为它会自动编译、启用、写配置。
-
php:alpine：必须用apk add php82-xxx，不能用docker-php-ext-install（缺少 build 依赖且路径不兼容） -
php:apache/php:fpm（Debian）：优先用docker-php-ext-install，比如docker-php-ext-install mysqli pdo_mysql - 需要
pecl扩展（如redis、swoole）：先pecl install xxx，再docker-php-ext-enable xxx
docker-php-ext-install 报错“no such file or directory”或“configure: error”
这是没装编译依赖。Debian 系镜像默认不带 gcc、make、autoconf 等工具，而 docker-php-ext-install 本质是帮你跑 ./configure && make && make install。
正确做法是在 RUN 中合并安装依赖和扩展：
立即学习“PHP免费学习笔记（深入）”；
RUN apt-get update \
&& apt-get install -y libfreetype6-dev libjpeg62-turbo-dev libpng-dev \
&& docker-php-ext-configure gd --with-freetype --with-jpeg \
&& docker-php-ext-install gd mysqli pdo_mysql \
&& rm -rf /var/lib/apt/lists/*
- 图像扩展（
gd）要额外指定库路径，否则 configure 失败 -
libzip-dev是zip扩展必需的，libxml2-dev是soap、xmlrpc的依赖 - 每装一个扩展都触发一次
apt-get update是低效且危险的，务必合并成单条RUN
pecl 安装 redis/swoole 后 php -m 不显示？
pecl install 只负责把 .so 文件放到 /usr/local/lib/php/extensions/...，不会自动写 extension=redis.so 到 ini 文件里。
必须手动启用：
- 用
docker-php-ext-enable redis（推荐，自动处理 ini 加载顺序） - 或手写
RUN echo "extension=redis.so" > /usr/local/etc/php/conf.d/docker-php-ext-redis.ini - 注意：如果用
pecl install redis-5.3.7指定了版本，生成的 so 文件名仍是redis.so，不用改名 -
swoole4.8+ 要求 PHP 8.0+，且需加--enable-swoole-curl等开关才开启子功能
Alpine 镜像装不上 gd、mbstring？别硬刚，换镜像或换方法
php:alpine 的 apk 源里扩展有限，gd、mbstring 默认已编译进 PHP 二进制，不需要额外装 —— 但可能被禁用。检查是否在 php.ini 里写了 disable_functions 或漏了 extension=mbstring.so。
真实常见情况：
-
mbstring在 Alpine 上叫php82-mbstring，直接apk add php82-mbstring -
gd在 Alpine 上依赖太多（freetype、jpeg、png），apk add php82-gd通常就足够 - 如果非要从源码编译，Alpine 必须先
apk add $PHPIZE_DEPS（含gcc、make等），再运行docker-php-ext-install—— 但成功率远低于 Debian 镜像
生产环境若频繁折腾扩展，建议直接切到 php:apache 或 php:fpm（Debian），省去 ABI 兼容和包名映射的隐性成本。
