cover

給第一次碰 Laravel 的你——從裝 Composer 到跑起專案,五分鐘搞定。

先講結論

Composer 就是 PHP 世界的 npm。你要用 Laravel,就得先裝它。裝好之後一行指令就能生出一個完整的 Laravel 專案,沒什麼魔法。

Composer 是什麼?為什麼你該在意?

如果你寫過 Node.js,你一定用過 npm install。Composer 做的事情一模一樣——管理 PHP 的套件相依性。

差別在於,PHP 社群花了很長一段時間才搞出這個東西。在 Composer 之前,PHP 開發者是手動下載 .php 檔案丟進專案裡的。對,就跟你想的一樣原始。

確認你的環境

先確認 Composer 有沒有裝好:

composer --version

有跑出版號?恭喜,跳到下一段。沒有的話,去 Composer 官網 照著裝,Windows 用戶直接下載 installer 最省事。

建立 Laravel 專案

你有兩條路,選哪條都行:

路線 A:Composer 直接建(我推薦這個)

composer create-project laravel/laravel my-project

一行搞定,不需要額外裝任何東西。

路線 B:用 Laravel Installer

# 先全域安裝 installer
composer global require laravel/installer
 
# 再建專案
laravel new my-project

多一個步驟,但以後建新專案會快一點。老實說差異不大,我自己都用路線 A。

專案建好了,裡面有什麼?

my-project/
├── app/           # 你的程式碼放這裡
├── config/        # 設定檔
├── database/      # 資料庫遷移與種子資料
├── public/        # 網站入口(index.php 在這)
├── resources/     # Blade 模板與前端資源
├── routes/        # 路由定義
├── storage/       # 快取、Log、上傳檔案
└── vendor/        # Composer 裝的套件(不要動它)

重點:vendor/ 資料夾不要 commit 進 git。它就像 node_modules/,用 composer install 隨時可以重建。你有沒有遇過同事把 node_modules commit 進去的?那種痛我懂。


工具裝好了只是起點,真正的坑在後面等著你。

延伸閱讀