將 Laravel 應用程式部署到 Heroku
使用加密的 .env.vault 檔案將 Laravel 應用程式部署到 Heroku。
在此指南中，請在 GitHub 上找到完整的程式碼範例。
初始設定
安裝 Laravel 並建立一個新的 Laravel 專案。
composer create-project laravel/laravel yourapp
新增一個 Procfile 來執行您的 Laravel 應用程式。
Procfile
web: heroku-php-apache2 public/
編輯 resources/views/welcome.blade.php。
resources/views/welcome.blade.php
Hello {{ env('HELLO') }}.
在 Heroku 上建立您的專案。
heroku create
產生一個 Laravel APP_KEY 並在 Heroku 上設定它。
php artisan key:generate --show
heroku config:set APP_KEY='base64:1234...'
將所有內容提交到程式碼並推送到 Heroku。
git push heroku
部署後，您的應用程式會顯示 'Hello .'，因為它還沒有辦法存取環境變數。接下來我們來處理這個問題。
安裝 dotenv-vault-laravel
在您的 composer.json 檔案中要求 dotenv-vault-laravel。
composer require davidcochrum/dotenv-vault-laravel
composer.json
...
"require": {
"davidcochrum/dotenv-vault-laravel": "^1.1",
...
}
...
在您的 .env 檔案底部新增 HELLO=World。
.env
...
HELLO="World"
嘗試在本機執行它。
php artisan serve
INFO Server running on [http://127.0.0.1:8000]
它應該顯示 Hello World。
太棒了！ENV 現在有您在 .env 檔案中定義的金鑰和值。這涵蓋了本機開發。接下來我們來解決生產環境的問題。
建置 .env.vault
推送您最新的 .env 檔案變更並編輯您的生產機密。深入瞭解同步 .env 檔案
npx dotenv-vault@latest new
npx dotenv-vault@latest push
npx dotenv-vault@latest open production
使用比較環境功能將 Laravel 的開發值複製到生產環境。（另外，根據需要修改任何生產值。）
接下來，將 HELLO 修改為 production。
然後建置您加密的 .env.vault 檔案。
npx dotenv-vault@latest build
其內容應如下所示。
.env.vault
#/-------------------.env.vault---------------------/
#/ cloud-agnostic vaulting standard /
#/ [how it works](https://dotenv.org/env-vault) /
#/--------------------------------------------------/
# development
DOTENV_VAULT_DEVELOPMENT="/HqNgQWsf6Oh6XB9pI/CGkdgCe6d4/vWZHgP50RRoDTzkzPQk/xOaQs="
DOTENV_VAULT_DEVELOPMENT_VERSION=2
# production
DOTENV_VAULT_PRODUCTION="x26PuIKQ/xZ5eKrYomKngM+dO/9v1vxhwslE/zjHdg3l+H6q6PheB5GVDVIbZg=="
DOTENV_VAULT_PRODUCTION_VERSION=2
設定 DOTENV_KEY
取得您的生產 DOTENV_KEY。
npx dotenv-vault@latest keys production
# outputs: dotenv://:[email protected]/vault/.env.vault?environment=production
使用 CLI 在 Heroku 上設定 DOTENV_KEY。
heroku config:set DOTENV_KEY='dotenv://:key_1234…@dotenv.org/vault/.env.vault?environment=production'
或使用 Heroku 的 UI。
部署
將這些變更安全地提交到程式碼並部署。
就這樣！在部署時，您的 .env.vault 檔案將被解密，其生產機密將作為環境變數注入，就在及時的時候。
當您在日誌中看到 Loading env from encrypted .env.vault 時，您就知道一切運作正常。如果沒有設定 DOTENV_KEY（例如在本機電腦上開發時），它將退回標準的 dotenv 功能。
您已成功使用新的 .env.vault 標準來加密和部署您的機密。這比將您的機密分散在多個第三方平台和工具中安全得多。每當您需要新增或變更機密時，只需重建您的 .env.vault 檔案並重新部署即可。