minor #18501 [Encore] Webpack Dev Server & Symfony CLI HTTPS: add note for Node 17+ (jmsche)

javiereguiluz · javiereguiluz · commit e094be3053b2 · 2023-07-05T12:15:31.000+02:00
This PR was merged into the 5.4 branch. Discussion ---------- [Encore] Webpack Dev Server & Symfony CLI HTTPS: add note for Node 17+ A little note required to run Webpack Dev Server with Symfony CLI + its HTTPS certificate using Node.js 17+. Related issue on Webpack Encore: symfony/webpack-encore#1187 Credits to `@fracsi` for the "fix" :) Commits ------- 0ec56cd [Encore] Webpack Dev Server & Symfony CLI HTTPS: add note for Node 17+
diff --git a/frontend/encore/dev-server.rst b/frontend/encore/dev-server.rst
@@ -58,7 +58,6 @@ method in your ``webpack.config.js`` file:
         })
     ;
 
-
 Enabling HTTPS using the Symfony Web Server
 -------------------------------------------
 
@@ -84,6 +83,19 @@ server SSL certificate:
     +         }
     +     })
 
+.. note::
+
+    If you are using Node.js 17 or newer, you have to run the ``dev-server`` command with the
+    ``--openssl-legacy-provider`` option:
+
+    .. code-block:: terminal
+
+        # if you use the Yarn package manager
+        $ NODE_OPTIONS=--openssl-legacy-provider yarn encore dev-server
+
+        # if you use the npm package manager
+        $ NODE_OPTIONS=--openssl-legacy-provider npm run dev-server
+
 CORS Issues
 -----------
 
