轉載自:http://hi.baidu.com/leo5210/item/291877ea5f125c345b7cfb83

所有的文件標記都是在每一行的 * 後面以@開頭。如果在一段話的中間出來@的標記，這個標記將會被當做普通內容而被忽略掉。
@access        該標記用於指明關鍵字的存取許可權：private、public或proteced 使用範圍：class,function,var,define,module
@author        指明作者
@copyright    指明版權資訊
@const        使用範圍：define 用來指明php中define的常量
@final            使用範圍：class,function,var 指明關鍵字是一個最終的類、方法、屬性，禁止派生、修改。
@global        指明在此函式中引用的全域性變數
@name            為關鍵字指定一個別名。
@package    用於邏輯上將一個或幾個關鍵字分到一組。
@abstrcut    說明當前類是一個抽象類
@param        指明一個函式的引數
@return        指明一個方法或函式的返回值
@static            指明關建字是靜態的。
@var            指明變數型別
@version        指明版本資訊
@todo            指明應該改進或沒有實現的地方
@link            可以通過link指到文件中的任何一個關鍵字
@ingore        用於在文件中忽略指定的關鍵字

一些註釋規範
a.註釋必須是
/**
* XXXXXXX
*/
的形式
b.對於引用了全域性變數的函式，必須使用glboal標記。
c.對於變數，必須用var標記其型別（int,string,bool…）
d.函式必須通過param和return標記指明其引數和返回值
e.對於出現兩次或兩次以上的關鍵字，要通過ingore忽略掉多餘的，只保留一個即可
f.呼叫了其他函式或類的地方，要使用link或其他標記連結到相應的部分，便於文件的閱讀。
g.必要的地方使用非文件性註釋（PHPDOC無法識別的關鍵字前的註釋），提高程式碼易讀性。
h.描述性內容儘量簡明扼要，儘可能使用短語而非句子。
i.全域性變數，靜態變數和常量必須用相應標記說明

能夠被phpdoc識別的關鍵字：
Include
Require
include_once
require_once
define
function
global
class

規範註釋的php程式碼 :

1. <?php  
2. /** 
3. * 檔名(sample2.php) 
4. * 
5. * 功能描述（略） 
6. * 
7. * @author steve <[email protected]> 
8. * @version 1.0 
9. * @package sample2 
10. */  
11. /** 
12. * 包含檔案 
13. */  
14. include_once 'sample3.php';  
15. /** 
16. * 宣告全域性變數 
17. * @global integer $GLOBALS['_myvar'] 
18. * @name $_myvar 
19. */  
20. $GLOBALS['_myvar'] = 6;  
21. /** 
22. * 宣告全域性常量 
23. */  
24. define('NUM', 6);  
25. /** 
26. * 類名 
27. * 
28. * 類功能描述 
29. * 
30. * @package sample2 
31. * @subpackage classes(如果是父類 就新增) 
32. */  
33. class myclass {  
34. /** 
35. * 宣告普通變數 
36. * 
37. * @accessprivate 
38. * @var integer|string 
39. */  
40. var $firstvar = 6;  
41. /** 
42. * 建立建構函式 {@link $firstvar} 
43. */  
44. function myclass() {  
45. $this->firstvar = 7;  
46. }  
47. /** 
48. * 定義函式 
49. * 
50. * 函式功能描述 
51. * 
52. * @global string $_myvar 
53. * @staticvar integer $staticvar 
54. * @param string $param1 
55. * @param string $param2 
56. * @return integer|string 
57. */  
58. function firstFunc($param1, $param2 = 'optional') {  
59. static $staticvar = 7;  
60. global $_myvar;  
61. return $staticvar;  
62. }  
63. }  
64. ?>