mysqlnd_memcache_get_configReturns information about the plugin configuration
&reftitle.description;
arraymysqlnd_memcache_get_configmixedconnection
This function returns an array containing all the mysqlnd_memcache related
configuration attached to a MySQL connection. This includes MySQL the
Memcache object provided via mysqlnd_memcache_set
as well as the table mapping configuration which was automatically collected
from the MySQL server.
&reftitle.parameters;
connection
A handle to a MySQL server of the type
PDO_MYSQL, mysqli or
ext/mysql for which the configuration is to
be returned.
&reftitle.returnvalues;
If the connection is associated with a memcache connection an array will
be returned. Otherwise this function will return false.
The returned array has these elements:
mysqlnd_memcache_get_config array structureArray KeyDescriptionmemcached
Instance of Memcached associated to this MySQL connection
by mysqlnd_memcache_set. You can use this to
change settings of the memcache connection or directly querying the
server onthis connection.
pattern
Regular expression used to match an SQL query being sent to the server.
Queries matching this pattern will be further analyzed to decide whether
the query can be intercepted and sent via the memcache interface or
whether the query is sent using the general MySQL protocol to the
server. The pattern either is the default pattern,
MYSQLND_MEMCACHE_DEFAULT_REGEXP or set via
mysqlnd_memcache_set.
mappings
An associative array with a list of all configured containers as they
were discovered by this plugin. The key for these elements is the name
of the container in the MySQL configuration. The value is described
below. The contents of this field is created by querying the MySQL
server during associting a MySQL and a memcache connection using
mysqlnd_memcache_set.
mapping_queryAn SQL query used during
mysqlnd_memcache_set
to identify the available containers and mappings. The result of that
query is provided in the mappings element.
Mapping entry structureArray KeyDescriptionprefix
A prefix used while accessing data via memcache. With the MySQL InnoDB
Memcache Deamon plugin this usully begins with @@ and ends with a
configurable separator. This prefix is placed in front of the key value
while using the memcache protocol.
schema_name
Name of the schema (database) which contains the table being accessed.
table_name
Name of the table which contins the data accessible via memcache
protocol.
id_field_name
Name of the database field (column) with the id used as key when
accessing the table vi a memcache. Often this is the database field
having a primary key.
separator
A seprator used to split different field values. This is needed as
memcache only provides access to a single value while MySQL can map
multiple columns to this value.
The separator, which can be set in the MySQL Server configuration
should not be part ofany value retrieved via memcache as proper
mapping can't be guranteed.
fields
An array with the names of all fields availle forthis mapping.
&reftitle.examples;
mysqlnd_memcache_get_config example
addServer("host", 11211);
mysqlnd_memcache_set($mysqli, $memc);
var_dump(mysqlnd_memcache_get_config($mysqli));
?>
]]>
&example.outputs;
object(Memcached)#2 (0) {
}
["pattern"]=>
string(125) "/^\s*SELECT\s*(.+?)\s*FROM\s*`?([a-z0-9_]+)`?\s*WHERE\s*`?([a-z0-9_]+)`?\s*=\s*(?(?=["'])["']([^"']*)["']|([0-9e\.]*))\s*$/is"
["mappings"]=>
array(1) {
["mymem_test"]=>
array(6) {
["prefix"]=>
string(13) "@@mymem_test."
["schema_name"]=>
string(4) "test"
["table_name"]=>
string(10) "mymem_test"
["id_field_name"]=>
string(2) "id"
["separator"]=>
string(1) "|"
["fields"]=>
array(3) {
[0]=>
string(2) "f1"
[1]=>
string(2) "f2"
[2]=>
string(2) "f3"
}
}
}
["mapping_query"]=>
string(209) " SELECT c.name,
CONCAT('@@', c.name, (SELECT value FROM innodb_memcache.config_options WHERE name = 'table_map_delimiter')) AS key_prefix,
c.db_schema,
c.db_table,
c.key_columns,
c.value_columns,
(SELECT value FROM innodb_memcache.config_options WHERE name = 'separator') AS sep
FROM innodb_memcache.containers c"
}
]]>
&reftitle.seealso;
mysqlnd_memcache_set