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

Chuyển hướng bằng PHP header Location: mã trạng thái, exit, headers already sent

Viết chuyển hướng bằng hàm header của PHP cho đúng: ghi rõ mã 301 hay 302, luôn exit sau đó, sửa lỗi headers already sent và khi nào nên để máy chủ làm.

Close view of a Vietnamese programmer hands on a mechanical keyboard beside a laptop with a dimmed blank screen, notebook and pen on a desk in a Hue home office, evening lamp

Chuyển hướng bằng PHP đúng cách gồm ba việc: gọi hàm header với tiêu đề Location, ghi rõ mã trạng thái bạn muốn, và gọi exit ngay sau đó. Viết header('Location: /lien-he', true, 301); rồi exit; là đủ cho đa số trường hợp. Bỏ con số đi, PHP sẽ gửi 302; bỏ exit đi, phần mã phía sau vẫn tiếp tục chạy dù trình duyệt đã được bảo đi chỗ khác.

Bài này dành cho người viết hoặc bảo trì mã PHP tự viết, hay cần chèn một chuyển hướng vào mã nguồn có sẵn mà không có quyền sửa cấu hình máy chủ. Các mẫu là ví dụ giả định; thử trên bản sao của site ở môi trường thử, bật hiển thị lỗi ở đó để thấy cảnh báo, và tắt hiển thị lỗi ở site thật.

Hàm header làm gì với mã trạng thái

Hàm header nhận ba tham số: chuỗi tiêu đề, cờ thay thế tiêu đề cùng tên, và mã trạng thái phản hồi. Khi chuỗi bắt đầu bằng Location và bạn không truyền mã, PHP tự đặt mã 302, trừ khi mã hiện tại đã là 201 hoặc một mã 3xx. Đó là lý do nhiều site viết chuyển hướng vĩnh viễn bằng PHP nhiều năm mà thực ra đang phát 302: người viết chỉ nhớ dòng Location, quên tham số thứ ba.

Có hai cách ghi rõ mã. Cách thứ nhất là truyền thẳng vào header, như mẫu ở đầu bài. Cách thứ hai là gọi http_response_code(301); trước, rồi mới gọi header('Location: /lien-he');. Hai cách cho kết quả như nhau; chọn một và dùng nhất quán trong mã nguồn để người sau đọc dễ.

Về đích chuyển hướng, chuẩn HTTP hiện hành cho phép tiêu đề Location chứa đường dẫn tương đối như /lien-he, và các trình duyệt phổ biến đều hiểu. Tuy vậy, khi site đứng sau CDN hoặc bộ cân bằng tải, hoặc khi chuyển sang tên miền khác, nên viết đích đầy đủ gồm https và tên miền để khỏi phụ thuộc vào cách tầng trung gian ghép địa chỉ.

Vì sao luôn phải exit sau header

Header không dừng chương trình. Hàm header chỉ xếp một tiêu đề vào hàng chờ gửi đi. Mọi dòng mã phía sau vẫn chạy: truy vấn cơ sở dữ liệu, ghi tệp, gửi thư, in nội dung trang. Trình duyệt bình thường sẽ đi theo Location và không hiển thị phần thân, nhưng phần thân vẫn được tạo ra và gửi đi.

Thiếu exit là lỗ hổng kiểm soát truy cập. Mẫu sai kinh điển: trang quản trị kiểm tra chưa đăng nhập thì gọi header chuyển về trang đăng nhập, nhưng quên exit. Người dùng chưa đăng nhập dùng công cụ không tự đi theo chuyển hướng vẫn nhận được nguyên nội dung trang quản trị trong phần thân phản hồi, và mọi thao tác phía sau vẫn được thực hiện.

Thiếu exit làm lãng phí tài nguyên. Trang nặng vẫn dựng xong toàn bộ dù không ai xem. Với chuyển hướng hàng loạt từ đường dẫn cũ, phần dựng trang thừa này cộng lại thành tải đáng kể cho máy chủ.

