cpanel-debug

Compare original and translation side by side

🇺🇸

Original

English

🇨🇳

Translation

Chinese

cPanel — Debug & Sửa lỗi

cPanel — 调试与故障修复

Quy trình chẩn đoán lỗi website trên hosting cPanel.

在cPanel主机上诊断网站故障的流程。

1. Đọc error log

1. 查看错误日志

bash

undefined

bash

undefined

Mặc định đọc public_html/error_log

默认查看public_html/error_log

cpanel log:errors

Đọc error_log của một subdir/addon domain

查看子目录/附加域名的error_log

cpanel log:errors public_html/newsite.com/error_log


Lỗi PHP thường ghi ở đây. Tìm dòng `PHP Fatal error`, `PHP Warning`, stack trace.

cpanel log:errors public_html/newsite.com/error_log


PHP错误通常记录在这里。查找`PHP Fatal error`、`PHP Warning`、堆栈跟踪信息。

2. Đọc file cấu hình / mã nguồn

2. 查看配置文件/源代码

bash

cpanel file:read public_html wp-config.php
cpanel file:read public_html/app/config app.php

bash

cpanel file:read public_html wp-config.php
cpanel file:read public_html/app/config app.php

3. Kiểm tra version & cấu hình PHP (escape hatch)

3. 检查PHP版本与配置（应急方案）

bash

undefined

bash

undefined

Liệt kê version PHP khả dụng và version đang dùng cho từng domain

列出可用的PHP版本以及每个域名当前使用的版本

cpanel uapi LangPHP php_get_vhost_versions cpanel uapi LangPHP php_get_installed_versions

Đổi version PHP cho một vhost

为虚拟主机更改PHP版本

cpanel uapi LangPHP php_set_vhost_versions vhost=example.com version=ea-php82


> Trên server CloudLinux, `php_get_installed_versions` có thể trả `alt-phpXX` trong khi
> vhost lại chạy `ea-phpXX`. Luôn chạy `php_get_vhost_versions` trước để biết đúng định
> dạng giá trị `version` mà server chấp nhận.

cpanel uapi LangPHP php_set_vhost_versions vhost=example.com version=ea-php82


> 在CloudLinux服务器上，`php_get_installed_versions`可能返回`alt-phpXX`，而虚拟主机实际运行的是`ea-phpXX`。请始终先运行`php_get_vhost_versions`以确认服务器接受的`version`参数格式。

4. Kiểm tra cron (tác vụ nền lỗi)

4. 检查定时任务（后台任务故障）

bash

cpanel cron:list                  # mỗi dòng có 'linekey'
cpanel cron:add 30 3 '*' '*' '*' 'php /home/u/cron.php'
cpanel cron:delete <linekey> --yes   # linekey lấy từ cron:list (cần --yes sau khi user đồng ý)

bash

cpanel cron:list                  # 每一行都有'linekey'
cpanel cron:add 30 3 '*' '*' '*' 'php /home/u/cron.php'
cpanel cron:delete <linekey> --yes   # linekey从cron:list获取（需用户同意后添加--yes）

Checklist chẩn đoán lỗi 500 / trang trắng

500错误/白屏故障诊断检查清单

```
log:errors
```
— đọc lỗi PHP gần nhất (đây là bước quan trọng nhất).
Nếu lỗi thiếu extension/sai version → kiểm tra & đổi version PHP (mục 3).
Nếu lỗi kết nối DB → kiểm tra credential trong file cấu hình (
```
file:read
```
) so với database thực tế (
```
cpanel db:list
```
).
Nếu lỗi permission/
```
.htaccess
```
→ đọc
```
.htaccess
```
qua
```
file:read
```
.
Lỗi memory/timeout → cân nhắc tăng giới hạn qua MultiPHP INI Editor:
```
cpanel uapi LangPHP php_ini_set_user_basic_directives ...
```

```
log:errors
```
— 查看最新的PHP错误（这是最重要的步骤）。
如果是缺少扩展/版本错误 → 检查并更改PHP版本（第3步）。
如果是数据库连接错误 → 查看配置文件中的凭证（
```
file:read
```
）并与实际数据库（
```
cpanel db:list
```
）对比。
如果是权限/
```
.htaccess
```
错误 → 通过
```
file:read
```
查看
```
.htaccess
```
文件。
内存/超时错误 → 考虑通过MultiPHP INI Editor提高限制：
```
cpanel uapi LangPHP php_ini_set_user_basic_directives ...
```

An toàn

安全注意事项

Đọc log/file là thao tác chỉ đọc — an toàn, cứ thực hiện để chẩn đoán.
Trước khi sửa file cấu hình hay đổi version PHP, mô tả thay đổi và xác nhận với người dùng. Backup file gốc trước khi ghi đè khi có thể.
Không in nội dung nhạy cảm (mật khẩu DB trong
```
wp-config.php
```
) ra ngoài một cách thừa thãi.

查看日志/文件是只读操作——安全可靠，可放心执行以进行诊断。
在修改配置文件或更改PHP版本之前，需向用户说明更改内容并获得确认。如有可能，修改前先备份原文件。
不要随意输出敏感内容（如
```
wp-config.php
```
中的数据库密码）。