Be warned that setting the option Memcached::OPT_DISTRIBUTION to Memcached::DISTRIBUTION_CONSISTENT can carry a significant performance hit so is best used with persistent connections. More details at http://github.com/andreiz/php-memcached/issues#issue/14
Memcached::setOption
(PECL memcached >= 0.1.0)
Memcached::setOption — Set a Memcached option
Description
This method sets the value of a Memcached option.
Some options correspond to the ones defined by libmemcached, and some are
specific to the extension. See Memcached Constants for more
information.
The options listed below require values specified via constants.
Memcached::OPT_HASH requires Memcached::HASH_* values.
Memcached::OPT_DISTRIBUTION requires Memcached::DISTRIBUTION_* values.
Return Values
Returns TRUE on success or FALSE on failure.
Examples
Example #1 Setting a Memcached option
<?php
$m = new Memcached();
var_dump($m->getOption(Memcached::OPT_HASH) == Memcached::HASH_DEFAULT);
$m->setOption(Memcached::OPT_HASH, Memcached::HASH_MURMUR);
$m->setOption(Memcached::OPT_PREFIX_KEY, "widgets");
echo "Prefix key is now: ", $m->getOption(Memcached::OPT_PREFIX_KEY), "\n";
?>
The above example will output:
bool(true) Prefix key is now: widgets
See Also
- Memcached::getOption() - Retrieve a Memcached option value
- Memcached::setOptions() - Set Memcached options
- Memcached Constants
Harry Fuecks ¶
2 years ago
