feat: add env var to skip local import (#2546)

* feat: add env var to skip local import

* feat: tests

packages/webpack-cli/bin/cli.js

@@ -12,9 +12,11 @@ const importLocal = require('import-local');
 const runCLI = require('../lib/bootstrap');
 const utils = require('../lib/utils');
 
-// Prefer the local installation of `webpack-cli`
-if (importLocal(__filename)) {
-    return;
+if (!process.env.WEBPACK_CLI_SKIP_IMPORT_LOCAL) {
+    // Prefer the local installation of `webpack-cli`
+    if (importLocal(__filename)) {
+        return;
+    }
 }
 
 process.title = 'webpack';

test/build/import-local/import-local.test.js

@@ -0,0 +1,21 @@
+'use strict';
+
+const { run } = require('../../utils/test-utils');
+
+const importLocalMock = jest.fn();
+jest.setMock('import-local', importLocalMock);
+
+describe('import local', () => {
+    beforeEach(() => {
+        importLocalMock.mockClear();
+    });
+    it('should skip import local when supplied', () => {
+        const { exitCode, stderr, stdout } = run(__dirname, [], {
+            env: { WEBPACK_CLI_SKIP_IMPORT_LOCAL: true },
+        });
+        expect(importLocalMock).toHaveBeenCalledTimes(0);
+        expect(exitCode).toBe(0);
+        expect(stderr).toBeFalsy();
+        expect(stdout).toBeTruthy();
+    });
+});