PHP 8.1.28 Released!


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

php_uname Restituisce informazioni sul sistema operativo su cui gira il PHP


php_uname(string $mode = ?): string

php_uname() restituisce una stringa con la descrizione del sistema operativo su cui gira PHP. Se si desidera semplicemente il nome del sistema operativo, si utilizzi la costante PHP_OS, ma si ricordi che questa costante contiene il nome del sistema operativo su cui il PHP è stato compilato.

Sui sistemi Unix, la funzione passa a visualizzare il sistema operativo su cui il PHP è stato compilato, se non è in grado di determinare le imformazioni del sistema operativo su cui il PHP gira.

mode definisce quali informazioni debbano essere restituite:

  • 'a': Questo è il default. Contiene tutte le modalità nella sequenza "s n r v m".
  • 's': Nome del sistema operativo. Es. FreeBSD.
  • 'n': Nome del server. Es.
  • 'r': Nome del rilascio. Es. 5.1.2-RELEASE.
  • 'v': Informazioni sulla versione. Varia molto in base al sistema operativo.
  • 'm': Tipo di macchina. Es. i386.

Example #1 Alcuni esempi di php_uname()

echo php_uname();

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

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

Windows NT XN1 5.1 build 2600

if (strtoupper(substr(PHP_OS, 0, 3)) === 'WIN') {
'This is a server using Windows!';
} else {
'This is a server not using Windows!';


Esistono alcune Costanti PHP predefinite che possono essere di aiuto, ad esempio:

Example #2 Alcune costanti relative al OS

// *nix
echo PHP_SHLIB_SUFFIX; // so

// Win*
echo PHP_SHLIB_SUFFIX; // dll

Vedere anche phpversion(), php_sapi_name() e phpinfo().

add a note

User Contributed Notes 4 notes

Ricardo Striquer (ricardophp yohoocombr)
4 years ago
Although it does not indicate receiving parameters this function allows some chars as parameters, they are the options a; m; n; r; s; v.

I don't know exactly what each one does, but below is a code example and its output on PHP 5.5 running on RedHat 4.4

echo '<pre>';
'(void): '.php_uname()."\n"; // output: "(void): Linux 4.4.180 #1 SMP Wed May 22 15:27:37 -03 2019 x86_64"
echo 'a: '.php_uname('a')."\n"; // output: "a: Linux 4.4.180 #1 SMP Wed May 22 15:27:37 -03 2019 x86_64"
echo 'm: '.php_uname('m')."\n"; // output: "m: x86_64"
echo 'n: '.php_uname('n')."\n"; // output: "n:"
echo 'r: '.php_uname('r')."\n"; // output: "r: 4.4.180"
echo 's: '.php_uname('s')."\n"; // output: "s: Linux"
echo 'v: '.php_uname('v')."\n"; // output: "v: #1 SMP Wed May 22 15:27:37 -03 2019"
// echo file_get_contents('/etc/issue')."\n";

echo '</pre>';

Note that I used file_get_contentes with a file, that file is present in most linux boxies and varies on content, but most of times it indicates kernel version, linux version, distribution and so on. In my case my user didn't have access to the file, so to identify that it was a red hat I paid attention to php_info outputs, there in the middle was the postgress driver description, p. eg indicating the distribution.

I guess there is no easy way to find out the server version programmatically a 100% of times, but by and large you can get around by yourself.
Grzechooo+php at gmail dot com
11 years ago
Note that PHP won't tell you that it reverted to displaying platform it was built on.
3 years ago
Note that the argument is not a "format". This means that <?php uname('a') ?> is not equivalent to <?php uname('s n r v m') ?>, but rather <?php uname('s') . ' ' . uname('n') . ' ' . uname('r') . ' ' . uname('v') . ' ' . uname('m') ?>.
Yzmir Ramirez
12 years ago
Note that php_uname('n') does not always equal $_SERVER['HOST_NAME']

The machine that you are running the script may server many different host names so don't use this when building urls.
To Top