ChuyenHuong.comChuyển Hướng
Cấu hình chuyển hướng trên máy chủ

Chuyển hướng bằng .htaccess: Redirect, RedirectMatch hay RewriteRule

Cách viết chuyển hướng trong tệp .htaccess của Apache: khi nào đủ Redirect, khi nào cần RewriteRule với RewriteCond, cờ R=301 và L, lỗi hay gặp.

Young Vietnamese web freelancer working on a laptop with a softly blurred screen at a wooden table in a Da Nang cafe, iced coffee nearby, over-the-shoulder view, morning light

Với tệp .htaccess của Apache, chuyển hướng một trang hay một thư mục cố định chỉ cần chỉ thị Redirect; khi phải xét tên miền, giao thức hay chuỗi truy vấn thì mới cần RewriteRule đi kèm RewriteCond. Hai nhóm này thuộc hai mô-đun khác nhau là mod_alias và mod_rewrite, và trộn chúng trong cùng một tệp là nguyên nhân của rất nhiều quy tắc chạy sai thứ tự.

Bài này dành cho người dùng hosting chia sẻ chạy Apache hoặc máy chủ tương thích, thường không có quyền sửa cấu hình vhost và chỉ được đặt .htaccess trong thư mục web. Các mẫu là ví dụ giả định với vidu.vn. Tệp .htaccess sai cú pháp làm cả site trả lỗi 500 ngay lập tức, nên hãy giữ bản sao lưu và thử trên một thư mục thử hoặc site thử trước.

Ba chỉ thị, ba mức độ

Bảng so sánh nhanh để chọn đúng công cụ. Mẫu viết trong cột giữa, mỗi mẫu là một dòng trong .htaccess.

Chỉ thịMẫuHợp với việc gì
Redirect (mod_alias)Redirect 301 /lien-he-cu /lien-heMột đường dẫn cố định sang một đích; phần đuôi phía sau đường dẫn cũ được nối sang đích
RedirectMatch (mod_alias)RedirectMatch 301 ^/tin-tuc/(.*)$ /bai-viet/$1Một khuôn đường dẫn dùng biểu thức chính quy, không cần điều kiện
RewriteRule (mod_rewrite)RewriteRule ^tin-tuc/(.*)$ /bai-viet/$1 [R=301,L]Khi cần điều kiện theo tên miền, giao thức, tham số, tệp có tồn tại hay không

Điểm dễ quên nhất của Redirect là phần nối đuôi. Dòng Redirect 301 /san-pham /cua-hang sẽ đưa /san-pham/ao-thun sang /cua-hang/ao-thun. Đó thường là điều bạn muốn khi đổi tên thư mục, nhưng thành lỗi khi bạn chỉ định đổi đúng trang /san-pham và để nguyên các trang con. Lúc đó dùng RedirectMatch với ký tự neo hai đầu: RedirectMatch 301 ^/san-pham/?$ /cua-hang.

Chỉ thị Redirect còn nhận từ khoá thay cho con số: permanent tương đương 301, temp tương đương 302, seeother là 303, và gone trả mã 410 cho trang đã bỏ hẳn mà không cần đích, ví dụ Redirect gone /chuong-trinh-2019. Viết Redirect mà không ghi mã nào thì Apache mặc định trả 302, giống cờ R trần của RewriteRule. Vì vậy thói quen tốt là luôn ghi rõ con số, để người đọc tệp sau này khỏi phải tra.

Đọc một khối RewriteRule cho đúng

Một khối mod_rewrite chuẩn mở đầu bằng RewriteEngine On, sau đó là các cặp điều kiện và quy tắc. Mỗi RewriteCond đặt ngay trên một RewriteRule là điều kiện của riêng quy tắc đó; các điều kiện liên tiếp mặc định được nối bằng phép và, muốn phép hoặc thì thêm cờ [OR] vào cuối điều kiện. Điều kiện không mang sang quy tắc tiếp theo, đây là lỗi kinh điển khi người viết tưởng một RewriteCond áp cho cả khối.

