<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
<html>
<head>
<meta http-equiv="content-type" content="text/html; charset=UTF-8">
<title>Runtime Configuration</title>
</head>
<body><div class="manualnavbar" style="text-align: center;">
<div class="prev" style="text-align: left; float: left;"><a href="memtrack.installation.html">Installation</a></div>
<div class="next" style="text-align: right; float: right;"><a href="memtrack.resources.html">Resource Types</a></div>
<div class="up"><a href="memtrack.setup.html">Installing/Configuring</a></div>
<div class="home"><a href="index.html">PHP Manual</a></div>
</div><hr /><div id="memtrack.ini" class="section">
<h2 class="title">Runtime Configuration</h2>
<p class="simpara">
The behaviour of these functions is affected by settings in <var class="filename">php.ini</var>.
</p>
<p class="para">
<table class="doctable table">
<caption><strong>Memtrack Configuration Options</strong></caption>
<thead>
<tr>
<th>Name</th>
<th>Default</th>
<th>Changeable</th>
</tr>
</thead>
<tbody class="tbody">
<tr>
<td><a href="memtrack.ini.html#ini.memtrack.enabled" class="link">memtrack.enabled</a></td>
<td>"0"</td>
<td>PHP_INI_SYSTEM</td>
</tr>
<tr>
<td>memtrack.soft_limit</td>
<td>"0"</td>
<td>PHP_INI_ALL</td>
</tr>
<tr>
<td>memtrack.hard_limit</td>
<td>"0"</td>
<td>PHP_INI_ALL</td>
</tr>
<tr>
<td>memtrack.vm_limit</td>
<td>"0"</td>
<td>PHP_INI_ALL</td>
</tr>
<tr>
<td>memtrack.ignore_functions</td>
<td>""</td>
<td>PHP_INI_SYSTEM</td>
</tr>
</tbody>
</table>
For further details and definitions of the
PHP_INI_* modes, see the <a href="configuration.changes.modes.html" class="xref">Where a configuration setting may be set</a>.
</p>
<p class="para">Here's a short explanation of
the configuration directives.</p>
<p class="para">
<dl>
<dt id="ini.memtrack.enabled">
<span class="term">
<em><code class="parameter">memtrack.enabled</code></em>
<span class="type"><a href="language.types.boolean.html" class="type boolean">boolean</a></span>
</span>
<dd>
<p class="para">
Disables or enables the extension. Default value is 0, i.e. disabled.
</p>
</dd>
</dt>
<dt id="ini.memtrack.soft-limit">
<span class="term">
<em><code class="parameter">memtrack.soft_limit</code></em>
<span class="type"><a href="language.types.integer.html" class="type int">int</a></span>
</span>
<dd>
<p class="para">
Soft memory limit.
</p>
<p class="para">
The extension checks memory consumption before and after executing an
op_array and produces a warning is the difference between the two values
is equal to or greater than the soft limit, but only if the function is not
ignored.
</p>
<p class="para">
Setting this option to 0 also disables both soft and hard limit warnings.
Default value is 0, i.e. no warnings is produced.
</p>
</dd>
</dt>
<dt id="ini.memtrack.hard-limit">
<span class="term">
<em><code class="parameter">memtrack.hard_limit</code></em>
<span class="type"><a href="language.types.integer.html" class="type int">int</a></span>
</span>
<dd>
<p class="para">
Hard memory limit.
</p>
<p class="para">
The extension checks memory consumption before and after executing an
op_array and produces a warning is the difference between the two values
is equal to or greater than the hard limit, <em class="emphasis">even if the function is
ignored</em>.
Setting this option to 0 disables hard limit warnings completely.
Default value is 0, i.e. no hard limit warnings is produced.
</p>
</dd>
</dt>
<dt id="ini.memtrack.vm-limit">
<span class="term">
<em><code class="parameter">memtrack.vm_limit</code></em>
<span class="type"><a href="language.types.integer.html" class="type int">int</a></span>
</span>
<dd>
<p class="para">
Virtual memory limit (set on a process).
</p>
<p class="para">
This limit is checked only on shutdown and a warning is produced if the
value is greater than or equal to the limit.
</p>
<p class="para">
This option is currently supported only on OSes where mallinfo() function
is available (i.e. Linux).
</p>
</dd>
</dt>
<dt id="ini.memtrack.ignore-functions">
<span class="term">
<em><code class="parameter">memtrack.ignore_functions</code></em>
<span class="type"><a href="language.types.string.html" class="type string">string</a></span>
</span>
<dd>
<p class="para">
A comma or whitespace-separated list of functions which are to be ignored
by soft_limit. The values are case-insensitive, for class methods use
class::method syntax.
</p>
</dd>
</dt>
</dl>
</p>
</div><hr /><div class="manualnavbar" style="text-align: center;">
<div class="prev" style="text-align: left; float: left;"><a href="memtrack.installation.html">Installation</a></div>
<div class="next" style="text-align: right; float: right;"><a href="memtrack.resources.html">Resource Types</a></div>
<div class="up"><a href="memtrack.setup.html">Installing/Configuring</a></div>
<div class="home"><a href="index.html">PHP Manual</a></div>
</div></body></html>
