getenv
En esta página
getenv
Retorna el valor de una o todas las variables de entorno
Descripción#
getenv([string $name], [bool $local_only]): string
```php
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](https://datatracker.ietf.org/doc/html/rfc3875), en particular la sección 4.1 "Request Meta-Variables".
## Parámetros
`name`
El nombre de la variable como `string` o `null`.
`local_only`
Cuando se establece en `true`, solo se retornan las variables de entorno locales, definidas por el sistema operativo o putenv. Esto solo tiene efecto cuando `name` es un `string`.
## Valores devueltos
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.
## Historial de cambios
| 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`. |
## Ejemplos
Ejemplo con `getenv`
```php
Notas#
[!WARNING] 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
putenvha sido utilizado para definir una variable de entorno local con el mismo nombre. El parámetrolocal_onlydebe ser utilizado para retornar los valores de variables de entorno definidas localmente.
Véase también#
putenv, apache_getenv, Superglobales