4 8 月, 2020

Mac的Laravel開發環境建置

By super

你是否也想要學習Laravel但是總是無法順利建置開發環境嗎? 今天就來學習怎麼建置吧
10分鐘快速學會Mac作業系統環境建置,使用Windows作業系統的學員請看這裡。Let’s Go!

Step 1.安裝XAMPP

XAMPP是PHP + Apache + MariaDB 這三個軟體的安裝懶人包,對新手來說相當方便。請點這個下載網址來下載XAMPP for OS X版本

記得選擇版本的時候,去選擇最高的PHP版本(最低PHP 7.2.5)來做下載,同樣版本但是大小較大的檔案會包含VM(虛擬機器),如為初學者建議使用較小不含VM的版本。下載完成之後雙擊安裝檔來進行安裝

如果出現這樣的提示,可以放心的點”打開”,安裝過程中均按照預設設置即可

看到這個畫面就代表XAMPP安裝成功囉

Step 2.安裝Visual Studio Code

開啟Visual Studio Code的官方網站,網址點此,選擇Mac版本做一個下載
下載完成後進行解壓縮,接著把應用App的ICON搬移到應用程式內,方便之後使用。點兩下App來開啟,跳出警告的話同樣點”打開”

出現如上畫面的話,就代表我們的Visual Studio Code順利完成安裝囉

Step 3.安裝Composer

用於管理所有PHP套件,包含Laravel

(非必須,本文下方就有)進入Composer官網,複製指令:指令複製網址

開啟Terminal,貼入以下指令後按enter執行

php -r "copy('<a href="https://getcomposer.org/installer">https://getcomposer.org/installer</a>', 'composer-setup.php');"php -r "if (hash_file('sha384', 'composer-setup.php') === 'e0012edf3e80b6978849f5eff0d4b4e4c79ff1609dd1e613307e16318854d24ae64f26d17af3ef0bf7cfb710ca74755a') { echo 'Installer verified'; } else { echo 'Installer corrupt'; unlink('composer-setup.php'); } echo PHP_EOL;"php composer-setup.phpphp -r "unlink('composer-setup.php');"

搬移到指定位置,指令如下:

sudo mv composer.phar /usr/local/bin/composer

如果/usr/local/bin不存在,輸入指令來建立

sudo mkdir /usr/local/bin

接著開啟.bash_profile檔案來設定路徑,輸入指令

touch ~/.bash_profile;open ~/.bash_profile

加入以下程式碼

export PATH=/usr/local/bin:$PATH<img src="">

立即讀取路徑設定,輸入指令

source ~/.bash_profile

(非必須)Step 4.安裝Homebrew以下載缺少套件

這個步驟不一定要做,你可先跳到Step 5,如果安裝失敗再回來

Homebrew用於Mac環境安裝工具或套件,當執行composer時找不到必須套件,就需要使用它來下載

開啟安裝Homebrew網站去複製指令,網址為https://brew.sh

開啟Terminal,貼入以下指令並執行

/bin/bash -c "$(curl -fsSL <a href="https://raw.githubusercontent.com/Homebrew/install/master/install.sh">https://raw.githubusercontent.com/Homebrew/install/master/install.sh</a>)"

開啟Terminal,輸入以下指令

brew install php@7.4brew link php@7.4 --force

PS: 7.4版本應替換為你所安裝XAMPP所採用的PHP版本

Step 5.下載Laravel安裝器

如果進行這個階段遇到錯誤,請先退回到Step4安裝完再回來。如果跳出需要命令列開發者工具,點安裝來安裝工具

開啟Terminal,輸入以下指令

composer global require "laravel/installer"

開啟.bash_profile以設定路徑,輸入指令

touch ~/.bash_profile;open ~/.bash_profile;

修改完整程式碼如下

export PATH=$HOME/.composer/vendor/bin:/Applications/XAMPP/xamppfiles/bin:/usr/local/bin:$PATH

修改好後,立即讀取剛寫好的路徑設定,指令為

source ~/.bash_profile 

Step 6.建立Laravel專案

開啟Terminal,切換到xampp的htdocs資料夾,輸入指令,路徑應根據您的狀況作調整

cd /Applications/XAMPP/htdocs

如果要建立的是最新Laravel版本的專案,專案名稱為blog,請輸入指令

laravel new blog

(可選)如果要建立指定Laravel版本的新專案,例如5.8,需使用composer,請輸入指令

composer create-project --prefer-dist laravel/laravel blog "5.8.*"

每個Laravel專案都需要有應用金鑰才能夠執行。一般在生成專案時就會幫你建立好,如果沒有的話也沒關係,可以自己生成應用金鑰,開啟Terminal,切換到新建立的專案資料夾,輸入指令

php artisan key:generate

將storage資料夾權限全開,同樣在Terminal,路徑在專案資料夾,輸入指令

sudo chmod -R 777 storage

開啟專案,確定是否有.env檔案,如果找不到.env檔,可將.env.example檔案改名成.env

Step 7.確認建置是否成功

請確保Apache服務和MySQL服務都有開啟開啟瀏覽器,比如Google Chrome,訪問blog專案輸入網址 http://localhost/blog/public

Step 8.專案設定

修改config/app.php,設定timezone時區與locale語系

//config/app.php

'locale' => 'zh_TW',
'timezone' => 'Asia/Taipei',

錯誤排除

資料庫連線錯誤

  1. 出現1071 Specified key was too long; max key length is 767 bytes

解決方法:開啟 app\Providers\AppServiceProvider.php 加入以下程式碼

use Illuminate\Support\Facades\Schema;
public function boot(){
  Schema::defaultStringLength(191);
}

權限不足錯誤

  1. Mac開發環境出現storage資料夾的 failed to open stream:Permission denied

解決方法:開啟Terminal,切換到專案資料夾後,輸入以下指令

sudo chmod -R 777 storage

應用錯誤

  1. 出現No application encryption key has been specified

錯誤原因是缺少應用的金鑰解決方案:開啟Terminal,切換到專案資料夾後,輸入以下指令

php artisan key:generate

自此你就已經完成了Laravel的基礎環境建置囉,建立了第一個Laravel專案,並且有Visual Studio Code來編輯專案,同時開啟了Apache和MySQL服務來運行專案。


希望你從今天的課程當中得到了學習Laravel的樂趣,如果你希望能夠在你的本地端也就是你的電腦,為你的專案建立一個本地化網址,又或者是想要為專案設定資料庫的話,可以參考哥布林的完整實作課程,網址於此,裡面有更多的技巧等著你去學唷。
這是我們10分鍾學Laravel的第一個單元,趕緊去看看其他單元吧。