array ( 0 => 'index.php', 1 => 'PHP Manual', ), 'head' => array ( 0 => 'UTF-8', 1 => 'es', ), 'this' => array ( 0 => 'function.php-uname.php', 1 => 'php_uname', 2 => 'Devuelve información sobre el sistema operativo', ), 'up' => array ( 0 => 'ref.info.php', 1 => 'Funciones de Opciones/Info de PHP', ), 'prev' => array ( 0 => 'function.php-sapi-name.php', 1 => 'php_sapi_name', ), 'next' => array ( 0 => 'function.phpcredits.php', 1 => 'phpcredits', ), 'alternatives' => array ( ), 'source' => array ( 'lang' => 'es', 'path' => 'reference/info/functions/php-uname.xml', ), 'history' => array ( ), ); $setup["toc"] = $TOC; $setup["toc_deprecated"] = $TOC_DEPRECATED; $setup["parents"] = $PARENTS; manual_setup($setup); contributors($setup); ?>

php_uname

(PHP 4 >= 4.0.2, PHP 5, PHP 7, PHP 8)

php_uname — Devuelve información sobre el sistema operativo

Descripción

php_uname(string $mode = "a"): string

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

Ejemplo #1 Ejemplos con php_uname()

<?php
echo php_uname();
echo PHP_OS;

/* Salidas posibles:
Linux localhost 2.4.21-0.13mdk #1 Fri Mar 14 15:08:06 EST 2003 i686
Linux

FreeBSD localhost 3.2-RELEASE #15: Mon Dec 17 08:46:02 GMT 2001
FreeBSD

Windows NT XN1 5.1 build 2600
WINNT
*/

if (strtoupper(substr(PHP_OS, 0, 3)) === 'WIN') {
echo 'El servidor se ejecuta en Windows !';
} else {
echo 'El servidor no se ejecuta en Windows !';
}

?>

Existen también algunas constantes PHP predefinidas relacionadas que pueden resultar útiles, por ejemplo:

Ejemplo #2 Ejemplos con algunas constantes relacionadas con el sistema

<?php
// *nix
echo DIRECTORY_SEPARATOR; // /
echo PHP_SHLIB_SUFFIX; // so
echo PATH_SEPARATOR; // :

// Win*
echo DIRECTORY_SEPARATOR; // \
echo PHP_SHLIB_SUFFIX; // dll
echo PATH_SEPARATOR; // ;
?>

Ver también