php_uname

php_uname([string $mode]): string
```php

`php_uname` devuelve una descripción del sistema operativo en el que se ejecuta PHP. Es la misma cadena que se ve al principio de `phpinfo`. Si solo se desea conocer el nombre del sistema operativo, puede utilizarse la constante `PHP_OS`, pero debe tenerse en cuenta que esta constante contiene el nombre del sistema en el que PHP fue *compilado*.

En algunas antiguas plataformas Unix, no es posible determinar las informaciones corrientes del SO, en cuyo caso esta función se limita a devolver el nombre del SO en el que PHP fue compilado. Esto solo ocurrirá si la biblioteca `uname()` no existe o no funciona.

## Parámetros

`mode`  
`mode` es un solo carácter que define qué información se devolverá:

- `'a'`: Este es el valor por omisión. Devuelve las mismas informaciones que los modos individuales `'s'`, `'n'`, `'r'`, `'v'`, `'m'` separadas por espacios.

- `'s'`: nombre del sistema operativo. Por ejemplo, `FreeBSD`.

- `'n'`: nombre del host. Por ejemplo, `localhost.example.com`.

- `'r'`: nombre de la versión. Por ejemplo, `5.1.2-RELEASE`.

- `'v'`: información sobre la versión. Varía enormemente según el sistema operativo.

- `'m'`: tipo de máquina. Por ejemplo, `i386`.

## Valores devueltos

Devuelve la descripción, en forma de `string`.

## Historial de cambios

| Versión | Descripción |
|----|----|
| 8.4.0 | Levanta una excepción `ValueError` cuando se especifica un `mode` inválido. |

## Ejemplos

Ejemplos con `php_uname`

Existen también algunas [constantes PHP predefinidas](#language.constants.predefined) relacionadas que pueden resultar útiles, por ejemplo:

Ejemplos con algunas constantes relacionadas con el sistema