在 macbook 上使用 laradock 建立 Laravel 專案開發環境

下載、安裝 Docker Desktop

clone laradock 專案在自己的家目錄下

cd ~/
git clone https://github.com/laradock/laradock.git

從範例檔案複製一份作為環境設定（.env）

cd Laradock
cp env-example .env

編輯「Laradock/.env」檔案：

按下「Command」＋「Shift」＋「.」切換隱藏檔案顯示，再按一次回復設定」

透過關鍵字搜尋跳轉各設定區塊，注意點有：

Paths 部分： APP_CODE_PATH_HOST=~/Projects/ 專案存放目錄，上列內容是設定存放在家目錄下的「Projects」資料夾
PHP Version 部分： PHP_VERSION=7.4 設定 PHP-FPM container 的PHP 版本，也會影響到Workspace container。撰寫當下是7.3，如果啟動後有改版本記得要重新 build 才會生效。
MYSQL 部分： MYSQL_ROOT_PASSWORD=root
up phpmyadmin 之後以root 身份登入時的密碼
PHP MY ADMIN 部分：
PMA_USER=default PMA_ROOT_PASSWORD=secret PHA_PORT=8081
PHPMyAdmin 的登入埠口預設為8081

編輯macos 本身的/etc/hosts 檔案，將測試專案網站的網址加在裡面，在瀏覽器輸入測試專案網址時能夠連到 container 而不是外部網站

sudo nano /etc/hosts

加入內容

127.0.0.1 laravel.test

啟動需要的 container

docker-compose up -d nginx mysql phpmyadmin

透過 PHPMyAdmin 建立 Laravel 專案用資料庫網址輸入：

127.0.0.1:8081

登入資訊如下：

設定好連線帳號、密碼與資料庫後到資料庫「操作」畫面將編碼與校正變更為「utf8mb4_unicode_ci」

建立 Laravel 專案：切換至 workspace container：

docker-compose exec workspace bash

進入後會發現路徑在/var/www，對應宿主系統（macos）的「~/Projects」。用 composer 指令建立Laravel 專案，以 Laravel 8 最新版為例：

composer create-project laravel/laravel laravel.test 8.* --prefer-dist

設定Laravel 專案資料庫連線資訊切換至專案目錄：

cd ~/Projects/laravel.test

在 Finder 畫面下按command + shift + . 可顯示隱藏檔案，接著編輯 Laravel 專案「.env」檔案：

DB_CONNECTION=mysql
DB_HOST=mysql
DB_PORT=3306
DB_DATABASE=ffxitoolbox
DB_USERNAME=ffxitoolbox
DB_PASSWORD=ffxitoolbox

建立Nginx 站台設定檔

cd ~/Laradock/nginx/sites
cp laravel.conf.example laravel.test.conf

編輯上述新增的站台設定檔，其中：server_name：站台網址，範例如下：

server_name laravel.test;

root：網站檔案目錄（/var/www <-> ~/Projects），記得Laravel 專案的起始目錄是「public」，範例如下：

root /var/www/ffxitoolbox.abokuo.com/public;

error_log：錯誤日誌檔案，建議以網站別命名。範例如下：

error_log /var/log/nginx/ffxitoolbox.abokuo.com_error.log

access_log：存取日誌檔案，建議以網站別命名。範例如下：

access_log /var/log/nginx/ffxitoolbox.abokuo.com_access.log

完成以上作業後重新起動各 container：

docker-compose down
docker-compose up -d nginx mysql

然後在瀏覽器輸入Laravel 專案網址，如果能看到Laravel 專案頁面則完成。

重開機後記得要先啟動 Docker Desktop 才能啟動各 container。

docker-compose ps

docker-compose ps

觀看執行中的各 container 及使用埠口

docker-compose down

停止執行中的 container

docker-compose exec [container 名] bash

切換至container 內

docker-compose build [container 名] 

更改程式版本時需重新編譯 docker image 用，記得先將執行中的 container 停止

docker exec [Nginx container 名如：laradock_nginx_1] nginx -t

Nginx container 執行命令：測試設定檔是否正確

docker exec [Nginx container 名如：laradock_nginx_1] nginx -s reload

Nginx container 執行命令：重新載入設定檔