PHP @param是一種在函數、方法或類中使用的注釋標記。它用于在文檔中說明傳遞給函數的參數名稱、數據類型和用途。正確使用@param標記可以幫助其他開發者更快速地理解您的代碼，減少可能出現的錯誤。

下面是示例代碼：

/**
 * 計算兩個數的和
 * @param int $num1 第一個數
 * @param int $num2 第二個數
 * @return int 兩個數的和
 */
function sum($num1, $num2) {
return $num1 + $num2;
}

這段代碼中，@param標記用于說明函數的兩個參數。第一個參數為$num1，表示第一個數；第二個參數為$num2，表示第二個數。通過這樣的注釋，其他開發者就可以明確了解這個函數需要傳入哪些參數，以及它們的含義和數據類型。

在實際開發中，正確使用@param標記也可以幫助開發者更好地完成參數校驗，防止錯誤輸入。例如：

/**
 * 獲取用戶信息
 * @param string $username 用戶名
 * @param string $password 密碼
 * @return array 用戶信息數組
 */
function getUserInfo($username, $password) {
// 校驗參數
if (empty($username) || empty($password)) {
return ['code' =>400, 'msg' =>'用戶名或密碼不能為空'];
}
// 查詢數據庫，獲取用戶信息
// ...
}

這里，通過對參數進行校驗，確保了函數會接收到符合要求的參數，避免了在函數內部因為參數錯誤而引起的錯誤和異常。

另外，@param標記還可以使用不同的描述詞語來進一步說明參數的作用和具體要求：

• @param int $num1 必填，第一個數
• @param string $name 姓名，必須是1-10個字符
• @param array $list 數組，必須包含鍵名為'id'的項

這些描述詞語可以在PHPDoc文檔中找到，開發者可以根據自己的需要使用。正確使用@param標記可以幫助其他開發者快速了解您的代碼，提高代碼的可讀性和可維護性。