<?xml version="1.0" encoding="iso-8859-1"?>
<!-- $Revision: 1.11 $ -->
<!-- splitted from ./en/functions/info.xml, last change in rev 1.2 -->
  <refentry id="function.phpinfo">
   <refnamediv>
    <refname>phpinfo</refname>
    <refpurpose>Outputs lots of PHP information</refpurpose>
   </refnamediv>
   <refsect1>
    <title>Description</title>
     <methodsynopsis>
     <type>int</type><methodname>phpinfo</methodname>
     <methodparam choice="opt"><type>int</type><parameter>what</parameter></methodparam>
    </methodsynopsis>
    <para>
     Outputs a large amount of information about the current state of
     PHP. This includes information about PHP compilation options and
     extensions, the PHP version, server information and environment
     (if compiled as a module), the PHP environment, OS version
     information, paths, master and local values of configuration
     options, HTTP headers, and the PHP License.
    </para>
    <para>
     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.
    </para>
    <para>
     <table>
      <title><function>phpinfo</function> options</title>
      <tgroup cols="3">
       <thead>
        <row>
         <entry>Name (constant)</entry>
         <entry>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 their respective settings.  See also
          <function>get_loaded_extensions</function>.
         </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 <link linkend="language.variables.predefined">
          predefined variables</link> 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 value.
         </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
      <link linkend="ini.expose-php">expose_php</link> configuration setting
      is set to <literal>off</literal>. This includes the PHP and Zend logos,
      and the credits.
     </para>
    </note>
    <note>
     <para>
      <function>phpinfo</function> outputs plain text instead of HTML when
      using the CLI mode.
     </para>
    </note>
    <para>
    See also <function>phpversion</function>,
    <function>phpcredits</function>,
    <function>php_logo_guid</function>, 
    <function>ini_get</function>,
    <function>ini_set</function>, 
    <function>get_loaded_extensions</function>,
    and the section on <link
    linkend="language.variables.predefined">Predefined
    Variables</link>.
    </para>
   </refsect1>
  </refentry>

<!-- Keep this comment at the end of the file
Local variables:
mode: sgml
sgml-omittag:t
sgml-shorttag:t
sgml-minimize-attributes:nil
sgml-always-quote-attributes:t
sgml-indent-step:1
sgml-indent-data:t
indent-tabs-mode:nil
sgml-parent-document:nil
sgml-default-dtd-file:"../../../../manual.ced"
sgml-exposed-tags:nil
sgml-local-catalogs:nil
sgml-local-ecat-files:nil
End:
vim600: syn=xml fen fdm=syntax fdl=2 si
vim: et tw=78 syn=sgml
vi: ts=1 sw=1
-->