函數是程式碼重用的基本單位。PHP 內建 700+ 函數,也支援使用者自訂函數。本文完整涵蓋函數定義、參數傳遞、回傳值、變數範圍、型別宣告、可變參數、匿名函數等核心概念。
<?php
// 定義函數
function writeMyName() {
echo "Kai Jim Refsnes";
}
// 呼叫函數
writeMyName(); // 輸出:Kai Jim Refsnes
// 在程式流程中穿插呼叫
echo "Hello world!<br>";
echo "My name is ";
writeMyName();
echo ".<br>That's right, ";
writeMyName();
echo " is my name.";
?>
<?php
function writeMyName(string $fname): void {
echo "$fname Refsnes<br>";
}
writeMyName("Kai Jim"); // Kai Jim Refsnes
writeMyName("Hege"); // Hege Refsnes
writeMyName("Stale"); // Stale Refsnes
?>
<?php
function writeMyName(string $fname, string $punctuation): void {
echo "$fname Refsnes$punctuation<br>";
}
writeMyName("Kai Jim", ".");
writeMyName("Hege", "!");
writeMyName("Ståle", "...");
?>
<?php
function greet(string $name, string $greeting = "Hello"): void {
echo "$greeting, $name!<br>";
}
greet("John"); // Hello, John!
greet("John", "Hi"); // Hi, John!
greet("Mary", "早安"); // 早安, Mary!
// 注意:有預設值的參數必須在無預設值參數之後
// function foo($a = 1, $b) {} // 錯誤
?>
<?php
// 純量型別:int, float, string, bool
// 類別/介面型別
// 回傳型別宣告在參數列後:: type
function add(int $x, int $y): int {
return $x + $y;
}
function getUser(int $id): ?User { // 可回傳 null
// ...
return null;
}
// 嚴格模式(檔案最頂端宣告)
declare(strict_types=1);
?>
<?php
function add(int $x, int $y): int {
$total = $x + $y;
return $total; // 結束函數並回傳值
}
echo "1 + 16 = " . add(1, 16); // 1 + 16 = 17
// 多重回傳(透過陣列或物件)
function divmod(int $a, int $b): array {
return [$a / $b, $a % $b];
}
[$quotient, $remainder] = divmod(10, 3); // 解構賦值 PHP 7.1+
echo "商:$quotient 餘數:$remainder";
?>
| 範圍類型 | 說明 | 範例 |
|---|---|---|
| 區域變數 | 函數內部宣告,僅函數內可見 | function foo() { $x = 1; } |
| 全域變數 | 函數外部宣告,需 global 關鍵字在函數內存取 | $x = 1; function foo() { global $x; } |
| 靜態變數 | 函數內宣告 static,保持值跨呼叫 | function foo() { static $c = 0; return ++$c; } |
| 超全域變數 | PHP 內建,任何地方可見 | $GLOBALS, $_GET, $_POST, $_SESSION... |