用 15 分鐘快速打造 Laravel 開發環境

cover page

相信大家對 Laravel 都很熟悉,但是初學者或是新進同事要快速入門 Laravel 最大的門檻就是該如何在短時間內在本機電腦快速安裝好公司專案。這時候使用 Laradock 就是一個最佳時機,透過 Docker 容器話,快速切換 PHP 版本,或者是安裝額外的服務像是 MySQL, MariaDB, phpMyAdmin 或 nginx 等服務,讓本機端不受到自訂安裝套件的困擾,用完隨時關閉,完全不會影響到電腦環境。底下我會介紹使用 Laradock 該注意的事情。完整詳細的操作步驟可以直接看 Youtube 影片。

教學影片

同步放在 Udemy 平台上面,有興趣的可以直接參考底下:

前置處理

先來定義 laradock 該如何跟既有或者是全新專案結合,底下提供一種目錄結構

├── laradock
└── www

其實蠻好懂的,先建立空目錄,www 代表專案的程式碼,而 laradock 就是本機端開發環境。你也可以直接將 laradock 放進 www 內也可以。

編輯 laradock/.env (從 env-example 複製)

修改

APP_CODE_PATH_HOST=../www

專案架構調整為:

├── laradock
└── www

如果機器本身已經有 nginx, apachetraefik,請將 nginx container port 修改為:

NGINX_HOST_HTTP_PORT=8000
NGINX_HOST_HTTPS_PORT=4430

下載專案原始碼

如果已經有 Source Code 了請忽略此步驟,如果是全新的專案,請先進入 workspace 容器:

docker-compose exec workspace bash

進去後預設會在 /var/www 目錄底下,接著下載 laravel 官方原始碼

composer create-project laravel/laravel --prefer-dist .

完成後請離開 container,就可以看到在 www 底下有完整的 laravel 代碼,避免跟主機 Host 衝突。接著啟動專案 (nginx + mariadb)

docker-compose up -d nginx mariadb

設定 nginx 檔案

先假設網域名稱為 laravel.test,先複製 config

cp -r nginx/sites/laravel.conf.example nginx/sites/laravel.test.conf

修改 nginx/sites/laravel.test.conf

# 將底下
root /var/www/laravel/public
# 改成
root /var/www/public

這邊我有發個 PR 到 Laradock,最後新增 laravel.test 到 /etc/hosts 檔案

修改目錄權限

由於 php-fpm 容器運行的 www-data 的使用者,所以您必須在 Host 設定相對應的 uid 及 gid,先進入 php-fpm 來取得 www-data 個人資訊:

$ docker-compose exec php-fpm id www-data
uid=1000(www-data) gid=1000(www-data) groups=1000(www-data)

設定權限

chown -R 1000:1000 www/storage/

編輯 laradock/docker-compose.yml

Docker 預設使用 172.21.x 開頭的 IP,可以修改 docker-compose.yml 來調整網路設定:

networks:
  frontend:
    driver: ${NETWORKS_DRIVER}
    ipam:
      driver: default
      config:
        - subnet: 192.168.100.0/24
  backend:
    driver: ${NETWORKS_DRIVER}
    ipam:
      driver: default
      config:
        - subnet: 192.168.101.0/24
  default:
    driver: ${NETWORKS_DRIVER}
    ipam:
      driver: default
      config:
        - subnet: 192.168.110.0/24

避免跟公司網路 172.xxx.xxx.xxx 網域衝到造成網路斷線。

  • Vam Houng

    您好,我想請問一下

    我嘗試了好幾次,但我的 www 目錄下並沒有出現我透過

    docker-compose exec workspace bash

    建立的 laravel 專案,請問我是哪個部分有錯誤呢?

  • jt

    感謝版主教學!我多做了一層 blog,也有改 nginx path 但一直 404 弄了一整天,一整天…。
    建議照版主教學,www 下面直接建專案,不要再拉一層目錄了…