php man page for mysqlnd_qc_set_storage_handler

MYSQLND_QC_SET_STORAGE_HANDLER(3)					 1					 MYSQLND_QC_SET_STORAGE_HANDLER(3)

mysqlnd_qc_set_storage_handler - Change current storage handler

SYNOPSIS
       bool mysqlnd_qc_set_storage_handler (string  $handler)

DESCRIPTION
	Sets  the  storage handler used by the query cache. A list of available storage handler can be obtained from mysqlnd_qc_get_available_han-
       dlers(3). Which storage are available depends on the compile time configuration of the query cache plugin. The default storage  handler	is
       always available. All other storage handler must be enabled explicitly when building the extension.

PARAMETERS
	      o $handler
		-  Handler  can  be  of  type  string  representing  the  name	of a built-in storage handler or an object of type mysqlnd_qc_han-
		dler_default. The names of the built-in storage handler are default, APC, MEMCACHE, sqlite.

RETURN VALUES
	Returns TRUE on success or FALSE on failure.

	If changing the storage handler fails a catchable fatal error will be thrown. The query cache cannot operate if the previous storage  han-
       dler has been shutdown but no new storage handler has been installed.

EXAMPLES
       Example #1

	      mysqlnd_qc_set_storage_handler(3) example

	       The example shows the output from the built-in default storage handler. Other storage handler may report different data.

	      <?php
	      var_dump(mysqlnd_qc_set_storage_handler("memcache"));

	      if (true === mysqlnd_qc_set_storage_handler("default"))
		printf("Default storage handler activated");

	      /* Catchable fatal error */
	      var_dump(mysqlnd_qc_set_storage_handler("unknown"));
	      ?>

	      The above examples will output:

	      bool(true)
	      Default storage handler activated
	      Catchable fatal error: mysqlnd_qc_set_storage_handler(): Unknown handler 'unknown' in (file) on line (line)

SEE ALSO
       Installation, mysqlnd_qc_get_available_handlers(3).

PHP Documentation Group 											 MYSQLND_QC_SET_STORAGE_HANDLER(3)