Z-Blog PHP 可在 phpEnv 中运行，需满足 PHP ≥7.4（推荐 7.4.33 或 8.1.27）、启用 curl/mbstring/gd/xml/json 扩展、将程序重命名为 localhost 放入 www 目录，并配置 nginx 伪静态规则以支持静态化。
phpEnv 本身不内置 Z-Blog，但能直接运行 Z-Blog PHP 版——前提是 PHP 版本、扩展和目录权限满足最低要求。Z-Blog PHP 当前（2026 年）稳定版要求 PHP >= 7.4，且必须启用 curl、mbstring、gd、xml、json 这 5 个扩展；低于 7.4 或缺失任一扩展，安装页面会卡在“环境检测”环节，报错信息通常是：Required extension "xxx" is not loaded。
确认 phpEnv 中的 PHP 版本与扩展是否达标
Z-Blog PHP 不兼容 PHP 5.x，也不推荐用 PHP 8.3+（部分插件尚未适配）。实测最稳的是 PHP 7.4.33 或 PHP 8.1.27。
- 打开 phpEnv 主界面 → 点击右上角「环境设置」→ 查看当前启用的
PHP版本号 - 若版本过低（如显示
5.6.40），点击「PHP 版本」下拉菜单，选一个 ≥7.4 的版本，再点「应用并重启服务」 - 重启后，访问
http://localhost/phpinfo.php（若无此文件，手动在www目录下建一个，内容为<?php phpinfo(); ?>），搜索curl、mbstring等关键词，确认状态为enabled - 若某扩展未启用，在 phpEnv 的「PHP 扩展」页签中勾选它，再重启服务
把 Z-Blog PHP 放进 www 目录并重命名成 localhost
phpEnv 默认只认 localhost 这个域名路径下的站点。如果你直接解压 Z-Blog 到 www/zblog，访问 http://localhost/zblog 会 404 —— 因为 nginx 配置里没配子目录路由，且 Z-Blog 的伪静态规则默认依赖根目录。
- 下载 Z-Blog PHP 最新版（官网 zblogcn.com，选「PHP 版」ZIP 包）
- 解压后，把整个文件夹重命名为
localhost（不是zblog，也不是带版本号的文件夹名） - 覆盖式粘贴进 phpEnv 的
www目录（路径类似C:\phpenv\www），确保index.php在www\localhost\下一级 - 别动
zb_system文件夹权限：phpEnv 默认以当前 Windows 用户身份运行 nginx，只要没把www放在C:\Program Files这类受保护路径，写入权限就天然存在
访问 localhost 完成安装，避开数据库名/用户硬编码陷阱
Z-Blog 安装时要求填数据库名、用户名、密码，但它不接受空密码（哪怕 MySQL 是 root 空密码），且数据库名不能含短横线（-）或中文——否则后续升级或插件安装会触发 SQL syntax error。
立即学习“PHP免费学习笔记（深入）”；
- 先用 phpEnv 自带的 phpMyAdmin（访问
http://localhost/phpmyadmin）新建库，库名用zblog或zb，排序规则选utf8mb4_unicode_ci - 安装页面填：数据库服务器
localhost，数据库名zblog，用户名root，密码留空（如果 phpEnv 默认没设密码） - 若提示「连接数据库失败」，检查
mysql服务是否已启动（phpEnv 界面里 MySQL 圆点是绿色）；仍失败则尝试把服务器地址改成127.0.0.1（Windows 下localhost有时走 socket，127.0.0.1强制走 TCP） - 安装成功后，立刻修改
zb_users表里的管理员密码（用 phpMyAdmin），因为 Z-Blog 默认明文存 salt，本地环境虽无风险，但养成习惯很重要
伪静态失效？直接改 nginx 配置加 rewrite 规则
Z-Blog 启用「静态化」后，文章链接变成 /post/1.html，但 phpEnv 默认 nginx 配置没加载重写规则，访问这类地址会返回 404。
- 打开 phpEnv 安装目录 →
nginx\conf\vhost\localhost.conf - 在
location / {块内，插入以下三行：
if (!-e $request_filename) {
rewrite ^(.*)$ /index.php?s=$1 last;
}
- 保存文件，回到 phpEnv 界面，点击「重启 nginx」
- 进 Z-Blog 后台 → 「网站设置」→ 「静态化」→ 开启「URL 静态化」，选「文章页」即可生效
- 注意：不要开「分类页静态化」，Z-Blog 当前版本对分类伪静态支持不稳定，容易导致后台 500 错误
真正麻烦的不是安装步骤，而是 Z-Blog 的插件生态和 phpEnv 的 PHP 版本绑定太紧——比如「微信推送」插件只兼容到 PHP 8.1，换到 8.2 就报 Deprecated: Return type of xxx must be compatible。建议装完基础站后，先停在 PHP 8.1，插件全量更新一遍再考虑升版。
