<?php
// 完整語法 (PHP 8+)
function functionName(
Type1 $param1,
Type2 $param2 = 'default',
...Type3 $variadicParams
): ReturnType {
// 函數主體
return $result;
}
?>
| 模式 | 語法 | 特性 | 適用場景 |
|---|---|---|---|
| 值傳遞 (預設) | function foo($x) | 複製值,函數內修改不影響外部 | 標量、陣列 (複製)、物件 (複製引用) |
| 參考傳遞 | function foo(&$x) | 傳遞變數別名,修改影響原變數 | 需修改原變數、大型陣列避免複製 |
| 預設值 | function foo($x = 'default') | 呼叫時可省略,預設值必為常數表達式 | 可選參數 |
| 型別宣告 (PHP 7+) | function foo(int $x): int | 強制型別檢查 (嚴格模式下) | API 契約、自動文件、靜態分析 |
| 可變參數 (PHP 5.6+) | function foo(...$args) | 接收任意數量參數為陣列 | 不定參數、中介軟體、包裝函數 |
| 命名參數 (PHP 8+) | foo(paramName: value) | 依名稱傳遞,順序無關、可跳過預設值 | 參數多、預設值多、可讀性 |
<?php
function byValue($num) {
$num += 1;
echo "函數內: $num\n";
}
function byRef(&$num) {
$num += 1;
echo "函數內: $num\n";
}
$value = 10;
byValue($value);
echo "函數外: $value\n"; // 10 (未變)
$value = 10;
byRef($value);
echo "函數外: $value\n"; // 11 (被修改)
?>
<?php
declare(strict_types=1); // 檔案頂端
function add(int $a, int $b): int {
return $a + $b;
}
echo add(1, 2); // 3
// echo add(1.5, 2); // TypeError: float 傳給 int
// echo add("1", 2); // TypeError: string 傳給 int (嚴格模式)
// 弱類型模式 (預設) 會嘗試強制轉換
?>
<?php
function sum(int ...$numbers): int {
return array_sum($numbers);
}
echo sum(1, 2, 3, 4); // 10
$arr = [5, 6, 7];
echo sum(...$arr); // 18 (解包陣列)
?>
<?php
function createUser(string $name, int $age = 18, string $role = 'member', bool $active = true): User {
// ...
}
// 呼叫方式
createUser('Alice'); // 全部預設
createUser('Bob', age: 25); // 指定 age,跳過 role
createUser('Charlie', role: 'admin', active: false); // 任意順序
?>
return 立即結束函數並回傳值。return 或 return; 回傳 null。: int、: string、: array、: ?User (可為 null)、: never (PHP 8.1+ 永不回傳)。void 表示不應回傳值 (PHP 7.1+)。<?php
// 變數函數
$func = 'strlen';
echo $func('hello'); // 5
// 匿名函數 (Closure)
$multiply = fn($a, $b) => $a * $b; // 箭頭函數 PHP 7.4+
$multiply = function($a, $b) { return $a * $b; }; // 完整語法
// 綁定作用域
$factor = 10;
$multiplyByFactor = fn($x) => $x * $factor; // 自動捕獲 $factor
// callable 型別提示
function execute(callable $callback, mixed ...$args): mixed {
return $callback(...$args);
}
?>
declare(strict_types=1);。global 或 $GLOBALS。@param、@return、@throws。& 導致預期修改失效。function foo($x = time()) ❌ (PHP 8.1+ 允許常數表達式,但仍建議避免)。sort、count)。函數是程式碼複用的基本單元,善用現代 PHP 的型別系統與參數特性,能建立健壯、自文件化的 API 介面。