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

# Memcache::connect

# memcache_connect

(PECL memcache >= 0.2.0)

Memcache::connect -- memcache_connect — memcached サーバーへの接続をオープンする

### 説明

function Memcache::connect(string `$host`, int `$port` = ?, int `$timeout` = ?): bool
function memcache_connect(string `$host`, int `$port` = ?, int `$timeout` = ?): Memcache

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

### パラメータ

`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() - memcached サーバーへの持続的な接続をオープンする
- Memcache::close() - memcached サーバーとの接続を閉じる

`↑` and `↓` to navigate • `Enter` to select • `Esc` to close • `/` to open