Memcache::connect
(PECL memcache >= 0.2.0)
Memcache::connect — Open memcached server connection
Description
$host, int $port = ?, int $timeout = ?): boolMemcache::connect() establishes a connection to the memcached server. The connection, which was opened using Memcache::connect() will be automatically closed at the end of script execution. Also you can close it with Memcache::close(). Also you can use memcache_connect() function.
Parameters
-
host -
Point to the host where memcached is listening for connections. This parameter may also specify other transports like
unix:///path/to/memcached.sockto use UNIX domain sockets, in this caseportmust also be set to0. -
port -
Point to the port where memcached is listening for connections. Set this parameter to
0when using UNIX domain sockets.Please note:
portdefaults 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
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() - Open memcached server persistent connection
- Memcache::close() - Close memcached server connection
