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

Reply via email to