PHP Comments

PHP Comments

What are PHP comments? 

In PHP, comments are sections of code that are not executed when a program is run. End users do not see PHP comments — they are only visible when viewing the PHP code in a file. PHP comments are usually meant to help programmers understand and interpret the PHP code.A PHP comment can explain the purpose of a particular section of code to other programmers. This way, when a developer is viewing a PHP file for the first time, they can more easily understand the code they’re looking at.

Similarly, comments help remind programmers why they wrote code in a particular way. You may create a PHP file, and then not return to it for months or years. When you eventually re-open the file, you’ll want to have thorough comments so you can quickly familiarize yourself with your old code. Or, you can use comments to drop short notes to yourself, like where you left off in your work.

Additionally, PHP comments can be used to temporarily deactivate particular sections of code for debugging purposes. Say you discover an error originating somewhere in your PHP file — you can “comment out” a part of the code, rerun the program, and see if the error still occurs. This is much easier (and safer) than deleting lines of code when debugging.

PHP Comment Syntax

PHP has two built-in ways of commenting: 

• single-line comments 
• multiline comments. 

Single-line PHP Comments

Single-line PHP comments are useful for short notes before a code block or for explaining a single line of code. To leave a single-line comment, type two forward slashes (//) followed by your comment text. All text to the right of the // will be ignored. You can also use a hash symbol (#) instead of // to make a single-line comment.

Example:

<?php

//single line comment 

?>

Multiline PHP Comments

PHP also allows for comments that span multiple lines, in case you want to comment out a larger section of code or leave a more descriptive comment. Start your multiline comment by writing /* and end it by writing */. 

Example:

<?php

/* multiline comment 

multiline comment*/

?>

PHP comments are a best practice.

To review, use single-line comments for short notes to clarify the purpose of a function or a line of code, and use multiline comments for longer notes, such as a more detailed description of a code block or a note to a fellow developer that they can delete later.

In PHP (and other coding languages), comments are often underutilized. At first, they may seem like an unnecessary step that just adds more bulk to your files. But, once you start working in teams and taking on complex longer-term projects, you should already be in the habit of writing comments — they’ll save you and others a lot of time trying to figure things out.