NỘI DUNG
File .htaccess là file cấu hình riêng của Apache và LiteSpeed, đặt trong từng thư mục và áp dụng cho thư mục đó cùng các thư mục con. Với WordPress, file cấu hình .htaccess mặc định chỉ làm một việc chính: chuyển các đường dẫn đẹp về index.php để WordPress tự định tuyến.
Bài này dùng đúng 3 mẫu chuẩn từ tài liệu WordPress: WordPress thường, Multisite subfolder và Multisite subdomain. Kèm theo là cách sửa file trên cPanel, DirectAdmin và vài lỗi thường gặp.
Bạn chỉ cần copy đúng mẫu, không cần hiểu hết từng dòng mới dùng được. Phần giải thích bên dưới giúp bạn biết dòng nào làm gì để sửa đúng chỗ khi cần.
1. .htaccess là gì?
Khi Apache nhận một request, nó đọc file .htaccess trong thư mục được yêu cầu trước khi phục vụ nội dung. Nhờ đó bạn đổi được hành vi của server mà không cần sửa file cấu hình chính hay khởi động lại Apache.
Một lưu ý quan trọng: chỉ Apache và LiteSpeed đọc .htaccess. Nginx không dùng file này, nên nếu site chạy nginx thuần thì đoạn mã trong bài không có tác dụng.
File này có hiệu lực theo thư mục: đặt ở thư mục gốc thì áp cho toàn site, đặt trong thư mục con thì chỉ áp cho thư mục đó. WordPress chỉ dùng file ở thư mục gốc.
2. Cấu hình .htaccess mặc định trên WordPress
WordPress tự sinh đoạn mã cấu hình .htaccess này khi bạn lưu Permalink lần đầu. File nằm ở thư mục gốc của site, cùng cấp với wp-config.php. Nếu file chưa có hoặc server không ghi được, WordPress sẽ hiện mã để bạn copy tay.
# BEGIN WordPress
RewriteEngine On
RewriteRule .* - [E=HTTP_AUTHORIZATION:%{HTTP:Authorization}]
RewriteBase /
RewriteRule ^index\.php$ - [L]
RewriteCond %{REQUEST_FILENAME} !-f
RewriteCond %{REQUEST_FILENAME} !-d
RewriteRule . /index.php [L]
# END WordPressRewriteEngine On: bật module viết lại URL.RewriteRule .* - [E=HTTP_AUTHORIZATION:...]: giữ lại header Authorization cho REST API và các ứng dụng xác thực.RewriteBase /: đường dẫn gốc tính từ thư mục cài WordPress. Site nằm trong thư mục con thì đổi thành/thumuc/.RewriteRule ^index\.php$ - [L]: request thẳng tớiindex.phpthì giữ nguyên, không viết lại nữa.RewriteCond %{REQUEST_FILENAME} !-fvà!-d: chỉ viết lại khi request không phải file thật và không phải thư mục thật.RewriteRule . /index.php [L]: mọi request còn lại đều đưa vềindex.phpđể WordPress định tuyến theo permalink.
Khi cấu hình .htaccess, chỉ sửa ngoài cặp marker # BEGIN WordPress và # END WordPress. Mỗi lần lưu Permalink, WordPress ghi đè toàn bộ nội dung giữa hai marker này, mọi đoạn mã tự thêm vào giữa sẽ mất.
3. Multisite: 2 mẫu mặc định khác
Multisite dùng mẫu cấu hình .htaccess riêng tùy theo kiểu mạng. Chọn đúng một mẫu dưới đây, đừng trộn hai mẫu với nhau.
Multisite subfolder
Dùng khi site con có dạng domain.com/site1.
# BEGIN WordPress Multisite
# Using subfolder network type: https://wordpress.org/documentation/article/htaccess/#multisite
RewriteEngine On
RewriteBase /
RewriteRule ^index\.php$ - [L]
# uploaded files
RewriteRule ^([_0-9a-zA-Z-]+/)?files/(.+) wp-includes/ms-files.php?file=$2 [L]
# add a trailing slash to /wp-admin
RewriteRule ^([_0-9a-zA-Z-]+/)?wp-admin$ $1wp-admin/ [R=301,L]
RewriteCond %{REQUEST_FILENAME} -f [OR]
RewriteCond %{REQUEST_FILENAME} -d
RewriteRule ^ - [L]
RewriteRule ^[_0-9a-zA-Z-]+/(wp-(content|admin|includes).*) $1 [L]
RewriteRule ^[_0-9a-zA-Z-]+/(.*\.php)$ $1 [L]
RewriteRule . index.php [L]
# END WordPress MultisiteMultisite subdomain
Dùng khi site con có dạng site1.domain.com.
# BEGIN WordPress Multisite
# Using subdomain network type: https://wordpress.org/documentation/article/htaccess/#multisite
RewriteEngine On
RewriteBase /
RewriteRule ^index\.php$ - [L]
# uploaded files
RewriteRule ^files/(.+) wp-includes/ms-files.php?file=$1 [L]
RewriteCond %{REQUEST_FILENAME} -f [OR]
RewriteCond %{REQUEST_FILENAME} -d
RewriteRule ^ - [L]
RewriteRule . index.php [L]
# END WordPress Multisite4. Cách sửa file cấu hình .htaccess trên cPanel và DirectAdmin
File .htaccess là file ẩn nên trình quản lý file mặc định không hiện nó. Khi cấu hình .htaccess, bật hiện file ẩn trước rồi mới sửa. Nếu chưa biết mở file ở đâu, xem thêm 4 cách mở và sửa file .htaccess trên hosting và VPS.
- cPanel: mở File Manager, bấm Settings ở góc phải, tick Show Hidden Files (dotfiles), mở thư mục
public_html, chuột phải file.htaccessrồi Edit. - DirectAdmin: mở File Manager, vào thư mục
public_html(hoặc thư mục chứa site), bấm Edit ở file.htaccess. - Dán đúng mẫu cấu hình .htaccess ở trên, Save rồi tải lại site để kiểm tra.


