Sửa lỗi Syntax Error trong WordPress nhanh, đúng cách

Syntax Error là lỗi thường gặp khi chỉnh sửa mã nguồn website, thêm code vào WordPress, cập nhật plugin, sửa theme hoặc viết chương trình bằng PHP, Python, JavaScript. Lỗi này có thể khiến website hiển thị cảnh báo, trắng trang hoặc không truy cập được trang quản trị.

Tin tốt là lỗi Syntax Error thường không quá khó sửa nếu bạn biết đọc thông báo lỗi và xác định đúng file gây lỗi. Bài viết này sẽ hướng dẫn bạn cách sửa lỗi syntax error theo từng bước, đặc biệt trong môi trường WordPress và hosting.

Cách sửa lỗi Syntax Error trong WordPress

Nếu website WordPress bị lỗi sau khi bạn thêm code, sửa theme hoặc cập nhật plugin, hãy làm theo thứ tự dưới đây. Không nên sửa ngẫu nhiên vì có thể làm lỗi nặng hơn.

Bước 1: Sao lưu trước khi chỉnh sửa

Trước khi sửa bất kỳ file nào, hãy sao lưu file gốc hoặc toàn bộ website. Bạn có thể sao lưu bằng:

• File Manager trong cPanel hoặc DirectAdmin.
• FTP Client như FileZilla.
• Plugin backup nếu vẫn vào được WordPress Admin.
• Bản backup tự động từ nhà cung cấp hosting.

Nếu sửa sai, bạn có thể khôi phục lại file ban đầu nhanh hơn.

Bước 2: Xác định thay đổi gần nhất

Hãy nhớ lại thao tác cuối cùng trước khi lỗi xuất hiện:

• Bạn vừa thêm code vào functions.php?
• Bạn vừa sửa file theme?
• Bạn vừa cập nhật plugin?
• Bạn vừa đổi phiên bản PHP?
• Bạn vừa copy code từ website khác?
• Bạn vừa cài plugin mới?

Nếu lỗi xuất hiện ngay sau một thao tác cụ thể, khả năng cao nguyên nhân nằm ở thao tác đó. Đây là cách khoanh vùng nhanh nhất.

Bước 3: Sửa lỗi bằng File Manager trên hosting

Nếu không vào được WordPress Admin, bạn có thể sửa trực tiếp qua File Manager.

Cách làm:

1. Đăng nhập cPanel, DirectAdmin hoặc trang quản trị hosting.
2. Mở mục File Manager.
3. Vào thư mục public_html.
4. Tìm file được báo trong thông báo lỗi.
5. Tải file về máy để sao lưu.
6. Mở file và kiểm tra dòng được báo lỗi.
7. Sửa lại cú pháp sai hoặc xóa đoạn code vừa thêm.
8. Lưu file.
9. Tải lại website để kiểm tra.

Ví dụ, nếu lỗi báo:

/wp-content/themes/my-theme/functions.php on line 52

Bạn cần vào:

public_html/wp-content/themes/my-theme/functions.php

Sau đó kiểm tra dòng 52 và các dòng phía trên.

Bước 4: Sửa lỗi bằng FTP

Nếu không dùng File Manager, bạn có thể sửa bằng FTP.

Các bước thực hiện:

1. Mở phần mềm FTP như FileZilla.
2. Kết nối hosting bằng host, username, password và port.
3. Vào thư mục public_html.
4. Mở đúng đường dẫn file được báo lỗi.
5. Tải file về máy tính.
6. Mở bằng VS Code, Sublime Text hoặc Notepad++.
7. Sửa lỗi cú pháp.
8. Upload lại file đã sửa lên đúng vị trí cũ.
9. Tải lại website để kiểm tra.

FTP hữu ích khi bạn bị khóa khỏi trang quản trị WordPress sau khi sửa code trong Theme File Editor.

Bước 5: Kiểm tra các lỗi cú pháp PHP phổ biến

Khi mở file, hãy kiểm tra các lỗi sau:

Thiếu dấu chấm phẩy:

echo “Xin chào”

Sửa thành:

echo “Xin chào”;

Thiếu dấu đóng ngoặc:

