Tony's Blog

Windows作業系統

1.安裝XAMPP

2.安裝Visual Studio Code

3.安裝Composer

4.下載Laravel安裝器

5.建立Laravel專案

6.確認建置是否成功

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

8.專案設定

9.錯誤排除

Laravel開發環境建置

Windows作業系統

1.安裝XAMPP

PHP + Apache + MariaDB懶人包

下載點

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

2.安裝Visual Studio Code

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

下載點

3.安裝Composer

用於管理所有PHP套件，包含Laravel， Composer-Setup.exe。

下載點

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

composer self-update

4.下載Laravel安裝器

開啟cmd，輸入以下指令

composer global require laravel/installer

5.建立Laravel專案

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

cd c:\xampp\htdocs

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

//c:\xampp\htdocs
//app_name 專案名稱

laravel new app_name

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

//c:\xampp\htdocs

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

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

//c:\xampp\htdocs\app_name

php artisan key:generate

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

6.確認建置是否成功

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

開啟瀏覽器，輸入網址 http://localhost/app_name/public

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

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

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

127.0.0.1 laravel.test #Laravel學習專案

//輸入網址  http://laravel.test/app_name/public

告訴此網域需要由哪個專案資料夾來接手，作法是修改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>

要求Apache開啟時需讀取httpd-vhosts.conf，作法是修改 XAMPP資料夾\apache\conf\original\httpd.conf。找到httpd-vhosts.conf那一行，把前面的#註解移除。
重開Apache服務，訪問http://laravel.test，看能否順利開啟

8.專案設定

主設定檔修改 - 修改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= //資料庫密碼

9.錯誤排除

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

解決方案:

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

解決方案:

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

composer self-update --2

資料庫連線錯誤 - 出現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);
}

權限不足錯誤 - Mac開發環境出現storage資料夾的 failed to open stream:Permission denied

解決方法:

開啟Terminal，切換到專案資料夾後，輸入以下指令

sudo chmod -R 777 storage

應用錯誤 - 出現No application encryption key has been specified - 錯誤原因是缺少應用的金鑰

解決方案:

開啟Terminal，切換到專案資料夾後，輸入以下指令

php artisan key:generate