Memcache::connect
Open memcached server connection
Description
bool Memcache::connect(string $host
, int $port
= ?, int $timeout
= ?)
Parameters
-
host
-
Point to the host where memcached is listening for connections. This parameter
may also specify other transports like unix:///path/to/memcached.sock
to use UNIX domain sockets, in this case port
must also
be set to 0
.
-
port
-
Point to the port where memcached is listening for connections. Set this
parameter to 0
when using UNIX domain sockets.
Please note: port
defaults to
memcache.default_port
if not specified. For this reason it is wise to specify the port
explicitly in this method call.
-
timeout
-
Value in seconds which will be used for connecting to the daemon. Think
twice before changing the default value of 1 second - you can lose all
the advantages of caching if your connection is too slow.
Return Values
Returns true
on success or false
on failure.
Examples
Example #1 Memcache::connect example
<?php
/* procedural API */
$memcache_obj = memcache_connect('memcache_host', 11211);
/* OO API */
$memcache = new Memcache;
$memcache->connect('memcache_host', 11211);
?>
Notes
Warning
When the port
is unspecified, this method defaults to the
value set of the PHP ini directive
memcache.default_port
If this value was changed elsewhere in your application it might lead to
unexpected results: for this reason it is wise to always specify the port
explicitly in this method call.
See Also
- Memcache::pconnect
- Memcache::close