給php程式碼新增規範的註釋

在phpdocumentor中，註釋分為文件性註釋和非文件性註釋。
所謂文件性註釋，是那些放在特定關鍵字前面的多行註釋，特定關鍵字是指能夠被phpdoc分析的關鍵字，例如class，var等，具體的可參加附錄1.
那些沒有在關鍵字前面或者不規範的註釋就稱作非文件性註釋，這些註釋將不會被phpdoc所分析，也不會出現在你產生的api文當中。
3.2如何書寫文件性註釋:
所 有的文件性註釋都是由/**開始的一個多行註釋，在phpDocumentor裡稱為DocBlock, DocBlock是指軟體開發人員編寫的關於某個關鍵字的幫助資訊，使得其他人能夠通過它知道這個關鍵字的具體用途，如何使用。 PhpDocumentor規定一個DocBlock包含如下資訊：

<?php

/**

* @name 名字

* @abstract 申明變數/類/方法

* @access 指明這個變數、類、函式/方法的存取許可權

* @author 函式作者的名字和郵箱地址

* @category  組織packages

* @copyright 指明版權資訊

* @const 指明常量

* @deprecate 指明不推薦或者是廢棄的資訊MyEclipse編碼設定

* @example 示例

* @exclude 指明當前的註釋將不進行分析，不出現在文擋中

* @final 指明這是一個最終的類、方法、屬性，禁止派生、修改。

* @global 指明在此函式中引用的全域性變數

* @include 指明包含的檔案的資訊

* @link 定義線上連線

* @module 定義歸屬的模組資訊

* @modulegroup 定義歸屬的模組組

* @package 定義歸屬的包的資訊

* @param 定義函式或者方法的引數資訊

* @return 定義函式或者方法的返回資訊

* @see 定義需要參考的函式、變數，並加入相應的超級連線。

* @since 指明該api函式或者方法是從哪個版本開始引入的

* @static 指明變數、類、函式是靜態的。

* @throws 指明此函式可能丟擲的錯誤異常,極其發生的情況

* @todo 指明應該改進或沒有實現的地方

* @var 定義說明變數/屬性。

* @version 定義版本資訊

*/

function XXX($a){..}

/** 
02.* some_func  
03.* 函式的含義說明 
04.* 
05.* @access public 
06.* @param mixed $arg1 引數一的說明 
07.* @param mixed $arg2 引數二的說明 
08.* @param mixed $mixed 這是一個混合型別 
09.* @since 1.0 
10.* @return array 
11.*/  
12.public function thisIsFunction($string, $integer, $mixed) {return array();}