Trong framework, dùng hàm chuyển hướng của nó. Các framework PHP phổ biến có hàm hoặc đối tượng phản hồi chuyển hướng riêng, tự lo phần dừng xử lý đúng cách trong vòng đời của framework. Khi làm việc trong framework, dùng cách của nó thay vì gọi header rồi exit thô, để không bỏ qua các bước như lưu phiên làm việc.

Lỗi headers already sent: nguyên nhân và cách sửa

Thông báo Cannot modify header information, headers already sent by output started at kèm tên tệp và số dòng nghĩa là đã có nội dung được gửi ra trước khi bạn gọi header. Giao thức HTTP gửi tiêu đề trước phần thân; một khi byte đầu tiên của phần thân đã đi, không còn cách nào thêm tiêu đề nữa. Phần quý nhất của thông báo là vị trí output started at, nó chỉ thẳng tệp và dòng đã in ra thứ gì đó.

Nguyên nhân hay gặp nhất là những thứ vô hình: khoảng trắng hoặc dòng trống trước thẻ mở PHP, khoảng trắng sau thẻ đóng PHP ở cuối một tệp được include, và ký tự BOM mà một số trình soạn thảo chèn vào đầu tệp lưu dưới dạng UTF-8. Nguyên nhân dễ thấy hơn là lệnh echo, print, đoạn HTML nằm trước chỗ gọi header, hoặc một cảnh báo PHP được in ra màn hình vì đang bật hiển thị lỗi.

Cách sửa bền: với tệp chỉ chứa mã PHP, bỏ hẳn thẻ đóng ở cuối tệp, đây cũng là khuyến nghị của chuẩn viết mã PHP phổ biến; lưu tệp dạng UTF-8 không BOM; và đưa mọi logic quyết định chuyển hướng lên trước khi in bất cứ thứ gì. Đừng sửa bằng cách bật bộ đệm đầu ra cho xong chuyện mà không hiểu vì sao.

Điều này giải thích một hiện tượng hay gây bối rối: cùng một mã, máy thử chạy được mà máy chủ thật báo lỗi, hoặc ngược lại. Thiết lập output_buffering trong php.ini có thể khác giữa hai máy; khi bộ đệm bật, nội dung in ra sớm được giữ lại và header vẫn gửi được, lỗi bị che. Kiểm thiết lập này trên cả hai máy khi gặp tình huống đó.

Chọn mã trạng thái cho chuyển hướng trong PHP

Bảng dưới gắn mã với những tình huống mã PHP hay gặp. Chi tiết về từng mã có ở danh mục các mã chuyển hướng trên trang.

Tình huống trong mãMã nên dùngGhi chú
Đường dẫn cũ đổi vĩnh viễn, tra từ bảng trong cơ sở dữ liệu301Ghi rõ tham số thứ ba, không để mặc định
Chưa đăng nhập, đưa về trang đăng nhập302Luôn exit ngay sau đó
Sau khi xử lý biểu mẫu POST thành công303Mẫu POST, chuyển hướng, rồi GET; tránh gửi lại biểu mẫu khi bấm tải lại
Điểm cuối API đổi địa chỉ, khách gửi POST307 hoặc 308Giữ nguyên phương thức và thân yêu cầu
Trang đã bỏ hẳn, không có trang thay thếKhông chuyển hướngTrả 404 hoặc 410 thay vì đẩy về trang chủ

Mẫu POST, chuyển hướng, GET ở hàng thứ ba đáng dùng cho mọi biểu mẫu: đặt hàng, gửi liên hệ, lưu cài đặt. Sau khi xử lý xong, trả 303 về một trang kết quả. Người dùng bấm tải lại chỉ tải lại trang kết quả, không gửi đơn hàng lần hai. Mã 302 cũng thường chạy được trong thực tế vì trình duyệt đổi POST thành GET, nhưng 303 nói đúng ý định hơn.

