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