PHP 自定義函數完整指南：語法結構、參數傳遞、返回值、變量作用域與最佳實踐

函數是代碼復用與模組化的基本單元。PHP 支援用戶自定義函數，提供豐富的參數機制、類型聲明、可變參數等現代特性。

基本語法結構

function 函數名(參數列表) : 返回類型 {
    函數體;
    return 返回值;
}

完整範例：四則運算計算器

funcs.php

<?php
function jisuan(float $num1, float $num2, string $oper) : float {
    switch ($oper) {
        case '+': return $num1 + $num2;
        case '-': return $num1 - $num2;
        case '*': return $num1 * $num2;
        case '/': 
            if ($num2 == 0) throw new Exception('除數不能為零');
            return $num1 / $num2;
        default:
            throw new InvalidArgumentException("不支援的運算符: $oper");
    }
}
?>

test.php

<?php
require 'funcs.php';
$num1 = 56; $num2 = 44; $oper = '+';
try {
    $res = jisuan($num1, $num2, $oper);
    echo "計算結果是：$res"; // 100
} catch (Exception $e) {
    echo "錯誤：" . $e->getMessage();
}
?>

參數傳遞機制

引用傳遞範例

<?php
function addPrefix(&$str, $prefix = 'Mr. ') {
    $str = $prefix . $str;
}
$name = 'John';
addPrefix($name);
echo $name; // Mr. John
?>

可變參數與解包

<?php
function sum(...$numbers) {
    return array_sum($numbers);
}
echo sum(1, 2, 3, 4, 5); // 15

$arr = [10, 20, 30];
echo sum(...$arr); // 60 (解包陣列)
?>

返回值與類型聲明

<?php
// 返回類型聲明 (PHP 7+)
function add(int $a, int $b) : int {
    return $a + $b;
}

// 可空返回類型 (PHP 7.1+)
function find(int $id) : ?User {
    return $user ?? null;
}

// void 返回類型 (PHP 7.1+)
function log(string $msg) : void {
    error_log($msg);
}

// 生成器返回 (PHP 5.5+)
function generator() : Generator {
    yield 1; yield 2; yield 3;
}
?>

變量作用域規則

匿名函數與閉包 (PHP 5.3+)

<?php
$multiply = function($a, $b) { return $a * $b; };
echo $multiply(3, 4); // 12

// 閉包綁定外部變量 (use)
$factor = 10;
$scale = function($x) use ($factor) { return $x * $factor; };
echo $scale(5); // 50

// 箭頭函數 (PHP 7.4+，自動捕獲外部變量)
$scale = fn($x) => $x * $factor;
?>

最佳實踐

1. 單一職責：函數只做一件事，< 20 行
2. 純函數優先：無副作用、相同輸入必得相同輸出
3. 類型聲明：盡量加標量/返回類型聲明，啟用 declare(strict_types=1)
4. 錯誤處理：拋出異常而非返回 false/NULL
5. 命名規範：動詞開頭 getUser()、calculateTotal()、isValid()

函數設計質量直接決定代碼可維護性，遵循 SOLID 原則中的單一職責與介面隔離，構建清晰的抽象層次。