xampp服务需正常启动且端口未被占用，z-blog php依赖apache和mysql，端口80和3306冲突是部署失败主因；文件须完整解压至htdocs子目录并设置zb_users等目录可写权限；数据库配置须用127.0.0.1、utf8mb4_unicode_ci字符集及正确mysql凭证；安装后必须删除install.php并修改后台路径以保障安全。
确认 XAMPP 服务已正常启动且端口未被占用
Z-Blog PHP 依赖 Apache 和 MySQL，XAMPP 启动失败或端口冲突（尤其是 80 和 3306）是部署卡住的第一常见原因。打开 XAMPP Control Panel，检查 Apache 和 MySQL 状态是否为绿色“Running”；若显示“Stopped”，点击对应模块的 Start 按钮后仍失败，大概率是端口被 Skype、IIS、其他 Web 服务或残留进程占用。
快速排查方法：在命令行运行 netstat -ano | findstr :80（Windows）或 lsof -i :80（macOS/Linux），查出 PID 后用任务管理器或 kill -9 [PID] 终止；也可直接在 XAMPP 设置中将 Apache 端口改为 8080，但需注意后续访问地址要带端口号（如 http://localhost:8080/zblog/）。
将 Z-Blog PHP 文件正确放入 htdocs 并设置目录权限
Z-Blog PHP 不是单文件程序，必须完整解压到 htdocs 下的子目录（如 htdocs/zblog），不能直接丢进 htdocs 根目录——否则安装向导会因路径识别异常而报错 Warning: require_once(./zb_system/function/c_system_base.php): failed to open stream。
解压后需确保关键目录可写：
-
zb_users目录及其子目录（cache、theme、plugin）必须有写权限（Windows 下右键 → 属性 → 安全 → 编辑 → 给Everyone或IIS_IUSRS勾选“修改”；macOS/Linux 执行chmod -R 755 zb_users） -
zb_system下的function和lib目录只需读取权限，禁止开放写入
权限设错会导致安装时提示“无法创建缓存文件”或“主题无法启用”。
通过浏览器访问安装向导并正确填写数据库配置
启动 Apache 和 MySQL 后，在浏览器中输入 http://localhost/zblog/（假设放在 htdocs/zblog），页面会自动跳转至 install.php。这里容易出错的是数据库连接参数：
-
数据库地址填127.0.0.1（不推荐填localhost，某些 MySQL 配置下会走 socket 而非 TCP，导致连接超时） -
数据库名可新建一个空库（如zblog），用 phpMyAdmin 创建时字符集选utf8mb4_unicode_ci，避免 emoji 和生僻字乱码 -
用户名和密码默认是 XAMPP 的root/ 空（不是admin或其他）；若你改过 MySQL 密码，请如实填写
填完点“下一步”，如果卡在“正在检测环境”，大概率是 mysqli 扩展未启用——打开 php.ini（XAMPP 安装路径下的 \php\php.ini），确认 extension=mysqli 这一行前面没有分号 ;，改完重启 Apache。
安装完成后立即修改 admin 路径并禁用 install.php
Z-Blog PHP 默认后台入口是 /zb_system/login.php，但安装包里留着 install.php 是重大安全隐患。安装成功后第一件事就是删除或重命名它：
- 进入
htdocs/zblog/目录，删掉install.php（或改名为install.php.bak） - 登录后台后，立刻去「网站设置 → 系统设置 → 安全设置」中修改
后台管理路径，比如改成myadmin，这样真实后台地址就变成/myadmin/，防止暴力扫描
别忽略这步：很多本地测试环境后期暴露在局域网甚至公网，install.php 一旦被访问就会重跑安装流程，覆盖现有数据；默认后台路径也常被自动化脚本爆破。
php免费学习视频：立即使用
踏上前端学习之旅，开启通往精通之路！从前端基础到项目实战，循序渐进，一步一个脚印，迈向巅峰！