Chuyển hướng đường dẫn cũ bằng một bảng tra trong PHP

Khi site tự viết đổi cấu trúc đường dẫn và danh sách cũ – mới nằm trong cơ sở dữ liệu, một đoạn mã nhỏ ở đầu bộ định tuyến là đủ. Các bước nguyên lý, mỗi dòng một việc, ví dụ giả định:

  • Lấy đường dẫn hiện tại từ $_SERVER['REQUEST_URI'], tách phần đường dẫn khỏi chuỗi truy vấn bằng parse_url.
  • Chuẩn hoá: bỏ gạch chéo cuối nếu quy ước site là không có, đổi về chữ thường nếu bảng lưu chữ thường.
  • Tra bảng chuyển hướng bằng câu truy vấn có tham số, không ghép chuỗi trực tiếp vào câu SQL.
  • Nếu có đích, kiểm đích là đường dẫn nội bộ bắt đầu bằng một dấu gạch chéo hoặc thuộc danh sách tên miền được phép, rồi gọi header với mã 301 và exit.
  • Nếu không có đích, để bộ định tuyến xử lý như bình thường; trang không tồn tại thì trả 404 thật.
  • Ghi lại số lần mỗi đường dẫn cũ được dùng, để sau một thời gian biết dòng nào còn cần giữ.

Bước kiểm đích ở dòng thứ tư là phòng thủ trước lỗ hổng chuyển hướng mở: nếu đích lấy từ dữ liệu mà ai đó sửa được, hoặc tệ hơn là từ tham số trên địa chỉ, kẻ xấu có thể biến site của bạn thành bàn đạp đưa người dùng sang trang lừa đảo. Danh mục lỗi và bảo mật trên trang có bài riêng về cách vá lỗi này.

Viết phép kiểm tự động cho chuyển hướng trong mã

Chuyển hướng trong mã PHP dễ bị phá âm thầm khi ai đó sửa bộ định tuyến hay đổi thứ tự xử lý. Một phép kiểm nhỏ chạy sau mỗi lần triển khai bắt được lỗi trước khách hàng.

  1. Lập một tệp danh sách, mỗi dòng gồm đường dẫn nguồn, mã mong đợi và đích mong đợi, ví dụ giả định /lien-he-cu 301 /lien-he.
  2. Đưa vào danh sách cả những trường hợp không được chuyển hướng, như trang chủ và vài trang quan trọng phải trả 200, để phát hiện quy tắc bắt nhầm.
  3. Viết một đoạn lệnh lặp qua từng dòng, gọi curl -s -o /dev/null -w "%{http_code} %{redirect_url}" tới môi trường thử, không tự đi theo chuyển hướng.
  4. So mã và đích nhận được với cột mong đợi; dòng nào lệch thì in ra và cho đoạn lệnh kết thúc với mã lỗi.
  5. Gắn đoạn lệnh vào quy trình triển khai: chạy trên môi trường thử trước, chỉ đẩy lên site thật khi không có dòng lệch.
  6. Mỗi lần thêm chuyển hướng mới trong mã, thêm luôn một dòng vào tệp danh sách, coi như một phần của thay đổi.

Phép kiểm kiểu này không cần thư viện kiểm thử nào, chạy được trên mọi máy có curl, và có ích không chỉ với PHP mà với cả quy tắc ở tầng máy chủ. Điểm quan trọng là kiểm từng bước một, không để curl tự đi theo chuyển hướng: đi theo tới cuối thì một chuỗi ba bước vẫn trông như đúng vì đích cuối cùng khớp.

Khi nào nên để máy chủ làm thay PHP

Chuyển hướng bằng PHP tiện vì nằm trong mã nguồn, đi theo kho mã, triển khai cùng lúc với tính năng. Nhưng mỗi lần chuyển hướng đều phải khởi động PHP, nạp mã ứng dụng, có khi mở kết nối cơ sở dữ liệu, chỉ để trả về vài dòng tiêu đề. Với vài đường dẫn ít người vào, chi phí này không đáng kể. Với chuyển cả tên miền hay ép một địa chỉ chuẩn cho mọi yêu cầu, đặt ở nginx hoặc Apache nhanh hơn rõ rệt và không phụ thuộc mã ứng dụng còn chạy hay không.

