PHP 偽重載技術:利用 func_get_args 實現多態函數簽名
PHP 不支持傳統意義上的函數重載 (同名不同參數列表),但通過 func_get_args()、func_num_args()、func_get_arg() 三大函數,可實現參數數量/類型自適應的「偽重載」模式。
核心檢測函數
| 函數 | 返回值 | 用途 |
| func_num_args() | int | 實際傳遞參數個數 |
| func_get_arg(int $index) | mixed | 獲取指定索引參數值 |
| func_get_args() | array | 獲取所有參數數組 |
基礎偽重載實現
<?php
function test() {
$argNum = func_num_args();
$args = func_get_args(); // 獲取所有參數數組
switch ($argNum) {
case 0:
echo "無參數調用\n";
break;
case 1:
testOne($args[0]);
break;
case 2:
testTwo($args[0], $args[1]);
break;
case 3:
testThree($args[0], $args[1], $args[2]);
break;
default:
echo "參數過多: $argNum 個\n";
}
}
function testOne($a) { echo "1 參數: $a\n"; }
function testTwo($a, $b) { echo "2 參數: $a, $b\n"; }
function testThree($a, $b, $c) { echo "3 參數: $a, $b, $c\n"; }
// 測試
test(); // 無參數調用
test(1); // 1 參數: 1
test(1, 2); // 2 參數: 1, 2
test(1, 2, 3); // 3 參數: 1, 2, 3
test(1, 2, 3, 4); // 參數過多: 4 個
?>
構造函數偽重載 (經典應用場景)
<?php
class Config {
private $host = 'localhost';
private $port = 3306;
private $user = 'root';
private $pass = '';
private $dbname = 'test';
public function __construct() {
$args = func_get_args();
$num = func_num_args();
switch ($num) {
case 0:
// 使用所有默認值
break;
case 1:
// 僅指定 host
$this->host = $args[0];
break;
case 2:
// host, port
[$this->host, $this->port] = $args;
break;
case 4:
// host, port, user, pass
[$this->host, $this->port, $this->user, $this->pass] = $args;
break;
case 5:
// 所有參數
[$this->host, $this->port, $this->user, $this->pass, $this->dbname] = $args;
break;
default:
throw new InvalidArgumentException("無效參數數量: $num");
}
}
public function getDsn(): string {
return "mysql:host={$this->host};port={$this->port};dbname={$this->dbname}";
}
}
// 靈活實例化
$db1 = new Config(); // 全默認
$db2 = new Config('db.server'); // 指定 host
$db3 = new Config('db.server', 3307); // host + port
$db4 = new Config('db.server', 3306, 'user', 'pass'); // 4 參數
$db5 = new Config('db.server', 3306, 'user', 'pass', 'my_db'); // 全指定
?>
現代 PHP 替代方案 (PHP 7.0+)
1. 可選參數 + 默認值 (推薦)
<?php
function connect(
string $host = 'localhost',
int $port = 3306,
string $user = 'root',
string $pass = '',
string $dbname = 'test'
): PDO {
// 實現...
}
// 調用方式靈活多樣
connect();
connect('db.server');
connect('db.server', 3307);
connect(dbname: 'my_db'); // PHP 8.0+ 命名參數
connect(host: 'db.server', port: 3307, user: 'app');
?>
2. 參數對象模式 (複雜參數)
<?php
class ConnectParams {
public string $host = 'localhost';
public int $port = 3306;
public string $user = 'root';
public string $pass = '';
public string $dbname = 'test';
public int $timeout = 30;
public bool $ssl = false;
}
function connect(ConnectParams $params): PDO { /* ... */ }
// 使用
$params = new ConnectParams();
$params->host = 'db.server';
$params->dbname = 'production';
connect($params);
?>
3. 可變參數 (...) (PHP 5.6+)
<?php
function sum(int ...$numbers): int {
return array_sum($numbers);
}
sum(1, 2, 3); // 6
sum(...[1,2,3]); // 6 (解包數組)
sum(); // 0
?>
偽重載 vs 現代方案對比
| 維度 | func_get_args 偽重載 | 可選參數/命名參數 | 參數對象 |
| 代碼可讀性 | 低 (switch 分支) | 高 (聲明即文檔) | 高 (IDE 提示) |
| 類型安全 | 無 (運行時檢查) | 編譯期檢查 (PHP 7+) | 編譯期檢查 |
| 重構友好 | 差 | 好 | 優秀 |
| 向後兼容 | PHP 4+ | PHP 7.0+ / 8.0+ | PHP 5.0+ |
| 適用場景 | 舊代碼維護、簡單適配 | 新代碼首選 | 複雜配置、建構者模式 |
避坑指南
- ❌ 不要在偽重載中根據參數類型分發 (用聯合類型/多態替代)
- ❌ 不要濫用偽重載導致函數邏輯過於複雜
- ✅ 文檔註解標註
@param Type $name Description 提供 IDE 支持
- ✅ 參數驗證前置,拋出明確異常
- ✅ 遷移至現代 PHP 類型系統