萬盛學電腦網

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

PHP 函數定義與使用完整指南:參數傳遞、回傳值、型別宣告與現代特性

函數定義基礎語法

<?php
// 完整語法 (PHP 8+)
function functionName(
    Type1 $param1, 
    Type2 $param2 = 'default', 
    ...Type3 $variadicParams
): ReturnType {
    // 函數主體
    return $result;
}
?>

參數傳遞模式

模式語法特性適用場景
值傳遞 (預設)function foo($x)複製值,函數內修改不影響外部標量、陣列 (複製)、物件 (複製引用)
參考傳遞function foo(&$x)傳遞變數別名,修改影響原變數需修改原變數、大型陣列避免複製
預設值function foo($x = 'default')呼叫時可省略,預設值必為常數表達式可選參數
型別宣告 (PHP 7+)function foo(int $x): int強制型別檢查 (嚴格模式下)API 契約、自動文件、靜態分析
可變參數 (PHP 5.6+)function foo(...$args)接收任意數量參數為陣列不定參數、中介軟體、包裝函數
命名參數 (PHP 8+)foo(paramName: value)依名稱傳遞,順序無關、可跳過預設值參數多、預設值多、可讀性

實戰範例

值傳遞 vs 參考傳遞

<?php
function byValue($num) {
    $num += 1;
    echo "函數內: $num\n";
}

function byRef(&$num) {
    $num += 1;
    echo "函數內: $num\n";
}

$value = 10;
byValue($value);
echo "函數外: $value\n";  // 10 (未變)

$value = 10;
byRef($value);
echo "函數外: $value\n";  // 11 (被修改)
?>

型別宣告與嚴格模式

<?php
declare(strict_types=1);  // 檔案頂端

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

echo add(1, 2);      // 3
// echo add(1.5, 2);  // TypeError: float 傳給 int
// echo add("1", 2);  // TypeError: string 傳給 int (嚴格模式)

// 弱類型模式 (預設) 會嘗試強制轉換
?>

可變參數與解包

<?php
function sum(int ...$numbers): int {
    return array_sum($numbers);
}

echo sum(1, 2, 3, 4);  // 10

$arr = [5, 6, 7];
echo sum(...$arr);     // 18 (解包陣列)
?>

命名參數 (PHP 8+)

<?php
function createUser(string $name, int $age = 18, string $role = 'member', bool $active = true): User {
    // ...
}

// 呼叫方式
createUser('Alice');                           // 全部預設
createUser('Bob', age: 25);                    // 指定 age,跳過 role
createUser('Charlie', role: 'admin', active: false);  // 任意順序
?>

回傳值與型別

  • return 立即結束函數並回傳值。
  • 無 return 或 return; 回傳 null。
  • 回傳型別宣告:: int、: string、: array、: ?User (可為 null)、: never (PHP 8.1+ 永不回傳)。
  • void 表示不應回傳值 (PHP 7.1+)。

變數函數與匿名函數

<?php
// 變數函數
$func = 'strlen';
echo $func('hello');  // 5

// 匿名函數 (Closure)
$multiply = fn($a, $b) => $a * $b;  // 箭頭函數 PHP 7.4+
$multiply = function($a, $b) { return $a * $b; };  // 完整語法

// 綁定作用域
$factor = 10;
$multiplyByFactor = fn($x) => $x * $factor;  // 自動捕獲 $factor

// callable 型別提示
function execute(callable $callback, mixed ...$args): mixed {
    return $callback(...$args);
}
?>

現代最佳實踐

  1. 嚴格模式:所有檔案加 declare(strict_types=1);。
  2. 完整型別提示:參數、回傳、屬性皆宣告型別。
  3. 單一職責:函數只做一件事,超過 20 行考慮拆分。
  4. 純函數優先:無副作用、相同輸入必得相同輸出,易測試、易快取。
  5. 避免全域狀態:透過參數傳遞依賴,而非 global 或 $GLOBALS。
  6. 文件化:PHPDoc 完整標註 @param、@return、@throws。

常見錯誤避坑

  • 參考傳遞時忘記 & 導致預期修改失效。
  • 預設值使用非常數表達式:function foo($x = time()) ❌ (PHP 8.1+ 允許常數表達式,但仍建議避免)。
  • 遞迴函數缺少終止條件導致堆疊溢位。
  • 函數名與內建函數衝突 (如 sort、count)。

函數是程式碼複用的基本單元,善用現代 PHP 的型別系統與參數特性,能建立健壯、自文件化的 API 介面。

copyright © 萬盛學電腦網 all rights reserved