Z-BlogPHP当前官方要求PHP≥7.2.5，推荐PHP8.1/8.2，禁用PHP7.4及以下版本因其已停维且存在CVE-2024-4577等未修复漏洞；XAMPP旧版默认PHP7.4/8.0易因扩展未启用、SSL配置错误或opcache冲突导致白屏、加载失败等问题；安全切换至PHP8.2需独立解压并手动配置php.ini、httpd.conf，确保Server API为Apache 2.0 Handler、mbstring.func_overload=Off，并启用mod_rewrite。
Z-BlogPHP 当前（2026 年）官方明确要求 PHP ≥ 7.2.5，推荐使用 PHP 8.1 或 PHP 8.2；PHP 8.3 已支持但需确认所用插件兼容性。不建议在新部署中选用 PHP 7.4 及以下版本——它们已停止维护，且存在未修复的安全漏洞（如 CVE-2024-4577），Z-Blog 官方扩展中心多数新插件也不再适配。
为什么不能直接用 XAMPP 自带的默认 PHP 版本？
XAMPP 旧版（如 8.0.x 系列）默认捆绑 PHP 7.4 或 PHP 8.0，而新版 XAMPP（如 8.2+）才预装 PHP 8.2。但问题不在“有没有”，而在“能不能用”：Z-Blog 的 zblogphp 主程序虽能勉强跑在 PHP 7.4 上，但其依赖的 mbstring、curl、json 等扩展在旧版 XAMPP 的 php.ini 中常被注释或路径错误；更关键的是，opcache.enable=1 在 PHP 7.4 下与 Z-Blog 的模板缓存机制偶发冲突，导致后台编辑文章后页面空白。
常见错误现象包括：
-
Call to undefined function mb_strlen()——mbstring扩展未启用 - 后台“应用中心”加载超时或白屏 ——
cURLSSL 配置缺失或 CA 证书路径错误 - 启用主题后首页 CSS/JS 不加载 ——
opcache.revalidate_freq=0未设，或realpath_cache_size过小
如何安全切换到 PHP 8.2（以 Windows + XAMPP 8.1.3 为例）
不要直接覆盖 XAMPP\php\ 目录，XAMPP 8.1.3 内置的 Apache 模块（php8apache2_4.dll）只兼容 PHP 8.1，强行塞入 PHP 8.2 会导致 Apache 启动失败并报错：Cannot load D:/xampp/php/php8apache2_4.dll into server: The specified module could not be found.
立即学习“PHP免费学习笔记（深入）”；
正确做法是分三步走：
- 从 windows.php.net/download 下载
PHP 8.2.20 (VC15 x64 Thread Safe)ZIP 包（务必选 TS、x64，与 XAMPP 编译环境一致） - 解压到独立路径，例如
D:\php-8.2.20；复制原XAMPP\php\php.ini到该目录并重命名为php.ini，然后手动修正以下几项：
•extension_dir = "D:/php-8.2.20/ext"
•date.timezone = "Asia/Shanghai"
• 取消注释extension=mbstring、extension=curl、extension=gd、extension=openssl - 编辑
XAMPP\apache\conf\httpd.conf，注释掉原LoadModule php_module行，新增：LoadModule php_module "D:/php-8.2.20/php8apache2_4.dll"PHPIniDir "D:/php-8.2.20"
并在<filesmatch></filesmatch>区块内确保SetHandler application/x-httpd-php生效
Z-Blog 安装后必须验证的 PHP 配置项
Z-Blog 对运行时环境敏感，仅靠 php -v 显示版本号远远不够。必须访问 http://localhost/zblog/phpinfo.php（自行建一个含 <?php phpinfo(); ?> 的文件），重点核对：
-
Server API必须是Apache 2.0 Handler（不是 CGI/FastCGI），否则伪静态和后台登录会异常 -
Loaded Configuration File路径是否指向你刚配置的php.ini（避免仍读取 XAMPP 默认路径） -
mbstring.func_overload必须为Off（Z-Blog 会自行处理编码，开启会导致数据库写入乱码） -
max_execution_time建议 ≥120（主题安装、插件批量更新易超时） -
upload_max_filesize和post_max_size均应 ≥32M（上传大附件或备份包时必需）
最容易被忽略的一点：Z-Blog 的伪静态规则（.htaccess）依赖 Apache 的 mod_rewrite 模块，而 XAMPP 默认是关闭它的。若启用后前台 404、后台无法保存设置，先检查 httpd.conf 中 LoadModule rewrite_module modules/mod_rewrite.so 是否已取消注释，且对应 <directory></directory> 区块中 AllowOverride All 是否生效。
