<!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="memcache.installation.html">Installation</a></div>
<div class="next" style="text-align: right; float: right;"><a href="memcache.resources.html">Resource Types</a></div>
<div class="up"><a href="memcache.setup.html">Installing/Configuring</a></div>
<div class="home"><a href="index.html">PHP Manual</a></div>
</div><hr /><div id="memcache.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>Memcache Configuration Options</strong></caption>
<thead>
<tr>
<th>Name</th>
<th>Default</th>
<th>Changeable</th>
<th>Changelog</th>
</tr>
</thead>
<tbody class="tbody">
<tr>
<td><a href="memcache.ini.html#ini.memcache.allow-failover" class="link">memcache.allow_failover</a></td>
<td>"1"</td>
<td>PHP_INI_ALL</td>
<td>Available since memcache 2.0.2.</td>
</tr>
<tr>
<td><a href="memcache.ini.html#ini.memcache.max-failover-attempts" class="link">memcache.max_failover_attempts</a></td>
<td>"20"</td>
<td>PHP_INI_ALL</td>
<td>Available since memcache 2.1.0.</td>
</tr>
<tr>
<td><a href="memcache.ini.html#ini.memcache.chunk-size" class="link">memcache.chunk_size</a></td>
<td>"8192"</td>
<td>PHP_INI_ALL</td>
<td>Available since memcache 2.0.2.</td>
</tr>
<tr>
<td><a href="memcache.ini.html#ini.memcache.default-port" class="link">memcache.default_port</a></td>
<td>"11211"</td>
<td>PHP_INI_ALL</td>
<td>Available since memcache 2.0.2.</td>
</tr>
<tr>
<td><a href="memcache.ini.html#ini.memcache.hash-strategy" class="link">memcache.hash_strategy</a></td>
<td>"standard"</td>
<td>PHP_INI_ALL</td>
<td>Available since memcache 2.2.0.</td>
</tr>
<tr>
<td><a href="memcache.ini.html#ini.memcache.hash-function" class="link">memcache.hash_function</a></td>
<td>"crc32"</td>
<td>PHP_INI_ALL</td>
<td>Available since memcache 2.2.0.</td>
</tr>
<tr>
<td><a href="session.configuration.html#ini.session.save-handler" class="link">session.save_handler</a></td>
<td>"files"</td>
<td>PHP_INI_ALL</td>
<td>Supported since memcache 2.1.2</td>
</tr>
<tr>
<td><a href="session.configuration.html#ini.session.save-path" class="link">session.save_path</a></td>
<td>""</td>
<td>PHP_INI_ALL</td>
<td>Supported since memcache 2.1.2</td>
</tr>
<tr>
<td><a href="memcache.ini.html#ini.memcache.protocol" class="link">memcache.protocol</a></td>
<td>ascii</td>
<td>>PHP_INI_ALL</td>
<td>Supported since memcache 3.0.0</td>
</tr>
<tr>
<td><a href="memcache.ini.html#ini.memcache.redundancy" class="link">memcache.redundancy</a></td>
<td>1</td>
<td>>PHP_INI_ALL</td>
<td>Supported since memcache 3.0.0</td>
</tr>
<tr>
<td><a href="memcache.ini.html#ini.memcache.session-redundancy" class="link">memcache.session_redundancy</a></td>
<td>2</td>
<td>>PHP_INI_ALL</td>
<td>Supported since memcache 3.0.0</td>
</tr>
<tr>
<td><a href="memcache.ini.html#ini.memcache.compress-threshold" class="link">memcache.compress_threshold</a></td>
<td>20000</td>
<td>>PHP_INI_ALL</td>
<td>Supported since memcache 3.0.3</td>
</tr>
<tr>
<td><a href="memcache.ini.html#ini.memcache.lock-timeout" class="link">memcache.lock_timeout</a></td>
<td>15</td>
<td>>PHP_INI_ALL</td>
<td>Supported since memcache 3.0.4</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.memcache.allow-failover">
<span class="term">
<em><code class="parameter">memcache.allow_failover</code></em>
<span class="type"><a href="language.types.boolean.html" class="type boolean">boolean</a></span>
</span>
<dd>
<p class="para">
Whether to transparently failover to other servers on
errors.
</p>
</dd>
</dt>
<dt id="ini.memcache.max-failover-attempts">
<span class="term">
<em><code class="parameter">memcache.max_failover_attempts</code></em>
<span class="type"><a href="language.types.integer.html" class="type integer">integer</a></span>
</span>
<dd>
<p class="para">
Defines how many servers to try when setting and getting data.
Used only in conjunction with memcache.allow_failover.
</p>
</dd>
</dt>
<dt id="ini.memcache.chunk-size">
<span class="term">
<em><code class="parameter">memcache.chunk_size</code></em>
<span class="type"><a href="language.types.integer.html" class="type integer">integer</a></span>
</span>
<dd>
<p class="para">
Data will be transferred in chunks of this size, setting
the value lower requires more network writes. Try
increasing this value to 32768 if noticing otherwise
inexplicable slowdowns.
</p>
</dd>
</dt>
<dt id="ini.memcache.default-port">
<span class="term">
<em><code class="parameter">memcache.default_port</code></em>
<span class="type"><a href="language.types.string.html" class="type string">string</a></span>
</span>
<dd>
<p class="para">
The default TCP port number to use when connecting to
the memcached server if no other port is specified.
</p>
</dd>
</dt>
<dt id="ini.memcache.hash-strategy">
<span class="term">
<em><code class="parameter">memcache.hash_strategy</code></em>
<span class="type"><a href="language.types.string.html" class="type string">string</a></span>
</span>
<dd>
<p class="para">
Controls which strategy to use when mapping keys to servers. Set this value to
<em>consistent</em> to enable consistent hashing which allows servers
to be added or removed from the pool without causing keys to be remapped.
Setting this value to <em>standard</em> results in the old strategy
being used.
</p>
</dd>
</dt>
<dt id="ini.memcache.hash-function">
<span class="term">
<em><code class="parameter">memcache.hash_function</code></em>
<span class="type"><a href="language.types.string.html" class="type string">string</a></span>
</span>
<dd>
<p class="para">
Controls which hash function to apply when mapping keys to servers, <em>crc32</em>
uses the standard CRC32 hash while <em>fnv</em> uses FNV-1a.
</p>
</dd>
</dt>
<dt id="ini.memcache.session-handler">
<span class="term">
<em><code class="parameter">session.save_handler</code></em>
<span class="type"><a href="language.types.string.html" class="type string">string</a></span>
</span>
<dd>
<p class="para">
Use memcache as a session handler by setting this value to <em>memcache</em>.
</p>
</dd>
</dt>
<dt id="ini.memcache.save-path">
<span class="term">
<em><code class="parameter">session.save_path</code></em>
<span class="type"><a href="language.types.string.html" class="type string">string</a></span>
</span>
<dd>
<p class="para">
Defines a comma separated of server urls to use for session storage, for example
<em>"tcp://host1:11211, tcp://host2:11211"</em>.
</p>
<p class="para">
Each url may contain parameters which are applied to that server, they are the same
as for the <span class="function"><a href="memcache.addserver.html" class="function">Memcache::addServer()</a></span> method. For example
<em>"tcp://host1:11211?persistent=1&weight=1&timeout=1&retry_interval=15"</em>
</p>
</dd>
</dt>
<dt id="ini.memcache.protocol">
<span class="term">
<em><code class="parameter">memcache.protocol</code></em>
<span class="type"><a href="language.types.string.html" class="type string">string</a></span>
</span>
<dd>
<p class="para">
</p>
</dd>
</dt>
<dt id="ini.memcache.redundancy">
<span class="term">
<em><code class="parameter">memcache.redundancy</code></em>
<span class="type"><a href="language.types.integer.html" class="type integer">integer</a></span>
</span>
<dd>
<p class="para">
</p>
</dd>
</dt>
<dt id="ini.memcache.session-redundancy">
<span class="term">
<em><code class="parameter">memcache.session_redundancy</code></em>
<span class="type"><a href="language.types.integer.html" class="type integer">integer</a></span>
</span>
<dd>
<p class="para">
</p>
</dd>
</dt>
<dt id="ini.memcache.compress-threshold">
<span class="term">
<em><code class="parameter">memcache.compress_threshold</code></em>
<span class="type"><a href="language.types.integer.html" class="type integer">integer</a></span>
</span>
<dd>
<p class="para">
</p>
</dd>
</dt>
<dt id="ini.memcache.lock-timeout">
<span class="term">
<em><code class="parameter">memcache.lock_timeout</code></em>
<span class="type"><a href="language.types.integer.html" class="type integer">integer</a></span>
</span>
<dd>
<p class="para">
</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="memcache.installation.html">Installation</a></div>
<div class="next" style="text-align: right; float: right;"><a href="memcache.resources.html">Resource Types</a></div>
<div class="up"><a href="memcache.setup.html">Installing/Configuring</a></div>
<div class="home"><a href="index.html">PHP Manual</a></div>
</div></body></html>
