トップページ　→関数リファレンス　→その他のサービス　→Memcache　→Memcache

関数・クラス解説

Memcache::connect

version:PECL memcache >= 0.2.0 (公式)

memcached サーバーへの接続をオープンする

公式リファレンス

書式

Memcache::connect ( string $host [, int $port [, int $timeout ]] ) : bool

説明

Memcache::connect() は、memcached サーバーへの接続を確立します。 Memcache::connect() を使用してオープンされた接続は、スクリプトの実行終了時に自動的に閉じられます。 Memcache::close() を使用して閉じることも可能です。 memcache_connect() 関数を使用することも可能です。

パラメータ

host: memcached が接続を待ち受けるホストを指定します。このパラメータには別のトランスポート層を指定することもできます。たとえば unix:///path/to/memcached.sock のようにすると Unix ドメインソケットを使用できます。この場合、 port は 0 を指定しなければなりません。
port: memcached が接続を待ち受けるポートを指定します。 Unix ドメインソケットを使用する場合は、このパラメータを 0 とします。 port を指定しなかったときのデフォルトは memcache.default_port となります。そのため、このメソッドをコールするときにはポートを明示しておくことをおすすめします。
timeout: デーモンへの接続の際に使用する値 (秒単位) です。デフォルト値を 1 秒でも変更する前には十分注意してください。接続が遅くなってしまうと、キャッシュ処理のメリットがなくなってしまいます。

返値

成功した場合に TRUE を、失敗した場合に FALSE を返します。

注意

警告 port を省略した場合は、PHP の ini 設定 memcache.default_port の値をデフォルトとして使います。もしこの値がアプリケーションのどこかで変更されていれば、予期せぬ結果を引き起こすかもしれません。このメソッドをコールするときには、常にポートを明示しておくことをおすすめします。警告 port を省略した場合は、PHP の ini 設定 memcache.default_port の値をデフォルトとして使います。もしこの値がアプリケーションのどこかで変更されていれば、予期せぬ結果を引き起こすかもしれません。このメソッドをコールするときには、常にポートを明示しておくことをおすすめします。

サンプル

例1 Memcache::connect() の例 


/* 手続き型の API */

$memcache_obj = memcache_connect('memcache_host', 11211);

/* オブジェクト指向の API */

$memcache = new Memcache;
$memcache->connect('memcache_host', 11211);