PHP 函數進階：遞歸實現、return 與 echo 差異、變量作用域與最佳實踐

函數是 PHP 代碼復用的基本單元。本文通過三個漸進式範例，深度講解遞歸邏輯、return 與 echo 的本質差異、變量作用域隔離，並給出現代 PHP 函數設計最佳實踐。

一、範例資料

$data = [
    0 => 'apple', 1 => 'banana', 2 => 'cat',
    3 => 'dog', 4 => 'egg', 5 => 'father'
];

二、函數演進三部曲

版本 1：返回陣列（資料處理型）

function filterArray(array $arr, string $target): array {
    $result = []; // 局部變量，不影響外部
    foreach ($arr as $key => $value) {
        if ($value === $target) {
            $result[] = [$key => $value];
        }
    }
    return $result; // 返回陣列，函數即表達式
}

// 調用
print_r(filterArray($data, 'banana'));
/*
Array
(
    [0] => Array
        (
            [1] => banana
        )
)
*/

關鍵點：

• 函數內 `$result` 為局部變量，外部不可見。
• return 結束函數執行，後續代碼不再運行。
• 調用者決定如何使用返回值（打印、存儲、傳遞）。

版本 2：返回 HTML 字串（視圖渲染型）

function buildList(array $arr, array $targets): string {
    $html = '
';
    foreach ($arr as $value) {
        // 雙層迴圈 = 遞歸過濾邏輯
        foreach ($targets as $target) {
            if ($value === $target) {
                $html .= "
$value
";
            }
        }
    }
    $html .= '
';
    return $html; // 返回字串
}

// 調用
$targets = ['apple', 'father'];
echo buildList($data, $targets); // 輸出 HTML

遞歸概念澄清：此處「雙層迴圈過濾」非嚴格遞歸（函數自我調用），實為**巢狀迭代**。真正遞歸範例：

function factorial(int $n): int {
    return $n <= 1 ? 1 : $n * factorial($n - 1); // 函數呼叫自身
}

版本 3：直接輸出（副作用型）

function printList(array $arr, array $targets): void {
    echo '
';
    foreach ($arr as $value) {
        foreach ($targets as $target) {
            if ($value === $target) {
                echo "
$value
";
            }
        }
    }
    echo '
';
    // 無 return，隱式返回 null
}

// 調用
printList($data, ['apple', 'father']); // 直接輸出，無需 echo

三、return vs echo 核心差異對比

四、變量作用域規則

• 超全局變量（`$_GET`、`$_SESSION` 等）：任意作用域可訪問。
• 全局變量：需 `global $var` 或 `$GLOBALS['var']` 在函數內訪問（不推薦）。
• 靜態變量：`static $count = 0;` 保持狀態跨調用。
• 局部變量：函數內定義，函數結束銷毀，**與同名全局/外部變量完全隔離**。
• 參數傳遞：預設**值傳遞**（複製），物件傳遞為**引用句柄複製**（可修改物件內部狀態）。

五、現代 PHP 函數設計最佳實踐

1. 嚴格類型聲明：declare(strict_types=1); + 參數/返回類型提示。
2. 單一職責：函數只做一件事，優先返回值，避免直接輸出。
3. 不可變性：不修改輸入參數，返回新值。
4. 早期返回：Guard Clauses 減少巢狀層級。
5. 純函數傾向：相同輸入必得相同輸出，無副作用，易測試、易並行。
6. 文檔註解：PHPDoc 標註參數、返回、異常、副作用。

六、總結

• return 讓函數成為**可組合的值生產者**；echo 讓函數成為**不可組合的副作用執行者**。
• 遞歸 = 函數直接/間接呼叫自身，需**基線條件** + **遞歸步進**。
• 變量作用域隔離保護封裝性，善用參數傳遞與返回值流轉數據。
• 現代 PHP 開發：**函數返回數據/結構，控制器/視圖層負責輸出**。

1. 上一篇文章： PHP 調用新浪 IP API 獲取城市並轉拼音：完整可用代碼
2. 下一篇文章： PHP 文件上傳實戰：按日期自動創建目錄、類型校驗、縮略圖生成

PHP 相關知識

Windows 下 PHP 5.2.4 + MySQL 6.0 + Apache 2.2.4 + Zend Optimizer 3.3.0 完整安裝配置圖文教程

前言：Windows 開發環境手動構建指南 雖然現代開發推薦

PHP 二進位安全機制深度解析：從 zval 結構到 Redis SDS 設計

PHP 二進位安全機制深度解析 所謂「二進位安全」指內建函式

電商高併發架構下的多級緩存策略設計指南

電商高併發架構下的多級緩存策略設計指南 緩存是分布式系統應對

PHP 分頁類實作與應用：兩種顯示模式、自定義參數與資料庫整合

Pagination 類別設計 支援兩種顯示模式：