Laravel 自動加載優化：app/start/global.php 中 ClassLoader::addDirectories 讓 admin 控制器免 dump-autoload

背景

Laravel 4/5 早期版本中，app/controllers/admin 等子目錄下的控制器不在 Composer 自動加載列表，每次新增需執行 composer dump-autoload。通過 ClassLoader::addDirectories 可將其納入框架自動加載，實現「保存即生效」。

核心配置

// app/start/global.php (Laravel 4) / bootstrap/app.php 附近 (Laravel 5.0-5.2)
ClassLoader::addDirectories([
    app_path() . '/commands',
    app_path() . '/controllers',
    app_path() . '/controllers/admin', // ← 關鍵：添加子目錄
    app_path() . '/models',
    app_path() . '/database/seeds',
]);

驗證效果

• 在 app/controllers/admin/UserController.php 創建控制器
• 路由直接指向：Route::get('admin/user', 'UserController@index');
• 無需 composer dump-autoload，瀏覽器訪問即可生效

⚠️ 命名衝突風險與解決

若 app/controllers/UserController.php 與 app/controllers/admin/UserController.php 同名：

• 加載順序決定勝出：數組中靠前的優先
• 上例中 controllers 在前 → 外層生效
• 若需 admin 生效，將其移到 controllers 前面

最佳實踐：命名空間隔離（根治衝突）

// app/controllers/admin/UserController.php
<?php
namespace App\Controllers\Admin;

use App\Models\User;
use Illuminate\Routing\Controller;

class UserController extends Controller {
    public function index() { return User::all(); }
}

// 路由
Route::group(['namespace' => 'App\Controllers\Admin', 'prefix' => 'admin'], function () {
    Route::get('user', 'UserController@index');
});

優勢： 物理隔離 + 邏輯隔離，彻底消除衝突，符合 PSR-4，現代 Laravel (5.3+) 默認即此結構。

版本演進提示

• Laravel 4/5.0-5.2：需手動配置 ClassLoader::addDirectories 或 composer.json autoload.classmap
• Laravel 5.3+：app/Http/Controllers 已納入 composer.json autoload.psr-4，子目錄自動識別，無額外配置
• Laravel 8+：app/Models 亦同

總結

1. 舊版本可用 addDirectories 臨時解決免 dump-autoload
2. 同名衝突靠順序控制，治標不治本
3. 命名空間 + PSR-4 是正統解法，現代版本開箱即用
4. 遷移建議：統一遷移至 app/Http/Controllers/Admin + 命名空間