萬盛學電腦網

您现在的位置: 萬盛學電腦網 >> 程式設計 >  >> 網路程式設計 >> PHP 程式設計

PHP 函數返回值完全指南:單值、多值、引用與陣列技巧

PHP 函數的返回值機制靈活多樣:可返回單一值、通過陣列模擬多返回值、利用引用傳遞修改外部變數。掌握這些技巧,能讓 API 設計更優雅、數據流向更清晰。

基礎:單一返回值

<?php
function add($num) {
    return $num + 1; // 返回計算結果
}
echo add(2); // 輸出 3
?>

return 會立即結束函數執行,將值返回給調用者。

進階:通過陣列實現「多返回值」

PHP 函數只能返回一個值,但該值可以是陣列,從而攜帶多個數據。

範例 1:返回多個計算結果

<?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
?>

範例 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 7+)

現代 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 $val
  • 多值打包陣列 return [$a, $b],配合解構賦值 [$x, $y] = fn()
  • 需修改外部變數用引用 function(&$var)
  • 善用返回類型聲明提升代碼自文檔化程度

合理設計返回值結構,是編寫清晰、可維護 PHP 代碼的基礎功夫。

copyright © 萬盛學電腦網 all rights reserved