Source of: /manual/en/memcache.ini.php
<?php
include_once $_SERVER['DOCUMENT_ROOT'] . '/include/shared-manual.inc';
$TOC = array();
$PARENTS = array();
include_once dirname(__FILE__) ."/toc/memcache.setup.inc";
$setup = array (
'home' =>
array (
0 => 'index.php',
1 => 'PHP Manual',
),
'head' =>
array (
0 => 'UTF-8',
1 => 'en',
),
'this' =>
array (
0 => 'memcache.ini.php',
1 => 'Runtime Configuration',
),
'up' =>
array (
0 => 'memcache.setup.php',
1 => 'Installing/Configuring',
),
'prev' =>
array (
0 => 'memcache.installation.php',
1 => 'Installation',
),
'next' =>
array (
0 => 'memcache.resources.php',
1 => 'Resource Types',
),
);
$setup["toc"] = $TOC;
$setup["parents"] = $PARENTS;
manual_setup($setup);
manual_header();
?>
<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">
</p><table class="doctable table">
<caption><b>Memcache Configuration Options</b></caption>
<thead valign="middle">
<tr valign="middle">
<th>Name</th>
<th>Default</th>
<th>Changeable</th>
<th>Changelog</th>
</tr>
</thead>
<tbody valign="middle" class="tbody">
<tr valign="middle">
<td align="left"><a href="memcache.ini.php#ini.memcache.allow-failover" class="link">memcache.allow_failover</a></td>
<td align="left">"1"</td>
<td align="left">PHP_INI_ALL</td>
<td align="left">Available since memcache 2.0.2.</td>
</tr>
<tr valign="middle">
<td align="left"><a href="memcache.ini.php#ini.memcache.max-failover-attempts" class="link">memcache.max_failover_attempts</a></td>
<td align="left">"20"</td>
<td align="left">PHP_INI_ALL</td>
<td align="left">Available since memcache 2.1.0.</td>
</tr>
<tr valign="middle">
<td align="left"><a href="memcache.ini.php#ini.memcache.chunk-size" class="link">memcache.chunk_size</a></td>
<td align="left">"8192"</td>
<td align="left">PHP_INI_ALL</td>
<td align="left">Available since memcache 2.0.2.</td>
</tr>
<tr valign="middle">
<td align="left"><a href="memcache.ini.php#ini.memcache.default-port" class="link">memcache.default_port</a></td>
<td align="left">"11211"</td>
<td align="left">PHP_INI_ALL</td>
<td align="left">Available since memcache 2.0.2.</td>
</tr>
<tr valign="middle">
<td align="left"><a href="memcache.ini.php#ini.memcache.hash-strategy" class="link">memcache.hash_strategy</a></td>
<td align="left">"standard"</td>
<td align="left">PHP_INI_ALL</td>
<td align="left">Available since memcache 2.2.0.</td>
</tr>
<tr valign="middle">
<td align="left"><a href="memcache.ini.php#ini.memcache.hash-function" class="link">memcache.hash_function</a></td>
<td align="left">"crc32"</td>
<td align="left">PHP_INI_ALL</td>
<td align="left">Available since memcache 2.2.0.</td>
</tr>
<tr valign="middle">
<td align="left">session.save_handler</td>
<td align="left">"files"</td>
<td align="left">PHP_INI_ALL</td>
<td align="left">Supported since memcache 2.1.2</td>
</tr>
<tr valign="middle">
<td align="left">session.save_path</td>
<td align="left">""</td>
<td align="left">PHP_INI_ALL</td>
<td align="left">Supported since memcache 2.1.2</td>
</tr>
</tbody>
</table>
<p>
For further details and definitions of the
PHP_INI_* modes, see the <a href="configuration.changes.modes.php" 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">
</p><dl>
<dt id="ini.memcache.allow-failover" class="varlistentry">
<span class="term">
<i><tt class="parameter">memcache.allow_failover</tt></i>
<a href="language.types.boolean.php" class="type boolean">boolean</a>
</span>
</dt><dd class="listitem">
<p class="para">
Whether to transparently failover to other servers on
errors.
</p>
</dd>
<dt id="ini.memcache.max-failover-attempts" class="varlistentry">
<span class="term">
<i><tt class="parameter">memcache.max_failover_attempts</tt></i>
<a href="language.types.integer.php" class="type integer">integer</a>
</span>
</dt><dd class="listitem">
<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 id="ini.memcache.chunk-size" class="varlistentry">
<span class="term">
<i><tt class="parameter">memcache.chunk_size</tt></i>
<a href="language.types.integer.php" class="type integer">integer</a>
</span>
</dt><dd class="listitem">
<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 id="ini.memcache.default-port" class="varlistentry">
<span class="term">
<i><tt class="parameter">memcache.default_port</tt></i>
<a href="language.types.string.php" class="type string">string</a>
</span>
</dt><dd class="listitem">
<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 id="ini.memcache.hash-strategy" class="varlistentry">
<span class="term">
<i><tt class="parameter">memcache.hash_strategy</tt></i>
<a href="language.types.string.php" class="type string">string</a>
</span>
</dt><dd class="listitem">
<p class="para">
Controls which strategy to use when mapping keys to servers. Set this value to
<i>consistent</i> 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 <i>standard</i> results in the old strategy
being used.
</p>
</dd>
<dt id="ini.memcache.hash-function" class="varlistentry">
<span class="term">
<i><tt class="parameter">memcache.hash_function</tt></i>
<a href="language.types.string.php" class="type string">string</a>
</span>
</dt><dd class="listitem">
<p class="para">
Controls which hash function to apply when mapping keys to servers, <i>crc32</i>
uses the standard CRC32 hash while <i>fnv</i> uses FNV-1a.
</p>
</dd>
<dt id="ini.memcache.session-handler" class="varlistentry">
<span class="term">
<i><tt class="parameter">session.save_handler</tt></i>
<a href="language.types.string.php" class="type string">string</a>
</span>
</dt><dd class="listitem">
<p class="para">
Use memcache as a session handler by setting this value to <i>memcache</i>.
</p>
</dd>
<dt id="ini.memcache.save-path" class="varlistentry">
<span class="term">
<i><tt class="parameter">session.save_path</tt></i>
<a href="language.types.string.php" class="type string">string</a>
</span>
</dt><dd class="listitem">
<p class="para">
Defines a comma separated of server urls to use for session storage, for example
<i>"tcp://host1:11211, tcp://host2:11211"</i>.
</p>
<p class="para">
Each url may contain parameters which are applied to that server, they are the same
as for the <a href="function.memcache-addserver.php" class="function">Memcache::addServer()</a> method. For example
<i>"tcp://host1:11211?persistent=1&weight=1&timeout=1&retry_interval=15"</i>
</p>
</dd>
</dl>
<p>
</p>
</div><?php manual_footer(); ?>
