Nó không chỉ làm cho việc thực thi cơ bản của dự án của bạn minh bạch và dễ hiểu hơn mà còn dễ tiếp cận hơn trong cách tiếp cận của nó. Trong môi trường công ty hoặc cộng đồng, các phương pháp ghi nhật ký thông minh có thể giúp mọi người hiểu rõ về tình trạng và tiến độ của dự án
Trong bài đăng này, chúng ta sẽ xem cách chúng ta có thể tinh chỉnh các phương pháp phát triển web PHP của mình bằng cách hiểu tầm quan trọng của việc đăng nhập vào bảng điều khiển trình duyệt. Chúng ta sẽ xem cách ghi nhật ký được hỗ trợ nguyên bản trong PHP và cách thực hiện ghi nhật ký trong bảng điều khiển trình duyệt có nhiều thứ hơn là in nhật ký trên trang web hoặc ghi nhật ký vào tệp
Sử dụng các liên kết này để điều hướng
Bối cảnh - Đăng nhập bằng PHP
Hơn 25 năm kể từ khi được tạo ra, PHP vẫn là một trong những ngôn ngữ lập trình được sử dụng rộng rãi nhất trên thế giới, chiếm khoảng 78% lượng truy cập Internet được biết đến.
Mặc dù khi tôi bắt đầu lập trình bằng PHP, tôi nhận ra rằng nền tảng về Javascript của tôi chưa chuẩn bị cho tôi về điều này. Tôi đã quá quen với việc làm việc với bảng điều khiển của trình duyệt để gỡ lỗi nên việc phải làm việc với hỗ trợ ghi nhật ký gốc của PHP không thể lấp đầy khoảng trống đó. Nhưng đã có hy vọng
Trước đó, hãy xem PHP hỗ trợ ghi nhật ký và gỡ lỗi như thế nào
PHP có thể được sử dụng để đăng nhập thông qua hai cách chính -
- Bằng cách ghi vào tệp nhật ký trên đĩa hoặc
- Bằng cách hiển thị các giá trị biến trên các trang web sử dụng echo và var_dump.
Cả hai tùy chọn này có thể chứng minh là hạn chế
Mặc dù các tệp nhật ký tĩnh giúp phân tích hồi cứu về cách thực thi diễn ra, nhưng theo một nghĩa nào đó, chúng có thể làm mất đi trải nghiệm thời gian thực phong phú của bạn trong việc theo dõi động lực của một trang web hiện đại với các yêu cầu mạng và kết nối ổ cắm
Ngoài ra, chỉ có rất nhiều thông tin mà bạn có thể đăng nhập vào trang web của mình mà không làm gián đoạn thiết kế của nó. Do đó, các cơ chế ghi nhật ký thông thường có thể có trong PHP có vẻ ít khả thi hơn đối với các trang web động, rộng lớn hơn
Các vấn đề đã nói ở trên hạn chế khả năng ghi nhật ký không chỉ đối với PHP mà còn đối với bất kỳ ngôn ngữ nào sẽ được sử dụng để phát triển web trong tương lai
Các trình duyệt hiện đại đã ra đời và nhận ra tầm quan trọng của việc cung cấp cho các nhà phát triển các công cụ cần thiết để hỗ trợ gỡ lỗi và ghi nhật ký dễ dàng nhưng mạnh mẽ. Chúng còn được gọi là Công cụ dành cho nhà phát triển và có thể được truy cập bằng cách nhấp chuột phải vào trang web và chọn tùy chọn 'Kiểm tra'.
Những công cụ này cho phép bạn kiểm tra đối tượng DOM, theo dõi các yêu cầu và phản hồi của mạng, thời gian tải trang, hiệu suất trang web, mức tiêu thụ bộ nhớ, v.v.
Một trong những Công cụ dành cho nhà phát triển này, được gọi là bảng điều khiển của trình duyệt, cho phép bạn ghi nhật ký tin nhắn và chạy mã Javascript để gỡ lỗi ứng dụng của bạn. Hãy xem làm thế nào chúng ta có thể sử dụng điều đó để lợi thế của chúng tôi
Khái niệm cơ bản về ghi nhật ký bảng điều khiển trình duyệt
Khi xảy ra sự cố trên một trang web, thông thường người dùng sẽ thấy một thông báo lỗi thú vị về những gì đã xảy ra
Nhưng cửa sổ của nhà phát triển web có thể đã xảy ra sự cố là Công cụ dành cho nhà phát triển của trình duyệt - chủ yếu là bảng điều khiển trình duyệt
Bảng điều khiển trình duyệt là gì?
Bảng điều khiển trình duyệt, như tên gợi ý, là một bảng điều khiển trong trình duyệt.
Giống như bạn có thể chạy Python hoặc Node. js trên bảng điều khiển trong thiết bị đầu cuối của bạn và in kết quả cũng như ghi nhật ký lỗi, bảng điều khiển trong trình duyệt của bạn cho phép bạn chạy mã Javascript và thông tin nhật ký phù hợp với trang web của bạn
Hãy để chúng tôi hiểu điều này thông qua một ví dụ. Giả sử bạn đã tạo một nền tảng nhắn tin trực tuyến và vì một số lý do không xác định, người dùng trên trang web của bạn không thể nhận được tin nhắn từ bạn bè của họ. Bây giờ trong trường hợp như vậy, sẽ rất hữu ích nếu có một hệ thống ghi nhật ký rõ ràng có thể giúp bạn xác định xem điều gì đã sai và ở đâu. Sau đây là một ví dụ về nhật ký
- Cơ sở dữ liệu được kết nối
- Tìm nạp bạn bè của người dùng
- Tài liệu đã qua xử lý
- kết xuất dữ liệu
- Mở kết nối ổ cắm
- Kết nối ổ cắm thành công
- Gửi tin nhắn trên kênh
- Đã nhận được tin nhắn trên kênh
- Kết xuất thông báo
- [LỖI TRONG TIN NHẮN KẾT XUẤT]
Như đã trình bày trong ví dụ trên, nhật ký được triển khai tốt sẽ giúp bạn nhận ra rằng mặc dù đã nhận được nội dung thư, nhưng chính trong quá trình hiển thị nội dung đó, mã của bạn đã bị lỗi. Bây giờ bạn có thể tiếp tục và chuyển trực tiếp đến phần có liên quan trong mã của mình và thực hiện các thay đổi cần thiết
Bạn có thể in thông tin ra bàn điều khiển bằng cách sử dụng bàn điều khiển. phương thức log[].
Tùy thuộc vào yêu cầu, các phương thức khác của đối tượng console cũng có thể được sử dụng -
- bảng điều khiển. thông tin[]
- bảng điều khiển. gỡ lỗi[]
- bảng điều khiển. cảnh báo[]
- bảng điều khiển. lỗi[]
Nó đâu rồi?
Trong Google Chrome, bạn có thể truy cập bảng điều khiển trình duyệt bằng cách sử dụng Cmd + Shift + C [Ctrl + Shift + C trên Windows, Linux] hoặc bằng cách điều hướng đến tab 'Bảng điều khiển' trong Công cụ dành cho nhà phát triển sau khi chọn tùy chọn menu 'Kiểm tra'
Cách ghi nhật ký bảng điều khiển có thể được thực hiện trong PHP
Bất chấp uy quyền tối cao của PHP, thực tế là tất cả các trình duyệt hiện đại đã chọn Javascript làm ngôn ngữ thông dịch trình duyệt có nghĩa là cách duy nhất để nhật ký mã PHP có thể đưa nó vào bảng điều khiển của trình duyệt là thông qua các hàm trợ giúp tùy chỉnh. Các chức năng này có thể gọi bảng điều khiển của Javascript. log[] bằng cách lặp lại nó đến trang web được yêu cầu
// code for connecting to database
echo 'console.log["Database connected!"]';
Đây là cơ sở về cách một người có thể sử dụng các khả năng của bảng điều khiển trình duyệt dựa trên JS cho môi trường dựa trên PHP.
Hãy xem cách chúng ta có thể tận dụng những điều trên để ghi nhật ký thường xuyên hơn và linh hoạt hơn
Ví dụ trên chỉ để in các chuỗi thông báo được mã hóa cứng thông báo về trạng thái và tiến trình của một nhiệm vụ con nhất định.
Nó cũng rất phổ biến để gỡ lỗi bằng cách ghi nhật ký các biến dữ liệu, chẳng hạn như để yêu cầu tham số, phản hồi JSON [Ký hiệu đối tượng Javascript], đầu ra được xử lý, v.v. Hãy để chúng tôi xem cách chúng tôi có thể in một mảng PHP lên bảng điều khiển trình duyệt
';
echo 'console.log['. json_encode[$my_arr, JSON_HEX_TAG] .']';
echo '';
?>
ĐẦU RA ĐIỀU KHIỂN
Hàm json_encode[] chuyển đổi biến PHP thành đối tượng JSON có thể được phân tích cú pháp bằng Javascript để in ra bảng điều khiển. Tệp PHP đẹp mắt của chúng tôi được trình duyệt chuyển đổi thành mã đánh dấu HTML sau -
[được kiểm tra từ phần 'Nguồn' của Công cụ dành cho nhà phát triển]
Hàm json_encode[] có thể được sử dụng để chuyển đổi bất kỳ loại dữ liệu PHP nào thành ký hiệu tương thích với Javascript.
Thay vì viết câu lệnh echo tương ứng mỗi lần chúng ta muốn ghi nội dung nào đó vào bảng điều khiển, chúng ta có thể tạo một hàm tương tự như vậy -
function console_log[$data, $add_script_tags = false] {
$command = 'console.log['. json_encode[$data, JSON_HEX_TAG].'];';
if [$add_script_tags] {
$command = '';
}
echo $command;
}Chức năng trên có thể được sử dụng theo cách chúng tôi muốn tùy thuộc vào việc chúng tôi có muốn kèm theo hay không';
ĐẦU RA ĐIỀU KHIỂN
Sử dụng các thư viện PHP để ghi nhật ký bảng điều khiển
Nếu bạn muốn thuê ngoài mã phần mềm trung gian ghi nhật ký này cho thư viện Nguồn mở của người trợ giúp cho phép nhiều chức năng hơn, thì bạn có thể xem một cái gì đó như PHPConsole hoặc PHPDebugConsole.
PHPConsole phổ biến hơn trên Github nhưng hơi cũ và ít được cập nhật thường xuyên hơn. Nó hoạt động với tiện ích mở rộng trình duyệt [dành cho Chrome] để ghi thông tin vào bảng điều khiển trình duyệt. Mã và hướng dẫn cài đặt có thể được tìm thấy ở đây.
Mặt khác, PHPDebugConsole, mặc dù chỉ có 34 sao trên Github, nhưng được bảo trì thường xuyên hơn và có tài liệu tốt hơn. Code, thông tin cài đặt và hướng dẫn sử dụng của thư viện có thể tham khảo tại đây
Theo mặc định, nó xuất nhật ký trên trang web theo kiểu có tổ chức. Đây là một ví dụ sử dụng được cung cấp trên trang web của họ cho thấy việc bắt đầu ghi nhật ký bằng PHPDebugConsole dễ dàng như thế nào
true,
'output' => true,
]];
$debug->log['hello world'];Dưới đây là một ví dụ về đầu ra HTML từ trang web của họ
Họ cũng cung cấp hỗ trợ đăng nhập vào bảng điều khiển của trình duyệt bằng cách cài đặt một số tiện ích mở rộng nhất định
Theo ý kiến của tôi, nếu bạn đang làm việc trong một dự án cá nhân quy mô nhỏ, thì không có gì sánh được với sự đơn giản của việc sử dụng chức năng trợ giúp dựa trên json_encode[] tùy chỉnh của bạn. Nó sẽ giúp bạn không phải quan tâm đến các phụ thuộc bên ngoài và khả năng tương thích chéo của trình duyệt
Tại sao bạn nên đăng nhập vào bảng điều khiển
Tiện
Đăng nhập vào bảng điều khiển trình duyệt chắc chắn có một yếu tố thuận tiện. Nhà phát triển sẽ dễ dàng ghi lại các lỗi ngay bên cạnh màn hình của trang web. Bằng cách này, nhà phát triển chỉ phải chuyển đổi giữa IDE và trình duyệt so với việc mở tệp nhật ký ở bên có nhiều khả năng không tự động làm mới
Giám sát kết quả theo thời gian thực
Vì một phần chính trong hoạt động của trang web là hiển thị và hiển thị nội dung của trang web, điều quan trọng đối với nhà phát triển là có thể theo dõi nhật ký và hiệu suất của trang web trong thời gian thực khi trang web mở ra và khi người dùng sử dụng. . Sự đồng bộ này có thể mở đường cho những hiểu biết mới về cách trang web đang hoạt động và về những cải tiến có liên quan có thể được thực hiện
Giúp bạn không phải xem qua các tệp nhật ký tĩnh khổng lồ
Mặc dù trong nhiều trường hợp, điều quan trọng là phải theo dõi và duy trì các tệp nhật ký cho các dự án quy mô lớn để phân tích và đánh giá hiệu suất, nhưng có thể hơi thất vọng khi nhận ra rằng trong PHP, ngôn ngữ này cung cấp hỗ trợ ghi nhật ký duy nhất. Đối với nhật ký gỡ lỗi ít quan trọng hơn, thật tuyệt khi có bảng điều khiển hiển thị kết quả khi được yêu cầu.
Không lộn xộn với trang web
Đôi khi echo và var_dump của PHP có thể được sử dụng để ghi nhật ký và theo dõi dữ liệu trên trang web. Nhưng như chúng ta đã thảo luận trước đây, nó làm gián đoạn hiển thị trang web của bạn, ảnh hưởng đến trải nghiệm người dùng và không phải là một phương pháp hay cho các dự án mở rộng. Dưới đây là một ví dụ -
Việc một cửa sổ bảng điều khiển trình duyệt riêng biệt có thể được sử dụng để hiển thị nhật ký có nghĩa là các nhà phát triển không cần lo lắng về việc làm biến dạng bố cục trang web hoặc về định dạng nhật ký của họ
gói nó lên
Trong bài đăng này, chúng tôi đã nhận ra tầm quan trọng của việc có một hệ thống ghi nhật ký tốt cho ứng dụng của bạn, dù nhỏ hay lớn. Chúng ta đã thấy cách PHP cho phép gỡ lỗi và ghi nhật ký, cũng như cách chúng ta có thể sử dụng bảng điều khiển trình duyệt cho cùng một mục đích. Chúng tôi đã thấy cách chúng tôi có thể lặp lại bảng điều khiển của Javascript. log[] gọi để ghi vào bàn điều khiển bằng hàm json_encode[]. Chúng tôi cũng đã thấy một số khung Nguồn mở có thể giúp chúng tôi đăng nhập vào bảng điều khiển. Cuối cùng, chúng tôi đã tóm tắt những lợi ích của việc đăng nhập vào bảng điều khiển thành bốn điểm có thể thuyết phục chúng tôi áp dụng các phương pháp ghi nhật ký đã nói ở trên vào thói quen phát triển web của mình, trên con đường mã hóa hiệu quả hơn