Laravel Admin 建立專案流程

📌 適用版本:Laravel 8 + laravel-admin 1.8
📚 官方網站:https://laravel-admin.org


1. 建立 Laravel 專案

composer create-project laravel/laravel:^8.0 projectName
cd projectName

2. 安裝 laravel-admin

composer require encore/laravel-admin

3. 發佈資源與設定檔

php artisan vendor:publish --provider="Encore\Admin\AdminServiceProvider"

4. 設定 .envconfig

編輯 .env 設定資料庫連線:

DB_DATABASE=your_db_name
DB_USERNAME=your_db_user
DB_PASSWORD=your_db_password

如有上傳需求,需設定 FILESYSTEM_DISK 或於 config/admin.php 中指定 upload.disk

// config/admin.php
'upload' => [
    'disk' => 'admin', // 對應 config/filesystems.php 中的設定
],

新增對應的儲存 disk(可選):

// config/filesystems.php
'disks' => [
    'admin' => [
        'driver' => 'local',
        'root' => public_path('uploads'),
        'url' => env('APP_URL') . '/uploads',
        'visibility' => 'public',
    ],
],

5. 執行安裝指令

php artisan admin:install

此指令會執行以下操作:

  • 建立後台管理的資料表
  • 新增預設管理員帳號(admin / admin
  • 匯入必要的 seed 與 assets

6. 啟動伺服器並登入後台

php artisan serve

預設登入網址:

http://localhost:8000/admin

帳號密碼(預設):

  • 帳號:admin
  • 密碼:admin

如需擴充登入驗證、管理員角色權限,建議參考官方說明進行進一步設定:https://laravel-admin.org/docs/zh/1.x/