z-blog php 在 xampp 上跑不起来主因是环境配置错误：需 php ≥7.2 且启用 mysqli 扩展；mysql 字符集必须为 utf8mb4_unicode_ci；apache 必须启用 rewrite_module 并设 allowoverride all；zb_users 下 cache/theme/plugin/avatar 目录须有写权限。
Z-Blog PHP 在 XAMPP 上跑不起来，90% 是环境兼容性没调对，不是程序本身问题。 它对 PHP 版本、MySQL 字符集、Apache 模块和目录权限有明确要求，缺一不可。下面直击关键环节。
检查 PHP 版本与 mysqli 扩展是否启用
Z-Blog PHP 2.0+ 要求 PHP ≥ 7.2，且必须启用 mysqli 扩展（mysql 已废弃）。XAMPP 默认可能带多个 PHP 版本（如 7.4 / 8.0 / 8.1），但控制面板只显示一个——容易误判。
- 打开 XAMPP 控制面板，点击
Apache行右侧的Config→PHP (php.ini)，确认文件头有PHP Version 7.4.33或更高（别只看控制面板右下角小字） - 搜索
;extension=mysqli，去掉前面的分号，保存后重启 Apache - 在
htdocs下建个info.php，内容为<?php phpinfo(); ?>，浏览器访问http://localhost/info.php，Ctrl+F 查mysqli，看到“enabled”才算成功 - 若仍报
Class 'mysqli' not found，说明你改的是错版本的php.ini——XAMPP 可能有多个配置文件，务必确认路径是XAMPP\php\php.ini，不是XAMPP\apache\bin\php.ini
MySQL 字符集必须设为 utf8mb4_unicode_ci
安装向导卡在“正在检测环境”或创建数据库失败，大概率是字符集不匹配。XAMPP 自带的 MySQL 默认用 latin1 或 utf8（非真正 UTF-8），而 Z-Blog PHP 强制要求 utf8mb4_unicode_ci 支持 emoji 和四字节 Unicode。
- 启动 phpMyAdmin（
http://localhost/phpmyadmin），新建数据库时，不要点“创建”就完事，在“排序规则”下拉框中手动选utf8mb4_unicode_ci - 如果已有数据库，进该库 → 点“操作” → “排序规则”改为
utf8mb4_unicode_ci，再点“执行” - 额外验证：在 phpMyAdmin 的 SQL 标签页执行
SHOW VARIABLES LIKE 'character_set%';，确保character_set_server和collation_server都是utf8mb4相关值；如果不是，需修改my.ini（路径：XAMPP\mysql\bin\my.ini），在[mysqld]下加两行：character-set-server=utf8mb4和collation-server=utf8mb4_unicode_ci，然后重启 MySQL
Apache 必须启用 rewrite_module 且 .htaccess 生效
Z-Blog PHP 的伪静态、后台路由、主题资源加载都依赖 Apache 的重写功能。XAMPP 默认禁用 rewrite_module，且 AllowOverride 设为 None，导致所有美化链接 404、后台打不开、插件 JS/CSS 加载失败。
- 打开
XAMPP\apache\conf\httpd.conf，搜索rewrite_module，确认这行未被注释：LoadModule rewrite_module modules/mod_rewrite.so - 继续搜索
<directory></directory>（注意路径可能含盘符），找到对应区块，把里面的AllowOverride None改成AllowOverride All - 保存后重启 Apache；测试方法：在 Z-Blog 根目录放个
.htaccess文件，内容写RewriteEngine On，再访问任意不存在路径，如果返回 Apache 默认 404 页面，说明生效；如果返回 Z-Blog 的“页面未找到”，说明 rewrite 已接管 - Windows 用户特别注意：确保
.htaccess文件名没有隐藏的.txt后缀（用记事本另存为时选“所有文件”类型）
zb_users 目录权限错误是最隐蔽的失败点
安装完成但无法启用主题、不能上传附件、缓存不更新，甚至后台登录后空白，几乎全是 zb_users 权限问题。它不像 WordPress 只要 wp-content 可写，Z-Blog PHP 要求子目录级细粒度控制。
- 必须可写的路径只有：
zb_users/cache、zb_users/theme、zb_users/plugin、zb_users/AVATAR；其他如zb_users/defend、zb_users/language只读即可 - Windows 下右键
zb_users→ 属性 → 安全 → 编辑 → 添加用户IIS_IUSRS（不是 Everyone），勾选“修改”；若无此用户，添加Users组并勾选“修改” - macOS/Linux 执行：
chmod -R 755 zb_users/cache zb_users/theme zb_users/plugin zb_users/AVATAR；切勿chmod -R 777 zb_users，会触发 Z-Blog 的安全拦截，直接拒绝安装 - 权限改完后，删掉
zb_users/cache下所有文件，再刷新后台，看是否重建缓存目录——这是最快速的验证方式
真正卡住的地方，往往不是“哪里没做”，而是“哪里做过了但没做对”。比如改了 php.ini 却没重启 Apache，或者设了 AllowOverride All 却没开 rewrite_module，又或者以为 utf8 就够用了。每一步都要有可验证的反馈，而不是凭感觉点下一步。
php免费学习视频：立即使用
踏上前端学习之旅，开启通往精通之路！从前端基础到项目实战，循序渐进，一步一个脚印，迈向巅峰！
