Mọi người đều biết về bình luận vì đó là điều đầu tiên được dạy trong các trường học và đại học. Chúng tôi đã nói rằng mã nhận xét không bao giờ được thực thi trong một chương trình, nó đúng nhưng không hoàn toàn, tôi sẽ chỉ cho bạn chi tiết trong bài đăng này nhưng trước tiên chúng ta hãy đi qua định nghĩa của nó
Nhận xét trong PHP là gì?Nhận xét, bằng PHP hoặc bất kỳ ngôn ngữ lập trình nào khác là văn bản trong mã nguồn không được thực thi khi chương trình được biên dịch, giải thích hoặc chạy, nghĩa là văn bản chúng tôi viết trong nhận xét không hiển thị cho người dùng cuối. Ngoài ra, các nhận xét rất hữu ích để chia sẻ ý tưởng hoặc hoạt động của một khối mã trong nhóm các nhà phát triển làm việc trên cùng một dự án
Khối mã có thể là bất kỳ thứ gì, một dòng mã hoặc một hàm hoặc một lớp hoặc chính tệp đó. Chúng thậm chí còn quan trọng đối với các nhà phát triển đơn lẻ vì các nhận xét có thể nhắc nhở ý tưởng hoặc thuật toán mà một nhà phát triển đã áp dụng từ lâu. Vì bài đăng này liên quan đến PHP nên tôi phải cung cấp cho bạn thêm chi tiết về nhận xét PHP
Các loại bình luận trong PHPPHP hỗ trợ nhận xét kiểu 'C', 'C++' và Unix shell [kiểu Perl]. Theo tiêu chuẩn PHP, có ba [3] cách để nhận xét mã
Trong dòng / Nhận xét một dòngNhận xét trong dòng hoặc dòng đơn được ký hiệu là // [dấu gạch chéo kép]. Dòng duy nhất sau // trở thành văn bản cho bình luận. Ví dụ
Phím tắt cho bình luận một dòng
Trong phpstorm IDE, chọn dòng hoặc đặt con trỏ vào dòng bạn muốn bình luận và nhấn Ctrl+/
Nhận xét nhiều dòngNhận xét nhiều dòng được sử dụng khi chúng tôi muốn nhận xét toàn bộ khối dòng mã. Văn bản nhận xét được đính kèm trong /* và */. Ví dụ
Phím tắt để bình luận nhiều dòng
Trong phpstorm IDE, chọn các dòng từ đầu đến khi bạn muốn bình luận và nhấn Ctrl+shift+/
Đây là một loại bình luận PHP khác có tiêu chuẩn riêng — nó được gọi là DocBlock. DocBlocks là các khối văn bản được sử dụng để tạo tài liệu bằng cách sử dụng phpDocumentor còn được gọi là phpDoc. Thật thú vị, chúng quan trọng hơn và chúng tôi phải sử dụng chúng nếu chúng tôi đang phát triển một sản phẩm phần mềm phức tạp, mọi thứ phải được ghi lại trong trường hợp đó
DocBlocks là phiên bản sửa đổi của Nhận xét nhiều dòng và có thể dễ dàng xác định bằng phong cách riêng biệt của chúng. Ví dụ
Trong phpsorm, nhấn Ctrl + E và chọn TODO, bạn sẽ thấy tất cả những việc cần làm mà bạn cần chú ý
Phần kết luậnVì vậy, các bạn, bây giờ chúng ta đã đi đến phần cuối của bài đăng này, nơi chúng ta đã thấy các loại nhận xét khác nhau trong PHP và cách sử dụng chúng trong mã và tài liệu của chúng ta. Loại nào bạn thấy hữu ích nhất, hãy cho tôi biết trong phần bình luận bên dưới