ConFoo 2025

Memcached::setOption

(PECL memcached >= 0.1.0)

Memcached::setOptionMemcached のオプションの値を設定する

説明

public Memcached::setOption(int $option, mixed $value): bool

このメソッドは、Memcached のオプションの値を設定します。 libmemcached で定義されているオプションに対応するものもあれば、 この拡張モジュールに固有のものもあります。

パラメータ

option

定数 Memcached::OPT_* のうちのひとつ。 詳細は Memcached 定数 を参照ください。

value

設定する値

注意:

以下のオプションの値は、定数で指定する必要があります。

  • Memcached::OPT_HASH には Memcached::HASH_* の値を指定しなければなりません。
  • Memcached::OPT_DISTRIBUTION には Memcached::DISTRIBUTION_* の値を指定しなければなりません。

戻り値

成功した場合に true を、失敗した場合に false を返します。

例1 Memcached オプションの設定

<?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";
?>

上の例の出力は以下となります。

bool(true)
Prefix key is now: widgets

参考

add a note

User Contributed Notes 1 note

up
0
Harry Fuecks
14 years ago
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
To Top