Ví dụ giả định chuyển tên miền cũ sang tên miền mới, giữ đường dẫn, viết thành ba dòng: RewriteEngine On, rồi RewriteCond %{HTTP_HOST} ^(www\.)?tenmien-cu\.vn$ [NC], rồi RewriteRule ^(.*)$ https://tenmien-moi.vn/$1 [R=301,L]. Điều kiện đọc biến tên miền khách gửi lên, cờ NC cho phép không phân biệt hoa thường, dấu chấm phải thoát bằng gạch chéo ngược vì trong biểu thức chính quy dấu chấm nghĩa là bất kỳ ký tự nào.

Một điểm chỉ có ở .htaccess: biểu thức của RewriteRule so khớp đường dẫn đã bị cắt bỏ phần thư mục chứa tệp .htaccess, kể cả dấu gạch chéo đầu. Vì thế trong .htaccess ở thư mục gốc, bạn viết ^tin-tuc/ chứ không phải ^/tin-tuc/. Cùng quy tắc đó chép vào cấu hình vhost thì phải thêm lại dấu gạch chéo. Đây là lý do một quy tắc chép từ hướng dẫn trên mạng chạy ở chỗ này mà không chạy ở chỗ khác.

Các cờ hay dùng và ý nghĩa thật

[R=301] hay [R=302]. Bật chuyển hướng ra ngoài với mã tương ứng. Chỉ viết [R] trần thì Apache mặc định trả 302, nhiều người tưởng là 301 và để vậy nhiều năm. Có thể dùng các mã khác như 307, 308 trên phiên bản Apache hiện hành; kiểm tài liệu bản bạn đang chạy.

[L]. Dừng xét các quy tắc còn lại trong lượt này. Với chuyển hướng ra ngoài, gần như luôn đi kèm R. Lưu ý trong .htaccess, sau khi một quy tắc viết lại nội bộ, Apache có thể chạy lại cả bộ quy tắc một lượt nữa, nên L không có nghĩa là quy tắc khác không bao giờ được chạm tới.

[NC]. Không phân biệt chữ hoa chữ thường khi so khớp. Hữu ích với tên miền và với các đường dẫn cũ từng được gõ lẫn hoa thường.

[QSA] và [QSD]. QSA nối chuỗi truy vấn cũ vào đích khi đích đã có tham số riêng. QSD bỏ hẳn chuỗi truy vấn cũ, có từ Apache 2.4. Không có cờ nào thì chuỗi truy vấn cũ tự được giữ nếu đích không chứa dấu hỏi.

[NE]. Không mã hoá lại ký tự đặc biệt ở đích. Cần khi đích chứa dấu thăng cho neo trang hoặc ký tự phần trăm đã mã hoá sẵn; thiếu cờ này, dấu thăng bị biến thành %23 và neo không chạy.

Không trộn mod_alias với mod_rewrite trong cùng một tệp

Tài liệu Apache nói rõ các chỉ thị mod_rewrite và mod_alias không chạy theo thứ tự dòng bạn viết trong tệp, mà theo thứ tự các mô-đun được gọi trong vòng đời một yêu cầu. Kết quả thực tế: bạn đặt một dòng Redirect ở cuối tệp với ý định nó chạy sau cùng, nhưng nó lại chạy trước hoặc sau RewriteRule tuỳ ngữ cảnh, sinh ra chuỗi hai bước hoặc một quy tắc bị bỏ qua.

Hosting dùng WordPress là nơi dễ dính nhất. Tệp .htaccess đã có sẵn khối mod_rewrite của WordPress để đưa mọi yêu cầu về index.php. Người quản trị chèn thêm vài dòng Redirect 301 phía dưới, thấy chạy được với trang này nhưng không với trang kia, vì khối rewrite đã kịp viết lại đường dẫn sang index.php trước khi mod_alias nhìn thấy nó.

Quy ước đơn giản để tránh: nếu tệp đã có RewriteEngine On, viết mọi chuyển hướng bằng RewriteRule và đặt chúng trên cùng, trước khối của ứng dụng. Nếu tệp không dùng mod_rewrite, có thể chỉ dùng Redirect và RedirectMatch. Đừng chọn cả hai. Và luôn để các quy tắc chuyển hướng ra ngoài phía trên các quy tắc viết lại nội bộ.