Quy tắc thực dụng: chuyển hướng cố định, áp cho nhiều đường dẫn, ít khi đổi thì đặt ở tầng máy chủ. Chuyển hướng phụ thuộc dữ liệu, như bài đổi slug, sản phẩm gộp, tài khoản đổi tên, thì để ứng dụng xử lý. Chuyển hướng theo trạng thái người dùng, như chưa đăng nhập hay chưa đủ quyền, đương nhiên thuộc về ứng dụng.

Dù đặt ở tầng nào, hãy tránh để cùng một đường dẫn được xử lý ở cả hai tầng. Máy chủ chuyển /a sang /b rồi PHP lại chuyển /b sang /c là chuỗi hai bước; nếu PHP lại chuyển về /a thì thành vòng lặp. Khi thêm chuyển hướng trong mã, kiểm xem cấu hình máy chủ đã có quy tắc nào đụng tới đường dẫn đó chưa.

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

Có thể dùng thẻ meta refresh hoặc JavaScript thay cho header Location không?

Có thể nhưng không nên khi bạn kiểm soát được mã phía máy chủ. Meta refresh và JavaScript chỉ chạy sau khi trình duyệt đã tải trang, chậm hơn, và máy tìm kiếm có thể không hiểu chúng như một chuyển hướng vĩnh viễn rõ ràng. Chỉ dùng khi không có cách nào gửi tiêu đề HTTP.

Gọi header Location hai lần thì chuyện gì xảy ra?

Với tham số thay thế mặc định là true, lần gọi sau ghi đè lần gọi trước, chỉ một tiêu đề Location được gửi. Tình huống này thường là dấu hiệu logic rối: hai nhánh mã cùng quyết định chuyển hướng. Nên gom quyết định về một chỗ và exit ngay sau lần gọi đầu tiên.

Có cần đặt thêm tiêu đề chống bộ nhớ đệm cho chuyển hướng không?

Với 302 và 303, trình duyệt thường không lưu lâu nếu không có chỉ dẫn. Với 301, trình duyệt có thể nhớ rất lâu; nếu bạn còn đang thử, dùng 302 trước. Khi chuyển hướng phụ thuộc trạng thái người dùng, thêm tiêu đề không lưu bộ nhớ đệm để tầng trung gian không phát nhầm cho người khác.

Làm sao biết PHP đang thật sự gửi mã nào?

Dùng curl với tuỳ chọn chỉ lấy tiêu đề và không tự đi theo chuyển hướng, rồi đọc dòng đầu tiên của phản hồi. Tab mạng trong công cụ nhà phát triển của trình duyệt cũng hiện mã trạng thái, nhưng nhớ đánh dấu giữ nhật ký để không mất dòng chuyển hướng khi trang đổi.

Có nên lấy đích chuyển hướng từ tham số trên địa chỉ không?

Chỉ khi bạn kiểm tra chặt đích đó, ví dụ chỉ chấp nhận đường dẫn nội bộ bắt đầu bằng một dấu gạch chéo duy nhất, hoặc so với danh sách cho phép. Nhận nguyên giá trị tham số rồi đưa vào header là tạo ra lỗ hổng chuyển hướng mở, một lỗi bảo mật phổ biến.

Hàm header có chống chèn tiêu đề bằng ký tự xuống dòng không?

Các phiên bản PHP hiện hành từ chối chuỗi tiêu đề chứa ký tự xuống dòng, nên kiểu tấn công chèn thêm tiêu đề qua header bị chặn ở mức ngôn ngữ. Tuy vậy, điều đó không ngăn được chuyển hướng mở; việc kiểm đích vẫn là trách nhiệm của mã ứng dụng.

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