動態函數呼叫是實現插件架構、事件系統、命令模式、延遲執行的關鍵技術。本文系統整理 `call_user_func`、`call_user_func_array`、變數函數、閉包綁定等多種動態呼叫方式,並說明參考傳遞、錯誤處理與安全性考量。
| 方式 | 語法 | 參數傳遞 | 適用場景 | PHP 版本 |
|---|---|---|---|---|
| 變數函數 | `$funcName($arg1, $arg2)` | 列舉 | 簡單、固定參數、已知函數名變數 | 所有 |
| call_user_func | `call_user_func($callable, $arg1, $arg2...)` | 列舉 | 回調、靜態方法、需統一錯誤處理 | 所有 |
| call_user_func_array | `call_user_func_array($callable, $argsArray)` | 陣列 | 動態參數數量、參數來自陣列/JSON | 所有 |
| 解包運算子 | `$callable(...$args)` | 陣列解包 | 現代寫法、效能最佳、可讀性高 | 5.6+ |
<?php
function add($a, $b) { return $a + $b; }
function greet($name, $title = '') { echo "Hello, $title$name!\n"; }
// 1. 變數函數
$func = 'add';
echo $func(1, 2); // 3
// 2. call_user_func
echo call_user_func('add', 3, 4); // 7
call_user_func('greet', 'Alice', 'Ms. '); // Hello, Ms. Alice!
// 3. call_user_func_array
echo call_user_func_array('add', [5, 6]); // 11
call_user_func_array('greet', ['Bob', 'Dr. ']); // Hello, Dr. Bob!
// 4. 解包運算子 (PHP 5.6+)
$args = [7, 8];
echo $func(...$args); // 15
greet(...['Charlie', 'Prof. ']); // Hello, Prof. Charlie!
<?php
class Calculator {
public static function mul($a, $b) { return $a * $b; }
public function div($a, $b) { return $b ? $a / $b : INF; }
public function __call($name, $args) {
echo "Magic call: $name with " . implode(', ', $args) . "\n";
}
}
// 靜態方法
call_user_func(['Calculator', 'mul'], 3, 4); // 12
call_user_func_array(['Calculator', 'mul'], [5, 6]); // 30
// 實例方法
$calc = new Calculator();
call_user_func([$calc, 'div'], 10, 2); // 5
call_user_func_array([$calc, 'div'], [9, 3]); // 3
// 魔術方法 __call 也會被觸發
call_user_func([$calc, 'pow'], 2, 8); // Magic call: pow with 2, 8
<?php
interface PaymentGateway {
public function charge(float $amount, array $details): bool;
}
class StripeGateway implements PaymentGateway { /* ... */ }
class PayPalGateway implements PaymentGateway { /* ... */ }
$gateways = [
'stripe' => new StripeGateway(),
'paypal' => new PayPalGateway(),
];
function processPayment(string $gateway, float $amount, array $details): bool {
global $gateways;
if (!isset($gateways[$gateway])) {
throw new InvalidArgumentException("Unknown gateway: $gateway");
}
// 動態呼叫介面方法
return call_user_func_array([$gateways[$gateway], 'charge'], [$amount, $details]);
}
<?php
class EventDispatcher {
private array $listeners = [];
public function on(string $event, callable $listener): void {
$this->listeners[$event][] = $listener;
}
public function dispatch(string $event, array $payload = []): void {
foreach ($this->listeners[$event] ?? [] as $listener) {
// 使用 call_user_func_array 統一處理參數
call_user_func_array($listener, [$payload]);
}
}
}
$dispatcher = new EventDispatcher();
$dispatcher->on('user.registered', function($payload) {
echo "Welcome email sent to {$payload['email']}\n";
});
$dispatcher->on('user.registered', function($payload) {
echo "Analytics event tracked for user {$payload['id']}\n";
});
$dispatcher->dispatch('user.registered', ['id' => 123, 'email' => 'user@example.com']);
// Welcome email sent to user@example.com
// Analytics event tracked for user 123
<?php
class CommandQueue {
private array $queue = [];
public function push(callable $callable, array $args = []): void {
$this->queue[] = [$callable, $args];
}
public function execute(): void {
while ($job = array_shift($this->queue)) {
[$callable, $args] = $job;
try {
call_user_func_array($callable, $args);
} catch (Throwable $e) {
error_log("Command failed: " . $e->getMessage());
}
}
}
}
$queue = new CommandQueue();
$queue->push('sendEmail', ['user@example.com', 'Hello']);
$queue->push([new NotificationService(), 'notify'], ['msg' => 'Task done']);
$queue->execute();
<?php
function increment(&$value) { $value++; }
$num = 10;
// 正確方式:定義函數參數為參考,呼叫時正常傳遞變數
call_user_func('increment', $num); // $num 變 11
call_user_func_array('increment', [$num]); // $num 變 12
// 錯誤示範(PHP 5.3+ 廢棄、PHP 8.0+ 錯誤):
// call_user_func('increment', &$num);
// 若必須在呼叫端控制參考,使用閉包包裝
$refIncrement = fn(&$v) => $v++;
call_user_func($refIncrement, $num); // $num 變 13
<?php
function safeCall(callable $callable, array $args = [], callable $fallback = null): mixed {
try {
if (!is_callable($callable)) {
throw new InvalidArgumentException('Invalid callable');
}
return call_user_func_array($callable, $args);
} catch (Throwable $e) {
error_log("Dynamic call failed: " . $e->getMessage());
if ($fallback) return $fallback($e, $args);
throw $e; // 重拋或回傳 null
}
}
// 安全呼叫
$result = safeCall('dangerousFunction', [$input], fn($e) => null);
// 防止任意代碼執行:白名單驗證
$allowedFunctions = ['trim', 'strtoupper', 'json_encode', 'htmlspecialchars'];
function safeUserFunc(string $funcName, mixed $arg): mixed {
global $allowedFunctions;
if (!in_array($funcName, $allowedFunctions, true)) {
throw new Exception("Function not allowed: $funcName");
}
return call_user_func($funcName, $arg);
}
動態函數呼叫是 PHP 靈活性的核心體現。現代專案建議: