Laravel 5 入門安裝全紀錄：Composer 鏡像加速與專案建立步驟

Laravel 5 入門安裝全紀錄：Composer 鏡像加速與專案建立步驟

從 Yii 轉戰 Laravel 5，首戰即遇安裝阻礙。記錄完整安裝流程與踩坑避雷，助後人順利上手。

一、前置環境準備

• PHP ≥ 5.6（建議 7.1+）
• Composer 依賴管理器
  • Windows：下載 Composer-Setup.exe 圖形化安裝，安裝過程需指定 php.exe 路徑。
  • Linux：curl -sS https://getcomposer.org/installer | php → mv composer.phar /usr/local/bin/composer 設為全域指令。

二、配置 Composer 中國鏡像（關鍵加速）

預設 Packagist 國內訪問極慢，必須切換鏡像。兩種方式擇一：

1. 全域配置（推薦）

composer config -g repo.packagist composer https://packagist.phpcomposer.com

2. 專案級配置（composer.json）

{
    "repositories": [
        {"type": "composer", "url": "https://packagist.phpcomposer.com"},
        {"packagist": false}
    ]
}

三、建立 Laravel 專案

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

過程會自動下載依賴、生成 .env、執行 key:generate 等初始化動作。

四、驗證安裝

• 虛擬主機指向 public 目錄，瀏覽器訪問顯示 Laravel 歡迎頁即成功。
• 或使用內建伺服器測試：php artisan serve（預設 https://localhost:8000）。

五、常見問題排查

• 安裝卡住：耐心等待，或檢查網路/鏡像配置。
• 權限錯誤：確保 storage、bootstrap/cache 目錄可寫入（chmod -R 775）。
• 缺少擴展：安裝 php-xml、php-mbstring、php-tokenizer 等必要擴展。

完成以上步驟，你的 Laravel 5 開發環境即告就緒，準備迎接優雅的開發體驗！