FrankenPHP怎么部署WordPress网站-php教程-PHP中文网

frankenphp部署wordpress必须显式声明入口、配置重写、安装必要扩展并严格对齐https域名，否则将出现后台302循环、静态资源404和ajax失败；需设frankenphp_worker_entrypoint=index.php、在caddyfile中添加rewrite规则、启用cgi.fix_pathinfo=1、安装opcache/mysqli/zip等扩展，并在wp-config.php中明确定义wp_home和wp_siteurl。

frankenphp怎么部署wordpress网站

FrankenPHP 部署 WordPress 不需要 Nginx 或 Apache，但必须显式声明入口、启用重写、补全 PHP 扩展，且不能跳过 HTTPS 对齐配置——否则后台 302 循环、静态资源 404、AJAX 失败这三类问题会立刻出现。

必须设置 `FRANKENPHP_WORKER_ENTRYPOINT=index.php`

FrankenPHP 默认不把 index.php 当作入口，WordPress 的所有请求（包括后台、REST API、固定链接）都会直接 404。这不是路径问题，是运行模式识别失败。

在 docker-compose.yml 的服务环境变量中加：FRANKENPHP_WORKER_ENTRYPOINT=index.php
或改用 entrypoint： entrypoint: ["frankenphp", "worker", "index.php"]
确保 index.php 真实存在于 Web 根目录（如 /var/www/html/），且容器内可读（权限 644，非 600）
别用 php-server 模式——它只适合单文件脚本，对 WordPress 的多路由结构支持极差

重写规则必须写进 Caddyfile，且依赖 `cgi.fix_pathinfo=1`

WordPress 固定链接（比如 /2024/my-post/）靠 PATH_INFO 解析，而 FrankenPHP 的 Caddy 引擎默认不自动 fallback 到 index.php，必须手动配 rewrite。

Publish Passwords

本地凭据保险库，集成操作系统密钥链，支持加密存储与会话级访问控制。

下载

Caddyfile 片段示例（放在域名块内）：

rewrite * { to {path} {path}/ /index.php?{query} }

同时确认 PHP 配置中 cgi.fix_pathinfo=1 已生效（在 php.ini 或通过 php -i | grep fix_pathinfo 验证）
如果用的是官方 dunglas/frankenphp 镜像，cgi.fix_pathinfo 默认是 1，但某些自定义构建镜像可能关掉了，务必检查
开发阶段建议临时设 opcache.validate_timestamps=1，否则改了重写规则也不生效——OPcache 缓存了旧的路由逻辑

必须手动安装并重启才能启用 `opcache`、`mysqli`、`zip`

FrankenPHP 的 PHP 是静态编译的，php.ini 开关无效，扩展必须用 install-php-extensions 脚本安装，且装完不重启等于白装。

进入容器执行：install-php-extensions opcache mysqli zip gd curl mbstring xml simplexml json
装完立刻 docker restart <container_name></container_name>，否则 phpinfo() 里 opcache 仍显示 disabled
mysqli 和 pdo_mysql 二选一即可，但必须有其一；zip 是插件上传解压所必需，漏掉会导致“安装失败”提示但无日志报错
如果用 SQLite 插件或缓存组件（如 LiteSpeed Cache），还得额外装 pdo_sqlite，否则它们会静默退化到低效的文件缓存

`WP_HOME` 和 `WP_SITEURL` 必须与 Caddyfile 域名完全一致

FrankenPHP 终止 HTTPS 后，$_SERVER['HTTPS'] 自动设为 on，但 WordPress 仍需明确知道自己跑在哪个 HTTPS 地址上——否则 wp-admin 重定向、资源 URL、Cookie 安全标志全乱。

编辑 wp-config.php，在 /* That's all, stop editing! */ 上方加：

define('WP_HOME', 'https://yourdomain.com');define('WP_SITEURL', 'https://yourdomain.com');

域名必须和 Caddyfile 中 TLS 块写的完全一致：如果 Caddyfile 写的是 https://www.yourdomain.com，这里就不能写 https://yourdomain.com
不要装 Really Simple SSL 这类插件——FrankenPHP 已通过 Caddy 的 redir 和 php_server 指令完成 HTTP→HTTPS 跳转和协议头注入，插件反而会干扰重定向链路
检查浏览器控制台是否报混合内容（Mixed Content）：若有，说明某处硬编码了 http:// 链接，得进数据库查 wp_options 表里的 siteurl 和 home 字段