php函數和方法的注釋（php注釋種類有哪些?這些注釋在何種場合下使用）

• 1、php怎麼查看類方法的自定義文字注釋說明
• 2、php中怎樣注釋掉一部分的代碼
• 3、php中如何給類規範的注釋
• 4、什麼是PHP的函數？

@access

使用範圍：class,function,var,define,module

該標記用於指明關鍵字的存取權限：private、public或proteced

@author

指明作者

@copyright

使用範圍：class，function，var，define，module，use

指明版權信息

@deprecated

使用範圍：class，function，var，define，module，constent，global，include

指明不用或者廢棄的關鍵字

@example

該標記用於解析一段文件內容，並將他們高亮顯示。Phpdoc會試圖從該標記給的文件路徑中讀取文件內容

@const

使用範圍：define

用來指明php中define的常量

@final

使用範圍：class,function,var

指明關鍵字是一個最終的類、方法、屬性，禁止派生、修改。

@filesource

和example類似，只不過該標記將直接讀取當前解析的php文件的內容並顯示。

@global

指明在此函數中引用的全局變量

1、首先要先建一個php的文件(這裡名字叫comment.php，可以隨便改)。

2、然後要在文件裏面寫入PHP運行的基本格式。

3、第一種注釋方法:使用雙斜杠’//’作為單行注釋。

4、第二種注釋方法:也是單行注釋，是用’#’符號。

5、第三種注釋方法:多行注釋，是用’/**/’符號，中間可以換行。

6、最後運行看一下效果，這樣注釋就不會顯示在前端頁面上了。

需要準備的材料分別是：電腦、phpstrom編輯器。

1、首先，打開phpstrom編輯器，新建php文件，例如：index.php，定義一個函數示例。

2、在function的上方一行，輸入：/**，然後按回車。

3、此時會發現phpstrom編輯器將函數的注釋自動生成了。

PHP 用戶定義函數

除了內建的 PHP 函數，我們可以創建我們自己的函數。

函數是可以在程序中重複使用的語句塊。

頁面加載時函數不會立即執行。

函數只有在被調用時才會執行。

在 PHP 創建用戶定義函數

用戶定義的函數聲明以關單 “function” 開頭：

語法

function functionName() {

被執行的代碼;

}

注釋：函數名能夠以字母或下劃線開頭（而非數字）。

注釋：函數名對大小寫不敏感。

提示：函數名應該能夠反映函數所執行的任務。

在下面的例子中，我們創建名為 “writeMsg()” 的函數。打開的花括號（{）指示函數代碼的開始，而關閉的花括號（}）指示函數的結束。此函數輸出 “Hello world!”。如需調用該函數，只要使用函數名即可：

?php

function writeMsg() {

echo “Hello world!”;

}

writeMsg(); // 調用函數

?

PHP 函數參數

可以通過參數向函數傳遞信息。參數類似變量。

參數被定義在函數名之後，括號內部。您可以添加任意多參數，只要用逗號隔開即可。

下面的例子中的函數有一個參數（$fname）。當調用 familyName() 函數時，我們同時要傳遞一個名字（例如 Bill），這樣會輸出不同的名字，但是姓氏相同：

?php

function familyName($fname) {

echo “$fname Zhang.br”;

}

familyName(“Li”);

familyName(“Hong”);

familyName(“Tao”);

familyName(“Xiao Mei”);

familyName(“Jian”);

?

下面的例子中的函數有兩個參數（$fname 和 $year）：

?php

function familyName($fname,$year) {

echo “$fname Zhang. Born in $year br”;

}

familyName(“Li”,”1975″);

familyName(“Hong”,”1978″);

familyName(“Tao”,”1983″);

?

PHP 默認參數值

下面的例子展示了如何使用默認參數。如果我們調用沒有參數的 setHeight() 函數，它的參數會取默認值：

?php

function setHeight($minheight=50) {

echo “The height is : $minheight br”;

}

setHeight(350);

setHeight(); // 將使用默認值 50

setHeight(135);

setHeight(80);

?

PHP 函數 – 返回值

如需使函數返回值，請使用 return 語句：

?php

function sum($x,$y) {

$z=$x+$y;

return $z;

}

echo “5 + 10 = ” . sum(5,10) . “br”;

echo “7 + 13 = ” . sum(7,13) . “br”;

echo “2 + 4 = ” . sum(2,4);

?