扩展Webpack——是否兼容Shopware云环境？

一、环境变量方案适配性 #

你在自托管环境用的JS插件环境变量方案，不能直接照搬用到Shopware云环境，核心差异在于：

• Shopware云环境不读取本地.env文件，所有环境变量必须通过云控制台的环境变量配置面板，或者在shopware.yaml中通过env(ENV_VAR_NAME)的方式引用云平台托管的变量。
• 前端JS插件的环境变量必须在构建阶段注入，云环境不会在运行时为前端代码加载额外的环境变量，所以要确保构建流程（比如webpack的DefinePlugin）能正确拉取云环境变量并编译到静态文件中。

二、提交应用前的归档注意事项 #

1. 必须包含的目录 #

• dist/build目录：Shopware云环境默认不会执行前端构建命令，所以必须把编译完成的静态资源（比如打包后的JS、CSS文件）一起归档，确保插件部署后能直接运行。同时要检查plugin.xml里的资源路径是否正确指向该目录下的文件。

2. 绝对不能包含的文件 #

• .env文件：该文件包含敏感配置信息，且云环境完全不识别本地.env，一旦归档提交会导致敏感数据泄露，所有环境变量都要迁移到Shopware云的环境变量管理系统中。

3. 其他归档要点 #

• 移除本地开发相关文件：比如node_modules目录、开发日志、临时构建缓存文件（如.git、npm-debug.log），只保留插件运行必需的文件（src、dist、plugin.xml、composer.json、composer.lock等）。
• 验证环境变量注入逻辑：确保前端代码中所有依赖环境变量的部分，在构建时已经被正确替换为云环境配置的值，避免出现未定义的变量错误。

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