-
-
Notifications
You must be signed in to change notification settings - Fork 26.9k
New issue
Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.
By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.
Already on GitHub? Sign in to your account
add webpack-env-define-plugin package #1030
Changes from 3 commits
9ef53fd
863e640
35fbc21
7962c10
e82dce4
File filter
Filter by extension
Conversations
Jump to
Diff view
Diff view
There are no files selected for viewing
Original file line number | Diff line number | Diff line change |
---|---|---|
|
@@ -201,3 +201,35 @@ module.exports = { | |
// ... | ||
} | ||
``` | ||
|
||
#### `new webpackEnvDefinePlugin({regex: string, customVariables: Object.<string, string>})` | ||
|
||
This webpack plugin grabs environment variables that follows a specified regex and injects them into the application | ||
using the webpack DefinePlugin. | ||
In addition, the plugin allows defining custom environment variables to be injected. | ||
|
||
To use first reference it in your webpack config: | ||
|
||
```js | ||
var EnvDefinePlugin = require('react-dev-utils/webpackEnvDefinePlugin'); | ||
``` | ||
|
||
and define it as a plugin in the webpack config plugin section: | ||
|
||
```js | ||
plugins: [ | ||
... | ||
new EnvDefinePlugin({ | ||
// Grab MY_PREFIX_* environment variables | ||
regex: /^MY_PREFIX_/i, | ||
customVariables: { | ||
// Useful for determining whether we’re running in production mode. | ||
// Most importantly, it switches React into the correct mode. | ||
There was a problem hiding this comment. Choose a reason for hiding this commentThe reason will be displayed to describe this comment to others. Learn more. Both of these comments are a bit out of context (and the second one is actually misleading). |
||
'MY_ENV_VAR': JSON.stringify( | ||
process.env.MY_ENV_VAR || 'default' | ||
) | ||
} | ||
}), | ||
... | ||
] | ||
``` |
Original file line number | Diff line number | Diff line change |
---|---|---|
|
@@ -19,7 +19,8 @@ | |
"openBrowser.js", | ||
"prompt.js", | ||
"WatchMissingNodeModulesPlugin.js", | ||
"webpackHotDevClient.js" | ||
"webpackHotDevClient.js", | ||
"webpackEnvDefinePlugin.js" | ||
], | ||
"dependencies": { | ||
"ansi-html": "0.0.5", | ||
|
@@ -28,6 +29,7 @@ | |
"html-entities": "1.2.0", | ||
"opn": "4.0.2", | ||
"sockjs-client": "1.0.3", | ||
"strip-ansi": "3.0.1" | ||
"strip-ansi": "3.0.1", | ||
"webpack": "^1.13.3" | ||
There was a problem hiding this comment. Choose a reason for hiding this commentThe reason will be displayed to describe this comment to others. Learn more. There isn't an explicit webpack dependency to support both 1.x and 2.x. See #963 and #950 (comment) for more info. There was a problem hiding this comment. Choose a reason for hiding this commentThe reason will be displayed to describe this comment to others. Learn more. @gaearon what do you want to do regarding the webpack dependency? There was a problem hiding this comment. Choose a reason for hiding this commentThe reason will be displayed to describe this comment to others. Learn more. You can remove it. |
||
} | ||
} |
Original file line number | Diff line number | Diff line change |
---|---|---|
@@ -0,0 +1,51 @@ | ||
/** | ||
* Copyright (c) 2015-present, Facebook, Inc. | ||
* All rights reserved. | ||
* | ||
* This source code is licensed under the BSD-style license found in the | ||
* LICENSE file in the root directory of this source tree. An additional grant | ||
* of patent rights can be found in the PATENTS file in the same directory. | ||
*/ | ||
'use strict'; | ||
|
||
const DefinePlugin = require('webpack').DefinePlugin; | ||
|
||
/** | ||
* Webpack plugin to inject environment variables that pass a regex test. The plugin also support | ||
* custom variables by passing them in the options argument | ||
* | ||
* @param {Object} options - The plugin configuration | ||
* @param {string} options.regex - The regex to select the environment variables by | ||
* @param {Object.<string, string>} options.customVariables - A map that its keys are the | ||
* custom injected environment | ||
* variable names and its values are the variable values | ||
* @constructor - Returns a new EnvDefinePlugin instance | ||
*/ | ||
function EnvDefinePlugin(options) { | ||
this.regex = options.regex || /.*/; | ||
this.customVariables = options.customVariables || {}; | ||
} | ||
|
||
/** | ||
* Grabs environment variables that meets the regex test and prepare them to be injected into the | ||
* application via DefinePlugin in Webpack configuration. | ||
* @param {string} regex - The regex to select the environment variables by | ||
* @param {Object.<string, string>} customVariables - A map where its keys are the custom injected environment | ||
* @returns {{[process.env]: *}} - A DefinePlugin configuration | ||
*/ | ||
function getClientEnvironment(regex, customVariables) { | ||
const processEnv = Object | ||
.keys(process.env) | ||
.filter(key => regex.test(key)) | ||
.reduce((env, key) => { | ||
env[key] = JSON.stringify(process.env[key]); | ||
return env; | ||
}, customVariables); | ||
return { 'process.env': processEnv }; | ||
} | ||
|
||
EnvDefinePlugin.prototype.apply = function(compiler) { | ||
compiler.apply(new DefinePlugin(getClientEnvironment(this.regex, this.customVariables))); | ||
}; | ||
|
||
module.exports = EnvDefinePlugin; |
This file was deleted.
Original file line number | Diff line number | Diff line change |
---|---|---|
|
@@ -16,7 +16,7 @@ var HtmlWebpackPlugin = require('html-webpack-plugin'); | |
var CaseSensitivePathsPlugin = require('case-sensitive-paths-webpack-plugin'); | ||
var InterpolateHtmlPlugin = require('react-dev-utils/InterpolateHtmlPlugin'); | ||
var WatchMissingNodeModulesPlugin = require('react-dev-utils/WatchMissingNodeModulesPlugin'); | ||
var getClientEnvironment = require('./env'); | ||
var EnvDefinePlugin = require('react-dev-utils/webpackEnvDefinePlugin'); | ||
var paths = require('./paths'); | ||
|
||
// Webpack uses `publicPath` to determine where the app is being served from. | ||
|
@@ -26,8 +26,6 @@ var publicPath = '/'; | |
// as %PUBLIC_URL% in `index.html` and `process.env.PUBLIC_URL` in JavaScript. | ||
// Omit trailing slash as %PUBLIC_PATH%/xyz looks better than %PUBLIC_PATH%xyz. | ||
var publicUrl = ''; | ||
// Get environment variables to inject into our app. | ||
var env = getClientEnvironment(publicUrl); | ||
|
||
// This is the development configuration. | ||
// It is focused on developer experience and fast rebuilds. | ||
|
@@ -196,8 +194,23 @@ module.exports = { | |
template: paths.appHtml, | ||
}), | ||
// Makes some environment variables available to the JS code, for example: | ||
// if (process.env.NODE_ENV === 'development') { ... }. See `./env.js`. | ||
new webpack.DefinePlugin(env), | ||
// if (process.env.NODE_ENV === 'development') { ... }. | ||
new EnvDefinePlugin({ | ||
// Grab REACT_APP_* environment variables | ||
regex: /^REACT_APP_/i, | ||
customVariables: { | ||
// Useful for determining whether we’re running in production mode. | ||
// Most importantly, it switches React into the correct mode. | ||
'NODE_ENV': JSON.stringify( | ||
process.env.NODE_ENV || 'development' | ||
There was a problem hiding this comment. Choose a reason for hiding this commentThe reason will be displayed to describe this comment to others. Learn more. We don't need to read |
||
), | ||
// Useful for resolving the correct path to static assets in `public`. | ||
// For example, <img src={process.env.PUBLIC_URL + '/img/logo.png'} />. | ||
// This should only be used as an escape hatch. Normally you would put | ||
// images into the `src` and `import` them in code to get their paths. | ||
'PUBLIC_URL': JSON.stringify(publicUrl) | ||
} | ||
}), | ||
// This is necessary to emit hot updates (currently CSS only): | ||
new webpack.HotModuleReplacementPlugin(), | ||
// Watcher doesn't work well if you mistype casing in a path so we use | ||
|
Original file line number | Diff line number | Diff line change |
---|---|---|
|
@@ -18,7 +18,7 @@ var ManifestPlugin = require('webpack-manifest-plugin'); | |
var InterpolateHtmlPlugin = require('react-dev-utils/InterpolateHtmlPlugin'); | ||
var url = require('url'); | ||
var paths = require('./paths'); | ||
var getClientEnvironment = require('./env'); | ||
var EnvDefinePlugin = require('react-dev-utils/webpackEnvDefinePlugin'); | ||
|
||
function ensureSlash(path, needsSlash) { | ||
var hasSlash = path.endsWith('/'); | ||
|
@@ -45,14 +45,6 @@ var publicPath = ensureSlash(homepagePathname, true); | |
// as %PUBLIC_URL% in `index.html` and `process.env.PUBLIC_URL` in JavaScript. | ||
// Omit trailing slash as %PUBLIC_PATH%/xyz looks better than %PUBLIC_PATH%xyz. | ||
var publicUrl = ensureSlash(homepagePathname, false); | ||
// Get environment variables to inject into our app. | ||
var env = getClientEnvironment(publicUrl); | ||
|
||
// Assert this just to be safe. | ||
// Development builds of React are slow and not intended for production. | ||
if (env['process.env'].NODE_ENV !== '"production"') { | ||
throw new Error('Production builds must have NODE_ENV=production.'); | ||
} | ||
|
||
// This is the production configuration. | ||
// It compiles slowly and is focused on producing a fast and minimal bundle. | ||
|
@@ -228,10 +220,25 @@ module.exports = { | |
} | ||
}), | ||
// Makes some environment variables available to the JS code, for example: | ||
// if (process.env.NODE_ENV === 'production') { ... }. See `./env.js`. | ||
// if (process.env.NODE_ENV === 'production') { ... }. | ||
// It is absolutely essential that NODE_ENV was set to production here. | ||
// Otherwise React will be compiled in the very slow development mode. | ||
new webpack.DefinePlugin(env), | ||
new EnvDefinePlugin({ | ||
// Grab REACT_APP_* environment variables | ||
regex: /^REACT_APP_/i, | ||
customVariables: { | ||
// Useful for determining whether we’re running in production mode. | ||
// Most importantly, it switches React into the correct mode. | ||
'NODE_ENV': JSON.stringify( | ||
process.env.NODE_ENV || 'production' | ||
There was a problem hiding this comment. Choose a reason for hiding this commentThe reason will be displayed to describe this comment to others. Learn more. Same here. Just pass There was a problem hiding this comment. Choose a reason for hiding this commentThe reason will be displayed to describe this comment to others. Learn more. You'd need to update comments to make sense after the changes. |
||
), | ||
// Useful for resolving the correct path to static assets in `public`. | ||
// For example, <img src={process.env.PUBLIC_URL + '/img/logo.png'} />. | ||
// This should only be used as an escape hatch. Normally you would put | ||
// images into the `src` and `import` them in code to get their paths. | ||
'PUBLIC_URL': JSON.stringify(publicUrl) | ||
} | ||
}), | ||
// This helps ensure the builds are consistent if source hasn't changed: | ||
new webpack.optimize.OccurrenceOrderPlugin(), | ||
// Try to dedupe duplicated modules, if any: | ||
|
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
Please remove
webpack
prefix.