Mẫu đầu tệp .htaccess cho một site WordPress đổi đường dẫn

Ví dụ giả định: site vidu.vn chạy WordPress trên hosting Apache, cần chuyển ba thứ — trang giới thiệu cũ, chuyên mục cũ /tin/ sang /blog/, và các đường dẫn có đuôi .html từ thời trước. Các dòng dưới được đặt ở đầu tệp, trước khối mặc định mà WordPress tự sinh, mỗi dòng một mục.

  • # chuyen huong - them ngay 15/11, xem so tay van hanh — dòng ghi chú để người sau biết khối này của ai.
  • RewriteEngine On — bật mod_rewrite; dòng này có lặp lại trong khối của WordPress cũng không sao.
  • RewriteRule ^gioi-thieu-cong-ty/?$ /gioi-thieu/ [R=301,L] — một trang, chấp nhận cả bản có lẫn không có gạch chéo cuối.
  • RewriteRule ^tin/(.*)$ /blog/$1 [R=301,L] — cả chuyên mục, giữ phần đuôi.
  • RewriteCond %{REQUEST_FILENAME} !-f — chỉ áp quy tắc tiếp theo khi không có tệp thật trùng tên.
  • RewriteRule ^(.+)\.html$ /$1/ [R=301,L] — bỏ đuôi .html của bài cũ, nhưng không đụng tới tệp .html có thật như tệp xác minh của công cụ quản trị.

Điều kiện !-f ở dòng thứ năm là chi tiết nhiều người bỏ qua. Không có nó, các tệp .html tĩnh mà bạn đặt cố ý trong thư mục web, như tệp xác minh quyền sở hữu tên miền, cũng bị chuyển hướng và việc xác minh thất bại. Khối mặc định của WordPress phía dưới giữ nguyên, không chèn quy tắc nào vào giữa hai dòng đánh dấu BEGIN và END của nó, vì WordPress có thể ghi đè vùng đó khi bạn lưu lại cài đặt đường dẫn tĩnh.

Vì sao .htaccess của bạn không có tác dụng

Viết đúng cú pháp mà vẫn không thấy chuyển hướng, hãy kiểm lần lượt những nguyên nhân sau trước khi nghi ngờ quy tắc.

  • Máy chủ đặt AllowOverride None cho thư mục đó: Apache bỏ qua hoàn toàn tệp .htaccess. Trên hosting chia sẻ thường đã mở, trên máy chủ tự dựng thì phải mở ít nhất nhóm FileInfo cho mod_rewrite.
  • Mô-đun mod_rewrite chưa bật. Khối được bọc trong <IfModule mod_rewrite.c> sẽ im lặng bị bỏ qua thay vì báo lỗi.
  • Tệp đặt sai thư mục hoặc sai tên, ví dụ có đuôi .txt do trình soạn thảo tự thêm, hoặc nằm trong thư mục con không phải thư mục gốc của tên miền.
  • Thư mục con có tệp .htaccess riêng với RewriteEngine On: quy tắc rewrite của thư mục cha không được kế thừa xuống, trừ khi dùng tuỳ chọn kế thừa.
  • Máy chủ thực ra không phải Apache mà là nginx đứng trước, chỉ chuyển một phần yêu cầu xuống Apache; các tệp tĩnh do nginx trả thẳng nên quy tắc trong .htaccess không bao giờ được xét.
  • Bộ nhớ đệm: trình duyệt nhớ 301 cũ, plugin cache của ứng dụng hoặc CDN giữ phản hồi trước khi sửa.

Một mẹo kiểm nhanh liệu .htaccess có được đọc không: tạm thêm một dòng vô nghĩa ở đầu tệp trên site thử. Nếu site báo lỗi 500, tệp đang được đọc; nếu không có gì xảy ra, vấn đề nằm ở cấu hình máy chủ. Nhớ xoá dòng đó ngay, và tuyệt đối không làm trên site đang có khách.

Thêm một quy tắc mới mà không làm sập site

