How to Comment in PHP

Usage

1. How to Comment in PHP Picture 3
   Use comments to leave notes about how code works. You shouldn't have to do this for every line of code, since good code should be fairly easy to parse by other programmers. It is useful if the code is performing irregular or not obvious functions.^[3]

   // Generate curl request $session = curl_init($request); // Tell curl to use HTTP POST curl_setopt ($session, CURLOPT_POST, true); 

2. How to Comment in PHP Picture 4
   Leave comments so that you remember what you were doing. Whenever you're working on your own projects, comments can help you remember where you left off. Leave comments on code that isn't working properly, or that you haven't finished yet.

   // Need to revisit the output for this before moving on echo "Hello World!"; 

3. How to Comment in PHP Picture 5
   Comment on code you intend to share. If you plan on collaborating with others, or intend to make your code open-source, comments can help others figure out how your code functions and the best places to make improvements.^[4]

   /* Is there a more effective way to accomplish this? */ Gender:   value="female">Female   value="male">Male 

4. How to Comment in PHP Picture 6
   Use comments to keep specific blocks of code from being run. This is useful if you're testing something and need to prevent certain code from being run. Anything contained within the comment tags will be ignored when the page is loaded.

5. How to Comment in PHP Picture 7
   Be careful when commenting out large blocks of code. The comment function will end whenever the first ending tag is hit, so if there's already a multi-line comment inside the code you comment out, the comment will only last until the end of the original nested comment.

    

6. How to Comment in PHP Picture 8
   Use comments to create pseudo-documentation. You can use some creative code formatting to create documentation for your code directly in the code. This can be useful for open-source projects.