PHP注釋的應(yīng)用

    注釋即代碼的解釋和說明，一般放在代碼上方或代碼的尾部（放在尾部時，代碼和注釋之間以Tab鍵進(jìn)行分隔，以方便程序閱讀），用來說明代碼或函數(shù)的編寫人、用途、時間等。注釋不會影響到程序的執(zhí)行，因為在執(zhí)行時，注釋部分會被解釋器忽略不計。

    PHP支持3種風(fēng)格的程序注釋。

    @ 單行注釋（//）

    這是一種來源于C++語言語法的注釋模式，可以寫在PHP語句的上方，也可以寫在后方。

    <?php

        //這是寫在PHP語句上方的單行注釋

        echo '使用C++風(fēng)格的注釋';

    ?>

    <?php

        echo '使用C++風(fēng)格的注釋';      //這是寫在PHP語句后面的單行注釋

    ?>

    @ 多行注釋（/*...*/）

    這是一種來源于C語言語法的注釋模式，可以分為塊注釋和文檔注釋。

    塊注釋：

    <?php

        /*

        $a=1;

        $b=2;

        echo($a + $b);

        */

        echo 'PHP的多行注釋';

    ?>

    文檔注釋：

    <?php

        /* 說明：項目工具類

        * 作者：小辛

        * E-mail:mingrisoft@mingrisoft.com

        */

        class Util

        {

            /**

            * 方法說明：給字符串加前綴

            * 參數(shù)：String $str

            * 返回值：String

            */

            function addPrefix($str)

            {

                $str.='mingri';

                return $str;

            }

        }

    ?>

    @ #風(fēng)格的注釋（#）

    <?php

        echo '這是#風(fēng)格的注釋';        //這是#風(fēng)格的單行注釋

    ?>