轩辕镜像 官方专业版
轩辕镜像
专业版
轩辕镜像 官方专业版
轩辕镜像
专业版
首页个人中心搜索镜像
交易
充值流量¥8起我的订单
文档
工具
提交工单页面收录
ghcr.io/mlocati/php-extension-installer

ghcr.io/mlocati/php-extension-installer:2.11.24

ghcr.iolinux/amd642.11.24大小: 38.78 KB更新于 2026年10月7日
让 AI 帮你使用轩辕镜像？ · 展开查看说明 · 点击收起说明

如果你使用 DeepSeek、元宝 AI、Copilot、ChatGPT 等 AI 工具，协助配置轩辕镜像、编写 docker pull 命令、修改 Docker Compose 镜像地址、配置镜像加速、排查镜像拉取失败、分析报错日志等问题，请先让 AI 阅读并遵守轩辕镜像的规则文档。

只需在 AI 对话中先发送下面这段话即可：

请先阅读并遵守：https://xuanyuan.cloud/agents.md

未读文档前不要生成 pull 命令或排错方案。

查看 agents.md 用法指南与完整示范。国内用户首推 元宝 AI、DeepSeek 的深度思考模式，不推荐豆包 AI；Cursor 等编辑器可在对话 @ 该链接，或加入 User Rules。 若 AI 无法访问外链，可 打开说明文档 复制全文粘贴。文档会随站点更新，复制内容可能过期，建议定期检查。

在官方 PHP Docker 镜像中轻松安装 PHP 扩展

本仓库提供了一个脚本，可用于在https://hub.docker.com/_/php/内便捷安装 PHP 扩展。

该脚本会自动安装所有必需的 APT/APK 包；脚本执行完成后，所有不再需要的依赖包都会被移除，从而大幅缩小最终镜像体积。

支持的 Docker 镜像类型如下：

  • 基于 Debian 的 Docker 镜像：最低支持从 jessie（Debian 8）开始（要求最低 PHP 版本为 5.5）
  • 基于 Alpine 的 Docker 镜像：最低支持从 Alpine 3.9 开始（要求最低 PHP 版本为 7.1）

另请参阅特殊要求部分的说明。

使用方式

你可以通过多种方式在 Dockerfile 中使用此脚本。

以下是安装 GD 和 xdebug 这两个 PHP 扩展的 Dockerfile 示例列表：

使用 ADD 动态下载脚本

FROM php:7.2-cli

ADD --chmod=0755 https://github.com/mlocati/docker-php-extension-installer/releases/latest/download/install-php-extensions /usr/local/bin/

RUN install-php-extensions gd xdebug

使用 curl 动态下载脚本

FROM php:7.2-cli

RUN curl -sSLf \
-o /usr/local/bin/install-php-extensions \
https://github.com/mlocati/docker-php-extension-installer/releases/latest/download/install-php-extensions && \
chmod +x /usr/local/bin/install-php-extensions && \
install-php-extensions gd xdebug

使用 curl 直接执行脚本

FROM php:8.2-cli

