Một bình luận trong bất kỳ chương trình máy tính nào (chẳng hạn như chương trình PHP) là một đoạn văn bản giải thích nhất định mà trình biên dịch/giải thích ngôn ngữ sẽ bỏ qua. Mục đích của nó là giúp người dùng hiểu được logic được sử dụng trong thuật toán của chương trình.
Mặc dù việc đặt chú thích trong mã không phải là điều cần thiết, nhưng đây là một thực hành rất được khuyến khích. Các chú thích cũng phục vụ như tài liệu chương trình. Chú thích cũng hữu ích khi mã cần được gỡ lỗi và sửa đổi.
Có hai định dạng chú thích trong PHP −
Chú thích một dòng
Chú thích nhiều dòng
Chúng thường được sử dụng cho các giải thích ngắn hoặc ghi chú liên quan đến mã địa phương. PHP sử dụng hai ký hiệu để chèn một chú thích trên một dòng trong chương trình.
Một dòng trong mã PHP bắt đầu bằng ký hiệu "#" được coi là một bình luận trên một dòng.
<?php # Single line comment starting with # symbol echo 'Hello World'; ?>
PHP cũng hỗ trợ kiểu chú thích một dòng theo phong cách C với ký hiệu "//". Một dòng bắt đầu bằng ký hiệu hai chéo được coi là một chú thích.
<?php // Single line comment starting with // symbol echo 'Hello World'; ?>
Một chú thích bắt đầu bằng ký hiệu "#" hoặc "//" không cần phải được đóng lại. Hiệu ứng của những ký hiệu này kéo dài đến cuối dòng vật lý.
Nói cách khác, trình phân tích cú pháp PHP sẽ coi dòng tiếp theo là một câu lệnh PHP và không phải là một chú thích, ngay cả khi không có dấu kết thúc chú thích.
Các bình luận nhiều dòng thường được sử dụng để cung cấp các thuật toán pseudocode và các giải thích chi tiết hơn khi cần thiết.
Phong cách chú thích nhiều dòng giống như trong C. Một hoặc nhiều dòng được nhúng bên trong các ký hiệu "/*" và "*/" sẽ được coi là chú thích.
Đây là ví dụ về một chú thích đa dòng.
<?php /* This is a multiline comment example program to add two numbers Variables used - $x for first number, $y for second number */ $x=10; $y=20; print "Total = ". $x+$y; ?>
Lưu ý rằng bạn có thể đặt ngay cả một dòng đơn lẻ bên trong các ký hiệu "/* .. */". Tuy nhiên, nếu có ký hiệu "/*" trong chương trình, nó phải có một dấu kết thúc chú thích "*/". Nếu không, một lỗi sẽ được hiển thị như sau −
PHP Parse error: Unterminated comment starting line 3 in /home/cg/root/65ded9eeb52fc/main.php on line 3