最近很夯的PHP框架 Laravel 除了自己建 Laravel 專案以外,有時候也會 clone 回來專案, 完成後會發現無法執行。
因為Laravel 初始化就有 .gitignore檔案,你可以在根目錄找找看。因為 .gitignore
設定的原因,並沒有所有檔案都加入版本控制,所以抓下來後必須要有重建,整個專案才會運行。
.gitignore
.gitignore 主要的功能就是把不想加入版本控制的內容,寫在這個檔案中,在 Git 提交至版本控制的儲存庫( repository)時,不會加入 .gitignore 檔案裡面標註的路徑,大多是排除包含帳密的檔案 像是 .env
,把它push 到 Server 實在不恰當會有安全上的問題,或是一些快取檔案,這些並不需要加入,或是下載的 package ,所以特別在.gitignore加以排除,導致專案下載後,必須一些步驟才能還原專案。
還原Laravel 專案步驟
開始把 clone 回來的專案還原吧!
git clone
C:\ > git clone https://xxx
複製一份專案到 local 端
還原核心目錄
C:\LaravelProject > composer install
還原node_modules目錄
如果有用 node.js (不確定電腦有沒有裝node.js 可以輸入下方指令測試看看node.js 、npm 安裝了沒,有安裝皆須出現版本號例如有使用 Laravel Mix 舊版好像是叫 (Laravel Elixir)
C:\LaravelProject > node -v
C:\LaravelProject > npm -v
確定有安裝後 則可選擇執行 npm install 還原 目錄
C:\LaravelProject > npm install
建置.env 環境變數
C:\LaravelProject > cp .env.example .env
C:\LaravelProject > php artisan key:generate
第一行 先複製 .env.example
並重新命名為 .env
第二行 重新產生 APP_KEY
還原資料庫
把環境變數設定好以後
C:\LaravelProject > php artisan migrate
C:\LaravelProject > php artisan db:seed
如果有 clone 的需求,可以重做一次這些動作,讓Laravel 可以順利在local端運行。