Error log(错误日志)会记录您网站上发生的问题,包括PHP错误、数据库连接失败以及插件问题。当您的网站出现故障时,错误日志通常是找出原因最快的方法。
通过文件管理器或SFTP访问日志
KPanel没有专门的日志(Logs)选项卡。日志文件存储在服务器上,可以通过文件管理器或SFTP进行访问。
使用文件管理器:
- 登录KPanel,网址为kpanel.kapsulehost.com
- 进入网站(Websites),选择受影响的网站
- 点击设置(Settings)→ 文件管理器(File Manager)
- 导航至您网站根目录下的
logs/目录
使用SFTP:
- 在KPanel中进入设置(Settings)→ SFTP,查看您网站的连接详情
- 使用FileZilla或您偏好的SFTP客户端进行连接
- 导航至您网站根目录下的
logs/目录
logs/目录包含以下内容:
- PHP错误日志,由PHP代码产生的错误(最常需要查看的日志)
- 访问日志,记录对您网站的所有HTTP请求
- 错误日志,服务器级别的错误(500、502等)
读取PHP错误日志
一条典型的PHP错误日志条目如下所示:
[03-Jun-2026 14:32:11 UTC] PHP Fatal error: Call to undefined function get_header() in /var/www/sites/yourdomain/public_html/wp-content/themes/mytheme/page.php on line 8
其中包含日期和时间、错误类型、问题的描述,以及错误发生的文件路径和行号。
常见错误类型
| 类型 | 严重程度 | 含义 |
|---|---|---|
| 致命错误(Fatal error) | 高 | 执行已停止。页面将无法加载。 |
| 警告(Warning) | 中 | 发生了意外情况,但执行仍继续进行。 |
| 提示(Notice) | 低 | 轻微问题,通常是违反了编码最佳实践。 |
| 弃用(Deprecated) | 低 | 所使用的某个函数将在未来的PHP版本中被移除。 |
启用WordPress调试模式
对于WordPress网站,启用调试模式可以输出更详细的错误信息:
- 通过SFTP连接,或使用KPanel中的文件管理器
- 打开WordPress根目录下的
wp-config.php - 添加或更新以下几行内容:
define( 'WP_DEBUG', true );
define( 'WP_DEBUG_LOG', true );
define( 'WP_DEBUG_DISPLAY', false );
错误信息将被写入wp-content/debug.log,而不会显示在屏幕上。
请勿在正式运行的网站上将WP_DEBUG_DISPLAY设置为true,因为这可能会向访问者暴露敏感信息。
请在更新WordPress、插件或主题后立即检查错误日志。许多更新后出现的问题都会在PHP错误日志中留下明显的痕迹。