<?php
    echo 'This is a test'; // 這是單行 c++ 樣式注釋
    /* 這是一條多行注釋
       另一行也是注釋 */
    echo 'This is yet another test';
    echo 'One Final Test'; # 這是單行 shell 風(fēng)格的注釋
?>

2.1 行注釋

單行注釋

C 風(fēng)格單行注釋

<?php
    //這是第二行注釋
    echo "http://c.biancheng.net/php/";
    // echo "PHP 注釋";
?>

shell 風(fēng)格單行注釋

   #這是第一行注釋
    echo "C語言中文網(wǎng)<br>";

注意：單行注釋僅僅注釋到行末或者當(dāng)前的 PHP 代碼塊，視乎哪個(gè)首先出現(xiàn)。這意味著在 // … ?> 或者 # … ?> 之后的 HTML 代碼將被顯示出來：?> 跳出了 PHP 模式并返回了 HTML 模式，// 或 # 并不能影響到這一點(diǎn)。

<h1>This is an <?php # echo 'simple';?> example</h1>
<p>The header above will say 'This is an example'.</p>

2.2 多行注釋

在需要注釋的代碼塊上以/* 開始，以*/結(jié)束。

<?php
	/*
	    $a = "這是第一行";
	    $b = "這是第二行";
	    $c = "這是第三行";
	*/

注意：C 風(fēng)格的注釋在碰到第一個(gè) */ 時(shí)結(jié)束。要確保不要嵌套 C 風(fēng)格的注釋。

// 錯(cuò)誤的寫法
// Error: expect statement
/*
   echo 'This is a test'; /* 這個(gè)注釋會引發(fā)問題 */
*/
?>

3 小結(jié)

合理使用注釋應(yīng)該滿足以下幾項(xiàng)原則：

注釋必須準(zhǔn)確、易懂、簡潔，錯(cuò)誤的注釋不但無益反而有害；
注釋可以書寫在代碼中的任意位置，但是一般寫在代碼的開頭或者結(jié)束位置；
修改程序代碼時(shí)，一定要同時(shí)修改相關(guān)的注釋，以保持代碼和注釋的同步；
在實(shí)際的代碼規(guī)范中，要求注釋占程序代碼的 20% 左右，即 100 行程序中包含 20 行左右的注釋；
避免在注釋中使用縮寫，特別是不常用縮寫；
注釋與所描述內(nèi)容進(jìn)行同樣的縮進(jìn)，可使程序排版整齊，并方便注釋的閱讀與理解。

到此這篇關(guān)于PHP入門基礎(chǔ)之注釋的寫法的文章就介紹到這了,更多相關(guān)PHP注釋內(nèi)容請搜索腳本之家以前的文章或繼續(xù)瀏覽下面的相關(guān)文章希望大家以后多多支持腳本之家！

您可能感興趣的文章:

PHP
注釋

欧美bbbwbbbw肥妇,免费乱码人妻系列日韩,一级黄片

軟件下載

源碼下載

軟件編程

網(wǎng)絡(luò)編程

在線工具

數(shù)據(jù)庫

CMS

常用工具

PHP入門基礎(chǔ)之注釋的寫法

目錄

1 什么是注釋

1.1 注釋的目的

1.2 注釋的格式

2 PHP 的注釋格式

2.1 行注釋

2.2 多行注釋

3 小結(jié)

相關(guān)文章

最新評論

大家感興趣的內(nèi)容

最近更新的內(nèi)容

常用在線小工具