如何为@wordpress/env创建的本地WordPress实例添加环境变量

虽然官方文档未明确说明，但可以通过以下两种可行方式实现本地环境变量的配置：

方法1：通过wp-env.json直接定义 #

在项目根目录的wp-env.json配置文件中，新增env字段来指定不同环境的变量：

{
  "core": "WordPress/WordPress#6.4",
  "plugins": [ "./" ],
  "env": {
    "development": {
      "PROD_LIKE_VAR": "your_production_value",
      "ANOTHER_VAR": "test_specific_value"
    },
    "tests": {
      "PROD_LIKE_VAR": "test_environment_value"
    }
  }
}

• development对应本地开发环境，tests对应自动化测试环境
• 配置的变量会自动注入WordPress运行环境，插件中可通过getenv('PROD_LIKE_VAR')直接获取

方法2：使用.env文件管理 #

1. 在项目根目录创建.env文件，写入需要的环境变量：

PROD_LIKE_VAR=your_production_value
ANOTHER_VAR=test_specific_value

2. 在wp-env.json中开启对.env文件的支持：

{
  "core": "WordPress/WordPress#6.4",
  "plugins": [ "./" ],
  "useDotenv": true
}

这种方式更适合团队协作，记得将.env加入.gitignore，避免提交敏感信息。

验证变量是否生效 #

可以在插件中添加简单的调试代码确认：

// 插件主文件中添加
if ( defined( 'WP_ENVIRONMENT_TYPE' ) && WP_ENVIRONMENT_TYPE === 'local' ) {
    error_log( 'PROD_LIKE_VAR value: ' . getenv( 'PROD_LIKE_VAR' ) );
}

启动wp-env后，查看日志即可确认变量是否成功加载。

内容的提问来源于stack exchange，提问作者C0rn