wordpress在frankenphp上运行必需的php扩展包括：mysqli或pdo_mysql、mbstring、xml、simplexml、curl、gd、json；其中opcache和zip需显式安装并重启容器生效，ctype、iconv、openssl、zlib等虽不报错但缺失会导致功能降级。
WordPress在FrankenPHP上运行，需要的PHP扩展和传统LAMP环境基本一致，但有几点关键差异：FrankenPHP默认不启用所有扩展，且部分扩展（如opcache）对性能影响极大，必须显式开启；而像pdo_mysql这类扩展，虽非FrankenPHP特有，却是WordPress连接MySQL的刚性依赖。
WordPress在FrankenPHP中必需的PHP扩展列表
以下扩展缺一不可，否则WordPress将无法启动或出现致命错误：
-
mysqli或pdo_mysql：二者选其一，用于数据库连接。FrankenPHP镜像默认未启用，需手动安装 -
mbstring：处理中文、emoji等多字节字符，WP核心和多数插件强依赖 -
xml和simplexml：RSS、站点地图、插件更新、XML-RPC等功能的基础 -
curl：后台自动更新、插件市场调用、OAuth登录等依赖HTTP客户端 -
gd或imagick：媒体上传后缩略图生成、图片裁剪必须项；FrankenPHP默认不含imagick，推荐用gd -
json：REST API、块编辑器（Gutenberg）、AJAX交互的数据交换基础
FrankenPHP特有的扩展启用方式
FrankenPHP使用dunglas/frankenphp官方镜像，扩展不能靠改php.ini直接生效——它用的是编译时静态链接+运行时动态加载机制。正确做法是进入容器执行安装命令：
例如启用opcache（强烈建议开启，可提升30%以上首屏响应速度）和zip（插件/主题上传解压所需）：
docker exec -it <container_name> install-php-extensions opcache zip</container_name>
注意：install-php-extensions脚本会自动处理依赖、编译和配置，但安装后必须重启容器才能生效。常见错误是装完没重启，导致phpinfo()里仍显示opcache为disabled。
容易被忽略但实际关键的扩展项
这些扩展不报错，但缺失会导致功能静默降级或兼容性断裂：
-
ctype：WP核心字符串校验函数（如ctype_alnum）底层依赖，某些主题初始化会失败 -
iconv：处理UTF-8与GBK等编码转换，国产插件（如微信公众号同步）常触发 -
openssl：HTTPS请求、SMTP发信、JWT验证必备；FrankenPHP静态镜像默认不带，需在构建阶段通过PHP_EXTENSIONS=openssl声明 -
zlib：启用Gzip压缩，Caddy层虽可代理压缩，但PHP内部输出缓冲（ob_gzhandler）需此扩展支持
FrankenPHP的static-builder镜像对扩展更敏感——比如漏掉pdo_sqlite，即使你不用SQLite，某些缓存插件（如LiteSpeed Cache）也会因探测失败而退化到文件缓存，拖慢并发响应。
php免费学习视频：立即使用
踏上前端学习之旅，开启通往精通之路！从前端基础到项目实战，循序渐进，一步一个脚印，迈向巅峰！
