函式是程式碼複用、抽象邏輯、構建模組化系統的基本單元。PHP 從早期簡單的 function name() 演進至今,支援型別宣告、回傳型別、可變參數、參考傳遞、箭頭函式、首級可呼叫物件等現代特性。本文系統整理自訂函式的完整語法、進階模式與工程化最佳實踐。
myFunc, _privateHelpergetUserById, calculate_v2myFunc() === MYFUNC()(但建議統一風格)get..., set..., calculate..., handle..., validate...<?php
// 完整語法(PHP 7/8+)
function functionName(
Type1 $param1, // 型別宣告
Type2 $param2 = default, // 預設值
Type3 ...$varArgs // 可變參數
): ReturnType { // 回傳型別
// 函式主體
return $result;
}
// 實際範例
function calculateCircleArea(float $radius): float {
return $radius * $radius * M_PI;
}
echo calculateCircleArea(20); // 1256.637...
?>
<?php
function modifyValue($value) {
$value = 'changed';
}
$original = 'original';
modifyValue($original);
echo $original; // 'original'(未被修改)
?>
<?php
function modifyReference(&$value) {
$value = 'changed';
}
$original = 'original';
modifyReference($original);
echo $original; // 'changed'(被修改)
// 實際應用:陣列去重修改原陣列
function removeDuplicates(array &$arr): void {
$arr = array_values(array_unique($arr));
}
$data = [1, 2, 2, 3, 3];
removeDuplicates($data);
// $data 變為 [1, 2, 3]
?>
<?php
function greet(string $name = 'Guest', string $greeting = 'Hello'): string {
return "$greeting, $name!";
}
echo greet(); // Hello, Guest!
echo greet('Alice'); // Hello, Alice!
echo greet('Bob', 'Hi'); // Hi, Bob!
echo greet(greeting: 'Hey'); // Hey, Guest! (PHP 8+ 命名參數)
?>
<?php
// PHP 5.6+ ... 運算子
function sum(int ...$numbers): int {
return array_sum($numbers);
}
echo sum(1, 2, 3); // 6
echo sum(...[4, 5, 6]); // 15 (解包陣列)
// 僅最後一個參數可為可變參數
function buildQuery(string $table, string ...$columns): string {
return "SELECT " . implode(', ', $columns) . " FROM $table";
}
?>
<?php
function createUser(
string $name,
string $email,
int $age = 18,
bool $active = true,
string $role = 'user'
): User {
// ...
}
// PHP 8+ 命名參數:順序無關、可跳過預設值
$user = createUser(
name: 'Alice',
email: 'alice@example.com',
role: 'admin' // 跳過 age、active 使用預設值
);
?>
<?php
// 基本型別
function getName(): string { ... }
function getCount(): int { ... }
function isValid(): bool { ... }
function getPrice(): float { ... }
// 物件/介面型別
function getUser(): User { ... }
function getLogger(): LoggerInterface { ... }
// 可為 null(PHP 7.1+)
function findUser(int $id): ?User { ... }
// void:不回傳值(PHP 7.1+)
function logMessage(string $msg): void {
error_log($msg);
// return; // 可選,不可 return 值
}
// never:永不返回(PHP 8.1+)
function throwError(string $msg): never {
throw new Exception($msg);
}
// 多型回傳(PHP 8.0+ 聯合型別)
function getData(): array|string|false { ... }
?>
| 策略 | 適用場景 | 範例 |
|---|---|---|
| 陣列解構 | 固定結構、少量欄位 | [$a, $b] = func() |
| 關聯陣列 | 動態欄位、選填資料 | ['key' => $val] = func() |
| DTO/Value Object | 領域模型、型別安全 | return new UserDTO(...) |
| Generator | 大量資料流、記憶體效率 | yield $item; return $total; |
| 物件屬性 | 建構器/建構者模式 | $obj->setX()->setY()->build() |
<?php
function readLargeCsv(string $filename): Generator {
$handle = fopen($filename, 'r');
try {
while (($row = fgetcsv($handle)) !== false) {
yield $row; // 暫停執行,產生一行
}
} finally {
fclose($handle);
}
}
// 使用:記憶體常數,不載入整個檔案
foreach (readLargeCsv('huge.csv') as $row) {
processRow($row);
}
?>
<?php
function factorial(int $n): int {
return $n <= 1 ? 1 : $n * factorial($n - 1);
}
// 尾遞迴優化(PHP 不支援 TCO,深度遞迴會堆疊溢位)
// 大量遞迴請改用迭代或 Generator
?>
<?php
// 匿名函式指派給變數
$multiply = function(int $a, int $b): int {
return $a * $b;
};
// 閉包:綁定外部變數
$factor = 10;
$multiplyByFactor = function(int $n) use ($factor): int {
return $n * $factor;
};
// 箭頭函式(PHP 7.4+):隱性按值綁定
$multiplyByFactor = fn(int $n): int => $n * $factor;
// 閉包綁定物件作用域
class Multiplier {
private int $factor = 5;
public function getClosure(): Closure {
return function(int $n): int {
return $n * $this->factor; // 自動綁定 $this
};
}
}
?>
<?php
class Calculator {
public function add(int $a, int $b): int { return $a + $b; }
public static function mul(int $a, int $b): int { return $a * $b; }
}
$calc = new Calculator();
// PHP 8.1+ 首級可呼叫語法
$add = $calc->add(...); // Closure 物件
$mul = Calculator::mul(...); // 靜態方法
echo $add(2, 3); // 5
echo $mul(2, 3); // 6
// 替代舊式
$addOld = [$calc, 'add'];
$mulOld = [Calculator::class, 'mul'];
?>
<?php
function_exists('json_encode'); // true
function_exists('my_custom_func'); // 檢查自訂函式
// 反射取得函式資訊
$ref = new ReflectionFunction('calculateCircleArea');
$ref->getParameters(); // 參數資訊
$ref->getReturnType(); // 回傳型別
$ref->getDocComment(); // 文件註解
$ref->invoke(10); // 動態呼叫
?>
| 元素 | 慣例 | 範例 |
|---|---|---|
| 函式名稱 | camelCase | getUserById(), calculateTotal() |
| 類別方法 | camelCase | public function saveUser() |
| 私有/保護方法 | 底線前綴 + camelCase | _parseResponse(), _validateInput() |
| 常數 | 全大寫底線分隔 | MAX_RETRY_COUNT, DEFAULT_TIMEOUT |
| 變數 | camelCase 或 snake_case | $userName, $user_name(專案統一) |
| 參數 | camelCase | function($userId, $includeDetails) |
function(&$a) 正確,function(&$a = 1) 錯誤(預設值不能用參考)function(...$a, $b) ❌,必須在最後function(): void { return 1; } ❌ Fatal Errordeclare(strict_types=1) 會拋出 TypeErrorstatic 內部函式減少查找PHP 函式機制經過多版本演進,已具備現代語言的完整特性:型別系統、參考/值傳遞、可變參數、命名參數、Generator、首級可呼叫物件。掌握這些特性,配合 declare(strict_types=1)、PHPStan 靜態分析、PSR-12 風格規範,能寫出型別安全、可讀性高、效能優異的函式庫與應用程式核心邏輯。