Việc cài đặt hoặc cập nhật plugin là thao tác thiết yếu để mở rộng tính năng và bảo mật cho website WordPress. Tuy nhiên, quá trình này đôi khi bị gián đoạn bởi các lỗi phổ biến như “Could not create directory”, “Download failed”, hoặc yêu cầu thông tin FTP đột ngột. Bài viết này sẽ phân tích chi tiết nguyên nhân và cung cấp các bước hướng dẫn khắc phục triệt để những sự cố đó, giúp bạn nhanh chóng quản lý plugin trên trang web của mình một cách hiệu quả và suôn sẻ.
Nguyên nhân gây lỗi khi cài/update plugin WordPress
Thông thường, lỗi không cài đặt hoặc cập nhật hay điều chỉnh Plugin trong WordPress xuất phát từ các vấn đề liên quan đến:
- Cấu hình chặn upload, điều chỉnh plugin (Security Configuration): Một số cấu hình bảo mật nâng cao được thiết lập trong file wp-config.php có thể vô tình ngăn cản quá trình cài đặt hoặc cập nhật Plugin.
- Giới hạn bộ nhớ PHP (PHP Memory Limit): Bộ nhớ RAM cấp phát cho PHP quá thấp (thường dưới 128MB) không đủ để xử lý việc giải nén và cài đặt/cập nhật Plugin.
- Thời gian thực thi tối đa (Max Execution Time): Quá trình tải lên/cập nhật Plugin mất quá nhiều thời gian, vượt quá giới hạn thời gian thực thi của PHP (thường là 30-60 giây) khiến quá trình bị hủy.
- Giới hạn kích thước tải lên (Upload Max Filesize): Kích thước file Plugin bạn đang cố gắng tải lên vượt quá giới hạn cho phép của máy chủ.
- Lỗi phân quyền thư mục (File Permission): Ở trang quản trị WordPress, không có quyền ghi/sửa file trong thư mục wp-content/plugins, thường do sử dụng quyền không chính xác, ví dụ: 644 hoặc 755.
- Yêu cầu thông tin FTP/SFTP: Lỗi này xảy ra khi website WordPress không tự xác định được quyền ghi file của tài khoản Web Server, buộc phải yêu cầu thông tin FTP để thực hiện thay đổi.
Hướng dẫn khắc phục các lỗi khi cài và update plugin
Cách 1: Tắt cấu hình chặn cài đặt/điều chỉnh/cập nhật plugin/themes (Phổ biến nhất)
Cách 2: Tăng giới hạn tài nguyên PHP
Cách 3: Kiểm tra và khôi phục phân quyền thư mục (File Permissions)
Cách 4: Khắc phục lỗi yêu cầu thông tin FTP/SFTP
Cách 1: Tắt cấu hình chặn cài đặt/điều chỉnh/cập nhật plugin/themes (Phổ biến nhất)
Một trong những nguyên nhân phổ biến nhất khiến bạn không thể cài đặt, cập nhật hoặc chỉnh sửa Plugin/Theme là do các hằng số bảo mật đã được thiết lập trong file wp-config.php để ngăn chặn mọi hoạt động sửa đổi file (File Modifications).
Để xử lý, bạn cần truy cập vào máy chủ của website thông qua trình Quản lý Tệp (File Manager) trên control panel cPanel, DirectAdmin, aaPanel,… một phần mềm FTP chuyên dụng như FileZilla, hoặc kết nối trực tiếp qua giao thức SSH.
Thao tác trên tệp wp-config.php:
Tìm đến các dòng lệnh định nghĩa hằng số liên quan.
define( 'DISALLOW_FILE_MODS', true );
define( 'DISALLOW_FILE_EDIT', true );
define('AUTOMATIC_UPDATER_DISABLED', true);
define('WP_AUTO_UPDATE_CORE', false);Vô hiệu hóa chúng bằng cách thay đổi giá trị, xóa hoặc chuyển thành chú thích (comment out), sau đó lưu lại các thay đổi.
define( 'DISALLOW_FILE_MODS', false );
define( 'DISALLOW_FILE_EDIT', false );
define('AUTOMATIC_UPDATER_DISABLED', false);Giải thích ý nghĩa của các thông số:
| Biến | true (Chặn) | false (Cho phép) | minor | Dùng khi nào? | Gợi ý môi trường |
| DISALLOW_FILE_MODS | Chặn cài đặt /update/xóa plugin & theme | Cho phép cài/update/xóa | — | true → Production hoàn thiện false → Dev, thử plugin | Production: true Dev: false |
| DISALLOW_FILE_EDIT | Chặn sửa file trong wp-admin | Cho phép mở Theme/Plugin Editor | — | true → Chống hack false → Debug nhanh | Production: true Dev: false |
| AUTOMATIC_UPDATER_DISABLED | Tắt hết auto-update | Bật auto-update (core + plugin + theme) | — | true → Kiểm soát 100% false → Vá lỗi tự động | Production: true Staging: Hướngfalse |
| WP_AUTO_UPDATE_CORE | — | Tắt update core | Chỉ update bản nhỏ | true → Luôn mới nhất ‘minor’ → An toàn nhất false → Chặn hoàn toàn | Production: ‘minor’ Dev: true |
Cách 2: Tăng giới hạn tài nguyên PHP
Bạn có thể tăng giới hạn này thông qua file cấu hình wp-config.php, file .htaccess, hoặc file php.ini.
1. Tăng bộ nhớ PHP (PHP Memory Limit)
Cách này giúp bạn khắc phục các sự cố do thiếu hụt bộ nhớ, thường phát sinh khi hệ thống giải nén hoặc xử lý các plugin có dung lượng lớn.
Đầu tiên bạn truy cập vào thư mục gốc đường dẫn chứa source code WordPress và chỉnh sửa file wp-config.php
- Nếu bạn nhận thấy dòng code liên quan tới: WP_MEMORY_LIMIT hoặc WP_MAX_MEMORY_LIMIT đã tồn tại, bạn cần điều chỉnh lên cao hơn.
- Nếu bạn không tìm thấy code liên quan tới: WP_MEMORY_LIMIT hoặc WP_MAX_MEMORY_LIMIT bạn thêm dòng code:
define('WP_MEMORY_LIMIT', '1024M' );
define('WP_MAX_MEMORY_LIMIT', '1024M');2. Tăng Thời gian thực thi và kích thước tải lên
Để khắc phục sự cố hết thời gian chờ (timeout) trong quá trình xử lý và các lỗi phát sinh do kích thước tệp tải lên vượt quá giới hạn cho phép. bạn có thể thêm hoặc chỉnh sửa các giá trị sau vào file .htaccess (trong thư mục gốc):
php_value upload_max_filesize 64M
php_value post_max_size 64M
php_value max_execution_time 300
php_value max_input_time 300
Lưu ý
- Nếu dùng cPanel hoặc DirectAdmin, bạn nên chỉnh các giá trị này trực tiếp trong giao diện Select PHP Version hoặc MultiPHP INI Editor để đảm bảo hiệu quả.
- Với dịch vụ hosting cPanel, các thông số mặc định đều đang được đặt rất cao ở mọi phiên bản php, bạn sẽ không cần phải điều chỉnh lại các thông số này.
Cách 3: Kiểm tra và khôi phục phân quyền thư mục (File Permissions)
Phân quyền không chính xác là nguyên nhân phổ biến gây ra lỗi, khiến website WordPress của bạn không thể cài đặt hoặc cập nhật.
Bạn cần truy cập vào máy chủ chứa website thông qua một trong các phương thức sau: giao diện Quản lý Tệp (File Manager) của control pane, ví dụ: cPanel, DirectAdmin, aaPanel,… trình quản lý tệp qua giao thức FTP (ví dụ: FileZilla), hoặc kết nối SSH.
Điều chỉnh lại quyền truy cập theo đúng chuẩn sau:
- Thư mục (Folders): Thiết lập quyền là 755 (Người sở hữu có quyền đọc, ghi, thực thi; Nhóm và những người dùng khác chỉ có quyền đọc và thực thi).
- Tệp tin (Files): Thiết lập quyền là 644 (Người sở hữu có quyền đọc và ghi; Nhóm và những người dùng khác chỉ có quyền đọc).
Bạn có thể thực hiện việc phân quyền này thông qua:
Terminal (sử dụng dòng lệnh): Kết nối SSH và thực thi các lệnh sau tại thư mục gốc của website:
find ./ -type d -exec chmod 755 {} \;
find ./ -type f -exec chmod 644 {} \;
Giao diện File Manager: Sử dụng chức năng thay đổi quyền thường được đặt tên là “Change Permissions” có sẵn trong trình quản lý tệp.
Lưu ý: Cần đảm bảo quyền 755 được áp dụng một cách đệ quy cho tất cả các thư mục, bao gồm cả wp-content và các thư mục con bên trong nó như wp-content/plugins.
Cách 4: Khắc phục lỗi yêu cầu thông tin FTP/SFTP
Lỗi này phát sinh khi WordPress không thể tự động xác định được phương thức phù hợp để ghi tệp trên máy chủ. Để khắc phục, bạn có thể cấu hình tường minh để WordPress bắt buộc sử dụng phương thức truy cập hệ thống tệp trực tiếp (Direct).
Để thực hiện việc này, bạn cần truy cập vào máy chủ chứa website thông qua một trong các công cụ sau: giao diện Quản lý Tệp (File Manager) của control panel (ví dụ: cPanel, DirectAdmin, aaPanel,… trình quản lý tệp qua giao thức FTP (ví dụ: FileZilla), hoặc kết nối SSH.
Thực hiện trong tệp wp-config.php:
- Tìm đến dòng mã định nghĩa hằng số FS_METHOD.
- Tiến hành vô hiệu hóa (comment out), xóa bỏ, hoặc điều chỉnh lại dòng mã này để đảm bảo WordPress được cấu hình sử dụng phương thức direct. Ví dụ, dòng mã sau khi điều chỉnh nên có dạng:
define( 'FS_METHOD', 'direct' ); Kiểm tra kết quả
Sau khi thực hiện một hoặc nhiều giải pháp trên, bạn quay lại khu vực Plugins trên Dashboard WordPress và thử cài đặt hoặc cập nhật lại plugin. Nếu quá trình thành công và không còn thông báo lỗi, vấn đề đã được khắc phục.
Tình trạng không thể cài đặt hoặc cập nhật Plugin trong WordPress là một sự cố thường gặp, nguyên nhân chủ yếu bắt nguồn từ các giới hạn về tài nguyên hệ thống và cấu hình bảo mật được thiết lập quá nghiêm ngặt trên môi trường máy chủ. Bằng việc thực hiện các điều chỉnh cần thiết, bạn đã thành công gỡ bỏ những trở ngại kỹ thuật, qua đó khôi phục toàn vẹn khả năng quản trị và mở rộng chức năng cho website của mình.
Việc đảm bảo hệ thống được cung cấp đủ tài nguyên PHP và cho phép các thao tác sửa đổi tệp tin cần thiết không chỉ giúp bạn xử lý triệt để sự cố hiện tại, mà còn nâng cao tính linh hoạt và khả năng bảo trì cho trang WordPress. Giờ đây, bạn có thể dễ dàng thực hiện cập nhật các plugin quan trọng, nhằm đảm bảo website vận hành ổn định và được bảo vệ an toàn trước các rủi ro bảo mật tiềm ẩn. Trong quá trình thao tác nếu còn vấn đề cần giải đáp bạn có thể liên hệ Vietnix để được hỗ trợ kịp thời.
VIETNIX – DỊCH VỤ HOSTING, VPS TỐC ĐỘ CAO, ỔN ĐỊNH, BẢO MẬT
- Địa chỉ: 265 Hồng Lạc, Phường Bảy Hiền, Thành Phố Hồ Chí Minh
- Điện thoại: 1800 1093
- Email liên hệ: sales@vietnix.com.vn
- Website: https://vietnix.vn/
