Laravel 實用技巧兩則：路由批量命名與環境判斷最佳化

Laravel 開發中，有些實用技巧未在官方文檔明確說明，但能顯著提升開發效率。本文分享兩個高頻使用技巧：Route::controller 批量路由命名、基於環境變數的運行環境判斷。

技巧一：Route::controller 批量路由命名

背景

Route::controller 可自動將控制器方法對應至 RESTful 路由，減少大量重複定義。但需對特定路由命名（如產生 URL、重導向）時，官方文檔鮮少提及第三參數用法。

方法簽名

public function controller($uri, $controller, $names = array())

• $uri：URI 前綴
• $controller：控制器類別名
• $names：關鍵參數，陣列對應「方法 => 路由名稱」

實際應用

<?php
// 無命名：標準用法
Route::controller('admin', 'AdminController');

// 部分方法命名：第三參數傳入陣列
Route::controller('admin', 'AdminController', [
    'getIndex'   => 'admin.index',    // 對應 GET /admin
    'getLogin'   => 'admin.login',    // 對應 GET /admin/login
    'postLogin'  => 'admin.login',    // 對應 POST /admin/login
    'getLogout'  => 'admin.logout',   // 對應 GET /admin/logout
]);

// 使用命名路由
// 視圖中：route('admin.login')
// 控制器：redirect()->route('admin.index')
// URL 生成：URL::route('admin.logout')

命名規則對照

注意事項

• 僅需命名的方法列入陣列，其餘自動對應無名稱路由
• 同一 URI 不同 HTTP 動詞可共用名稱（如 login 表單顯示與提交）
• Laravel 5.2+ 建議改用資源控制器 Route::resource() 更語義化

技巧二：基於環境變數判斷運行環境

預設機制痛點

預設 bootstrap/start.php 透過主機名判斷：

$env = $app->detectEnvironment([
    'local' => ['homestead', 'localhost', 'dev-machine']
]);

問題：團隊成員電腦主機名不同，需不斷新增主機名至陣列，維護困難。

優化方案：環境變數優先

$env = $app->detectEnvironment(function () {
    // 1. 優先讀取環境變數
    $env = getenv('LARAVEL_ENV');
    
    // 2. 回退至主機名判斷（相容舊版/伺服器）
    if (!$env) {
        $env = [
            'local' => ['homestead']
        ];
    }
    
    return $env;
});

環境變數設定方式

Apache (.htaccess / httpd.conf)

SetEnv LARAVEL_ENV local

Nginx (fastcgi_params / site config)

fastcgi_param LARAVEL_ENV local;

命令行 / 測試環境

# Linux/Mac
export LARAVEL_ENV=local

# Windows PowerShell
$env:LARAVEL_ENV = "local"

# 單次執行
LARAVEL_ENV=local php artisan migrate

Docker 環境

# docker-compose.yml
services:
  app:
    environment:
      - LARAVEL_ENV=local

進階：多環境配置

$env = $app->detectEnvironment(function () {
    $env = getenv('LARAVEL_ENV') ?: 'production'; // 預設 production
    
    // 允許的環境值白名單
    $allowed = ['local', 'staging', 'production', 'testing'];
    
    return in_array($env, $allowed) ? $env : 'production';
});

Laravel 5.0+ 現代化寫法

Laravel 5.0 起採用 vlucas/phpdotenv，環境配置更優雅：

.env 檔案

APP_ENV=local
APP_DEBUG=true
APP_KEY=base64:xxx
DB_HOST=localhost
DB_DATABASE=homestead
DB_USERNAME=homestead
DB_PASSWORD=secret

bootstrap/app.php

$app = new Illuminate\Foundation\Application(
    $_ENV['APP_BASE_PATH'] ?? dirname(__DIR__)
);

配置檔存取

'default' => env('DB_CONNECTION', 'mysql'),

總結

兩個技巧解決的核心痛點：

1. 路由命名：Route::controller 第三參數陣列，精準控制需命名的路由，避免大量單一定義
2. 環境判斷：環境變數優先策略，消除主機名維護負擔，支援容器化部署與團隊協作

這類「文檔未盡述但實戰高頻」的技巧，往往能大幅簡化程式碼與部署流程。建議團隊建立內部最佳實踐文檔，沉澱此類經驗。