[PHP-DOC] cvs: phpdoc /en/functions info.xml From: Philip Olson (philip <email protected>)
Date: 01/22/02

philip Tue Jan 22 15:12:41 2002 EDT

  Modified files:
    /phpdoc/en/functions info.xml
  Log:
  phpinfo: Expanded documentation for 'what' parameter, added an example and
           some other information.
  phpversion: minor update
  
  
Index: phpdoc/en/functions/info.xml
diff -u phpdoc/en/functions/info.xml:1.86 phpdoc/en/functions/info.xml:1.87
--- phpdoc/en/functions/info.xml:1.86 Wed Jan 16 22:19:06 2002
+++ phpdoc/en/functions/info.xml Tue Jan 22 15:12:41 2002
@@ -1,5 +1,5 @@
 <?xml version="1.0" encoding="iso-8859-1"?>
-<!-- $Revision: 1.86 $ -->
+<!-- $Revision: 1.87 $ -->
  <reference id="ref.info">
   <title>PHP options &amp; information</title>
   <titleabbrev>PHP options/info</titleabbrev>
@@ -1503,21 +1503,105 @@
      options, HTTP headers, and the PHP License.
     </para>
     <para>
- The output may be customized by passing one or more of the
- following values summed together in the optional parameter
- <parameter>what</parameter> (one can also combine them together
- with the <link linkend="language.operators.bitwise">or</link> operator.
- <itemizedlist>
- <listitem><simpara>INFO_GENERAL</simpara></listitem>
- <listitem><simpara>INFO_CREDITS</simpara></listitem>
- <listitem><simpara>INFO_CONFIGURATION</simpara></listitem>
- <listitem><simpara>INFO_MODULES</simpara></listitem>
- <listitem><simpara>INFO_ENVIRONMENT</simpara></listitem>
- <listitem><simpara>INFO_VARIABLES</simpara></listitem>
- <listitem><simpara>INFO_LICENSE</simpara></listitem>
- <listitem><simpara>INFO_ALL</simpara></listitem>
- </itemizedlist>
+ Because every system is setup differently, <function>phpinfo</function>
+ is commonly used to check <link linkend="configuration">configuration
+ settings</link> and for available
+ <link linkend="language.variables.predefined">predefined variables</link>
+ on a given system. Also, <function>phpinfo</function> is a valuable
+ debugging tool as it contains all EGPCS (Environment, GET, POST,
+ Cookie, Server) data.
     </para>
+ <para>
+ The output may be customized by passing one or more of the following
+ <emphasis>constants</emphasis> bitwise values summed together in the
+ optional <parameter>what</parameter> parameter. One can also combine
+ the respective constants or bitwise values together with the
+ <link linkend="language.operators.bitwise">or</link> operator.
+
+ <table>
+ <title><function>phpinfo</function> options</title>
+ <tgroup cols="3">
+ <thead>
+ <row>
+ <entry>Name (constant)</entry>
+ <entry>Bitwise value</entry>
+ <entry>Description</entry>
+ </row>
+ </thead>
+ <tbody>
+ <row>
+ <entry>INFO_GENERAL</entry>
+ <entry>1</entry>
+ <entry>The configuration line, php.ini location, build date,
+ Web Server, System and more.
+ </entry>
+ </row>
+ <row>
+ <entry>INFO_CREDITS</entry>
+ <entry>2</entry>
+ <entry>PHP 4 Credits. See also <function>phpcredits</function>.</entry>
+ </row>
+ <row>
+ <entry>INFO_CONFIGURATION</entry>
+ <entry>4</entry>
+ <entry>Current Local and Master values for php directives.
+ See also <function>ini_get</function>.</entry>
+ </row>
+ <row>
+ <entry>INFO_MODULES</entry>
+ <entry>8</entry>
+ <entry>Loaded modules and there respective settings.</entry>
+ </row>
+ <row>
+ <entry>INFO_ENVIRONMENT</entry>
+ <entry>16</entry>
+ <entry>Environment Variable information that's also
+ available in <varname>$_ENV</varname>.</entry>
+ </row>
+ <row>
+ <entry>INFO_VARIABLES</entry>
+ <entry>32</entry>
+ <entry>Shows all predefined variables, from EGPCS
+ (Environment, GET, POST, Cookie, Server).
+ </entry>
+ </row>
+ <row>
+ <entry>INFO_LICENSE</entry>
+ <entry>64</entry>
+ <entry>PHP License information. See also the
+ <ulink url="&url.php.license;">license faq</ulink>.
+ </entry>
+ </row>
+ <row>
+ <entry>INFO_ALL</entry>
+ <entry>-1</entry>
+ <entry>Shows all of the above. This is the default.
+ </entry>
+ </row>
+ </tbody>
+ </tgroup>
+ </table>
+ </para>
+ <para>
+ <example>
+ <title><function>phpinfo</function> examples</title>
+ <programlisting role="php">
+<![CDATA[
+<?php
+
+// Show all information, defaults to INFO_ALL
+phpinfo();
+
+// Show just the module information.
+// phpinfo(8) yields identical results.
+phpinfo(INFO_MODULES);
+
+?>
+]]>
+ </programlisting>
+ </example>
+ </para>
+
     <note>
      <para>
       Parts of the information displayed are disabled when the
@@ -1528,8 +1612,9 @@
     </note>
     <para>
      See also <function>phpversion</function>,
- <function>phpcredits</function>,
- <function>php_logo_guid</function>
+ <function>phpcredits</function>, <function>php_logo_guid</function>,
+ <function>ini_get</function>, <function>ini_set</function>, and the section
+ on <link linkend="language.variables.predefined">Predefined Variables</link>.
     </para>
    </refsect1>
   </refentry>
@@ -1558,11 +1643,13 @@
     </note>
     <para>
      <example>
- <title>phpversion() example</title>
+ <title><function>phpversion</function> example</title>
       <programlisting role="php">
 <![CDATA[
-// prints e.g. 'Current PHP version: 3.0rel-dev'
-echo "Current PHP version: ".phpversion();
+<?php
+// prints e.g. 'Current PHP version: 4.1.1'
+echo 'Current PHP version: ' . phpversion();
+?>
 ]]>
       </programlisting>
      </example>