Added information on what the return values mean, an example, and

see also get_loaded_extensions() and phpinfo().


git-svn-id: https://svn.php.net/repository/phpdoc/en/trunk@130439 c90b9560-bf6c-de11-be94-00142212c4b1

reference/info/functions/ini-get-all.xml

@@ -1,5 +1,5 @@
 <?xml version="1.0" encoding="iso-8859-1"?>
-<!-- $Revision: 1.2 $ -->
+<!-- $Revision: 1.3 $ -->
 <!-- splitted from ./en/functions/info.xml, last change in rev 1.23 -->
   <refentry id="function.ini-get-all">
    <refnamediv>
@@ -18,10 +18,65 @@
      parameter is set, returns only options specific for that
      extension.
     </para>
+    <para>
+     The returned array uses the directive name as the array key, with
+     elements of that array being <literal>global_value</literal> (set in
+     &php.ini;), <literal>local_value</literal> (perhaps set with
+     <function>ini_set</function> or &htaccess;), and
+     <literal>access</literal> (the access level).  See the manual section
+     on <link linkend="configuration.changes">configuration changes</link>
+     for information on what access levels mean.
+    </para>
+    <note>
+     <title>Access level note:</title>
+     <para>
+      It's possible for a directive to have multiple access levels, which is
+      why <literal>access</literal> shows the appropriate bitmask values.
+     </para>
+    </note>
+    <para>
+     <example>
+      <title>A <function>ini_get_all</function> example</title>
+      <programlisting role="php">
+<![CDATA[
+<?php
+$inis = ini_get_all();
+
+print_r($inis);
+
+/* Partial output may look like:
+
+Array
+(
+    [allow_call_time_pass_reference] => Array
+    (
+        [global_value] => 1
+        [local_value] => 1
+        [access] => 6
+    )
+    [allow_url_fopen] => Array
+    (
+        [global_value] => 1
+        [local_value] => 1
+        [access] => 7
+    )
+
+    ...
+
+)
+*/
+?>
+]]>
+      </programlisting>
+     </example>
+    </para>
     <para>
      See also: <function>ini_alter</function>,
-     <function>ini_restore</function>, <function>ini_get</function>,
-     and <function>ini_set</function>
+     <function>ini_restore</function>, 
+     <function>ini_get</function>,
+     <function>ini_set</function>,
+     <function>get_loaded_extensions</function>, and
+     <function>phpinfo</function>.
     </para>
    </refsect1>
   </refentry>