PHP 函數的返回值機制靈活多樣:可返回單一值、通過陣列模擬多返回值、利用引用傳遞修改外部變數。掌握這些技巧,能讓 API 設計更優雅、數據流向更清晰。
<?php
function add($num) {
return $num + 1; // 返回計算結果
}
echo add(2); // 輸出 3
?>
return 會立即結束函數執行,將值返回給調用者。
PHP 函數只能返回一個值,但該值可以是陣列,從而攜帶多個數據。
<?php
function calculate($a, $b, $c) {
return [$c, $b, $a]; // 短陣列語法 PHP 5.4+
}
[$x, $y, $z] = calculate(2, 3, 4); // 解構賦值 PHP 7.1+
echo "$x $y $z"; // 輸出:4 3 2
?>
<?php
function string_variants($str) {
return [
'original' => $str,
'upper' => strtoupper($str),
'lower' => strtolower($str),
'ucwords' => ucwords($str),
];
}
$result = string_variants('The quick brown fox');
print_r($result);
/*
Array
(
[original] => The quick brown fox
[upper] => THE QUICK BROWN FOX
[lower] => the quick brown fox
[ucwords] => The Quick Brown Fox
)
*/
?>
使用關聯陣列鍵名語義化返回值,調用端可按名稱獲取,不依賴順序。
在參數前加 & 實現引用傳遞,函數內修改將影響外部變數。
<?php
function modify_ref(&$a, &$b) {
$a = 1000;
$b = 12000;
return $a + $b; // 同時也可返回值
}
$x = 10;
$y = 12;
$sum = modify_ref($x, $y);
echo "x=$x, y=$y, sum=$sum"; // x=1000, y=12000, sum=13000
?>
關鍵點:
&(function(&$a))&(PHP 5.4+ 強制要求,否則報錯)現代 PHP 支援返回類型聲明,增強代碼健壯性:
<?php
function getConfig(): array {
return ['debug' => true, 'version' => '1.0'];
}
function getUser(int $id): ?User { // 可返回 User 或 null
// ...
}
?>
return 後仍有代碼 | return 即終止函數,後續代碼不會執行 |
| 混合返回類型(如成功返回陣列,失敗返回 false) | 拋出異常處理錯誤,成功統一返回預期類型;或使用 Result 物件模式 |
| 忘記 return | 隱式返回 null,建議顯式返回 |
PHP 函數返回值機制簡單而強大:
return $valreturn [$a, $b],配合解構賦值 [$x, $y] = fn()function(&$var)合理設計返回值結構,是編寫清晰、可維護 PHP 代碼的基礎功夫。