Laravel 安裝與入門指南

📦 安裝步驟

1. 確認安裝 PHP 與 Composer

Laravel 8 需要 PHP 7.3 或更高版本，並需要使用 Composer 來安裝。請先確保系統中已安裝：

2. 使用 Composer 建立 Laravel 專案

composer create-project --prefer-dist laravel/laravel project-name

project-name 替換為專案名稱。

3. 進入專案資料夾

cd project-name

4. 啟動 Laravel 開發伺服器

php artisan serve

開啟瀏覽器進入 http://localhost:8000，將看到 Laravel 的預設歡迎頁面。

🚀 開始使用 Laravel

1. 建立新的路由

打開 routes/web.php，新增如下程式碼：

Route::get('/', function () {
    return 'Hello, World!';
});

這會讓首頁顯示 Hello, World!。

2. 建立控制器

使用 Artisan 指令建立控制器：

php artisan make:controller HelloController

在 app/Http/Controllers/HelloController.php 中新增方法：

namespace App\Http\Controllers;

use Illuminate\Http\Request;

class HelloController extends Controller
{
    public function index()
    {
        return 'Hello from Controller!';
    }
}

3. 設定路由呼叫控制器

use App\Http\Controllers\HelloController;

Route::get('/hello', [HelloController::class, 'index']);

訪問 http://localhost:8000/hello，將看到控制器回傳的內容。

⚙️ 基本設定

1. 設定 .env 環境檔案

複製預設檔案並設定資料庫資訊：

cp .env.example .env

編輯 .env：

DB_CONNECTION=mysql
DB_HOST=127.0.0.1
DB_PORT=3306
DB_DATABASE=your_database_name
DB_USERNAME=your_username
DB_PASSWORD=your_password

2. 生成應用程式金鑰

php artisan key:generate

Laravel 將會自動將金鑰寫入 .env 檔案中的 APP_KEY。

3. 執行資料庫遷移

php artisan migrate

此指令將建立預設資料表，如 users、password_resets 等。

4. 安裝認證系統（Laravel 8+）

Laravel 8 以後已不支援 make:auth，需使用 Breeze、Jetstream 等：

Laravel Breeze

composer require laravel/breeze --dev
php artisan breeze:install
npm install && npm run dev
php artisan migrate

Breeze 提供最基本的登入、註冊功能與 Blade 範本。

✉️ 設定郵件發送功能

請在 .env 中設定 SMTP 相關資訊：

MAIL_MAILER=smtp
MAIL_HOST=smtp.example.com
MAIL_PORT=587
[email protected]
MAIL_PASSWORD=secret
MAIL_ENCRYPTION=tls
[email protected]
MAIL_FROM_NAME="Your App"

Laravel 郵件使用說明：https://laravel.com/docs/mail

🛠 補充：常見 .env 設定說明

變數名 說明
APP_ENV 指定環境，例如 local、production
APP_DEBUG 是否顯示錯誤訊息 (true/false)
APP_URL 應用程式的網址
APP_KEY 加密所需的應用程式金鑰
DB_* 資料庫連線設定
MAIL_* 郵件發送設定

備註： 請勿在業務邏輯中直接使用 env() 函數，建議透過 config() 函數來取得設定值。

🖥 終端機與 Artisan 說明

  • Terminal 是圖形介面下的命令列工具。
  • Bash 是最常見的 Unix Shell，允許輸入指令、執行腳本。
  • Artisan 是 Laravel 的命令列工具，支援如 make:model、migrate 等開發任務。

✅ 安裝流程總結

  1. 安裝 PHP 與 Composer
  2. 建立專案並進入目錄
  3. 執行 php artisan serve
  4. 設定 .env 與資料庫
  5. 執行 php artisan migrate
  6. 安裝認證套件（可選）
  7. 開始撰寫路由、控制器、Model 等邏輯

📚 本筆記已根據 Laravel 8 版本進行修正。