cvs: phpdoc /en/reference/info/functions php-uname.xml

philip Wed Jul 2 16:57:47 2003 EDT Modified files: /phpdoc/en/reference/info/functions php-uname.xml Log: Refer to PHP_OS and other OS related constants, expanded the examples, and added see also's. Index: phpdoc/en/reference/info/functions/php-uname.xml diff -u phpdoc/en/reference/info/functions/php-uname.xml:1.3 phpdoc/en/reference/info/functions/php-uname.xml:1.4 --- phpdoc/en/reference/info/functions/php-uname.xml:1.3 Mon Jun 16 15:33:51 2003 +++ phpdoc/en/reference/info/functions/php-uname.xml Wed Jul 2 16:57:47 2003 @@ -1,5 +1,5 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.3 $ --> +<!-- $Revision: 1.4 $ --> <!-- splitted from ./en/functions/info.xml, last change in rev 1.7 --> <refentry id="function.php-uname"> <refnamediv> @@ -15,20 +15,69 @@ <void/> </methodsynopsis> <simpara> - <function>php_uname</function> returns a string with a - description of the operating system PHP is built on. + <function>php_uname</function> returns a <type>string</type> with a + description of the operating system PHP is built on. If you're just + wanting the name of the operating system, consider using the + <constant>PHP_OS</constant> constant. </simpara> <para> <example> - <title><function>php_uname</function> example</title> + <title>Some <function>php_uname</function> examples</title> <programlisting role="php"> <![CDATA[ -if (substr(php_uname(), 0, 7) == "Windows") { - die ("Sorry, this script doesn't run on Windows.\n"); +<?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 (substr(PHP_OS, 0, 3) == 'Win') { + echo 'You are using Windows!'; +} else { + echo 'You are not using Windows!'; } + +?> ]]> </programlisting> </example> + </para> + <para> + There are also some related + <link linkend="language.constants.predefined">Predefined PHP + constants</link> that may come in handy, for example: + </para> + <para> + <example> + <title>A few OS related constant examples</title> + <programlisting role="php"> +<![CDATA[ +<?php +// *nix +echo DIRECTORY_SEPARATOR; // : +echo PHP_SHLIB_SUFFIX; // so + +// Win* +echo DIRECTORY_SEPARATOR; // ; +echo PHP_SHLIB_SUFFIX; // dll +?> +]]> + </programlisting> + </example> + </para> + <para> + See also <function>php_version</function>, + <function>php_sapi_name</function>, and + <function>phpinfo</function>. </para> </refsect1> </refentry>