Laravel 專案 clone 下來後要做什麼?

筆者不小心把專案搞壞了,於是把整個目錄砍掉重新從 GitHub clone 下來。
由於維護和安全性等考量,Laravel 預設有 .gitignore,有些檔案並沒有 push 到 GitHub。
專案 clone 之後必須要「重建」才能正常執行。

重建步驟

以下是幾個簡單的重建步驟:

1. 安裝依賴套件

到專案目錄執行以下指令,將框架所需的相依套件安裝完成:

$ composer install

2. 設定 .env 檔

將 .env.example 複製成 .env。
如果先前沒有花時間維護 .env.example,記得要修改裡面的內容,
如資料庫的相關參數DB_DATABASE=DB_USERNAMEDB_PASSWORD

3. 設定加密的 APP_KEY

執行以下指令,Laravel 就會自動在 .env 設定新的 APP_KEY

$ php artisan key:generate

4. 設定好你的資料庫

例如建立 SQLite 在 Laravel 的預設位置

$ touch database/database.sqlite

5. Migration

將資料表結構建立起來

$ php artisan migrate

故障排除

如果你在使用valet或是php artisan serve等伺服器的時候遇到以下錯誤:

The only supported ciphers are AES-128-CBC and AES-256-CBC with the correct key lengths.

就有可能是上面的動作沒有做完前就先運行 Laravel。
請做完以上重建步驟後,直接重開伺服器即可。

如果還是停在相同錯誤

請先清除設定檔快取後重開 Laravel。清除快取指令為:

$ php artisan config:clear

參考資料