webpack5配置:如何将contenthash存入文件供PHP模板使用
问题根源
webpack 5 中 contenthash 是资源级别的哈希值,不属于全局编译对象属性,直接在 stats 上取 .contenthash 自然拿不到有效结果。之前的 stats.hash 对应的是全局编译哈希,在 webpack 5 中已经改名为 fullhash,本身并不是你需要的、和资源内容绑定的 contenthash。
解决方案
修改自定义 MetaInfoPlugin 的逻辑,从编译产物列表中提取对应资源的 contenthash 写入文件,步骤如下:
- 调用
stats.toJson()拿到完整的编译序列化结果 - 遍历返回结果的
assets字段,定位你需要的入口资源(比如主 js、css 文件) - 直接读取对应资源自带的
contenthash属性,写入meta.json
改造后的完整可用代码
const fs = require('fs/promises'); // 直接使用 Promise 版 fs 避免嵌套回调 class MetaInfoPlugin { constructor(options) { this.options = { filename: 'meta.json', // 可配置要提取 contenthash 的资源名匹配规则 assetMatch: /main\.(js|css)$/, ...options }; } apply(compiler) { compiler.hooks.done.tapAsync(this.constructor.name, async (stats) => { // 拿到编译的完整 JSON 结果,关闭多余字段减少性能消耗 const statsJson = stats.toJson({ assets: true, hash: true, modules: false, chunks: false }); // 匹配所有需要存储的目标资源 const targetAssets = statsJson.assets.filter(asset => this.options.assetMatch.test(asset.name) ); const metaInfo = { // 存储资源名和对应 contenthash 的映射,PHP 可直接读取复用 assets: targetAssets.reduce((acc, asset) => { acc[asset.name] = { contenthash: asset.contenthash, size: asset.size }; return acc; }, {}), // 同时保留全局 fullhash 做兜底 fullhash: statsJson.hash }; // 写入目标文件 await fs.writeFile( this.options.filename, JSON.stringify(metaInfo, null, 2), 'utf8' ); }); } } // webpack 配置引用逻辑和原有保持一致即可 module.exports = { mode: 'production', target: 'web', // ... 其余原有配置全部保留 plugins: [ new MetaInfoPlugin({ filename: './public/theme/assets/scripts/meta.json', // 根据自身产物文件名规则修改匹配规则即可 assetMatch: /runtime~main\.js$|main\.[a-f0-9]+\.js$|main\.[a-f0-9]+\.css$/ }), ], // ... };
补充说明
- 如果只需要单个入口 chunk 的 contenthash,也可以直接从
statsJson.entrypoints找到对应入口,读取关联 chunk 的contenthash字段,和资源级别的 contenthash 完全一致 - 写入的
meta.json中存储的 contenthash,和你在配置里用[contenthash]占位符生成的文件名哈希值完全对齐,PHP 读取后可直接拼接出正确的资源引用地址
注意:不要手动拼接 contenthash 到文件名中,所有哈希值都以 webpack 编译生成的产物自带字段为准,避免和实际产物文件名不匹配。
内容的提问来源于stack exchange,提问作者Patrick
相关产品推荐
相关产品推荐

