---
tags: laravel
---
# Laravel開發環境建置


## Windows作業系統

### Step 1.安裝XAMPP

PHP + Apache + MariaDB懶人包

[下載網址](https://www.apachefriends.org/zh_tw/download.html)

請下載PHP 7.2.5以上版本，下載完後安裝，過程只需不斷按Next即可。

### Step 2.安裝Visual Studio Code

由微軟提供，可免費使用的IDE

[下載網址](https://code.visualstudio.com/download)

### Step 3.安裝Composer

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

[下載網址](https://getcomposer.org/download)

PS:如之前已安裝過，需升級成新版本，可使用以下指令

`composer self-update`

### Step 4.下載Laravel安裝器

開啟Terminal，輸入以下指令

composer global require laravel/installer

### Step 5.建立Laravel專案

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

`cd c:\xampp\htdocs`

2.如果要建立的是最新Laravel版本的專案，請輸入指令

`laravel new app_name`

2.1 如果要建立指定Laravel版本的新專案，例如5.8，需使用composer，請輸入指令

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

3. 生成應用金鑰，開啟Terminal，切換到新建立的專案資料夾，請輸入指令

`php artisan key:generate`

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

### Step 6.確認建置是否成功

==請確保Apache服務和MySQL服務都有開啟==

1. 開啟瀏覽器，比如Google Chrome

2. 輸入網址　http://localhost/app_name/public

### Step 7.設定本地化網域(非必須)

1. 將所命名的網域指向到本機 127.0.0.1，作法是修改hosts，這裡以laravel.dev為例

//C:\WINDOWS\system32\drivers\etc\hosts

127.0.0.1 laravel.dev #Laravel學習專案

2. 告訴此網域需要由哪個專案資料夾來接手，作法是修改httpd-vhost.conf，路徑應根據您的狀況作調整

//XAMPP資料夾\apache\conf\extra\httpd-vhosts.conf
 
<VirtualHost *:80>
    DocumentRoot "c:\xampp\htdocs\app_name\public"  
    ServerName laravel.test       
    <Directory "c:\xampp\htdocs\app_name\public">
        Options FollowSymLinks
        AllowOverride None
        Order allow,deny
        Allow from all
    </Directory>
</VirtualHost>

3. 要求Apache開啟時需讀取httpd-vhosts.conf，作法是修改 XAMPP資料夾\apache\conf\original\httpd.conf。找到httpd-vhosts.conf那一行，把前面的#註解移除。

4. 重開Apache服務，訪問http://laravel.test，看能否順利開啟

## Mac 作業系統

### Step 1.安裝XAMPP

PHP + Apache + MariaDB懶人包

[下載網址](https://www.apachefriends.org/zh_tw/download.html)

請下載PHP 7.2.5以上版本，下載完後安裝，過程只需不斷按Next即可。

選擇相同版號容量較小的非VM版本

### Step 2.安裝Visual Studio Code

由微軟提供，可免費使用的IDE

[下載網址](https://code.visualstudio.com/download)

### Step 3.安裝Composer

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

1. 進入Composer官網，複製指令
[指令複製網址](https://getcomposer.org/download)

2. 開啟Terminal，貼入以下指令並執行

php -r "copy('https://getcomposer.org/installer', '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.php
php -r "unlink('composer-setup.php');"

3. 搬移到指定位置，指令如下：

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

==如果/usr/local/bin不存在，輸入指令來建立:sudo mkdir /usr/local/bin==

4. 開啟.bash_profile來設定路徑，輸入指令: touch ~/.bash_profile;open ~/.bash_profile
4.1 加入以下程式碼
`export PATH=/usr/local/bin:$PATH`

5. 立即讀取路徑設定，輸入指令: source ~/.bash_profile

### Step 4.安裝Homebrew以下載缺少套件(非必須)
==可先跳到Step 5，如果安裝失敗再回來==

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

1. 開啟安裝Homebrew網站去複製指令，網址為https://brew.sh
2. 開啟Terminal，貼入以下指令並執行
`/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/master/install.sh)"`
3. 開啟Terminal，輸入指令:

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

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

### Step 5.下載Laravel安裝器

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

1. 開啟Terminal，輸入以下指令
`composer global require "laravel/installer"`
2. 開啟.bash_profile以設定路徑，輸入指令:`touch ~/.bash_profile;open ~/.bash_profile;`
2.1 修改完整程式碼如下:
` export PATH=$HOME/.composer/vendor/bin:/Applications/XAMPP/xamppfiles/bin:/usr/local/bin:$PATH`
3. 立即讀取路徑設定，指令為 `source ~/.bash_profile `

### Step 6.建立Laravel專案

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

`cd /Applications/XAMPP/htdocs`

2. 如果要建立指定Laravel版本的新專案，例如5.8，需使用composer，請輸入指令

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

2.1(可選) 如果要建立的是最新Laravel版本的專案，請輸入指令

`laravel new app_name`

3. 生成應用金鑰，開啟Terminal，切換到新建立的專案資料夾，輸入指令

`php artisan key:generate`

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

`sudo chmod -R 777 storage`

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

### Step 7.確認建置是否成功

==請確保Apache服務和MySQL服務都有開啟==

開啟瀏覽器，比如Google Chrome

輸入網址　http://localhost/app_name/public

### Step 8.設定本地化網域(非必須)

1. 將所命名的網域指向到本機 127.0.0.1，作法是修改hosts，這裡以laravel.dev為例

//etc\hosts

127.0.0.1 laravel.test #Laravel學習專案

2. 告訴此網域需要由哪個專案資料夾來接手，作法是修改httpd-vhost.conf，加入以下設定，路徑應根據您的狀況作調整

//XAMPP資料夾\etc\extra\httpd-vhosts.conf

<VirtualHost *:80>
    DocumentRoot "/Applications/XAMPP/htdocs/app_name/public"  
    ServerName laravel.test       
    <Directory "/Applications/XAMPP/htdocs/app_name/public">
        Require all granted
        Options All
        AllowOverride All
        Order deny,allow
        Allow from all
    </Directory>
</VirtualHost>

3. 要求Apache開啟時需讀取httpd-vhosts.conf，作法是修改//XAMPP資料夾\etc\httpd.conf。找到httpd-vhosts.conf那一行，把前面的#註解移除。

4. 重開Apache服務

5. 開啟瀏覽器，訪問http://laravel.test，看能否順利開啟

## 專案設定

### 主設定檔修改

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

//config/app.php

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

### 隱私設定檔設定

修改.env檔案，所設的值不可以有空格

//.env

APP_NAME=Blog //專案名稱
APP_ENV=local //專案所在環境，local為本地端開發，production為正式上線環境
APP_KEY //應用金鑰，不得為空，可透過 php artisan key:generate來生成
APP_DEBUG=true //是否開啟除錯模式，正式上線環境建議關掉
APP_URL=http://localhost/blog/public //專案網域，須設定到public資料夾

DB_CONNECTION=mysql //所要連接的資料庫
DB_HOST=127.0.0.1 //資料庫Ip Address
DB_PORT=3306 //資料庫port號
DB_DATABASE=blog //資料庫名稱
DB_USERNAME=root //資料庫帳號
DB_PASSWORD= //資料庫密碼

## 錯誤排除

### 套件安裝錯誤
1.出現記憶體不足的錯誤導致安裝失敗

解決方案:

找到Apache資料夾內的php.ini(Windows版本在php資料夾內)，找到裏頭的一行設定"memory_limit"，將其值改成-1，即可不限定伺服器的記憶體空間

### 套件安裝太慢

解決方案:

可能是Composer內核還是1.x版本，請升級到2.0.6以上，請開啟CMD輸入以下指令

`composer self-update --2`

### 資料庫連線錯誤

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`