if ($user_logged_in) {

    echo “Đã đăng nhập”;

Sửa thành:

if ($user_logged_in) {

    echo “Đã đăng nhập”;

}

Sai cấu trúc if…else:

if ($price > 0) {

    echo “Có giá”;

else {

    echo “Chưa có giá”;

}

Sửa thành:

if ($price > 0) {

    echo “Có giá”;

} else {

    echo “Chưa có giá”;

}

Thiếu dấu nháy:

$title = “Sửa lỗi Syntax Error;

Sửa thành:

$title = “Sửa lỗi Syntax Error”;

Dùng sai dấu nháy khi copy code:

echo “Hello World”;

Sửa thành:

echo “Hello World”;

Một số trình soạn thảo tự động đổi dấu nháy thẳng thành dấu nháy cong. PHP không hiểu kiểu dấu nháy này, nên bạn cần kiểm tra kỹ khi copy code từ Word, Google Docs hoặc bài viết trên mạng.

Bước 6: Vô hiệu hóa plugin gây lỗi

Nếu lỗi xuất hiện sau khi cài hoặc cập nhật plugin, hãy vô hiệu hóa plugin đó.

Nếu vẫn vào được WordPress Admin:

1. Vào Plugins.
2. Tìm plugin vừa cập nhật hoặc vừa cài.
3. Chọn Deactivate.
4. Kiểm tra lại website.

Nếu không vào được Admin:

1. Vào File Manager hoặc FTP.
2. Mở thư mục wp-content/plugins.
3. Đổi tên thư mục plugin nghi ngờ.
4. Tải lại website.

Ví dụ:

wp-content/plugins/plugin-demo

Đổi thành:

wp-content/plugins/plugin-demo-disabled

WordPress sẽ tự vô hiệu hóa plugin đó.

Bước 7: Chuyển theme về theme mặc định

Nếu lỗi nằm trong theme, đặc biệt là file functions.php, bạn có thể tạm thời đổi theme.

Cách làm đơn giản:

1. Vào wp-content/themes.
2. Đổi tên thư mục theme đang dùng.
3. WordPress sẽ không tìm thấy theme hiện tại.
4. Hệ thống có thể chuyển về theme mặc định nếu theme mặc định còn tồn tại.

Cách này phù hợp khi website bị trắng trang do theme lỗi và bạn không thể đăng nhập Admin.

Bước 8: Bật WP_DEBUG để tìm lỗi chính xác hơn

Nếu website chỉ hiển thị lỗi chung chung, bạn có thể bật chế độ debug của WordPress.

Mở file wp-config.php, tìm dòng:

define( ‘WP_DEBUG’, false );

Đổi thành:

define( ‘WP_DEBUG’, true );

Bạn cũng có thể ghi lỗi vào file log bằng cách thêm:

define( ‘WP_DEBUG_LOG’, true );

define( ‘WP_DEBUG_DISPLAY’, false );

Sau đó kiểm tra file:

wp-content/debug.log

Lưu ý: Không nên bật hiển thị lỗi công khai trên website thật quá lâu vì thông báo lỗi có thể lộ đường dẫn file và thông tin kỹ thuật. Sau khi sửa xong, hãy tắt debug.

Bước 9: Khôi phục backup nếu không xác định được lỗi

Nếu bạn không biết file nào bị lỗi hoặc đã sửa nhiều lần nhưng website vẫn lỗi, hãy khôi phục bản sao lưu gần nhất.

Nên ưu tiên bản backup trước thời điểm lỗi xuất hiện. Sau khi website hoạt động lại, hãy kiểm tra từng thay đổi một thay vì thêm lại toàn bộ code cùng lúc.

Câu hỏi thường gặp về lỗi Syntax Error

Syntax Error có nguy hiểm không?

Syntax Error không phải lúc nào cũng nguy hiểm về bảo mật, nhưng có thể khiến website ngừng hoạt động. Nếu lỗi làm lộ đường dẫn file hoặc thông tin máy chủ, bạn cần xử lý sớm và tắt hiển thị lỗi công khai sau khi sửa xong.

Vì sao sửa đúng dòng báo lỗi nhưng website vẫn lỗi?

Vì dòng báo lỗi không phải lúc nào cũng là dòng sai thật sự. Lỗi có thể nằm ở dòng phía trên, đặc biệt khi thiếu dấu ngoặc, dấu nháy hoặc dấu chấm phẩy.

Có thể sửa Syntax Error mà không cần vào WordPress Admin không?

Có. Bạn có thể sửa bằng File Manager trong hosting hoặc bằng FTP. Đây là cách phổ biến khi lỗi khiến bạn không đăng nhập được vào trang quản trị WordPress.

Có nên sửa trực tiếp file functions.php không?

Không nên nếu bạn chưa có backup. File functions.php rất nhạy cảm. Chỉ một lỗi nhỏ cũng có thể khiến website sập. Nếu cần thêm code, nên dùng child theme hoặc plugin quản lý snippet.

Syntax Error khác Runtime Error như thế nào?

Syntax Error xảy ra khi cú pháp code sai, khiến chương trình không thể chạy. Runtime Error xảy ra trong lúc chương trình đang chạy, dù cú pháp có thể đúng.

Sửa lỗi Syntax Error không khó nếu bạn xử lý đúng quy trình: đọc thông báo lỗi, xác định file và dòng lỗi, kiểm tra thay đổi gần nhất, sao lưu file, sửa cú pháp và kiểm tra lại website. Với WordPress, lỗi này thường xuất hiện sau khi thêm code vào functions.php, cập nhật plugin, sửa theme hoặc upload file bị lỗi.

Nếu website của bạn đang hoạt động kinh doanh, hãy ưu tiên an toàn: sao lưu trước khi sửa, không chỉnh sửa ngẫu nhiên và liên hệ kỹ thuật hosting khi không chắc nguyên nhân. Cách làm đúng sẽ giúp bạn khôi phục website nhanh hơn và tránh lặp lại lỗi syntax error trong tương lai.