中文(繁體)
中文(繁體)
為PHP 函數編寫清晰且全面的文檔對於模塊化、可維護和團隊協作的代碼至關重要。遵循標準化的文檔慣例有助於確保文檔一致且易於理解。
函數名稱應以小寫字母開頭，並使用下劃線分隔單詞（例如：my_function）。同時，遵循PSR-2 命名約定，類和方法名稱應使用駝峰命名法（例如：MyFunction）。
使用@param 標籤指定函數參數的類型和描述。
/**
* @param string $name 用戶名* @param string $password 密碼*/
function login(string $name, string $password) {}
使用@return 標籤指定函數的返回值類型和描述。
/**
* @return bool 登錄是否成功*/
function login(string $name, string $password): bool {}
使用@throws 標籤指定函數可能引發的異常類型和描述。
/**
* @throws InvalidArgumentException 如果$name 或$password 為空*/
function login(string $name, string $password): bool {}
符合PSR-5 註釋塊標準的函數註釋示例：
/**
* 登陸用戶* @param string $name 用戶名* @param string $password 密碼* @return bool 登錄是否成功* @throws InvalidArgumentException 如果$name 或$password 為空*/
function login(string $name, string $password): bool {}
示例：獲取當前時間。
/**
* 獲取當前時間* @return string 當前時間字符串*/
function get_current_time(): string {
return date('Ymd H:i:s');
}
示例：計算兩個數字的和。
/**
* 計算兩個數字的和* @param int $a 第一個數字* @param int $b 第二個數字* @return int 和*/
function sum(int $a, int $b): int {
return $a + $b;
}
