philip Wed Aug 4 01:23:47 2004 EDT
Modified files:
/phpdoc/en/reference/info/functions ini-get.xml
Log:
Show how to display shorthand notation as bytes as this is how the
php source does it.
And make the example formal.
http://cvs.php.net/diff.php/phpdoc/en/reference/info/functions/ini-get.xml?r1=1.8&r2=1.9&ty=u
Index: phpdoc/en/reference/info/functions/ini-get.xml
diff -u phpdoc/en/reference/info/functions/ini-get.xml:1.8
phpdoc/en/reference/info/functions/ini-get.xml:1.9
--- phpdoc/en/reference/info/functions/ini-get.xml:1.8 Mon Dec 15 11:51:14 2003
+++ phpdoc/en/reference/info/functions/ini-get.xml Wed Aug 4 01:23:47 2004
@@ -1,5 +1,5 @@
<?xml version="1.0" encoding="iso-8859-1"?>
-<!-- $Revision: 1.8 $ -->
+<!-- $Revision: 1.9 $ -->
<!-- splitted from ./en/functions/info.xml, last change in rev 1.64 -->
<refentry id="function.ini-get">
<refnamediv>
@@ -27,13 +27,21 @@
<note>
<title>When querying memory size values</title>
<para>
- Many ini memory size values, such as <literal>upload_max_filesize</literal>
- are stored in the &php.ini; file in shorthand notation.
<function>ini_get</function>
- will return the exact string stored in the &php.ini; file,
<emphasis>NOT</emphasis>
- its integer equivalent. Attempting normal arithmetic functions on these values
- will not have otherwise expected results.
- <informalexample>
- <programlisting role="php">
+ Many ini memory size values, such as
+ <link linkend="ini.upload-max-filesize">upload_max_filesize</link>, are
+ stored in the &php.ini; file in shorthand notation.
+ <function>ini_get</function> will return the exact string stored in the
+ &php.ini; file and <emphasis>NOT</emphasis> its <type>integer</type>
+ equivalent. Attempting normal arithmetic functions on these values
+ will not have otherwise expected results. The example below shows one
+ way to convert shorthand notation into bytes, much like how the PHP
+ source does it.
+ </para>
+ </note>
+ <para>
+ <example>
+ <title>A few <function>ini_get</function> examples</title>
+ <programlisting role="php">
<![CDATA[
<?php
/*
@@ -48,6 +56,24 @@
echo 'register_globals = ' . ini_get('register_globals') . "\n";
echo 'post_max_size = ' . ini_get('post_max_size') . "\n";
echo 'post_max_size+1 = ' . (ini_get('post_max_size')+1) . "\n";
+echo 'post_max_size in bytes = ' . return_bytes(ini_get('post_max_size'));
+
+function return_bytes($val) {
+ $val = trim($val);
+ $last = $val{strlen($val)-1};
+ switch($last) {
+ case 'k':
+ case 'K':
+ return (int) $val * 1024;
+ break;
+ case 'm':
+ case 'M':
+ return (int) $val * 1048576;
+ break;
+ default:
+ return $val;
+ }
+}
?>
]]>
@@ -62,12 +88,12 @@
register_globals = 0
post_max_size = 8M
post_max_size+1 = 9
+post_max_size in bytes = 8388608
]]>
</screen>
- </informalexample>
+ </example>
</para>
- </note>
<para>
See also
<function>get_cfg_var</function>,
