萬盛學電腦網

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

PHP 函數回傳值機制與實例:從定義到呼叫的完整流程

函數回傳值基礎

函數透過 return 陳述式將值傳回呼叫端。return 同時結束函數執行,後續程式碼不會執行。

基本語法與範例

<?php
/**
 * 將字串包裹在 <b> 標籤中並回傳
 * @param string $text 輸入文字
 * @return string 包裝後的 HTML 字串
 */
function makeBold(string $text): string {
    $bolded = '<b>' . $text . '</b>';
    return $bolded; // 回傳值
}

// 呼叫並使用回傳值
echo '這行沒有加粗!<br>';
echo makeBold('這行被加粗了!') . '<br>';
echo '這行沒有加粗!<br>';

// 回傳值可直接作為其他函數參數
echo strlen(makeBold('測試長度')); // 輸出包含標籤的總長度

多重回傳點

function divide(float $a, float $b): ?float {
    if ($b === 0.0) {
        return null; // 提前回傳表示錯誤
    }
    return $a / $b; // 正常回傳結果
}

$result = divide(10, 0);
if ($result === null) {
    echo '除數不可為零';
} else {
    echo "結果: $result";
}

回傳陣列/物件實現多值回傳

function getUserProfile(int $id): ?array {
    $user = $db->find($id);
    if (!$user) return null;
    return [
        'id'    => $user->id,
        'name'  => $user->name,
        'email' => $user->email,
        'roles' => $user->roles,
    ];
}

// 解構賦值 (PHP 7.1+)
['name' => $name, 'email' => $email] = getUserProfile(1) ?? [];

傳址回傳 (進階、慎用)

class Container {
    private array $data = [];
    public function &getRef(string $key) {
        if (!isset($this->data[$key])) {
            $this->data[$key] = null;
        }
        return $this->data[$key]; // 回傳參考
    }
}
$c = new Container();
$c->getRef('count')++; // 直接修改容器內部值
echo $c->getRef('count'); // 1

警告:傳址回傳易造成難以追蹤的副作用,現代 PHP 建議改用 物件封裝 + 方法修改內部狀態 或 回傳新物件 (不可變模式)。

型別宣告與嚴格模式

declare(strict_types=1); // 檔案頂端宣告

function add(int $a, int $b): int {
    return $a + $b;
}

add(1, 2);     // 3
add('1', '2'); // TypeError: Argument must be int (strict_types 生效)
add(1.5, 2.5); // TypeError: Argument must be int

常見錯誤與最佳實踐

錯誤原因正確做法
忘記 return函數隱性回傳 null所有路徑明確 return;純程序函數用 void 回傳型別
回傳區域變數參考函數結束變數銷毀,參考成懸空回傳值或物件屬性參考
混合回傳型別未聲明呼叫端無法靜態分析用 Union Type int|float|false 或拋出異常
大量資料回傳陣列佔記憶體一次性載入百萬筆改用 Generator (yield) 串流處理

結語

return 是函數與外界溝通的唯一橋樑。善用**回傳型別宣告、嚴格模式、單一職責、錯誤用異常而非特殊值**,能寫出可預測、可測試、可維護的函數。現代 PHP 更推薦 **Value Object / DTO 物件** 取代陣列,獲得型別安全與自動完成支援。

copyright © 萬盛學電腦網 all rights reserved