Using webpack-dev-server and HMR
Edit this pageWarning: You are browsing the documentation for Symfony 4.0, which is no longer maintained.
Read the updated version of this page for Symfony 6.2 (the current stable version).
Using webpack-dev-server and HMR
While developing, instead of using encore dev --watch
, you can use the
webpack-dev-server:
1
$ ./node_modules/.bin/encore dev-server
This serves the built assets from a new server at http://localhost:8080
(it does
not actually write any files to disk). This means your script
and link
tags
need to change to point to this.
If you've activated the manifest.json versioning you're done: the paths in your templates will automatically point to the dev server.
You can also pass options to the dev-server
command: any options that are supported
by the normal webpack-dev-server. For example:
1
$ ./node_modules/.bin/encore dev-server --https --port 9000
This will start a server at https://localhost:9000
.
Note
This Webpack server is independent from Symfony's development web server and you need to run both separately.
Using dev-server inside a VM
If you're using dev-server
from inside a virtual machine, then you'll need
to bind to all IP addresses and allow any host to access the server:
1
$ ./node_modules/.bin/encore dev-server --host 0.0.0.0 --disable-host-check
You can now access the dev-server using the IP address to your virtual machine on port 8080 - e.g. http://192.168.1.1:8080.
Hot Module Replacement HMR
Encore does support HMR, but only in some areas. To activate it, pass the --hot
option:
1
$ ./node_modules/.bin/encore dev-server --hot
HMR currently works for Vue.js, but does not work for styles anywhere at this time.