Retourne les informations sur le système d'exploitation

# php_uname

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

php_uname — Retourne les informations sur le système d'exploitation

### Description

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

php_uname() retourne une description sur le système d'exploitation sur lequel tourne PHP. C'est la même chaîne que celle que l'on voit en haut du phpinfo(). Pour juste savoir le nom du système d'exploitation, il est préférable d'utiliser la constante `PHP_OS`, en gardant à l'esprit que cette constante contient le nom du système sur lequel PHP a été compilé.

Sur certaines vieilles plate-formes Unix, il n'est pas possible de déterminer les informations courantes de l'OS, auquel cas cette fonction se contente de retourner le nom de l'OS sur lequel PHP a été compilé. Cela n'arrivera que si la bibliothèque `uname()` n'existe pas ou ne fonctionne pas.

### Liste de paramètres

`mode`

  `mode` est un seul caractère qui définit quelles seront les informations à retourner :

  - `'a'` : C'est la valeur par défaut. Retourne les mêmes informations que les modes individuels `'s'`, `'n'`, `'r'`, `'v'`, `'m'` séparées par des espaces.

  - `'s'`: nom du système d'exploitation. Par exemple, `FreeBSD`.
  - `'n'`: nom de l'hôte. Par exemple, `localhost.example.com`.
  - `'r'`: nom de la version. Par exemple, `5.1.2-RELEASE`.
  - `'v'`: information sur la version. Varie énormément suivant le système d'exploitation.
  - `'m'`: type de la machine. Par exemple, `i386`.

### Valeurs de retour

Retourne la description, sous la forme d'une chaîne de caractères.

### Historique

Version | Description
--- | ---
8.4.0 | Lève une exception ValueError lorsqu'un `mode` invalide est spécifié.

### Exemples

Exemple #1 Exemples avec php_uname()

    <?php
    echo php_uname();
    echo PHP_OS;

    /* Affichages possibles :
    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 'Le serveur tourne sous Windows !';
    } else {
        echo 'Le serveur ne tourne pas sous Windows !';
    }

    ?>

Il existe aussi des constantes PHP pré-définies liées qui peuvent s'avérer utiles, par exemple :

Exemple #2 Exemples avec quelques constantes liées au système

    <?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;      // ;
    ?>

### Voir aussi

- phpversion() - Retourne le numéro de la version courante de PHP
- php_sapi_name() - Retourne le type d'interface utilisée entre le serveur web et PHP
- phpinfo() - Affiche de nombreuses informations sur la configuration de PHP

`↑` and `↓` to navigate • `Enter` to select • `Esc` to close • `/` to open