Giới thiệu
Việc cá nhân hóa các trang lỗi (404 — trang không tìm thấy và 500 — lỗi máy chủ nội bộ) trong ứng dụng của bạn có thể cải thiện trải nghiệm người dùng trong các tình huống không mong đợi. Hướng dẫn này sẽ giải thích quy trình cấu hình các trang lỗi tùy chỉnh trong SonataExtraBundle.
Điều kiện tiên quyết
Trước khi tiếp tục, có một vài điểm quan trọng cần lưu ý:
- Môi trường phát triển: Các trang lỗi tùy chỉnh không hiển thị trong môi trường phát triển. Để xem chúng hoạt động, bạn cần cấu hình ứng dụng của mình ở chế độ sản xuất.
- Cài đặt môi trường : Định nghĩa trong tập tin của bạn
.envAPP_ENV=prodvàAPP_DEBUG=0. - Phiên quản trị: Hãy đảm bảo bạn không đăng nhập với quyền quản trị. Khuyến nghị sử dụng một phiên cho quản trị viên và một phiên khác (ở chế độ duyệt web riêng tư) để kiểm tra các trang lỗi.
Các bước cài đặt
Bước 1: cập nhật cấu hình của Sonata Admin
Trước hết, thêm những điều sau vào tệp cấu hình SonataPage của bạn:
sonata_admin:
catch_exceptions:
not_found: [404]
fatal: [500]
Cấu hình này chặn các ngoại lệ liên quan và truyền phản hồi đến tuyến đường _page_internal_error_{key}. SonataPage liên kết một cách thông minh điều này với một trang được chỉ định.
Bước 2: Trang trí các trang lỗi
Trong bảng quản trị "Pages" của Sonata, tìm và đánh dấu vào ô "décorer".
Bạn sẽ thấy các tùy chọn Trang Lỗi Nội Bộ Chết và Trang Lỗi Nội Bộ Không Tìm Thấy, những tùy chọn này rất quan trọng cho các bước tiếp theo.
Bước 3: Dịch và tùy chỉnh
Tất cả các yếu tố của các trang lỗi đều có thể được dịch cho từng ngôn ngữ của trang web.
Sau khi bật tùy chọn « Trang trí », hãy lưu các thay đổi của bạn và chuyển sang khung « tổ chức ». Ở đây, bạn có thể tùy chỉnh vùng chứa chính của trang lỗi của bạn.
Bước 4: Xuất bản các trang tùy chỉnh
Bước cuối cùng là xuất bản các trang tùy chỉnh của bạn. Tạo một bản chụp nhanh trang của bạn bằng cách nhấp vào bảng xuất bản.
Kết luận
Sau khi hoàn thành các bước này, các trang lỗi tùy chỉnh 404 và 500 của bạn nên được kích hoạt và hiển thị ở chế độ sản xuất.
Với cấu hình này, bạn đảm bảo trải nghiệm người dùng tốt hơn ngay cả khi có lỗi trong ứng dụng của bạn.
Công thức tối thiểu
Kiểm thử một URL không tồn tại và một lỗi ứng dụng đã được kiểm soát trong môi trường thử nghiệm. Phản hồi phải giữ nguyên mã HTTP đúng (404 hoặc 500): hiển thị một trang đẹp với trạng thái 200 làm giảm chất lượng theo dõi sự cố và lập chỉ mục.