Webpack Encore 使用教程

2024-08-26 00:38:12作者：齐冠琰

项目介绍

Webpack Encore 是一个简单但强大的 API，用于处理和编译基于 Webpack 的资产。它是 Symfony 项目的一部分，但可以轻松用于任何语言的应用程序。Encore 提供了干净的 API，用于打包 JavaScript 模块、预处理 CSS 和 JS，以及编译和压缩资产。它旨在解决最常见的 Webpack 用例，并提供了一个专业的资产系统，使用起来非常愉快。

项目快速启动

安装

首先，确保你已经安装了 Node.js 和 Yarn。然后，通过以下命令安装 Webpack Encore：

yarn add @symfony/webpack-encore --dev

配置

在你的项目根目录下创建一个 webpack.config.js 文件，并添加以下内容：

const Encore = require('@symfony/webpack-encore');

Encore
    // 项目输出目录
    .setOutputPath('public/build/')
    // 公共路径，用于访问输出文件
    .setPublicPath('/build')
    // 入口文件
    .addEntry('app', './assets/js/app.js')
    // 启用 React 支持
    .enableReactPreset()
    // 启用 Sass 支持
    .enableSassLoader()
    // 启用 PostCSS 支持
    .enablePostCssLoader()
    // 启用 Source Maps
    .enableSourceMaps(!Encore.isProduction())
    // 压缩 CSS 和 JS
    .enableVersioning(Encore.isProduction())
;

module.exports = Encore.getWebpackConfig();

编译

运行以下命令来编译你的资产：

yarn encore dev

或者，如果你需要进行生产环境的编译：

yarn encore production

应用案例和最佳实践

案例一：Symfony 项目中的使用

在 Symfony 项目中，Webpack Encore 可以与 Twig 模板引擎无缝集成。你可以在 Twig 模板中使用 encore_entry_link_tags 和 encore_entry_script_tags 函数来加载 CSS 和 JS 文件。

<!DOCTYPE html>
<html>
<head>
    <title>My Symfony App</title>
    {{ encore_entry_link_tags('app') }}
</head>
<body>
    <h1>Welcome to My Symfony App</h1>
    {{ encore_entry_script_tags('app') }}
</body>
</html>