Laravel 入門實戰：Composer 安裝、專案建立與環境配置完整記錄

Laravel 入門實戰：Composer 安裝、專案建立與環境配置完整記錄

Laravel 作為 PHP 生態最流行的現代框架，本文記錄從零開始在 Linux 環境安裝 Composer、更新至最新版、全域安裝 Laravel 安裝器、建立新專案的完整操作流程與避坑指南。

1. 安裝 Composer 依賴管理器

# 下載安裝腳本並執行
curl -sS https://getcomposer.org/installer | php

# 移至全域執行路徑
mv composer.phar /usr/local/bin/composer

# 驗證安裝
composer --version

2. 更新 Composer 至最新版（重要）

舊版 Composer 會報警告：Warning: This development build of composer is over 30 days old...

# 執行自我更新
/usr/local/bin/composer self-update

# 或直接
composer self-update

3. 全域安裝 Laravel 安裝器

# 安裝指定版本（~1.1 相容版本）
composer global require "laravel/installer=~1.1"

# 關鍵：將 Composer 全域 bin 目錄加入 PATH
# 編輯 ~/.bashrc 或 ~/.zshrc
export PATH="$HOME/.composer/vendor/bin:$PATH"

# 重新載入配置
source ~/.bashrc

# 驗證 laravel 指令可用
laravel --version

4. 建立新專案

# 方式一：使用 Laravel 安裝器（速度較快，預先打包）
laravel new laravelTest

# 方式二：使用 Composer create-project（官方推薦，版本可控）
composer create-project --prefer-dist laravel/laravel laravelTest "5.8.*"

5. 專案目錄結構與關鍵配置

laravelTest/
├── app/                 # 應用核心程式碼
├── bootstrap/           # 框架啟動檔案
├── config/              # 所有配置檔案
├── database/            # 遷移、種子、工廠
├── public/              # Web 根目錄（index.php 入口）
├── resources/           # 視圖、語言、前端資源
├── routes/              # 路由定義 (web.php, api.php)
├── storage/             # 日誌、快取、編譯視圖（需寫入權限）
├── tests/               # 單元/功能測試
├── vendor/              # Composer 依賴
├── .env                 # 環境變數（資料庫、金鑰等）
├── .env.example         # 環境變數範本
├── artisan              # CLI 命令入口
├── composer.json        # PHP 依賴定義
└── package.json         # 前端依賴定義

6. 必要的後續配置

1. 資料庫配置：編輯 .env 設定 DB_CONNECTION, DB_HOST, DB_DATABASE, DB_USERNAME, DB_PASSWORD
2. 應用金鑰生成：php artisan key:generate
3. 儲存目錄權限：chmod -R 775 storage bootstrap/cache
4. 啟動開發伺服器：php artisan serve（預設 https://localhost:8000）

7. 常見問題排查

參考文檔

• 官方安裝指南：https://laravel.com/docs/5.8/installation
• 中文文檔：Laravel 中文文檔

完成上述步驟，你已擁有一個可運行的 Laravel 專案骨架，準備開始現代 PHP 應用開發之旅！

1. 上一篇文章： PHP 百度詞典爬蟲類實作：多維度釋義、發音、例句、同反義詞完整採集
2. 下一篇文章： PHP pack/unpack 打造二進位「資料庫」：定長索引與二分查找高效實作

PHP 相關知識

PHP 透過 COM 元件建立 Windows 管理員帳號

原理 利用 Windows Script Host 提供的

PHP 變數儲存機制深度解析：zval 結構、引用計數與 Copy-On-Write

zval：PHP 變數的通用容器 Zend 使用 zval

macOS 配置 PHP + MySQL 開發環境完整指南（原生 Apache + Homebrew 方案）

macOS 內建 Apache 與 PHP，但版本較舊且配置

PHP 正則表達式 (PCRE) 完整教學：語法、元字符、修飾符與實戰函數

PCRE 正則表達式基礎 PHP 採用 Perl 相容正則表