Z-Blog PHP 常见问题技术文档

从安装到运维的完整排障指南（20页完整版）

本文档包含10个主要章节和3个附录，涵盖安装部署、数据库、登录、伪静态、主题插件、权限、性能、安全、迁移等常见问题及解决方案。

1.1 数据库连接错误（Error-4）

核对数据库配置信息：

// zb_users/c_option.php 或 config.php
define('DB_HOST', 'localhost');
define('DB_NAME', 'zblog_db');
define('DB_USER', 'zblog_user');
define('DB_PWD', 'your_password');

1.2 目录无写入权限

# Linux
chmod -R 755 /path/to/zblog
chmod -R 777 /path/to/zblog/zb_users
chown -R www-data:www-data /path/to/zblog

2.1 突然提示数据库连接错误

sudo systemctl status mysql
mysql -u root -p -e "SHOW STATUS LIKE 'Threads_connected';"
df -h

2.2 数据库表损坏

REPAIR TABLE zbp_posts;
OPTIMIZE TABLE zbp_posts;
mysqldump -u zblog_user -p zblog_db > backup.sql

3.1 升级后提示"非法访问"

1.7.3.3260+版本增加了CSRF保护，临时关闭方法：

'ZC_LOGIN_CSRFCHECK_ENABLE' => false,
'ZC_LOGIN_VERIFY_ENABLE' => false,

⚠️ 修复后务必恢复为true！

3.2 忘记管理员密码

UPDATE zbp_member 
SET mem_Password = MD5('123456') 
WHERE mem_ID = 1;

4.1 启用伪静态后404

Apache: 确认 AllowOverride All 并启用rewrite模块

Nginx配置:

location / {
    if (-f $request_filename/index.html) {
        rewrite (.*) $1/index.html break;
    }
    if (-f $request_filename/index.php) {
        rewrite (.*) $1/index.php;
    }
    if (!-f $request_filename) {
        rewrite (.*) /index.php;
    }
}

5.1 授权文件非法

1. 应用中心 → 登录购买账号
2. 检查DNS是否拦截 zblogcn.com
3. 离线环境联系作者获取授权

5.6 修改主题未生效

1. 后台 → 清空缓存并重新编译模板
2. 刷新CDN缓存
3. Ctrl+F5强制刷新

7.1 网站速度慢

1. 开启Gzip压缩（后台 → 全局设置）
2. 启用OPcache
3. 安装"可乐-超级缓存"插件
4. 使用CDN加速

8.1 暴力破解防护

• 安装"登录安全防护"插件
• 启用CSRF和验证码
• 使用fail2ban拦截恶意IP

8.2 网站被挂马

# 查找近期修改文件
find /path/to/zblog -type f -mtime -7

应急：备份→删异常→更新系统→改密码

9.2 跨服务器迁移（7步法）

1. 备份数据：导出数据库 + 打包网站
2. 导入数据库：新服务器创建并导入SQL
3. 修改配置：更新 config.php
4. 调整域名：更新 c_option.php
5. 权限修复：按第6章设置权限
6. 伪静态配置：根据新环境配置
7. 清空缓存：删除 zb_users/cache/

10.5 开启Debug模式

'ZC_DEBUG_MODE' => true,

查看页面源码末尾注释或 zb_users/logs/ 错误日志

📎 附录A：关键配置文件

• config.php - 数据库连接（高风险）
• c_option.php - 全局选项（中风险）
• cache/ - 编译缓存（可清空）
• logs/ - 错误日志（可清理）

📎 附录B：常用命令

php -v
php -m | grep -E 'mysqli|gd|curl'
systemctl status mysql
tail -f /var/log/nginx/error.log
find /var/www/zblog -type f -mtime -1

📎 附录C：官方资源

• 官方论坛：https://bbs.zblogcn.com/
• 应用中心：https://app.zblogcn.com/
• GitHub：https://github.com/zblogcn/zblogphp