phpenv本身不安装Z-Blog，仅管理PHP版本；Z-Blog是独立PHP应用，需在phpenv提供的7.4/8.0+环境中手动部署，关键需确保Web服务器调用phpenv的PHP、启用pdo_mysql等扩展，并正确配置Nginx fastcgi_pass路径。
phpenv 本身不安装 Z-Blog，它只管理 PHP 版本；Z-Blog 是一个独立的 PHP 应用，需在 phpenv 提供的合适 PHP 环境下手动部署。
确认 PHP 版本是否满足 Z-Blog 要求
Z-BlogPHP 官方明确要求 PHP ≥ 5.2，但实际推荐使用 7.4 或 8.0+（截至 2026 年，8.1 和 8.2 更稳妥）。低版本如 5.6 已被主流主机淘汰，且部分插件/主题依赖现代语法会报错。
常见错误现象：
- 安装页面空白、
500 Internal Server Error - 后台打开后提示
Parse error: syntax error（通常是 PHP 版本太低） - 主题启用时报
call to undefined function（比如str_contains()在8.0才引入）
实操建议：
立即学习“PHP免费学习笔记（深入）”；
- 先运行
phpenv versions查看已安装版本，若无合适版本，执行phpenv install 8.1.28（稳定、兼容性好） - 用
phpenv global 8.1.28设为全局默认，再验证：php -v输出应含8.1.28 - 别跳过
phpenv rehash—— 否则php命令可能仍指向旧版本
用 phpenv 环境跑 Z-Blog 的关键路径配置
Z-Blog 不是通过 phpenv 命令一键安装的，它依赖 Web 服务器（如 Nginx/Apache）把请求路由到 index.php。phpenv 只确保这个 index.php 被正确版本的 PHP 解释器执行。
容易踩的坑：
- Web 服务器没调用 phpenv 管理的 PHP：比如 Nginx 的
fastcgi_pass还指向系统自带的/usr/bin/php，而非 phpenv 的 shim 路径 - 权限问题：phpenv 安装的 PHP 默认不带
pdo_mysql或curl扩展，Z-Blog 安装时会卡在“环境检查”页
实操建议：
立即学习“PHP免费学习笔记（深入）”；
- 查 phpenv 的 PHP 实际路径：
which php应输出类似/home/yourname/.phpenv/shims/php - 确认扩展已启用：
php -m | grep -E "pdo|mysql|curl|mbstring"—— 缺哪个就进对应版本源码目录重新编译，或用php-build插件重装时加--with-pdo-mysql - Nginx 配置中，
fastcgi_pass必须配合fastcgi_param SCRIPT_FILENAME指向网站根目录下的$fastcgi_script_name，否则伪静态和后台登录会 404
Z-Blog 安装过程与 phpenv 的协作点
整个安装流程和普通环境一致，但 phpenv 用户需额外注意三处：
- 上传
install.php后，浏览器访问http://yoursite/install.php，如果页面直接下载而不是执行，说明 Web 服务器没把 .php 文件交给 phpenv 管理的 PHP 处理 - 数据库类型选
MySQLi时，必须确认当前 PHP 版本已编译mysqli扩展（php -m能看到），否则点击“下一步”会白屏 - 安装成功后，Z-Blog 生成的
zb_users/c_user.asp（或新版的zb_system/config.php）里记录了 PHP 运行环境信息，但不包含 phpenv 路径 —— 这是正常的，Z-Blog 不感知版本管理工具
简短示例（验证 PHP 是否就绪）：
echo "<?php echo 'PHP '.PHP_VERSION.' + '.(extension_loaded('mysqli') ? 'mysqli OK' : 'mysqli missing'); ?>" > /var/www/html/test.php
访问 http://yoursite/test.php，应输出类似 PHP 8.1.28 + mysqli OK。不满足就回上一步修 PHP 配置。
主题启用失败时，别急着改 phpenv
Z-Blog 主题启用报 授权文件非法 或 未登录客户端，99% 和 phpenv 无关，是 Z-Blog 自身的授权校验机制触发的 —— 它检查的是 zb_system/defend/ 下的密钥文件、应用中心登录状态、以及域名是否匹配授权记录。
此时做这些就够了：
- 确认已登录 Z-Blog 后台的应用中心（
/zb_system/cmd.php?act=appcenter） - 检查
zb_users/c_user.asp中ZC_BLOG_HOST是否和当前访问域名完全一致（含http://、末尾/、端口等） - 临时关闭防篡改功能：在
zb_system/config.php中把ZC_CHECK_APP_UPDATE设为false
强行用 phpenv 切换 PHP 版本来“修复授权问题”，只会让错误更隐蔽 —— 因为问题压根不在解释器层面。
