PHP return 全局作用域特性詳解：包含文件返回值與腳本中止控制

核心認知：return 不僅屬於函數

PHP 允許在 全局作用域 使用 return，這在 C/Java 等語言中是不可能的。其行為取決於上下文：

場景一：主腳本中止執行

<?php
echo "開始\n";
if ($maintenance) {
    echo "維護中\n";
    return; // 直接中止腳本，後續代碼不執行
}
echo "正常運行\n"; // 不會輸出

效果等同 exit，但 return 可選擇性返回整數作為 CLI 退出碼。

場景二：include/require 返回值（最實用）

config.php：

<?php
return [
    'db' => ['host' => 'localhost', 'name' => 'app'],
    'debug' => true,
];

index.php：

$config = include 'config.php';
// $config 獲得返回的數組
var_dump($config['db']['host']); // 'localhost'

優勢：配置文件純數據、無副作用、安全（直接訪問不會輸出）、語義清晰。

場景三：Composer 自動載入器實現

// vendor/autoload.php 簡化
$loader = require __DIR__ . '/composer/autoload_real.php';
// 實際返回 ComposerAutoloaderInit::getLoader() 實例

場景四：路由入口早期返回

<?php
// public/index.php
require '../vendor/autoload.php';

$app = new App();

if ($app->isMaintenance()) {
    http_response_code(503);
    include '../templates/503.php';
    return; // 阻斷後續路由分發、控制器執行
}

$app->run();

場景五：CLI 腳本返回退出碼

<?php
// deploy.php
if (!checkEnv()) return 1;
if (!gitPull()) return 2;
if (!composerInstall()) return 3;
if (!runMigration()) return 4;
return 0; // 成功

Shell 捕獲：

php deploy.php
case $? in
    0) echo "成功" ;;
    1) echo "環境檢查失敗" ;;
    2) echo "代碼拉取失敗" ;;
    *) echo "未知錯誤" ;;
esac

return vs exit/die 核心差異

最佳實踐原則

1. 配置文件統一 return [...]：安全、可緩存、語義明確
2. 入口文件用 return 做守衛子句：減少嵌套，提高可讀性
3. CLI 工具用 return $code：便於單元測試（可 include 驗證返回值）
4. 業務邏輯層禁用全局 return：應封裝在函數/方法中
5. 不要濫用：過度使用會導致控制流難以追蹤