Memcache::connect
memcached サーバーへの接続をオープンする
説明
bool Memcache::connect(string $host, int $port = ?, int $timeout = ?)
パラメータ
-
host
-
memcached が接続を待ち受けるホストを指定します。
このパラメータには別のトランスポート層を指定することもできます。たとえば
unix:///path/to/memcached.sock
のようにすると Unix ドメインソケットを使用できます。この場合、
port は 0
を指定しなければなりません。
-
port
-
memcached が接続を待ち受けるポートを指定します。
Unix ドメインソケットを使用する場合は、このパラメータを 0
とします。
port を指定しなかったときのデフォルトは
memcache.default_port
となります。そのため、このメソッドをコールするときにはポートを明示しておくことをおすすめします。
-
timeout
-
デーモンへの接続の際に使用する値 (秒単位) です。
デフォルト値を 1 秒でも変更する前には十分注意してください。
接続が遅くなってしまうと、 キャッシュ処理のメリットが
なくなってしまいます。
戻り値
成功した場合に true を、失敗した場合に false を返します。
例
例1 Memcache::connect の例
<?php
/* 手続き型の API */
$memcache_obj = memcache_connect('memcache_host', 11211);
/* オブジェクト指向の API */
$memcache = new Memcache;
$memcache->connect('memcache_host', 11211);
?>
注意
警告
port を省略した場合は、PHP の ini 設定
memcache.default_port
の値をデフォルトとして使います。
もしこの値がアプリケーションのどこかで変更されていれば、予期せぬ結果を引き起こすかもしれません。
このメソッドをコールするときには、常にポートを明示しておくことをおすすめします。
参考
- Memcache::pconnect
- Memcache::close