RUN ( curl -sSLf https://github.com/mlocati/docker-php-extension-installer/releases/latest/download/install-php-extensions -o - || echo 'return 1' ) | sh -s \
gd xdebug

从 Docker 镜像中复制脚本

  • 使用 GitHub Container Registry
FROM php:8.4-cli

COPY --from=ghcr.io/mlocati/php-extension-installer /usr/bin/install-php-extensions /usr/local/bin/

RUN install-php-extensions gd xdebug
  • 使用 Docker Hub
FROM php:8.4-cli

COPY --from=mlocati/php-extension-installer /usr/bin/install-php-extensions /usr/local/bin/

RUN install-php-extensions gd xdebug

[!WARNING] 使用该方法可能会用到已过期的 Docker 镜像版本。建议提前执行 docker pull ghcr.io/mlocati/php-extension-installer 或 docker pull mlocati/php-extension-installer 以拉取最新版本。

直接使用 Docker 镜像中的脚本

  • 使用 GitHub Container Registry
RUN --mount=type=bind,from=ghcr.io/mlocati/php-extension-installer:latest,source=/usr/bin/install-php-extensions,target=/usr/local/bin/install-php-extensions \
install-php-extensions gd xdebug
  • 使用 Docker Hub
RUN --mount=type=bind,from=mlocati/php-extension-installer:latest,source=/usr/bin/install-php-extensions,target=/usr/local/bin/install-php-extensions \
install-php-extensions gd xdebug

[!WARNING] 使用该方法可能会用到已过期的 Docker 镜像版本。建议提前执行 docker pull ghcr.io/mlocati/php-extension-installer 或 docker pull mlocati/php-extension-installer 以拉取最新版本。

安装扩展的指定版本

只需在扩展模块名称后追加 - 和版本号即可。例如：

install-php-extensions xdebug-2.9.7

该脚本还支持通过在版本号前添加脱字符（^）来自动解析兼容版本。例如：

# 安装 xdebug 2.x 的最新版本（例如 2.9.8）
install-php-extensions xdebug-^2
# 安装 xdebug 2.8.x 的最新版本（例如 2.8.1）
install-php-extensions xdebug-^2.8

请注意，使用上述语法时你将获取最新的兼容版本，该版本可能为非稳定版。如果希望安装最新的稳定版本，可以在末尾追加 @stable：

# 安装 xdebug 3.x 的最新 STABLE 版本（例如 3.2.2）
install-php-extensions xdebug-^3@stable

可用的稳定性后缀包括：@snapshot、@devel、@alpha、@beta 和 @stable。

对于 PECL 上提供的预发布版本扩展，你可以在扩展名称后直接追加其状态标识，例如 alpha、beta、rc、preview、devel 或 snapshot 来安装对应版本。例如：

install-php-extensions xdebug-beta

[!NOTE] 当 PECL 上的最新可用版本为非稳定版，而你希望保留上一个稳定版本时，可以在扩展名称后添加 stable 后缀来强制指定。例如：

> install-php-extensions mongodb-stable
>

从源代码安装扩展

你也可以从源代码安装 PHP 扩展，前提是源代码包中包含 package.xml 或 package2.xml 文件。

支持的源格式包括：

  • GitHub 托管仓库的短格式写法。 例如，对于 https://github.com/php-memcached-dev/php-memcached 这个 GitHub 仓库，你可以直接使用以下写法：
# 从指定提交（完整 SHA-1 哈希值）安装
  install-php-extensions php-memcached-dev/php-memcached@8f106564e6bb005ca6100b12ccc89000daafa9d8
  # 从指定提交（短 SHA-1 哈希值）安装
  install-php-extensions php-memcached-dev/php-memcached@8f106564e6bb
  # 从 v3.2.0RC2 标签安装
  install-php-extensions php-memcached-dev/php-memcached@v3.2.0RC2
  install-php-extensions php-memcached-dev/php-memcached@refs/tags/v3.2.0RC2
  # 从 master 分支安装
  install-php-extensions php-memcached-dev/php-memcached@master
  install-php-extensions php-memcached-dev/php-memcached@refs/heads/master
  • 提供源代码压缩包的 URL 地址。 示例如下：
# 提交 8f106564e6bb005ca6100b12ccc89000daafa9d8 对应的 tgz 压缩包
  install-php-extensions https://codeload.github.com/php-memcached-dev/php-memcached/tar.gz/8f106564e6bb005ca6100b12ccc89000daafa9d8
  # 标签 v3.1.5 对应的 tgz 压缩包
  install-php-extensions https://codeload.github.com/php-memcached-dev/php-memcached/tar.gz/refs/tags/v3.1.5
  # master 分支对应的 tgz 压缩包
  install-php-extensions https://codeload.github.com/php-memcached-dev/php-memcached/tar.gz/refs/heads/master
  • 本地目录的绝对路径。 示例如下：
# 下载源代码
  curl -o /tmp/source.tgz https://codeload.github.com/php-memcached-dev/php-memcached/tar.gz/refs/tags/v3.1.5
  tar xzf /tmp/source.tgz -C /tmp
  install-php-extensions /tmp/php-memcached-3.1.5

扩展是 PHP 内置捆绑的吗？

部分 PHP 扩展是随 PHP 源代码一起捆绑发布的，例如 gd 和 zip。

其中部分扩展同时也在 PECL 和/或独立源代码仓库中提供。

默认情况下，install-php-extensions 会优先安装 PHP 源代码中内置的捆绑版本。

如果你希望使用远程提供的版本：

  • 对于使用 PECL 版本：只需在包名后追加稳定性状态即可。例如：
install-php-extensions zip-stable
  • 对于从源代码安装：使用上述指定的语法即可。例如：
install-php-extensions php/pecl-database-oci8@7aa1061

install-php-extensions 支持为以下扩展安装远程版本，而非内置捆绑版本：

  • pdo_oci
  • oci8
  • zip

安装 composer

你也可以安装 https://getcomposer.org/，同时支持指定其主版本号或完整版本号。

使用示例：

# 安装最新版本
install-php-extensions @composer
# 安装 1.x 系列的最新版本
install-php-extensions @composer-1
# 安装指定的具体版本
install-php-extensions @composer-2.0.2

Let's Encrypt 证书相关问题

Let's Encrypt 的根 CA 证书已发生变更（https://letsencrypt.org/docs/dst-root-ca-x3-expiration-september-2021/），该变更会导致以下老旧 Linux 发行版出现问题：

  • Debian Jessie (8)
  • Debian Stretch (9)
  • Alpine Linux 3.7
  • Alpine Linux 3.8

你可以通过该脚本修复该问题：只需传入 @fix_letsencrypt 作为参数即可：

install-php-extensions @fix_letsencrypt

支持的 PHP 扩展

以下是 ghcr.io/mlocati/php-extension-installer 镜像（参考标签：latest）支持的 PHP 扩展与各版本兼容对照表，勾选标记表示该扩展可在对应 PHP 版本中正常安装使用：

扩展PHP 8.5PHP 8.4PHP 8.3PHP 8.2PHP 8.1PHP 8.0PHP 7.4PHP 7.3PHP 7.2PHP 7.1PHP 7.0PHP 5.6PHP 5.5
amqp✓✓✓✓✓✓✓✓✓✓✓✓✓
apcu✓✓✓✓✓✓✓✓✓✓✓✓✓
apcu_bc✓✓✓✓✓
ast✓✓✓✓✓✓✓✓✓✓✓
bcmath✓✓✓✓✓✓✓✓✓✓✓✓✓
bitset✓✓✓✓✓✓✓✓✓✓✓✓✓
blackfire✓✓✓✓✓✓✓✓✓✓✓✓✓
brotli✓✓✓✓✓✓✓✓✓✓✓
bz2✓✓✓✓✓✓✓✓✓✓✓✓✓
calendar✓✓✓✓✓✓✓✓✓✓✓✓✓
cassandra*✓✓✓✓✓✓✓✓✓
cmark✓✓✓✓✓
csv✓✓✓✓✓✓✓✓
dba✓✓✓✓✓✓✓✓✓✓✓✓✓
ddtrace*✓✓✓✓✓✓✓✓✓✓✓✓
decimal✓✓✓✓✓✓✓✓✓✓✓
ds✓✓✓✓✓✓✓✓✓✓✓
ecma_intl*✓✓
enchant✓✓✓✓✓✓✓✓✓✓✓✓✓
ev✓✓✓✓✓✓✓✓✓✓✓✓✓
event✓✓✓✓✓✓✓✓✓✓✓✓✓
excimer✓✓✓✓✓✓✓✓✓✓
exif✓✓✓✓✓✓✓✓✓✓✓✓✓
ffi✓✓✓✓✓✓✓
ftp✓✓✓✓
gd✓✓✓✓✓✓✓✓✓✓✓✓✓
gearman✓✓✓✓✓✓✓✓✓✓✓✓✓
geoip✓✓✓✓✓✓✓
geos*✓✓✓✓✓✓✓✓✓✓✓✓✓
geospatial✓✓✓✓✓✓✓✓✓✓✓✓✓
gettext✓✓✓✓✓✓✓✓✓✓✓✓✓
gmagick✓✓✓✓✓✓✓✓✓✓✓✓
gmp✓✓✓✓✓✓✓✓✓✓✓✓✓
gnupg✓✓✓✓✓✓✓✓✓✓✓✓✓
grpc✓✓✓✓✓✓✓✓✓✓✓✓✓
http✓✓✓✓✓✓✓✓✓✓✓✓✓
igbinary✓✓✓✓✓✓✓✓✓✓✓✓✓
imagick✓✓✓✓✓✓✓✓✓✓✓✓✓
imap✓✓✓✓✓✓✓✓✓✓✓✓✓
inotify✓✓✓✓✓✓✓✓✓✓✓✓✓
interbase✓✓✓✓✓✓
intl✓✓✓✓✓✓✓✓✓✓✓✓✓
ion✓✓✓✓✓
ioncube_loader✓✓✓✓✓✓✓✓✓✓✓✓
ip2location✓✓✓✓✓✓
jsmin✓✓✓✓✓✓✓
json_post✓✓✓✓✓✓✓✓✓✓✓✓✓
jsonpath✓✓✓✓✓✓✓
judy*✓✓✓✓✓✓
ldap✓✓✓✓✓✓✓✓✓✓✓✓✓
luasandbox✓✓✓✓✓✓✓✓✓✓✓✓✓
lz4*✓✓✓✓✓✓✓✓✓✓✓✓
lzf✓✓✓✓✓✓✓✓✓✓✓✓✓

支持的扩展数量：162

注：预安装的 PHP 扩展不计入此列表。 你可以使用以下命令列出这些预安装扩展（请将 php:8.5-cli 替换为你需要的 PHP 版本）：

$ docker run --rm php:8.5-cli php -m
[PHP Modules]
Core
ctype
curl
date
dom
fileinfo
filter
hash
iconv
json
lexbor
libxml
mbstring
mysqlnd
openssl
pcre
PDO
pdo_sqlite
Phar
posix
random
readline
Reflection
session
SimpleXML
sodium
SPL
sqlite3
standard
tokenizer
uri
xml
xmlreader
xmlwriter
Zend OPcache
zlib

[Zend Modules]
Zend OPcache

配置

你可以通过环境变量配置该脚本的行为，并针对部分扩展进行精细调整，以满足你的使用需求。

以下是配置示例：

IPE_LZF_BETTERCOMPRESSION=1 install-php-extensions lzf

所有支持的环境变量如下表所示：

扩展名称环境变量说明
无IPE_DEBUG=1设置该环境变量后，脚本会输出它执行的所有命令（输出内容会非常详尽，仅适用于调试场景）
无IPE_INSECURE=1设置该环境变量后，程序执行网络操作时将禁用 HTTPS 证书校验
无IPE_SAVE_PERMDEPS_TO=path IPE_SAVE_VOLDEPS_TO=path设置该环境变量后，脚本会将已安装 PHP 扩展所需的 APT/APK 包列表（IPE_SAVE_PERMDEPS_TO）和/或构建 PHP 扩展所需的包列表（IPE_SAVE_VOLDEPS_TO）存储到指定路径。请注意，install-php-extensions 可能还会通过其他方式配置系统（相关示例请https://github.com/mlocati/docker-php-extension-installer/blob/2.9.28/install-php-extensions#L2234-L2286查看）
无IPE_PROCESSOR_COUNT默认使用所有可用处理器。设置该环境变量可覆盖脚本自动检测的处理器数量（用于并行编译）
无IPE_DONT_ENABLE=1默认情况下，脚本会安装并启用扩展。如果你仅希望安装扩展而不启用它，可设置该环境变量。后续如需启用扩展，可执行 docker-php-ext-enable 命令（例如：docker-php-ext-enable xdebug）。请注意：安装部分 PHP 扩展要求其他扩展已提前启用，请谨慎使用此功能。
无IPE_SKIP_CHECK=1默认情况下，脚本会检查扩展是否可以被启用：如果你想跳过该检查，可使用此标志。请注意：扩展可能会在破坏 PHP 运行的情况下被强制启用，请谨慎使用此功能。
无IPE_NOSTRIP=1设置该环境变量后，编译生成的 PHP 扩展将保留调试符号（适用于调试分段错误等崩溃问题）
无IPE_KEEP_SYSPKG_CACHE=1默认情况下，脚本会清理 apt/apk/pear 缓存以节省磁盘空间。设置该环境变量可禁用此自动清理行为
lzfIPE_LZF_BETTERCOMPRESSION=1默认情况下，install-php-extensions 编译的 lzf 扩展优先考虑速度而非压缩率；你可以使用该环境变量让编译生成的扩展优先考虑压缩率而非速度
eventIPE_EVENT_NAMESPACE=...默认情况下，event 类定义在根命名空间下。你可以使用该环境变量指定自定义命名空间
gdIPE_GD_WITHOUTAVIF=1从 PHP 8.1 版本开始，gd 支持 AVIF 格式。在 Debian 11 及更早版本、Alpine 3.14 及更早版本中启用该支持需要编译 libaom/libdav1d/libyuv/libavif，耗时较长。在这些操作系统版本上可设置该环境变量禁用 AVIF 支持
oci8 & pdo_ociIPE_INSTANTCLIENT_BASIC=1oci8 和 pdo_oci PHP 扩展依赖 https://www.oracle.com/database/technologies/instant-client.html。为了节省磁盘空间，默认安装 Basic Lite 版本：如果你需要安装完整的 Basic（非精简）版本，只需设置该环境变量即可
http, intl, mongodbIPE_ICU_EN_ONLY=1部分扩展依赖 ICU 库，在 Alpine 3.16 及更高版本中使用该标志可安装体积更小、仅支持英语的 ICU 库
pspellIPE_ASPELL_LANGUAGES='...'配置可用的语言（例如：IPE_ASPELL_LANGUAGES='en fr'）。未指定时默认使用 en
无IPE_DEB_ARCHIVE & IPE_DEB_ARCHIVE_SECURITY非常老旧的 Debian 版本（例如 Jessie）的 APT 软件包可能已被归档：你可以使用这些环境变量指定这些 APT 归档源的自定义 URL
newrelicIPE_NEWRELIC_DAEMON=1同时安装 NewRelic 守护进程
newrelicIPE_NEWRELIC_KEEPLOG=1保留 NewRelic 安装过程中的日志文件（路径为 /tmp/nrinstall-….tar）
newrelicNR_INSTALL_KEY你的 New Relic 许可证密钥
ddtraceIPE_DD_APPSEC=1同时启用 Datadog https://docs.datadoghq.com/security/application_security/ 模块（ddappsec）。要求 PHP 7.0+，且使用 1.x 版本的追踪器
ddtraceIPE_DD_PROFILING=1同时启用 Datadog https://docs.datadoghq.com/profiler/ 模块（datadog-profiling）。要求 PHP 7.1+、Alpine 3.13+（或任意版本 Debian），且使用 1.x 版本的追踪器
swooleIPE_SWOOLE_WITHOUT_IOURING=1安全专家认为 io_uring 内核功能存在安全风险（相关说明可查看此处和此处）。默认情况下 Swoole 6 及更高版本开启了 io_uring 支持，使用该环境变量可跳过 io_uring 配置
saxonIPE_SAXON_EDITION=EE指定要使用的 Saxon 版本：EE 为企业版（默认值），PE 为专业版，HE 为家庭版

特殊要求

部分扩展存在特殊使用要求：

扩展名称要求限制
cassandra• 在 jessie Docker 镜像中不可用<br>• 在 stretch Docker 镜像中不可用
ddtrace在 jessie Docker 镜像中不可用
ecma_intl• 在 buster Docker 镜像中不可用<br>• 在 bullseye Docker 镜像中不可用<br>• 在 trixie Docker 镜像中不可用<br>• 在 alpine3.22 Docker 镜像中不可用<br>• 在 alpine3.23 Docker 镜像中不可用<br>• 在 alpine3.24 Docker 镜像中不可用
geos• 在 alpine3.9 Docker 镜像中不可用<br>• 在 alpine3.10 Docker 镜像中不可用
judy• 在 alpine3.13 Docker 镜像中不可用<br>• 在 alpine3.14 Docker 镜像中不可用<br>• 在 alpine3.15 Docker 镜像中不可用
lz4在 jessie Docker 镜像中不可用
memprof• 在 alpine3.9 Docker 镜像中不可用<br>• 在 alpine3.10 Docker 镜像中不可用<br>• 在 alpine3.11 Docker 镜像中不可用<br>• 在 alpine3.12 Docker 镜像中不可用<br>• 在 alpine3.13 Docker 镜像中不可用<br>• 在 alpine3.14 Docker 镜像中不可用<br>• 在 alpine3.15 Docker 镜像中不可用
parallel要求使用启用了线程安全（zts）编译 PHP 的镜像
parle在 jessie Docker 镜像中不可用
pdo_***• 在 Alpine 系列 Docker 镜像中不可用<br>• 在 jessie Docker 镜像中不可用
phpy在 buster Docker 镜像中不可用
pthreads要求使用启用了线程安全（zts）编译 PHP 的镜像
saxon• 在 alpine3.7 Docker 镜像中不可用<br>• 在 alpine3.8 Docker 镜像中不可用<br>• 在 alpine3.9 Docker 镜像中不可用<br>• 在 alpine3.10 Docker 镜像中不可用<br>• 在 alpine3.11 Docker 镜像中不可用<br>• 在 7.2-alpine Docker 镜像中不可用<br>• 在 7.3-alpine Docker 镜像中不可用<br>• 在 7.4-alpine Docker 镜像中不可用
seasclick• 在 alpine3.23 Docker 镜像中不可用<br>• 在 alpine3.24 Docker 镜像中不可用
simdjson• 在 jessie Docker 镜像中不可用<br>• 在 stretch Docker 镜像中不可用
sodium在 jessie Docker 镜像中不可用
sqlsrv• 在 7.1-alpine3.9 Docker 镜像中不可用<br>• 在 7.1-alpine3.10 Docker 镜像中不可用
statgrab• 在 alpine3.12 Docker 镜像中不可用<br>• 在 alpine3.13 Docker 镜像中不可用<br>• 在 alpine3.14 Docker 镜像中不可用<br>• 在 alpine3.15 Docker 镜像中不可用<br>• 在 alpine3.16 Docker 镜像中不可用
v8js• 在 buster Docker 镜像中不可用<br>• 在 bullseye Docker 镜像中不可用<br>• 在 alpine3.12 Docker 镜像中不可用<br>• 在 alpine3.13 Docker 镜像中不可用<br>• 在 alpine3.14 Docker 镜像中不可用<br>• 在 alpine3.15 Docker 镜像中不可用<br>• 在 alpine3.16 Docker 镜像中不可用<br>• 在 alpine3.17 Docker 镜像中不可用<br>• 在 alpine3.18 Docker 镜像中不可用
vips• 在 alpine3.9 Docker 镜像中不可用<br>• 在 jessie Docker 镜像中不可用
wikidiff2• 在 jessie Docker 镜像中不可用<br>• 在 stretch Docker 镜像中不可用
xpass在 buster Docker 镜像中不可用

如何查看当前使用的 Linux 发行版？

你可以运行以下命令：

cat /etc/os-release

示例输出：

  • 对于 Debian 11（Bullseye），输出结果如下：
PRETTY_NAME="Debian GNU/Linux 11 (bullseye)"
  • 对于 Alpine Linux 3.14，输出结果如下：
PRETTY_NAME="Alpine Linux v3.14"

库版本

部分 PHP 扩展依赖的系统库如果未在系统预设环境中提供，install-php-extensions 会自动编译或下载对应库。你可以通过设置对应的环境变量，指定使用非默认版本的库。例如：

IPE_LIBVERSION_XCRYPT=4.4.36 install-php-extensions xpass

[!WARNING] 非默认版本的库可能无法正常工作，使用该功能的风险需由你自行承担。

以下是相关库的完整列表（默认版本为当前最新版 install-php-extensions 所使用的版本）：

ghcr.io/mlocati/php-extension-installer 参考标签：latest

库环境变量默认版本使用者说明
https://aomedia.googlesource.com/aom/+refsIPE_LIBVERSION_AOM3.12.0gd仅在 Alpine 上配合 PHP 8.1+ 使用 - 格式同源码归档文件名
https://github.com/gearman/gearmand/releasesIPE_LIBVERSION_GEARMAN2.1.0gearman仅适用于 Alpine
https://github.com/Tessil/hat-trie/releasesIPE_LIBVERSION_HATTRIE0.7.1php_trie
libidnkitIPE_LIBVERSION_IDNKIT2.3http仅配合 PHP 7.0+ 使用
https://github.com/amzn/ion-c/releasesIPE_LIBVERSION_IONC1.1.6ion
https://github.com/chrislim2888/IP2Location-C-Library/tagsIPE_LIBVERSION_IP2LOCATION8.7.0ip2location
libmpdecIPE_LIBVERSION_MPDEC4.0.1decimal仅适用于 Alpine 和 Debian 12+
Microsoft ODBC Driver for SQL Server (Alpine)IPE_LIBVERSION_MSODBC18.7.1.1-1@ade174b7-8cea-4543-91a6-c33ae320c2f0pdo_sqlsrv, sqlsrv仅在 Alpine 上配合 PHP 7.4+ 使用，格式为 @（相关内容请参阅 Microsoft 官网 的下载地址）
Microsoft ODBC Driver 17 for SQL Server (Alpine)IPE_LIBVERSION_MSODBC1717.11.1.1-1@607ebe2c-e17c-4c34-b367-10a75b83bef9pdo_sqlsrv, sqlsrv仅在 Alpine 上配合最高支持 PHP 7.3 的版本使用，格式为 @（相关内容请参阅 Microsoft 官网 的下载地址）
https://github.com/tlwg/libthai/releasesIPE_LIBVERSION_THAI0.1.30wikidiff2仅适用于 Alpine
https://github.com/libtom/libtomcrypt/releasesIPE_LIBVERSION_TOMCRYPT1.18.2pdo_firebird, swoole仅在 Alpine 上配合 PHP 8.4+ 使用
https://github.com/libtom/libtommath/releasesIPE_LIBVERSION_TOMMATH1.3.0pdo_firebird, swoole仅在 Alpine 上配合 PHP 8.4+ 使用
https://github.com/besser82/libxcrypt/releasesIPE_LIBVERSION_XCRYPT4.5.2xpass仅适用于 Alpine
LibXDiffIPE_LIBVERSION_XDIFF0.23xdiff
https://chromium.googlesource.com/libyuv/libyuv/+logIPE_LIBVERSION_YUVd359a9f922af840b043535d43cf9d38b220d102egd仅在 Alpine < 3.15 且 Debian < 12 的环境下配合 PHP 8.1+ 使用（设置了 IPE_GD_WITHOUTAVIF 的情况除外），格式为 git 提交哈希
https://github.com/***/zstd/releasesIPE_LIBVERSION_ZSTD1.5.7redis仅配合 redis 5+ 使用

测试

在提交拉取请求时，系统会运行一个 https://github.com/mlocati/docker-php-extension-installer/blob/master/.github/workflows/test-extensions.yml，用于验证受影响的 PHP 扩展是否可正常工作（详见下文）。

此外，我们还会验证新版本 PHP 扩展及其依赖库是否仍可正常使用。 这项工作会通过另一个 https://github.com/mlocati/docker-php-extension-installer/blob/master/.github/workflows/check-updates.yml 按计划定期执行。 如果执行失败，系统会向一个 *** 频道 发送消息。 你可以自由订阅该频道，接收失败通知。

如何贡献

请参阅 https://github.com/mlocati/docker-php-extension-installer/blob/master/CONTRIBUTING.md 文件。

维护人员须知

请参阅 https://github.com/mlocati/docker-php-extension-installer/blob/master/MAINTAINERS.md 文件。

想要表达谢意？

你可以请我喝杯 https://github.com/***/mlocati 或者 单次咖啡 :wink:

轩辕镜像配置手册

按平台快速找到配置文档

一键安装

一键安装 Docker

Linux Docker 一键安装

AI

用 AI 使用轩辕镜像

agents.md · AI 对话 · 提示词

Docker

登录仓库拉取

登录认证 · 私有仓库

专属域名拉取

免登录 · 高速拉取

Linux

Docker 镜像配置

Windows / Mac

Docker Desktop 配置

MacOS OrbStack

OrbStack 容器

Apple Container

macOS 原生容器

Docker Compose

Compose 项目配置

NAS

群晖

Synology 配置

飞牛

fnOS 镜像配置

绿联

绿联 NAS

威联通

QNAP 配置

极空间

极空间 NAS

Unraid

Unraid NAS

企业仓库

其他仓库

ghcr · Quay · nvcr

Harbor 镜像源

Proxy Repository 对接

Portainer 镜像源

Registries 配置

Nexus 镜像源

Docker Proxy 缓存

开发工具

Dev Containers

VS Code 开发容器

Podman

Podman 配置指南

Singularity / Apptainer

HPC 科学计算容器

Kubernetes

K8s Containerd

Kubernetes · Containerd

K3s

轻量级集群

面板 / 网络

爱快路由

爱快 4.0 · iKuai 镜像加速

宝塔面板

一键配置镜像源

需要其他帮助？请查看我们的 常见问题Docker 镜像访问常见问题解答 或 提交工单

镜像拉取常见问题

功能

版本功能对比

功能对比 · 版本选择

支持的镜像仓库

Docker Hub · GCR · GHCR

专属域名用法

专属域名 · 开启停用 · 多仓库

新手拉取配置

登录 · 专属域名 · 配置

docker search 限制

专属域名 · Hub 搜索

不支持 push

仅支持 pull · 不支持

拉取速度原因

带宽 · 缓存 · 冷热镜像

错误码

402 与流量用尽

402 · 流量包 · 充值

401 认证失败

401 · docker login

manifest unknown

标签错误 · 镜像不存在

410 Gone 排查

410 · Docker 升级

429 限流

免费版 · 专业版 · 企业版 · 请求频率

其他报错

DNS 超时

DNS 解析 · 网络超时

TLS 证书失败

no matching manifest（架构）

docker.sock / daemon

账号

失败是否计费

manifest · blob · 计费

申请开票（企业 / 个人）

开票 · 发票 · 工单

修改登录密码

网站 · 仓库 · 重置

注销账户

工单 · 数据 · 注销

原理

mirrors 不生效

daemon.json · 重启

去掉域名前缀

docker tag · 重命名

指定架构拉取

ARM64 · AMD64 · 多架构

latest 与「最新」

digest · 版本号 · 标签

查看全部问题→

用户好评

来自真实用户的反馈，见证轩辕镜像的优质服务

用户头像

oldzhang

运维工程师

Linux服务器

5

"Docker访问体验非常流畅，大镜像也能快速完成下载。"

轩辕镜像
镜像详情
...
ghcr.io/mlocati/php-extension-installer
定价查看流量套餐与价格
博客Docker 镜像公告与技术博客
官方技术交流群：|问题咨询请：提交工单
服务号：轩辕镜像|公众号：源码跳动|小程序：轩辕镜像|官方技术交流群：|问题咨询请：提交工单
专业版 · 高速稳定拉取镜像
高速镜像下载·在线技术支持·99.95% SLA 保障·付费会员免广告
50GB 仅 ¥8/年
专业版 · 高速稳定拉取镜像
50GB 仅 ¥8/年
高速镜像下载·在线技术支持·99.95% SLA 保障·付费会员免广告
用户协议·隐私政策·增值电信业务经营许可证：浙B2-20261007·©2024-2026 源码跳动©2024-2026 杭州源码跳动科技有限公司·商务合作：点击复制邮箱