func_num_args() 只能在函數**內部**獲取實際傳入參數數量。若需在**外部** (不調用函數) 獲取**定義時的參數個數**,需使用 Reflection API。
<?php
function war($a, $b, $c = 'default', ...$rest) {}
$refFunc = new ReflectionFunction('war');
$params = $refFunc->getParameters();
echo "參數總數: " . count($params) . "\n"; // 4
foreach ($params as $p) {
echo "名稱: {$p->name}";
echo $p->isOptional() ? ' (可選' . ($p->isDefaultValueAvailable() ? ', 預設: ' . var_export($p->getDefaultValue(), true) : '') . ')' : ' (必填)';
echo $p->isVariadic() ? ' ...可變參數' : '';
echo "\n";
}
/* 輸出:
參數總數: 4
名稱: a (必填)
名稱: b (必填)
名稱: c (可選, 預設: 'default')
名稱: rest ...可變參數
*/
class Service {
public function handle(string $id, array $data = [], ?Logger $logger = null) {}
}
$refMethod = new ReflectionMethod(Service::class, 'handle');
foreach ($refMethod->getParameters() as $p) {
echo "{$p->name}: ";
echo $p->hasType() ? $p->getType() . ' ' : 'mixed ';
echo $p->isOptional() ? 'optional' : 'required';
echo "\n";
}
若需獲取 @param string $a 說明 這類語義資訊,需解析 DocBlock:
/**
* 處理訂單
* @param string $orderId 訂單ID
* @param array $items 商品列表
* @return bool
*/
function processOrder($orderId, $items) {}
$ref = new ReflectionFunction('processOrder');
$doc = $ref->getDocComment();
// 簡易正則提取 @param (生產建議用 phpDocumentor/ReflectionDocBlock 庫)
preg_match_all('/@param\s+(\S+)\s+\$(\w+)\s*(.*)/', $doc, $m, PREG_SET_ORDER);
foreach ($m as [$_, $type, $name, $desc]) {
echo "$name ($type): $desc\n";
}
strlen) 也可反射,但無法獲取預設值細節。ReflectionFunction::getTentativeReturnType() 等新特性。