萬盛學電腦網

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

PHP 自訂函式完全指南:命名規範、參數傳遞、回傳值、型別宣告與現代最佳實踐

前言

函式是程式碼複用、抽象邏輯、構建模組化系統的基本單元。PHP 從早期簡單的 function name() 演進至今,支援型別宣告、回傳型別、可變參數、參考傳遞、箭頭函式、首級可呼叫物件等現代特性。本文系統整理自訂函式的完整語法、進階模式與工程化最佳實踐。

一、函式命名規範與基本語法

命名規則

  • 以字母或底線開頭:myFunc, _privateHelper
  • 可包含字母、數字、底線:getUserById, calculate_v2
  • 不區分大小寫:myFunc() === MYFUNC()(但建議統一風格)
  • 不可與內建函式同名(會報錯)
  • 建議:動詞開頭 get..., set..., calculate..., handle..., validate...

基本宣告語法

<?php
// 完整語法(PHP 7/8+)
function functionName(
    Type1 $param1,           // 型別宣告
    Type2 $param2 = default, // 預設值
    Type3 ...$varArgs        // 可變參數
): ReturnType {              // 回傳型別
    // 函式主體
    return $result;
}

// 實際範例
function calculateCircleArea(float $radius): float {
    return $radius * $radius * M_PI;
}

echo calculateCircleArea(20); // 1256.637...
?>

二、參數傳遞機制深度解析

1. 值傳遞(預設行為)

<?php
function modifyValue($value) {
    $value = 'changed';
}

$original = 'original';
modifyValue($original);
echo $original; // 'original'(未被修改)
?>

2. 參考傳遞(& 符號)

<?php
function modifyReference(&$value) {
    $value = 'changed';
}

$original = 'original';
modifyReference($original);
echo $original; // 'changed'(被修改)

// 實際應用:陣列去重修改原陣列
function removeDuplicates(array &$arr): void {
    $arr = array_values(array_unique($arr));
}
$data = [1, 2, 2, 3, 3];
removeDuplicates($data);
// $data 變為 [1, 2, 3]
?>

3. 預設參數值

<?php
function greet(string $name = 'Guest', string $greeting = 'Hello'): string {
    return "$greeting, $name!";
}

echo greet();                    // Hello, Guest!
echo greet('Alice');             // Hello, Alice!
echo greet('Bob', 'Hi');         // Hi, Bob!
echo greet(greeting: 'Hey');     // Hey, Guest! (PHP 8+ 命名參數)
?>

4. 可變參數

<?php
// PHP 5.6+ ... 運算子
function sum(int ...$numbers): int {
    return array_sum($numbers);
}

echo sum(1, 2, 3);       // 6
echo sum(...[4, 5, 6]);  // 15 (解包陣列)

// 僅最後一個參數可為可變參數
function buildQuery(string $table, string ...$columns): string {
    return "SELECT " . implode(', ', $columns) . " FROM $table";
}
?>

5. 命名參數

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

// PHP 8+ 命名參數:順序無關、可跳過預設值
$user = createUser(
    name: 'Alice',
    email: 'alice@example.com',
    role: 'admin'  // 跳過 age、active 使用預設值
);
?>

三、回傳值與型別系統

回傳型別宣告

<?php
// 基本型別
function getName(): string { ... }
function getCount(): int { ... }
function isValid(): bool { ... }
function getPrice(): float { ... }

// 物件/介面型別
function getUser(): User { ... }
function getLogger(): LoggerInterface { ... }

// 可為 null(PHP 7.1+)
function findUser(int $id): ?User { ... }

// void:不回傳值(PHP 7.1+)
function logMessage(string $msg): void {
    error_log($msg);
    // return; // 可選,不可 return 值
}

// never:永不返回(PHP 8.1+)
function throwError(string $msg): never {
    throw new Exception($msg);
}

// 多型回傳(PHP 8.0+ 聯合型別)
function getData(): array|string|false { ... }
?>

返回多值策略

策略適用場景範例
陣列解構固定結構、少量欄位[$a, $b] = func()
關聯陣列動態欄位、選填資料['key' => $val] = func()
DTO/Value Object領域模型、型別安全return new UserDTO(...)
Generator大量資料流、記憶體效率yield $item; return $total;
物件屬性建構器/建構者模式$obj->setX()->setY()->build()

