代码拉取完成，页面将自动刷新
Dotenv es apoyado por la comunidad.
Gracias espaciales a:
Dotenv es un módulo de dependencia cero que carga las variables de entorno desde un archivo .env en process.env. El almacenamiento de la configuración del entorno separado del código está basado en la metodología The Twelve-Factor App.
# instalación local (recomendado)
npm install dotenv --save
O installación con yarn? yarn add dotenv
Cree un archivo .env en la raíz de su proyecto:
S3_BUCKET="YOURS3BUCKET"
SECRET_KEY="YOURSECRETKEYGOESHERE"
Tan prónto como sea posible en su aplicación, importe y configure dotenv:
require('dotenv').config()
console.log(process.env) // elimine esto después que haya confirmado que esta funcionando
.. o usa ES6?
import * as dotenv from 'dotenv' // vea en https://github.com/motdotla/dotenv#como-uso-dotenv-con-import
// REVISAR LINK DE REFERENCIA DE IMPORTACIÓN
dotenv.config()
import express from 'express'
Eso es todo. process.env ahora tiene las claves y los valores que definiste en tu archivo .env:
require('dotenv').config()
...
s3.getBucketCors({Bucket: process.env.S3_BUCKET}, function(err, data) {})
Si necesita variables de varias líneas, por ejemplo, claves privadas, ahora se admiten en la versión (>= v15.0.0) con saltos de línea:
PRIVATE_KEY="-----BEGIN RSA PRIVATE KEY-----
...
Kh9NV...
...
-----END RSA PRIVATE KEY-----"
Alternativamente, puede usar comillas dobles y usar el carácter \n:
PRIVATE_KEY="-----BEGIN RSA PRIVATE KEY-----\nKh9NV...\n-----END RSA PRIVATE KEY-----\n"
Los comentarios pueden ser agregados en tu archivo o en la misma línea:
# This is a comment
SECRET_KEY=YOURSECRETKEYGOESHERE # comment
SECRET_HASH="something-with-a-#-hash"
Los comentarios comienzan donde existe un #, entonces, si su valor contiene un #, enciérrelo entre comillas. Este es un cambio importante desde la versión >= v15.0.0 en adelante.
El motor que analiza el contenido de su archivo que contiene variables de entorno está disponible para su uso. Este Acepta una Cadena o un Búfer y devolverá un Objeto con las claves y los valores analizados.
const dotenv = require('dotenv')
const buf = Buffer.from('BASICO=basico')
const config = dotenv.parse(buf) // devolverá un objeto
console.log(typeof config, config) // objeto { BASICO : 'basico' }
Puede usar el --require (-r) opción de línea de comando para precargar dotenv. Al hacer esto, no necesita requerir ni cargar dotnev en el código de su aplicación.
$ node -r dotenv/config tu_script.js
Las opciones de configuración a continuación se admiten como argumentos de línea de comandos en el formato dotenv_config_<option>=value
$ node -r dotenv/config tu_script.js dotenv_config_path=/custom/path/to/.env dotenv_config_debug=true
Además, puede usar variables de entorno para establecer opciones de configuración. Los argumentos de línea de comandos precederán a estos.
$ DOTENV_CONFIG_<OPTION>=value node -r dotenv/config tu_script.js
$ DOTENV_CONFIG_ENCODING=latin1 DOTENV_CONFIG_DEBUG=true node -r dotenv/config tu_script.js dotenv_config_path=/custom/path/to/.env
Necesitaras agregar el valor de otro variable en una de sus variables? Usa dotenv-expand.
Necesitas mentener sincronizados los archivos .env entre maquinas, entornos, o miembros del equipo? Usa
dotenv-vault.
Vea ejemplos sobre el uso de dotenv con varios frameworks, lenguajes y configuraciones.
Dotenv expone dos funciones:
configuraciónanalizarConfiguración leerá su archivo .env, analizará el contenido, lo asignará a process.env,
y devolverá un Objeto con una clave parsed que contiene el contenido cargado o una clave error si falla.
const result = dotenv.config()
if (result.error) {
throw result.error
}
console.log(result.parsed)
Adicionalmente, puede pasar opciones a configuracion.
Por defecto: path.resolve(process.cwd(), '.env')
Especifique una ruta personalizada si el archivo que contiene las variables de entorno se encuentra localizado en otro lugar.
require('dotenv').config({ path: '/personalizado/ruta/a/.env' })
Por defecto: utf8
Especifique la codificación del archivo que contiene las variables de entorno.
require('dotenv').config({ encoding: 'latin1' })
Por defecto: false
Active el registro de ayuda para depurar por qué ciertas claves o valores no se inician como lo esperabas.
require('dotenv').config({ debug: process.env.DEBUG })
Por defecto: false
Anule cualquier variable de entorno que ya se haya configurada en su maquina con los valores de su archivo .env.
require('dotenv').config({ override: true })
El motor que analiza el contenido del archivo que contiene las variables de entorno está disponible para su uso. Acepta una Cadena o un Búfer y retornará un objecto con los valores analizados.
const dotenv = require('dotenv')
const buf = Buffer.from('BASICO=basico')
const config = dotenv.parse(buf) // devolverá un objeto
console.log(typeof config, config) // objeto { BASICO : 'basico' }
Por defecto: false
Active el registro de ayuda para depurar por qué ciertas claves o valores no se inician como lo esperabas.
const dotenv = require('dotenv')
const buf = Buffer.from('hola mundo')
const opt = { debug: true }
const config = dotenv.parse(buf, opt)
// espere por un mensaje de depuración porque el búfer no esta listo KEY=VAL
.env no carga mis variables de entorno correctamente?Lo más probable es que su archivo .env no esté en el lugar correcto. Vea este stack overflow.
Active el modo de depuración y vuelva a intentarlo...
require('dotenv').config({ debug: true })
Recibirá un error apropiado en su consola.
.env?No. Recomendamos enfáticamente no enviar su archivo .env a la versión de control. Solo debe incluir los valores especificos del entorno, como la base de datos, contraseñas o claves API.
.env?No. Recomendamos enfáticamente no tener un archivo .env "principal" y un archivo .env de "entorno" como .env.test. Su configuración debe variar entre implementaciones y no debe compartir valores entre entornos.
En una Aplicación de Doce Factores, las variables de entorno son controles diferenciados, cada uno totalmente independiente a otras variables de entorno. Nunca se agrupan como "entornos", sino que se gestionan de manera independiente para cada despliegue. Este es un modelo que se escala sin problemas a medida que la aplicación se expande de forma natural en más despliegues a lo largo de su vida.
El motor de análisis actualmente admite las siguientes reglas:
BASICO=basico se convierte en {BASICO: 'basico'}
# se tratan como comentarios# marca el comienzo de un comentario (a menos que el valor esté entre comillas)VACIO= se convierte en {VACIO: ''})JSON={"foo": "bar"} se convierte en {JSON:"{\"foo\": \"bar\"}")trim) (FOO= algo se convierte en {FOO: 'algo'})CITA_SIMPLE='citado' se convierte en {CITA_SIMPLE: "citado"})FOO=" algo " se convierte en {FOO: ' algo '})MULTILINEA="nueva\nlínea" se convierte en{MULTILINEA: 'nueva
línea'}
SIGNO_ACENTO=`Esto tiene comillas 'simples' y "dobles" en su interior.`)Por defecto, nunca modificaremos ninguna variable de entorno que ya haya sido establecida. En particular, si hay una variable en su archivo .env que colisiona con una que ya existe en su entorno, entonces esa variable se omitirá.
Si por el contrario, quieres anular process.env utiliza la opción override.
require('dotenv').config({ override: true })
Su código React se ejecuta en Webpack, donde el módulo fs o incluso el propio process global no son accesibles fuera-de-la-caja. El módulo process.env sólo puede ser inyectado a través de la configuración de Webpack.
Si estás usando react-scripts, el cual se distribuye a través de create-react-app, tiene dotenv incorporado pero con una singularidad. Escriba sus variables de entorno con REACT_APP_. Vea este stack overflow para más detalles.
Si estás utilizando otros frameworks (por ejemplo, Next.js, Gatsby...), debes consultar su documentación para saber cómo injectar variables de entorno en el cliente.
Sí! dotenv.config() devuelve un objeto que representa el archivo .env analizado. Esto te da todo lo que necesitas para poder establecer valores en process.env. Por ejemplo:
const dotenv = require('dotenv')
const variableExpansion = require('dotenv-expand')
const miEnv = dotenv.config()
variableExpansion(miEnv)
import?Simplemente..
// index.mjs (ESM)
import * as dotenv from 'dotenv' // vea https://github.com/motdotla/dotenv#como-uso-dotenv-con-import
dotenv.config()
import express from 'express'
Un poco de historia...
Cuando se ejecuta un módulo que contiene una sentencia
import, los módulos que importa serán cargados primero, y luego se ejecuta cada bloque del módulo en un recorrido en profundidad del gráfico de dependencias, evitando los ciclos al saltarse todo lo que ya se ha ejecutado.
¿Qué significa esto en lenguaje sencillo? Significa que se podrías pensar que lo siguiente funcionaría pero no lo hará.
// notificarError.mjs
import { Cliente } from 'mejor-servicio-para-notificar-error'
export default new Client(process.env.CLAVE_API)
// index.mjs
import dotenv from 'dotenv'
dotenv.config()
import notificarError from './notificarError.mjs'
notificarError.report(new Error('ejemplo documentado'))
process.env.CLAVE_API será vacio.
En su lugar, el código anterior debe ser escrito como...
// notificarError.mjs
import { Cliente } from 'mejor-servicio-para-notificar-errores'
export default new Client(process.env.CLAVE_API)
// index.mjs
import * as dotenv from 'dotenv'
dotenv.config()
import notificarError from './notificarError.mjs'
notificarError.report(new Error('ejemplo documentado'))
¿Esto tiene algo de sentido? Esto es poco poco intuitivo, pero es como funciona la importación de módulos en ES6. Aquí hay un ejemplo ejemplo práctico de esta trampa.
Existen dos arternativas a este planteamiento:
node --require dotenv/config index.js (Nota: no es necesario usar import dotenv con este método)config primero como se describe en este comentario #133
Prueba dotenv-expand
Vea dotenv-vault
Vea CONTRIBUTING.md
Vea CHANGELOG.md
Estos módulos npm dependen de él.
Los proyectos que lo amplían suelen utilizar la palabra clave "dotenv" en npm.
此处可能存在不合适展示的内容，页面不予展示。您可通过相关编辑功能自查并修改。
如您确认内容无涉及 不当用语 / 纯广告导流 / 暴力 / 低俗色情 / 侵权 / 盗版 / 虚假 / 无价值内容或违法国家有关法律法规的内容，可点击提交进行申诉，我们将尽快为您处理。