Quy trình ngắn cho người làm trên hosting chia sẻ, không có quyền xem nhật ký lỗi đầy đủ.

  1. Tải bản .htaccess hiện tại về máy, đổi tên kèm ngày để giữ làm bản lùi.
  2. Viết quy tắc mới ở đầu tệp, trên khối của ứng dụng, dùng mã 302 trong lúc thử.
  3. Tải lên thư mục của site thử hoặc thư mục con thử, mở trang chủ xem có lỗi 500 không.
  4. Kiểm bằng curl -sI https://vidu.vn/lien-he-cu, đọc dòng trạng thái và dòng Location; thử thêm bản có tham số, bản viết hoa, bản có dấu gạch chéo cuối.
  5. Khi đúng hết, đổi 302 thành 301, tải lên site thật, kiểm lại một lượt bằng curl.
  6. Ghi chú ngay trong tệp bằng dòng bắt đầu dấu thăng: quy tắc này để làm gì, thêm ngày nào, gỡ được khi nào.

Nếu có quyền sửa cấu hình vhost, nên chuyển dần các quy tắc ổn định từ .htaccess lên đó. Apache phải đọc .htaccess ở mọi thư mục trên đường đi của mỗi yêu cầu, còn cấu hình vhost chỉ đọc một lần khi nạp.

Câu hỏi thường gặp

Chỉ thị Redirect có giữ chuỗi truy vấn không?

Thông thường có: tham số sau dấu hỏi của địa chỉ cũ được giữ khi chuyển sang đích. Tuy nhiên hành vi chi tiết có thể khác giữa các phiên bản và máy chủ tương thích, nên sau khi viết hãy thử bằng curl với một địa chỉ có tham số để chắc chắn thay vì đoán.

Có thể viết chuyển hướng theo tham số bằng RewriteRule không?

Được, nhưng phải dùng RewriteCond với biến %{QUERY_STRING}, vì biểu thức của RewriteRule không bao giờ nhìn thấy phần sau dấu hỏi. Giá trị bắt được trong điều kiện được gọi lại bằng %1 ở đích, khác với $1 là nhóm bắt từ chính RewriteRule.

Tệp .htaccess dài có làm site chậm không?

Có ảnh hưởng, vì Apache đọc và phân tích .htaccess ở mỗi yêu cầu, ở mọi thư mục trên đường dẫn. Với vài chục dòng thì khó thấy khác biệt; với hàng nghìn quy tắc chuyển hướng, nên đưa lên cấu hình vhost hoặc dùng RewriteMap trong cấu hình máy chủ.

Viết [R=301,L] hay [L,R=301] có khác nhau không?

Không khác. Thứ tự các cờ trong ngoặc vuông không quan trọng, miễn ngăn cách bằng dấu phẩy và không có khoảng trắng. Khoảng trắng thừa bên trong ngoặc mới là lỗi, có thể làm Apache báo lỗi cấu hình và trả 500.

Sửa .htaccess xong có cần khởi động lại Apache không?

Không. Apache đọc .htaccess ở mỗi yêu cầu nên thay đổi có hiệu lực ngay. Nếu không thấy tác dụng, nghĩa là tệp không được đọc, bị quy tắc khác chặn trước, hoặc bạn đang thấy bản đã lưu trong bộ nhớ đệm, chứ không phải do thiếu bước khởi động lại.

Máy chủ LiteSpeed có đọc .htaccess giống Apache không?

LiteSpeed bản thương mại đọc phần lớn quy tắc .htaccess kiểu Apache, còn OpenLiteSpeed hỗ trợ hẹp hơn và có cách nạp riêng. Nếu hosting của bạn chạy LiteSpeed, đọc thêm bài riêng về LiteSpeed trên trang để biết những chỗ hành xử khác.

Cần tư vấn cụ thể cho trường hợp của bạn?

Chúng tôi sẽ liên hệ trong vòng 24 giờ.

Đăng ký tư vấn ngay

Bài viết liên quan

Bạn cần hỗ trợ thêm?

Để lại thông tin, chúng tôi sẽ liên hệ trong 24 giờ.

hoặc
Gọi ngay 0926 138 138