Generator 範例:大型資料集處理

<?php
function readLargeCsv(string $filename): Generator {
    $handle = fopen($filename, 'r');
    try {
        while (($row = fgetcsv($handle)) !== false) {
            yield $row; // 暫停執行,產生一行
        }
    } finally {
        fclose($handle);
    }
}

// 使用:記憶體常數,不載入整個檔案
foreach (readLargeCsv('huge.csv') as $row) {
    processRow($row);
}
?>

四、進階函式模式

1. 遞迴函式

<?php
function factorial(int $n): int {
    return $n <= 1 ? 1 : $n * factorial($n - 1);
}

// 尾遞迴優化(PHP 不支援 TCO,深度遞迴會堆疊溢位)
// 大量遞迴請改用迭代或 Generator
?>

2. 匿名函式與閉包

<?php
// 匿名函式指派給變數
$multiply = function(int $a, int $b): int {
    return $a * $b;
};

// 閉包:綁定外部變數
$factor = 10;
$multiplyByFactor = function(int $n) use ($factor): int {
    return $n * $factor;
};

// 箭頭函式(PHP 7.4+):隱性按值綁定
$multiplyByFactor = fn(int $n): int => $n * $factor;

// 閉包綁定物件作用域
class Multiplier {
    private int $factor = 5;
    public function getClosure(): Closure {
        return function(int $n): int {
            return $n * $this->factor; // 自動綁定 $this
        };
    }
}
?>

3. 首級可呼叫語法

<?php
class Calculator {
    public function add(int $a, int $b): int { return $a + $b; }
    public static function mul(int $a, int $b): int { return $a * $b; }
}

$calc = new Calculator();

// PHP 8.1+ 首級可呼叫語法
$add = $calc->add(...);      // Closure 物件
$mul = Calculator::mul(...); // 靜態方法

echo $add(2, 3);  // 5
echo $mul(2, 3);  // 6

// 替代舊式
$addOld = [$calc, 'add'];
$mulOld = [Calculator::class, 'mul'];
?>

五、函式檢查與反射

<?php
function_exists('json_encode');     // true
function_exists('my_custom_func');  // 檢查自訂函式

// 反射取得函式資訊
$ref = new ReflectionFunction('calculateCircleArea');
$ref->getParameters();     // 參數資訊
$ref->getReturnType();     // 回傳型別
$ref->getDocComment();     // 文件註解
$ref->invoke(10);          // 動態呼叫
?>

六、命名慣例與程式碼風格

元素慣例範例
函式名稱camelCasegetUserById(), calculateTotal()
類別方法camelCasepublic function saveUser()
私有/保護方法底線前綴 + camelCase_parseResponse(), _validateInput()
常數全大寫底線分隔MAX_RETRY_COUNT, DEFAULT_TIMEOUT
變數camelCase 或 snake_case$userName, $user_name(專案統一)
參數camelCasefunction($userId, $includeDetails)

七、常見錯誤與除錯技巧

  1. 參考傳遞語法錯誤:function(&$a) 正確,function(&$a = 1) 錯誤(預設值不能用參考)
  2. 可變參數位置錯誤:function(...$a, $b) ❌,必須在最後
  3. void 函式回傳值:function(): void { return 1; } ❌ Fatal Error
  4. never 型別誤用:確確實實不返回(拋出異常、exit、die、無限迴圈)
  5. 參數型別不匹配:嚴格模式下 declare(strict_types=1) 會拋出 TypeError

八、效能微調建議

  • 熱路徑函式:避免過度抽象、內聯簡單邏輯
  • 大量資料:使用 Generator 避免記憶體爆增
  • 頻繁呼叫小函式:OPcache 會優化,但可考慮 static 內部函式減少查找
  • 型別宣告:啟用 JIT(PHP 8+)後效能提升明顯

結語

PHP 函式機制經過多版本演進,已具備現代語言的完整特性:型別系統、參考/值傳遞、可變參數、命名參數、Generator、首級可呼叫物件。掌握這些特性,配合 declare(strict_types=1)、PHPStan 靜態分析、PSR-12 風格規範,能寫出型別安全、可讀性高、效能優異的函式庫與應用程式核心邏輯。

copyright © 萬盛學電腦網 all rights reserved