5. Xử lý lỗi thường gặp
- Lỗi 500 sau khi cấu hình .htaccess: thường do sai cú pháp. Đổi tên file thành
.htaccess.bakđể site chạy lại ngay, rồi soát lại từng dòng vừa thêm. - Mất đường dẫn đẹp: lưu lại Permalink trong wp-admin để WordPress tái tạo đoạn mã mặc định.
- Quên sao lưu trước khi sửa: luôn copy file gốc thành
.htaccess.baktrước khi thay đổi để có đường lui. - Dùng nginx mà vẫn lỗi 404: nginx không đọc
.htaccess, thêm đoạn sau vào blocklocation /trong cấu hình nginx.
location / {
try_files $uri $uri/ /index.php?$args;
}Câu hỏi thường gặp
WordPress có tự tạo file .htaccess không?
Có, khi bạn lưu Permalink lần đầu và thư mục gốc ghi được. Nếu không ghi được, WordPress hiện đoạn mã cấu hình .htaccess để bạn tự tạo file và dán vào.
Sửa .htaccess bị lỗi 500 thì khôi phục ra sao?
Đổi tên file thành .htaccess.bak qua File Manager hoặc SSH, site sẽ chạy lại ngay vì Apache không còn đọc file lỗi. Sau đó mở file .bak ra soát cú pháp rồi đổi tên lại.
Thêm mã tùy chỉnh vào đâu để WordPress không ghi đè?
Khi cấu hình .htaccess, thêm ngoài cặp marker # BEGIN WordPress và # END WordPress. Mọi thứ nằm giữa hai marker này đều bị ghi đè mỗi lần lưu Permalink.
Kết luận
Nắm đúng 3 mẫu cấu hình .htaccess trên là đủ cho hầu hết site WordPress. Khi cần thêm tính năng như chặn truy cập hay chuyển hướng, hãy thêm ngoài cặp marker và sao lưu file trước khi sửa. Xem thêm cách bảo mật WordPress bằng .htaccess.
Nguồn tham khảo
Nếu bạn phát hiện nội dung cũ, sai lệch hoặc cần cập nhật, vui lòng cho chúng tôi biết.
Báo cáo của bạn đã được gửi. Quản trị viên sẽ xem xét và cập nhật bài viết.
Với kinh nghiệm thực chiến từ việc tiếp xúc hàng ngày với vô vàn vấn đề về Website, Hosting, VPS, Server tại Phòng Kỹ thuật AZDIGI, mình luôn ấp ủ niềm đam mê chia sẻ kiến thức.
Mình xây dựng các blog không chỉ để tự trau dồi kỹ năng mà còn để cung cấp những tài liệu, hướng dẫn hữu ích nhất đến cộng đồng. Rất mong nhận được sự quan tâm của các bạn!
Để lại thông tin, mình sẽ phản hồi ngay.


2 comments
làm sao để chuyển tên miền cũ sang tên miền mới không mất google ạ
Bạn tham khảo hướng dẫn sau để cấu hình nhé