Laravel 安裝

發表於 Disqus：

軟體開發的起手式，就是準備環境。官方文件寫的非常詳細，以下就以個人經驗重點講一下。

Laravel 安裝分做兩段來說明：環境建置與初始化專案。官方文件是先講初始化專案，再講環境。但一般框架都是要先有環境，才有辦法透過工具初始化專案，所以我個人認為還是先講環境再來講初始化專案比較好。

用工具初始化專案的例子：

環境建置

環境需要的資訊，官方文件有清楚說明 PHP 版本與必須要裝哪些 extension，以下先完整列出：

  • PHP >= 7.3
  • BCMath PHP Extension
  • Ctype PHP Extension
  • Fileinfo PHP Extension
  • JSON PHP Extension
  • Mbstring PHP Extension
  • OpenSSL PHP Extension
  • PDO PHP Extension
  • Tokenizer PHP Extension
  • XML PHP Extension

Extension 是我覺得比較重要的，因為它會直接影響執行成功與否，包含 built-in server 和單元測試。

而 Web Server 官方文件的範例是 Nginx，可以參考看看。

初始化專案

官方介紹是使用 example app 或 Laravel Installer 來完成程式碼建置。

Example app

使用這個方法需要先安裝好 Docker，裝好後執行下面這個指令就會得到 Laravel 的原始碼：

curl -s https://laravel.build/example-app | bash

完成後，進入 example-app 使用 sail 指令即可啟動服務：

# 注意：不能這樣下
# php vendor/bin/sail up

./vendor/bin/sail up

這個算是一個 Docker 開發環境懶人包。當 Docker 執行完畢後，透過 http://localhost 即可看到建好 Laravel 的新手頁。

Laravel Installer

這是透過 PHP + Composer 與 Git 初始化 Laravel 專案。首先先使用 Composer 安裝 Laravel Installer，再用 Installer 初始化專案：

composer global require laravel/installer

laravel new example-app

透過 Installer 初始化好的專案，雖然有預裝好 sail，但是無法使用 sail up 來啟動 server。必須要改用 built-in server：

php artisan serve

相反的，Example app 建好的專案可以用 built-in server 的方法啟動。

AdSense