PHP: php_uname - Manual

downloads | documentation | faq | getting help | mailing lists | reporting bugs | php.net sites | links | conferences | my php.net

search for in the

phpcredits php_sapi_name

Last updated: Sat, 27 Jan 2007

view this page in

# php_uname

(PHP 4 >= 4.0.2, PHP 5)

php_uname -- Returns information about the operating system PHP is running on

## Description

string php_uname ( [string mode] )

php_uname() returns a description of the operating system PHP is running on. For the name of just the operating system, consider using the `PHP_OS` constant, but be reminded this constant will contain the operating system PHP was built on.

On Unix, the output reverts to displaying the operating system information PHP was built on if it cannot determine the currently running OS.

`mode` is a single character that defines what information is returned:

- `'a'`: This is the default. Contains all modes in the sequence `"s n r v m"`.

- `'s'`: Operating system name. eg. `FreeBSD`.

- `'n'`: Host name. eg. `localhost.example.com`.

- `'r'`: Release name. eg. `5.1.2-RELEASE`.

- `'v'`: Version information. Varies a lot between operating systems.

- `'m'`: Machine type. eg. `i386`.

Пример 1. Some php_uname() examples

`<?php
echo php_uname();
echo PHP_OS;
/* Some possible outputs:
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 'This is a server using Windows!';
} else {
echo 'This is a server not using Windows!';
}
?>`

There are also some related Predefined PHP constants that may come in handy, for example:

Пример 2. A few OS related constant examples

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

See also phpversion(), php_sapi_name(), and phpinfo().

add a note User Contributed Notes
php_uname
simon at NOSPAM dot zadra dot org
19-Jan-2006 09:26
`Contrary to the last note, PHP_OS does display the OS PHP runs on currently, whereas php_uname() displays the Operating system version via uname.
This has nothing to do with the system PHP was built on.`
michiel1978 /*at*/ hotmail /*dot*/ com
11-Dec-2005 02:38
`Example 1 in this article is a little bit misleading. The comment on the last block of code says it will output the server's operating system, but in reality (and according to this same article), it will output the operating system on which PHP was built, because it uses the constant PHP_OS.`
tac at smokescreen dot org
14-Jan-2005 03:25
`In php 4.1.2, php_uname('n') returns a warning about an invalid parameter count. Change it to @php_uname to hide this warning.`
add a note
phpcredits php_sapi_name

Last updated: Sat, 27 Jan 2007
show source | credits | stats | sitemap | contact | advertising | mirror sites
Copyright © 2001-2007 The PHP Group
All rights reserved.
This mirror generously provided by: Yahoo! Inc.
Last updated: Sat Mar 10 10:36:09 2007 PST