我應該如何PHPDoc回調？

我有一種方法，從數據庫中提取修改過的預定義樹橫向樹，並過濾使用回調函數。例如：我應該如何PHPDoc回調？

/** 
* Recursive function for building the Cas_Template_TreeNode. 
* 
* @static 
* @param array $rows 
* @param callback $filter A function to filter the tree by (return a value convertible to false to remove the item from the tree) 
* @return array 
*/ 
private static function MakeTreeGivenDbRows($rows, $filter = null) 
{ 
    if ($filter === null) 
    { 
     $filter = function($unused) 
     { 
      return true; 
     }; 
    } 
    $result = array(); 
    $childrenCount = 0; 
    for ($idx = 0; $idx < count($rows); $idx += $childrenCount + 1) 
    { 
     $current = $rows[$idx]; 
     $childrenCount = self::ChildrenCountFromRow($current); 
     if (!$filter($current)) 
     { 
      continue; 
     } 
     $childrenStartAt = $idx + 1; 
     $childRows = array_slice($rows, $childrenStartAt, $childrenCount); 
     $children = self::MakeTreeGivenDbRows($childRows, $filter); 
     $result[] = new Cas_Template_TreeNode(self::MakeNodeGivenDbRow($current), $children); 
    } 
    if (empty($result)) 
    { 
     return null; 
    } 
    return $result; 
}

我不知道該PHPDoc的應該是什麼樣的變量$filter - 這是一個回調，這是我所指出的，但我不知道這是正確的。

而且，在此代碼的質量（或缺乏）任何其他意見，將不勝感激:)

來源

2011-02-07 Billy ONeal

很好的問題。 – zerkms 2011-02-07 07:32:48

正確的類型提示是callable，它已在例如PhpStorm中長期可用，並且是當前正在規範中的PSR-5的一部分。

（我很驚訝，沒有人提到callable，這不是什麼新和已經到處使用了多年 - 據我所知，callback是不是，也永遠是一個定義PHP pseudo-type）

注意callable不僅包括關閉，還有「老派」PHP回調，例如array($object, 'methodName')或array('ClassName', 'methodName')甚至'function_name' - 爲了最大限度地發揮您API的實用性，您應該涵蓋所有這些用例，這很容易，因爲call_user_func和call_user_func_array都支持所有四種可調用類型：function-name as string，object /方法名稱，類/方法名稱和關閉。

來源

2014-02-11 14:00:19