(PHP 4, PHP 5, PHP 7, PHP 8)
getenv — Retorna el valor de una o todas las variables de entorno
Retorna el valor de una o todas las variables de entorno.
Puede verse una lista completa de las variables de entorno utilizando la función phpinfo(). Puede encontrarse el significado de cada una de ellas consultando la » RFC 3875, en particular la sección 4.1 "Request Meta-Variables".
Retorna el valor de la variable de entorno
name
, o false
si la variable
de entorno name
no existe.
Si name
es omitido, todas las variables
de entorno son retornadas como un array asociativo.
Versión | Descripción |
---|---|
8.0.0 |
El name ahora es nullable.
|
7.1.0 |
name ahora puede ser omitido para recuperar
un array asociativo de todas las variables de entorno.
|
7.0.9 |
Se ha añadido el parámetro local_only .
|
Ejemplo #1 Ejemplo con getenv()
<?php
// Ejemplo de uso de getenv()
$ip = getenv('REMOTE_ADDR');
// O simplemente usar una Superglobal ($_SERVER o $_ENV)
$ip = $_SERVER['REMOTE_ADDR'];
// Obtener de forma segura el valor de una variable de entorno,
// ignorando si ha sido definida por un SAPI o modificada con putenv
$ip = getenv('REMOTE_ADDR', true) ?: getenv('REMOTE_ADDR')
?>
Si PHP se ejecuta en un SAPI como Fast CGI, esta función retornará
siempre el valor de una variable de entorno definida por el SAPI,
incluso si putenv() ha sido utilizado para definir una variable
de entorno local con el mismo nombre. El parámetro
local_only
debe ser utilizado para retornar los
valores de variables de entorno definidas localmente.