什麼是 WordPress 環境變數？
在 WordPress 開發中，我們經常需要在不同的環境（例如：開發環境、測試環境、正式環境）之間切換，每個環境都可能需要不同的設定，像是資料庫連線資訊、API 金鑰等等。直接在程式碼中硬編碼這些設定非常不安全，且維護起來非常麻煩。這時候，環境變數就派上用場了。
環境變數是一種在作業系統層級設定的變數，應用程式可以在執行時讀取這些變數。它們提供了一種將配置資訊與程式碼分離的方法，提高了程式碼的可移植性、安全性和可維護性。
在 WordPress 中，我們可以利用環境變數來儲存敏感資訊，例如資料庫密碼、API 金鑰、網站網址等，然後在程式碼中使用 `getenv()` 函數來讀取這些變數。這樣，我們就可以根據不同的環境載入不同的配置，而無需修改程式碼。
為什麼要使用環境變數？
使用環境變數有很多好處，以下列出幾個主要的原因：
- 安全性：避免在程式碼中硬編碼敏感資訊，降低資訊洩漏的風險。將密碼、金鑰等資訊儲存在環境變數中，可以防止這些資訊被意外地提交到版本控制系統或被未經授權的人員訪問。
- 可移植性：方便在不同的環境之間切換。只需修改環境變數，即可快速調整應用程式的配置，無需修改程式碼。這使得應用程式更容易部署到不同的伺服器或雲端平台。
- 可維護性：使配置資訊更容易管理。環境變數集中管理，方便修改和更新。當配置資訊需要變更時，只需修改環境變數即可，無需修改程式碼，降低了錯誤發生的可能性。
- 版本控制：避免將敏感資訊提交到版本控制系統。環境變數通常不提交到版本控制系統中，避免了敏感資訊洩漏的風險。
如何在 WordPress 中設定環境變數？
設定 WordPress 環境變數有幾種方式，以下介紹兩種常見的方法：
1. 使用 `.env` 檔案
`.env` 檔案是一個儲存環境變數的純文字檔案。它通常位於 WordPress 專案的根目錄。為了讓 WordPress 能夠讀取 `.env` 檔案中的變數，我們需要使用一個名為 `phpdotenv` 的 PHP 函式庫。
步驟 1：安裝 `phpdotenv`
可以使用 Composer 來安裝 `phpdotenv`。在 WordPress 專案的根目錄下，執行以下命令：
composer require vlucas/phpdotenv
步驟 2：建立 `.env` 檔案
在 WordPress 專案的根目錄下，建立一個名為 `.env` 的檔案，並在其中設定環境變數。例如：
DB_NAME=your_database_name
DB_USER=your_database_user
DB_PASSWORD=your_database_password
DB_HOST=localhost
WP_HOME=https://your-website.com
WP_SITEURL=https://your-website.com
步驟 3：在 `wp-config.php` 中載入 `.env` 檔案
在 `wp-config.php` 檔案的最上方，加入以下程式碼：
safeLoad();
define( 'DB_NAME', $_ENV['DB_NAME'] ?? $_SERVER['DB_NAME'] ?? 'wordpress' );
define( 'DB_USER', $_ENV['DB_USER'] ?? $_SERVER['DB_USER'] ?? 'wordpress' );
define( 'DB_PASSWORD', $_ENV['DB_PASSWORD'] ?? $_SERVER['DB_PASSWORD'] ?? '' );
define( 'DB_HOST', $_ENV['DB_HOST'] ?? $_SERVER['DB_HOST'] ?? 'localhost' );
define( 'WP_HOME', $_ENV['WP_HOME'] ?? $_SERVER['WP_HOME'] ?? 'http://localhost' );
define( 'WP_SITEURL', $_ENV['WP_SITEURL'] ?? $_SERVER['WP_SITEURL'] ?? 'http://localhost' );
// ... 其他 WordPress 設定
上述程式碼首先載入 `phpdotenv` 的自動載入器，然後建立一個 `Dotenv` 實例，並載入 `.env` 檔案。最後，使用 `$_ENV` 或 `$_SERVER` 超全局變數來讀取環境變數，並將其定義為 WordPress 常數。 注意使用了空值合併運算符 `??` 作為預設值，如果環境變數沒有設定，則使用預設值。
2. 在伺服器環境中設定
除了使用 `.env` 檔案之外，還可以直接在伺服器環境中設定環境變數。這種方法通常用於生產環境，因為它可以更好地控制環境變數的設定。
具體設定方法取決於伺服器的類型。以下是一些常見的伺服器設定方法：
- Apache：可以在 `httpd.conf` 或 `.htaccess` 檔案中使用 `SetEnv` 指令來設定環境變數。
- Nginx：可以在 `nginx.conf` 檔案中使用 `fastcgi_param` 指令來設定環境變數。
- cPanel：可以在 cPanel 的 “環境變數” 介面中設定環境變數。
- 雲端平台 (如 AWS、Google Cloud、Azure)：可以在平台的環境變數設定介面中設定環境變數。
設定完成後，可以使用 `getenv()` 函數來讀取環境變數。例如：
$database_name = getenv('DB_NAME');
在 WordPress 外掛和主題中使用環境變數
環境變數不僅可以在 `wp-config.php` 中使用，也可以在 WordPress 外掛和主題中使用。使用方法與 `wp-config.php` 中類似，都是使用 `getenv()` 函數來讀取環境變數。
例如，假設我們有一個外掛需要使用 API 金鑰。我們可以在 `.env` 檔案中設定 API 金鑰：
API_KEY=your_api_key
然後，在外掛的程式碼中使用 `getenv()` 函數來讀取 API 金鑰：
$api_key = getenv('API_KEY');
// 使用 API 金鑰進行 API 呼叫
這樣，我們就可以避免將 API 金鑰硬編碼到外掛的程式碼中，提高了外掛的安全性和可維護性。
表格：WordPress 開發環境配置
| 功能 | 說明 |
|---|---|
| 環境變數設定 | 使用 .env 檔案或伺服器環境變數設定敏感資訊 |
| 資料庫配置 | 確保開發、測試和正式環境使用不同的資料庫 |
| 除錯模式 | 在開發環境啟用 WP_DEBUG，正式環境停用 |
| 網站網址 | 根據環境設定 WP_HOME 和 WP_SITEURL |
FAQ：常見問題
如何確保 .env 檔案的安全？
.env 檔案包含敏感資訊，因此需要確保其安全性。 建議將 `.env` 檔案添加到 `.gitignore` 檔案中，以防止其被提交到版本控制系統。 此外，還可以設置伺服器權限，限制對 `.env` 檔案的訪問。
如果環境變數沒有設定，會發生什麼？
如果使用 `getenv()` 函數讀取一個未設定的環境變數，`getenv()` 函數會回傳 `false`。 因此，在使用 `getenv()` 函數時，應該檢查其回傳值，以避免出現錯誤。 或者，可以使用預設值，如範例中的 `define( ‘DB_NAME’, $_ENV[‘DB_NAME’] ?? $_SERVER[‘DB_NAME’] ?? ‘wordpress’ );` 使用空值合併運算符提供預設值。
可以使用哪些工具來管理環境變數？
除了 `phpdotenv` 之外，還有一些其他的工具可以用來管理環境變數。 例如，可以使用 `symfony/dotenv` 或 `joho/godotenv` 等函式庫。 此外，也可以使用一些雲端平台提供的環境變數管理工具，例如 AWS Systems Manager Parameter Store、Google Cloud Secret Manager、Azure Key Vault 等。
