📄 function.ini-get.html
字号:
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd"><html> <head> <title>Gets the value of a configuration option</title> <meta http-equiv="content-type" content="text/html; charset=UTF-8"> </head> <body><div style="text-align: center;"> <div class="prev" style="text-align: left; float: left;"><a href="function.ini-get-all.html">ini_get_all</a></div> <div class="next" style="text-align: right; float: right;"><a href="function.ini-restore.html">ini_restore</a></div> <div class="up"><a href="ref.info.html">PHP Options/Info Functions</a></div> <div class="home"><a href="index.html">PHP Manual</a></div></div><hr /><div id="function.ini-get" class="refentry"> <div class="refnamediv"> <h1 class="refname">ini_get</h1> <p class="verinfo">(PHP 4, PHP 5)</p><p class="refpurpose"><span class="refname">ini_get</span> — <span class="dc-title">Gets the value of a configuration option</span></p> </div> <div class="refsect1 description"> <h3 class="title">Description</h3> <div class="methodsynopsis dc-description"> <span class="type">string</span> <span class="methodname"><b><b>ini_get</b></b></span> ( <span class="methodparam"><span class="type">string</span> <tt class="parameter">$varname</tt></span> )</div> <p class="para rdfs-comment"> Returns the value of the configuration option on success. </p> </div> <div class="refsect1 parameters"> <h3 class="title">Parameters</h3> <p class="para"> <dl> <dt> <span class="term"><i><tt class="parameter">varname</tt></i></span> <dd> <p class="para"> The configuration option name. </p> </dd> </dt> </dl> </p> </div> <div class="refsect1 returnvalues"> <h3 class="title">Return Values</h3> <p class="para"> Returns the value of the configuration option as a string on success, or an empty string on failure or for <i>null</i> values. </p> </div> <div class="refsect1 examples"> <h3 class="title">Examples</h3> <p class="para"> <div class="example"> <p><b>Example #1 A few <b>ini_get()</b> examples</b></p> <div class="example-contents"><div class="phpcode"><code><span style="color: #000000"><span style="color: #0000BB"><?php<br /></span><span style="color: #FF8000">/*<br />Our php.ini contains the following settings:<br /><br />display_errors = On<br />register_globals = Off<br />post_max_size = 8M<br />*/<br /><br /></span><span style="color: #007700">echo </span><span style="color: #DD0000">'display_errors = ' </span><span style="color: #007700">. </span><span style="color: #0000BB">ini_get</span><span style="color: #007700">(</span><span style="color: #DD0000">'display_errors'</span><span style="color: #007700">) . </span><span style="color: #DD0000">"\n"</span><span style="color: #007700">;<br />echo </span><span style="color: #DD0000">'register_globals = ' </span><span style="color: #007700">. </span><span style="color: #0000BB">ini_get</span><span style="color: #007700">(</span><span style="color: #DD0000">'register_globals'</span><span style="color: #007700">) . </span><span style="color: #DD0000">"\n"</span><span style="color: #007700">;<br />echo </span><span style="color: #DD0000">'post_max_size = ' </span><span style="color: #007700">. </span><span style="color: #0000BB">ini_get</span><span style="color: #007700">(</span><span style="color: #DD0000">'post_max_size'</span><span style="color: #007700">) . </span><span style="color: #DD0000">"\n"</span><span style="color: #007700">;<br />echo </span><span style="color: #DD0000">'post_max_size+1 = ' </span><span style="color: #007700">. (</span><span style="color: #0000BB">ini_get</span><span style="color: #007700">(</span><span style="color: #DD0000">'post_max_size'</span><span style="color: #007700">)+</span><span style="color: #0000BB">1</span><span style="color: #007700">) . </span><span style="color: #DD0000">"\n"</span><span style="color: #007700">;<br />echo </span><span style="color: #DD0000">'post_max_size in bytes = ' </span><span style="color: #007700">. </span><span style="color: #0000BB">return_bytes</span><span style="color: #007700">(</span><span style="color: #0000BB">ini_get</span><span style="color: #007700">(</span><span style="color: #DD0000">'post_max_size'</span><span style="color: #007700">));<br /><br />function </span><span style="color: #0000BB">return_bytes</span><span style="color: #007700">(</span><span style="color: #0000BB">$val</span><span style="color: #007700">) {<br /> </span><span style="color: #0000BB">$val </span><span style="color: #007700">= </span><span style="color: #0000BB">trim</span><span style="color: #007700">(</span><span style="color: #0000BB">$val</span><span style="color: #007700">);<br /> </span><span style="color: #0000BB">$last </span><span style="color: #007700">= </span><span style="color: #0000BB">strtolower</span><span style="color: #007700">(</span><span style="color: #0000BB">$val</span><span style="color: #007700">[</span><span style="color: #0000BB">strlen</span><span style="color: #007700">(</span><span style="color: #0000BB">$val</span><span style="color: #007700">)-</span><span style="color: #0000BB">1</span><span style="color: #007700">]);<br /> switch(</span><span style="color: #0000BB">$last</span><span style="color: #007700">) {<br /> </span><span style="color: #FF8000">// The 'G' modifier is available since PHP 5.1.0<br /> </span><span style="color: #007700">case </span><span style="color: #DD0000">'g'</span><span style="color: #007700">:<br /> </span><span style="color: #0000BB">$val </span><span style="color: #007700">*= </span><span style="color: #0000BB">1024</span><span style="color: #007700">;<br /> case </span><span style="color: #DD0000">'m'</span><span style="color: #007700">:<br /> </span><span style="color: #0000BB">$val </span><span style="color: #007700">*= </span><span style="color: #0000BB">1024</span><span style="color: #007700">;<br /> case </span><span style="color: #DD0000">'k'</span><span style="color: #007700">:<br /> </span><span style="color: #0000BB">$val </span><span style="color: #007700">*= </span><span style="color: #0000BB">1024</span><span style="color: #007700">;<br /> }<br /><br /> return </span><span style="color: #0000BB">$val</span><span style="color: #007700">;<br />}<br /><br /></span><span style="color: #0000BB">?></span></span></code></div> </div> <div class="example-contents"><p>The above example will output something similar to:</p></div> <div class="example-contents"><pre><div class="cdata"><pre>display_errors = 1register_globals = 0post_max_size = 8Mpost_max_size+1 = 9post_max_size in bytes = 8388608</pre></div> </pre></div> </div> </p> </div> <div class="refsect1 notes"> <h3 class="title">Notes</h3> <blockquote><p><b class="note">Note</b>: <b>When querying boolean values</b><br /> A boolean ini value of <i>off</i> will be returned as an empty string or "0" while a boolean ini value of <i>on</i> will be returned as "1". The function can also return the literal string of INI value. <br /> </p></blockquote> <blockquote><p><b class="note">Note</b>: <b>When querying memory size values</b><br /> Many ini memory size values, such as <a href="ini.core.html#ini.upload-max-filesize" class="link">upload_max_filesize</a>, are stored in the <var class="filename">php.ini</var> file in shorthand notation. <b>ini_get()</b> will return the exact string stored in the <var class="filename">php.ini</var> file and <em class="emphasis">NOT</em> its <a href="language.types.integer.html" class="type integer">integer</a> equivalent. Attempting normal arithmetic functions on these values will not have otherwise expected results. The example above shows one way to convert shorthand notation into bytes, much like how the PHP source does it. <br /> </p></blockquote> </div> <div class="refsect1 seealso"> <h3 class="title">See Also</h3> <p class="para"> <ul class="simplelist"> <li class="member"><a href="function.get-cfg-var.html" class="function" rel="rdfs-seeAlso">get_cfg_var()</a></li> <li class="member"><a href="function.ini-get-all.html" class="function" rel="rdfs-seeAlso">ini_get_all()</a></li> <li class="member"><a href="function.ini-restore.html" class="function" rel="rdfs-seeAlso">ini_restore()</a></li> <li class="member"><a href="function.ini-set.html" class="function" rel="rdfs-seeAlso">ini_set()</a></li> </ul> </p> </div></div><hr /><div style="text-align: center;"> <div class="prev" style="text-align: left; float: left;"><a href="function.ini-get-all.html">ini_get_all</a></div> <div class="next" style="text-align: right; float: right;"><a href="function.ini-restore.html">ini_restore</a></div> <div class="up"><a href="ref.info.html">PHP Options/Info Functions</a></div> <div class="home"><a href="index.html">PHP Manual</a></div></div></body></html>⌨️ 快捷键说明
复制代码
Ctrl + C
搜索代码
Ctrl + F
全屏模式
F11
切换主题
Ctrl + Shift + D
显示快捷键
?
增大字号
Ctrl + =
减小字号
Ctrl + -