PHP_UNAME(3) 1 PHP_UNAME(3)php_uname - Returns information about the operating system PHP is running onSYNOPSIS
string php_uname ([string $mode = "a"])
DESCRIPTION php_uname(3) returns a description of the operating system PHP is running on. This is the same string you see at the very top of the
phpinfo(3) output. For the name of just the operating system, consider using the PHP_OS constant, but keep in mind this constant will con-
tain the operating system PHP was built on.
On some older UNIX platforms, it may not be able to determine the current OS information in which case it will revert to displaying the OS
PHP was built on. This will only happen if your uname() library call either doesn't exist or doesn't work.
PARAMETERS
o $mode
-$mode is a single character that defines what information is returned:
o 'a': This is the default. Contains all modes in the sequence "s n r v m".
o 's': Operating system name. eg. FreeBSD.
o 'n': Host name. eg. localhost.example.com.
o 'r': Release name. eg. 5.1.2-RELEASE.
o 'v': Version information. Varies a lot between operating systems.
o 'm': Machine type. eg. i386.
RETURN VALUES
Returns the description, as a string.
EXAMPLES
Example #1
Some php_uname(3) 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:
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(3), php_sapi_name(3), phpinfo(3).
PHP Documentation Group PHP_UNAME(3)
Check Out this Related Man Page
VERSION_COMPARE(3) 1 VERSION_COMPARE(3)version_compare - Compares two "PHP-standardized" version number strings
SYNOPSIS
mixed version_compare (string $version1, string $version2, [string $operator])
DESCRIPTION version_compare(3) compares two "PHP-standardized" version number strings.
The function first replaces _, - and + with a dot . in the version strings and also inserts dots . before and after any non number so that
for example '4.3.2RC1' becomes '4.3.2.RC.1'. Then it compares the parts starting from left to right. If a part contains special version
strings these are handled in the following order: any string not found in this list < dev < alpha = a < beta = b < RC = rc < # < pl = p.
This way not only versions with different levels like '4.1' and '4.1.2' can be compared but also any PHP specific version containing devel-
opment state.
PARAMETERS
o $version1
- First version number.
o $version2
- Second version number.
o $operator
- If the third optional $operator argument is specified, test for a particular relationship. The possible operators are: <, lt,
<=, le, >, gt, >=, ge, ==, =, eq, !=, <>, ne respectively. This parameter is case-sensitive, values should be lowercase.
RETURN VALUES
By default, version_compare(3) returns -1 if the first version is lower than the second, 0 if they are equal, and 1 if the second is
lower.
When using the optional $operator argument, the function will return TRUE if the relationship is the one specified by the operator, FALSE
otherwise.
EXAMPLES
The examples below use the PHP_VERSION constant, because it contains the value of the PHP version that is executing the code.
Example #1
version_compare(3) examples
<?php
if (version_compare(PHP_VERSION, '6.0.0') >= 0) {
echo 'I am at least PHP version 6.0.0, my version: ' . PHP_VERSION . "
";
}
if (version_compare(PHP_VERSION, '5.3.0') >= 0) {
echo 'I am at least PHP version 5.3.0, my version: ' . PHP_VERSION . "
";
}
if (version_compare(PHP_VERSION, '5.0.0', '>=')) {
echo 'I am using PHP 5, my version: ' . PHP_VERSION . "
";
}
if (version_compare(PHP_VERSION, '5.0.0', '<')) {
echo 'I am using PHP 4, my version: ' . PHP_VERSION . "
";
}
?>
NOTES
Note
The PHP_VERSION constant holds current PHP version.
Note
Note that pre-release versions, such as 5.3.0-dev, are considered lower than their final release counterparts (like 5.3.0).
Note
Special version strings such as alpha and beta are case sensitive. Version strings from arbitrary sources that do not adhere to the
PHP standard may need to be lowercased via strtolower(3) before calling version_compare(3).
SEE ALSO phpversion(3), php_uname(3), function_exists(3).
PHP Documentation Group VERSION_COMPARE(3)