萬盛學電腦網

您现在的位置: 萬盛學電腦網 >> 程式設計 >  >> 網路程式設計 >> PHP 程式設計

PHP 外部獲取函數參數個數:利用 Reflection 讀取簽名

func_num_args() 只能在函數**內部**獲取實際傳入參數數量。若需在**外部** (不調用函數) 獲取**定義時的參數個數**,需使用 Reflection API。

ReflectionParameter 方案

<?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";
}

進階:讀取 DocBlock 註解獲取語義參數

若需獲取 @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";
}

應用場景

  • 自動生成 API 文檔 (Swagger/OpenAPI)
  • 依賴注入容器自動解析建構子參數
  • RPC 框架參數驗證、序列化
  • 代碼生成器、靜態分析工具

注意

  • Reflection 有效能開銷,**勿在熱路徑 (高頻請求) 重複反射**,應快取結果。
  • 內部函數 (如 strlen) 也可反射,但無法獲取預設值細節。
  • PHP 8+ 可用 ReflectionFunction::getTentativeReturnType() 等新特性。
copyright © 萬盛學電腦網 all rights reserved