函數透過 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 物件** 取代陣列,獲得型別安全與自動完成支援。