---
url: https://docs.zblogcn.com/php/start-faq.md
description: >-
  汇总 Z-BlogPHP 使用中的常见问题与处理方法，包括密码重置、固定域名设置、Debug 调试模式、用户等级、Emoji
  支持、错误日志查看及后台登录故障排查。
---

# 常见问题

本篇汇总 Z-BlogPHP 使用中的常见问题与处理方法，包括密码重置、固定域名设置、Debug 调试模式、错误日志查看及后台登录故障排查。

## 密码重置

Z-BlogPHP 密码找回工具：

下载地址：[https://update.zblogcn.com/tools/nologin.zip](https://update.zblogcn.com/tools/nologin.zip "Z-BlogPHP密码找回工具-程序发布-ZBlogger技术交流中心")

使用方法：在本地解压后，通过 FTP 将 `nologin.php` 上传到 Z-BlogPHP 根目录，在浏览器中打开该文件，选择管理员登录或将密码重置为 `12345678`；操作执行后工具会自动删除自身。

> **安全提醒：** 自删仅在点击「登录」或「重置密码」后触发，只打开页面不会删除；若因文件权限导致自删失败，请立即通过 FTP 手动删除。重置后请尽快登录后台修改密码。

有终端权限的空间，也可直接用命令下载并改成随机文件名，避免文件名被扫描器猜中：

```bash
# 下载
wget https://update.zblogcn.com/tools/nologin.zip

# 提取并直接改名为随机文件名（一步完成）
unzip -p nologin.zip nologin.php > "nologin-$(date +%m%d%H%M).php"

# 查看文件名，在浏览器中访问该文件即可
ls -1 nologin-*.php
```

## 开启固定域名功能

* 使用空间面板的文件管理或者 FTP 修改文件：`path/zb_users/c_option.php`；
* 配置项：
  ```php
  'ZC_PERMANENT_DOMAIN_FORCED_URL' => "https://www.newdomin.site/",
  ```

> path：当前博客程序所放置的路径，比如`/home/wwwroot/www.zblogcn.com`；

**注：如果是 1.6.0 之前的版本，请覆盖 1.6.0 及之后的程序包（`zb_system`）。**

**注 2：ZC_PERMANENT_DOMAIN_FORCED_URL 的意义为 强制开启固定域名功能并直接指定域名为固定域名**

「- -」「- -」「- -」「- -」「- -」

## 固定域名出错不能登入

* 使用空间面板的文件管理或者 FTP 修改文件：`path/zb_users/c_option.php`；

* 如果是固定域名出错，需要关闭固定域名功能，请在 c_option.php**增加**项目：

  ```php
  'ZC_PERMANENT_DOMAIN_ENABLE' => false, //1.7.3版本及以后版本使用

  //或是
  'ZC_PERMANENT_DOMAIN_WHOLE_DISABLE' => true, //1.7.2及以下版本使用
  ```

  如果是设置了 ZC_PERMANENT_DOMAIN_FORCED_URL 项目强制开启固定域名功能的，请删除   ~~ZC_PERMANENT_DOMAIN_FORCED_URL => 'domain',~~ 这一行配置

  这样就会跳过固定域名功能，然后访问正确的域名进网站

* 如果之前配置的固定域名不能访问，需要更改为正确的域名
  ```php
  #
  'ZC_PERMANENT_DOMAIN_FORCED_URL' => "https://更正的域名/",
  #如果你不希望再用固定域名，那就在option.php里删除这一行
  ```

> path：当前博客程序所放置的路径，比如`/home/wwwroot/www.zblogcn.com`；

**注：如果是 1.6.0 之前的版本，请先升级到 1.6.0**

「- -」「- -」「- -」「- -」「- -」

## 强制开启 Debug 调试模式

常规开启调试模式是在后台设置中进行，在后台设置的全局设置里打开“调试模式”并保存即可。

如果网站程序出错，不能进入后台进行设置，那么在 1.7.3 及更高版本可以在这样设置：

使用空间面板的文件管理或者 FTP 修改文件：`path/zb_users/c_option.php`；

```php
 'ZC_DEBUG_MODE' => true, //开启Debug，如果调试完毕请删除这一行
```

> path：当前博客程序所放置的路径，比如`/home/wwwroot/www.zblogcn.com`；

1.7.2 版本可以修改`zb_system\function\c_system_base.php`，取消第 22 行代码的注释状态后保存；

```php
// defined('ZBP_DEBUGMODE') || define('ZBP_DEBUGMODE', true);
// 修改为 ↓↓
defined('ZBP_DEBUGMODE') || define('ZBP_DEBUGMODE', true);
```

「- -」「- -」「- -」「- -」「- -」

## 用户等级划定

```php
'user_level_name' => array(
    '1' => '管理员',
    '2' => '网站编辑',
    '3' => '作者',
    '4' => '协作者',
    '5' => '评论者',
    '6' => '游客',
),

```

「- -」「- -」「- -」「- -」「- -」

## Emoji 表情支持

对于 MySQL ，其`utf8`并非标准的`UTF-8`。在 `5.5.3` 之后新增了`utf8mb4`来解决这个问题；

「Z-BlogPHP 1.7.0」起将默认使用`utf8mb4`编码创建数据表；

对于现有数据库，可按如下操作进行修改：

> 1. 进入「`phpMyAdmin`」或其他数据库管理工具；
> 2. 选择相应数据库，（默认为「`结构`」视图）；
> 3. 点击「`操作`」选项卡，更改「`排序规则`」为`utf8mb4_general_ci`；
> 4. 点击「`执行`」即可应用到所有表和所有表列字段！

「- -」「- -」「- -」「- -」「- -」

## 隐藏的错误查看

即使开启调试模式，有些错误也不会在页面内抛出；

默认情况下，前后台的页面源码的结尾会有如下样式的注释，

```html
<!--193.14 ms , 7 queries , 4042kb memory , 0 error-->

<!--109.38 ms , 6 queries , 1561kb memory , 6 errors-->
```

具体错误（如果不为 0 时）记录在：`zb_users\logs\`文件夹内；

该文件夹内的文件可直接清空，然后重复访问操作重新记录最新日志以方便排查；

「- -」「- -」「- -」「- -」「- -」

## 取消 root 级管理员的 root 权限

root 级管理员拥有系统最高权限，可以上传应用，导出应用，删除应用和更新系统

取消 root 级管理员的 root 权限后将不能安装新应用，删除应用，导出应用和更新系统

* 启用`应用中心客户端`的安全模式

禁止上传安装新应用及导出应用和系统更新，这是最简单和快捷的方式

* 取消 root 级管理员的 root 权限

在 「Z-BlogPHP 1.7.3」及更高版本，可以使用 .env 文件：

> 1. 在系统目录下放置 .env 文件，在其中加入代码

`ZBP_PRESET_DISABLE_ROOT=1`

在 「Z-BlogPHP 1.7.2」及更高版本，可以使用以下三种方法实现：

> 1. 修改 c_system_base.php，在其中加入代码

`define('ZBP_PRESET_DISABLE_ROOT', 1);`

> 2. 修改 php-fpm 的配置文件 conf，加入代码，并重启 php-fpm

`env[ZBP_PRESET_DISABLE_ROOT]=1`

> 3. 修改 nginx 的配置文件，在 `location ~ \.php$ {}` 加入代码，并重启 nginx

`fastcgi_param  ZBP_PRESET_DISABLE_ROOT  1;`

## 升级 1.7.3.3260 之后出现后台登录错误

升级 1.7.3.3260 之后出现后台登录错误（ **提示非法访问，验证码不显示，验证码报错** ）

这是因为 1.7.3.3260 增加了对后台登录的 2 个保护功能，因为主题插件的兼容性原因或其它原因造成功能不正常，可以在 option.php 里关掉 CSRF 保护功能或是验证码功能，或是 2 个都关闭

* 使用空间面板的文件管理或者 FTP 修改文件：`path/zb_users/c_option.php`；
* 配置项：
  ```php
  //关闭CSRF保护功能（出现非法访问请关闭）
  'ZC_LOGIN_CSRFCHECK_ENABLE' => false,
  //关闭验证码功能（出现验证码出错请关闭）
  'ZC_LOGIN_VERIFY_ENABLE'    => false,
  ```

> path：当前博客程序所放置的路径，比如`/home/wwwroot/www.zblogcn.com`；

**注：不建议长期关掉这 2 个功能，因为这 2 个功能可有效的防御被扫描破解账号的黑客事件，如果主题插件的兼容性问题已修复请恢复这 2 个功能**

**注 2：如果因为在后台开启安全增强功能导致进不了后台，可以按此方法进后台关闭安全增强功能，再回来删除这两项设置**

「- -」「- -」「- -」「- -」「- -」