Skip to content

Hello Encore 1.0 & Webpack 5!

Choose a tag to compare

View all tags
@weaverryan weaverryan released this 27 Jan 20:15
· 425 commits to main since this release
v1.0.0
c5d62a4

Hi Webpackers!

Today I'm thrilled to release Encore 1.0. In reality, Encore has been stable for years and has, as often as possible, deprecated features instead of hard breaking.

Most importantly, this release upgrades Webpack from 4 to 5, and a number of other dependencies have also been upgraded.

To upgrade run:

yarn upgrade "@symfony/webpack-encore@^1.0.0"

Changes: v0.33.0..v1.0.0

Documentation: http://symfony.com/doc/current/frontend.html

Highlights:

  • [DEPENDENCY UPGRADE] Webpack was upgraded from version 4 to 5.

  • [DEPENDENCY UPGRADES] The following packages had major version upgrades:

    • css-loader from 3 to 5
    • assets-webpack-plugin from 5 to 7
    • mini-css-extract-plugin from 0.4 to 1
    • style-loader from 1 to 2
    • terser-webpack-plugin from 1 to 5
    • webpack-cli from 3 to 4
    • webpack-manifest-plugin from 2 to 3
    • webpack-manifest-plugin from 3 to 4-beta

  • [DEPENDENCY SUPPORT CHANGES] Encore has changed what versions it supports
    of the following packages:

    • less from 3 to 4 and less-loader from 6 to 7
    • fork-ts-checker-webpack-plugin from 4 to 5 or 6

  • [BC BREAK] Image and font processing was changed from using file-loader
    (and optionally url-loader via configureUrlLoader()) to Webpack 5's
    new Asset Modules.
    In practice, unless you have a highly-configured system, this should
    not cause significant changes.

  • [BC BREAK] The configureUrlLoader() method was removed. See
    configureImageRule() and configureFontRule() - specifically the
    maxSize option and type: 'asset'. The url-loader is no longer used.

  • [BC BREAK] The disableImagesLoader() and disableFontsLoader() methods
    have been removed. See configureImageRule() and configureFontRule()
    for a new option to disable these.

  • [BC BREAK] The configureFilenames() method no longer accepts paths
    for images or fonts. See configureImageRule() and configureFontRule()
    for how to configure these filenames. The configureFilenames() method
    does now accept an assets option, but out-of-the-box, this will not
    result in any filename changes. See configureFilenames() for more details.

  • [BC BREAK] optimize-css-assets-webpack-plugin was replaced by
    css-minimizer-webpack-plugin and the optimizeCssPluginOptionsCallback()
    method was replaced by cssMinimizerPluginOptionsCallback().

  • [BC BREAK] The file-loader package is no longer required by Encore. If
    you use copyFiles(), you will need to install it manually (you
    will receive a clear error about this).

  • [BC BREAK] All previously-deprecated methods & options were removed.

  • [BEHAVIOR CHANGE] The HashedModuleIdsPlugin was previously used to
    help name "modules" when building for production. This has been removed
    and we now use Webpack's native optimization.moduleIds option, which
    is set to deterministic.

  • [configureMiniCssExtractPlugin()] configureMiniCssExtractPlugin() was
    added to allow the MiniCssExtractPlugin.loader and MiniCssExtractPlugin
    to be configured.

  • [enableBuildCache()] Added enableBuildCache() to enable the new
    Webpack 5 build caching. https://webpack.js.org/blog/2020-10-10-webpack-5-release/
    This feature should be considered experimental.

Happy Webpacking!

Assets 2
Loading