php扩展安装需区分alpine与debian系镜像：alpine用apk add php83-xxx或docker-php-ext-install（需先装$phpize_deps及系统库），debian系优先用docker-php-ext-install或pecl install+docker-php-ext-enable；gd等需configure的扩展须分步操作，且务必验证实际可用性。
直接拉取 php:8.3-fpm 或 php:8.3-cli 镜像后，PHP 扩展默认是不全的——你必须自己装，而且不能在运行中的容器里用 pecl install 临时加，否则构建不可复现、生产环境会丢扩展。
docker-php-ext-install 是最稳的安装方式
官方 PHP 镜像内置了 docker-php-ext-install 脚本，专为编译安装核心扩展设计。它自动处理源码解压、configure、make、install 全流程，且只打包编译产物，不残留源码（前提是配合 docker-php-source delete）。
- 必须先装系统依赖：比如
gd要libjpeg-dev、libpng-dev；pdo_mysql在 Alpine 上要mysql-client-dev，Debian 系则要default-libmysqlclient-dev - 多线程编译能提速：
docker-php-ext-install -j$(nproc) pdo_mysql mbstring - 别漏掉
docker-php-source delete——否则镜像体积暴增 50MB+，因为 /usr/src/php 被完整保留 - Alpine 和 Debian 基础镜像的包名不同：Alpine 用
apk add --no-cache php83-opcache是快捷方式，但仅限已预编译的扩展；自定义编译仍得走docker-php-ext-install
需要 configure 的扩展（如 gd、iconv）必须分两步
有些扩展依赖外部库路径，docker-php-ext-install 无法自动猜出位置，必须显式调用 docker-php-ext-configure 指定参数，否则编译失败或运行时报 “undefined symbol”。
OpenClaw Docker Setup
下载
在 Linux 上通过 Docker 运行 OpenClaw，并使用 Tailscale 实现远程访问。⚠️ 涉及 sudo、Docker、Tailscale和凭证挂载——请先查阅安全章节...
- 例如
gd：先apk add --no-cache libjpeg-turbo-dev libpng-dev freetype-dev，再docker-php-ext-configure gd --with-jpeg-dir=/usr/include/libjpeg-turbo --with-png-dir=/usr --with-freetype-dir=/usr，最后docker-php-ext-install gd -
iconv在 Alpine 上常报错，是因为 musl libc 不提供 glibc 风格的 iconv，此时应跳过安装，改用mbstring替代 - 不要在同一个 RUN 指令里混用 configure + install 多个扩展——失败时无法定位是哪个环节出问题
PECL 扩展（如 redis、swoole）要用 pecl install + 手动启用
pecl install 适合非核心、社区维护的扩展，但它生成的是 .so 文件，不会自动写入 ini 启用，也不处理系统级依赖（比如 swoole 需要 gcc、make、linux-headers）。
- Alpine 用户务必先装构建工具：
apk add --no-cache $PHPIZE_DEPS（官方镜像已预设该变量，值为autoconf automake autoheader libtool make g++） - 装完必须手动启用：
pecl install redis && docker-php-ext-enable redis；docker-php-ext-enable只是建软链到 conf.d，不校验 .so 是否真能加载 - 装完建议验证：
docker run --rm your-image php -m | grep redis，避免因路径错误导致模块未生效 - 某些 PECL 扩展（如
sqlsrv）根本不支持 Alpine，musl libc 缺少符号，只能换用php:8.3-cli-bullseye
验证扩展是否真正可用比“装上”更重要
很多镜像构建成功、php -m 显示模块名，但实际运行时仍报 “class not found”，原因是扩展虽加载，但依赖的底层库没进容器 PATH 或版本不兼容。
- 用
php -r "new Redis();"这类实例化代码测试，比单纯查模块列表更可靠 - Alpine 镜像中，
php:8.3-cli-alpine默认没装ca-certificates，导致curl扩展 HTTPS 请求失败，需额外apk add --no-cache ca-certificates - OPcache 必须在
php.ini中显式开启：opcache.enable=1，光装扩展不配置等于没装 - 生产镜像里禁用
display_errors后，扩展加载失败不会报错，只会静默失效——所以构建阶段就要验证，别等上线才排查
php免费学习视频：立即使用
踏上前端学习之旅，开启通往精通之路！从前端基础到项目实战，循序渐进，一步一个脚印，迈向巅峰！
