Laravel 入門：在 Mac 安裝與啟動 Laravel

關於 Laravel

Laravel 是 PHP 語言的後端 Framework，其優雅開發特性吸引了非常多愛好者，正如其官網標題 The PHP Framework For Web Artisans ，使它成為 PHP 目前主流 Framework 之一。

實際上要建置與啟動 Laravel 有很多方式，要用 xampp 去弄也可以，這篇筆記只是隨手記錄一下自己裝來玩的 Laravel 環境建置。

安裝 PHP

首先利用 Homebrew 來幫我們安裝 PHP，目前 PHP 已到了 7.4 版，故照 Homebrew 官網指令裝完 Homebrew 後，在 terminal 下指令來安裝 PHP 7.4：

brew install php@7.4

安裝 Composer

接著來安裝 composer。composer 是 PHP 主流套件管理器，因為筆者是前端工程師，前端工程師們可以將 composer 與 PHP 關係想像成有一點類似 npm 與 Node.js 、pip 與 python 的關係，在 terminal 下指令安裝：

brew install composer

安裝 Laravel

接著利用 composer 來安裝 Laravel，這過程與用 npm 來 install Node.js 後端框架 express 的狀況是一樣的。

composer global require laravel/installer

Opps 遇到了問題！缺少了一些 PHP extension

實際上是我自己疏漏造成的XD，我先前在 terminal 下 PHP --version 看到有東西，以為之前裝過 PHP 了，就跳過第一步用 Homebrew 安裝 PHP，直接進入二三步安裝 composer 和 Laravel ，爬文後才發現乖乖照 Homebrew 來安裝 PHP 就可以避免此問題。

重新安裝 PHP 後，再次安裝 Laravel 這次就成功了。

command not found

安裝完 Laravel 後，按照官網的說明，可以注意到

因為此時環境的變數 PATH 沒有設定好，若直接在 terminal 輸入指令建立專案

laravel new ${專案名稱}

terminal 會出現提示

laravel: command not found

我們可以在終端機下指令檢查目前 $PATH 的系統變數路徑

echo $PATH

可以看到目前指向的系統變數，這時裡頭並沒有 composer 的存在。

接下來的過程會與在 MAC 上裝 NVM 類似，不是說 composer 與 NVM 類似(這是南轅北轍的東西)，是指都要到 MAC 的 ./bashrc 或 ./bash_profile 設定 $PATH ，按照網路上文章會這樣寫，打開新 terminal 並輸入

echo 'export PATH="$PATH:$HOME/.composer/vendor/bin"' >> ~/.bashrc

然後輸入

source ~/.bashrc

用 source 指令去執行 .bashrc 檔案即可。

或者換個作法，如果不曉得你是./bashrc 或 ./bash_profile ，或是之前有沒有設定過，可以到你的資料夾 /user 根目錄，鍵盤按 command + shift + . ，會出現所有隱藏資料夾和檔案。

我這邊的檔案是./bash_profile，用任意編輯器 (VScode) 打開 ./bash_profile，並在最下面置入以下段落

export PATH="$PATH:$HOME/.composer/vendor/bin"

關閉編輯器後打開 terminal ，cd 切換到根目錄(或切換到有 ./bashrc 或 ./bash_profile 那層資料夾）下指令

source ~/.bash_profil

接著重新下

echo $PATH

若看到 .composer/vendor/bin 出現，就代表 PATH 設定成功了！

當然我覺得原本終端機下指令的方式比較快XD

如果你用的不是 bash 而是 zsh，恩..雖然 zsh 的設定檔放在 .zshrc，但你一樣可以先加 composer $PATH 進 ./bashrc 或 ./bash_profile ，接著到 .zshrc 檔案內添加 source ~/.bash_profile 同步系統變數，最後 terminal 下 source ~/.zshrc 即可。

安裝 MySQL

接著來安裝 MySQL ，在 terminal 下指令安裝：

brew install mysql@5.7

安裝好後 terminal 下指令檢查版本和是否有安裝成功

mysql --version

這時應該還是會出現

mysql: command not found

command not found ...again

是的，理由一樣是 $PATH 沒設定好，按照網路上的說明 Mysql command not found in OS X 10.7將以下加進 ./bashrc 或 ./bash_profile

export PATH=${PATH}:/usr/local/mysql/bin

一樣 terminal 繼續下指令設定

source ~/.bash_profile

之後在 terminal 下指令檢查版本和是否有安裝成功

mysql --version

這時遇到一個問題，我一樣出現

mysql: command not found

怎麼和我爬文到的資訊不一樣..

數完質數冷靜後，$PATH 是指向系統變數的路徑，當我們輸入指令時會按照先前 terminal 下 echo $PATH 出現的路徑去查找。

既然是路徑，只要有安裝過 MySQL ，還是可以在資料夾全域搜尋 MySQL bin 的位置，對照設定 export PATH=${PATH}:/usr/local/mysql/bin 的路徑 /local/mysql/bin ，我發現我的 MySQL 是裝在路徑資料夾..略有小小不同，小問題而已。

故按照路徑將原本寫在 .bash_profile 的段落

export PATH=${PATH}:/usr/local/mysql/bin

改成

export PATH="$PATH:/usr/local/${你的mysql路徑}"

一樣 terminal 繼續下指令設定

source ~/.bash_profile

之後在 terminal 下指令檢查版本和是否有安裝成功

mysql --version

這次就成功顯示出版本號了！

建立 Laravel 新專案

最後...處理好 $PATH 後，接著用 terminal cd 切換到想安裝 Laravel 的資料夾，下指令安裝

laravel new ${你的專案名稱}

就可以用 laravel 新建 Laravel 專案了

啟動 Laravel

建立好專案後，用 terminal 切換 cd 指進剛建立好的 Laravel 資料夾，輸入以下指令啟動

php artisan serve

按照 terminal 提示打開瀏覽器輸入 http://127.0.0.1:8000/ 就可以看到 Laravel 預設畫面囉！

參考資料：

• How to place the ~/.composer/vendor/bin directory in your PATH?
• Laravel PHP Can’t install Laravel installer via composer
• Mysql command not found in OS X 10.7
• Let’s Install MySQL 5.7 on OS X