mysqlnd_uh_set_statement_proxy(3) [php man page]

MYSQLND_UH_SET_STATEMENT_PROXY(3)					 1					 MYSQLND_UH_SET_STATEMENT_PROXY(3)

mysqlnd_uh_set_statement_proxy - Installs a proxy for mysqlnd statements

SYNOPSIS

       bool mysqlnd_uh_set_statement_proxy (MysqlndUhStatement	&$statement_proxy)

DESCRIPTION

	Installs  a  proxy  for mysqlnd statements. The proxy object will be used for all mysqlnd prepared statement objects, regardless which PHP
       MySQL extension (mysqli, mysql, PDO_MYSQL) has created them as long as the extension is compiled to use the mysqlnd library.

	The function can be disabled with mysqlnd_uh.enable. If mysqlnd_uh.enable is set to FALSE the function will  not  install  the	proxy  and
       always  return  TRUE.  Additionally,  an  error	of  the  type  E_WARNING  may  be  emitted.  The  error message may read like PHP Warning:
       mysqlnd_uh_set_statement_proxy():  (Mysqlnd  User  Handler)  The  plugin  has  been  disabled  by  setting  the	 configuration	 parameter
       mysqlnd_uh.enable = false. The proxy has not been installed [...].

PARAMETERS

	      o $statement_proxy
		- The mysqlnd statement proxy object of type MysqlndUhStatement

RETURN VALUES

	Returns TRUE on success. Otherwise, returns FALSE

SEE ALSO

       mysqlnd_uh_set_connection_proxy(3), mysqlnd_uh.enable.

PHP Documentation Group 											 MYSQLND_UH_SET_STATEMENT_PROXY(3)

MYSQLND_UH_CONVERT_TO_MYSQLND(3)					 1					  MYSQLND_UH_CONVERT_TO_MYSQLND(3)

mysqlnd_uh_convert_to_mysqlnd - Converts a MySQL connection handle into a mysqlnd connection handle

SYNOPSIS

       resource mysqlnd_uh_convert_to_mysqlnd (mysqli  &$mysql_connection)

DESCRIPTION

	Converts a MySQL connection handle into a mysqlnd connection handle. After conversion you can execute mysqlnd library calls on the connec-
       tion handle. This can be used to access mysqlnd functionality not made available through user space API calls.

	The function can be disabled with mysqlnd_uh.enable. If mysqlnd_uh.enable is set to FALSE the function will  not  install  the	proxy  and
       always  return  TRUE.  Additionally,  an  error	of  the  type  E_WARNING  may  be  emitted.  The  error message may read like PHP Warning:
       mysqlnd_uh_convert_to_mysqlnd():  (Mysqlnd  User  Handler)  The	plugin	has  been  disabled  by  setting   the	 configuration	 parameter
       mysqlnd_uh.enable = false. You are not allowed to call this function [...].

PARAMETERS

	      o $MySQL connection handle
		- A MySQL connection handle of type mysql, mysqli or PDO_MySQL.

RETURN VALUES

	A mysqlnd connection handle.

CHANGELOG

       +--------+---------------------------------------------------+
       |Version |						    |
       |	|						    |
       |	|		     Description		    |
       |	|						    |
       +--------+---------------------------------------------------+
       | 5.4.0	|						    |
       |	|						    |
       |	|  The	$mysql_connection  parameter  can now be of |
       |	| type mysql, PDO_MySQL, or  mysqli.  Before,  only |
       |	| the mysqli type was allowed.			    |
       |	|						    |
       +--------+---------------------------------------------------+
EXAMPLES

       Example #1

	      mysqlnd_uh_convert_to_mysqlnd(3) example

	      <?php
	      /* PDO user API gives no access to connection thread id */
	      $mysql_connection = new PDO("mysql:host=localhost;dbname=test", "root", "");

	      /* Convert PDO MySQL handle to mysqlnd handle */
	      $mysqlnd = mysqlnd_uh_convert_to_mysqlnd($mysql_connection);

	      /* Create Proxy to call mysqlnd connection class methods */
	      $obj = new MySQLndUHConnection();
	      /* Call mysqlnd_conn::get_thread_id */
	      var_dump($obj->getThreadId($mysqlnd));

	      /* Use SQL to fetch connection thread id */
	      var_dump($mysql_connection->query("SELECT CONNECTION_ID()")->fetchAll());
	      ?>

	      The above example will output:

	      int(27054)
	      array(1) {
		[0]=>
		array(2) {
		  ["CONNECTION_ID()"]=>
		  string(5) "27054"
		  [0]=>
		  string(5) "27054"
		}
	      }

SEE ALSO

       mysqlnd_uh.enable.

PHP Documentation Group 											  MYSQLND_UH_CONVERT_TO_MYSQLND(3)