PHP 可變參數函式三劍客：func_get_args、func_get_arg、func_num_args 完整解析

三函式速查

三者皆只能在使用者自訂函式內部呼叫，外部呼叫會觸發警告。

基礎範例

function foo() {
    $num = func_num_args();
    echo "參數個數: $num\n";
    if ($num >= 2) {
        echo "第 2 個參數: " . func_get_arg(1) . "\n";
    }
    $all = func_get_args();
    foreach ($all as $i => $v) {
        echo "參數 $i: $v\n";
    }
}

foo(1, 2, 3);
/* 輸出：
參數個數: 3
第 2 個參數: 2
參數 0: 1
參數 1: 2
參數 2: 3 */

實戰應用：彈性建構子（資料庫連線類）

class MyDB {
    private $host, $user, $pass, $db;

    public function __construct() {
        $n = func_num_args();
        if ($n === 0) return; // 允許無參數建構，稍後 init()

        $args = func_get_args();
        // 支援三種呼叫方式：
        // new MyDB('host', 'user', 'pass', 'db')
        // new MyDB(['host'=>..., 'user'=>..., 'pass'=>..., 'db'=>...])
        // new MyDB($configObj)
        if ($n === 1 && is_array($args[0])) {
            $cfg = $args[0];
        } elseif ($n >= 3) {
            $cfg = ['host'=>$args[0], 'user'=>$args[1], 'pass'=>$args[2], 'db'=>$args[3]??''];
        } else {
            throw new InvalidArgumentException('Invalid arguments');
        }
        $this->host = $cfg['host'];
        $this->user = $cfg['user'];
        $this->pass = $cfg['pass'];
        $this->db   = $cfg['db'];
        $this->connect();
    }
    // ...
}

進階技巧：配合 ... 運算子（PHP 5.6+）

現代 PHP 建議使用 ...$args 取代三函式，語意更清晰、效能更好：

function modernFoo(...$args) {
    echo "個數: " . count($args) . "\n";
    echo "第二個: " . ($args[1] ?? '無') . "\n";
    print_r($args);
}
modernFoo(1, 2, 3); // 相同效果

注意事項

• 三函式無法在箭頭函式（fn() => ...）中使用；
• func_get_arg() 索引超界會產生警告並回傳 false；
• 參考傳遞參數（function(&$a)）在 func_get_args() 回傳的陣列中為值複製，非引用；
• 效能敏感路徑避免頻繁呼叫，改用固定參數或 ...$args。