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>
--
PHP Documentation Mailing List (http://www.php.net/)
To unsubscribe, visit: http://www.php.net/unsub.php