<!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>