22.9.8.5. Installing/Configuring

22.9.8.5.1. Requirements

PHP 5.3.3 or later. It is recommended to use PHP 5.4.0 or later to get access to the latest mysqlnd features.

The mysqlnd_uh user handler plugin supports all PHP applications and all available PHP MySQL extensions (mysqli, mysql, PDO_MYSQL). The PHP MySQL extension must be configured to use mysqlnd in order to be able to use the mysqlnd_uh plugin for mysqlnd.

The alpha versions makes use of some mysqli features. You must enable mysqli to compile the plugin. This requirement may be removed in the future. Note, that this requirement does not restrict you to use the plugin only with mysqli. You can use the plugin to monitor mysql, mysqli and PDO_MYSQL.

22.9.8.5.2. Installation

Information for installing this PECL extension may be found in the manual chapter titled Installation of PECL extensions. Additional information such as new releases, downloads, source files, maintainer information, and a CHANGELOG, can be located here: http://pecl.php.net/package/mysqlnd-uh

PECL/mysqlnd_uh is currently not available on Windows. The source code of the extension makes use of C99 constructs not allowed with PHP Windows builds.

22.9.8.5.3. Runtime Configuration

The behaviour of these functions is affected by settings in php.ini.

Table 22.79. Mysqlnd_uh Configure Options

Name	Default	Changeable	Changelog
mysqlnd_uh.enable	1	PHP_INI_SYSTEM
mysqlnd_uh.report_wrong_types	1	PHP_INI_ALL

Here's a short explanation of the configuration directives.

mysqlnd_uh.enable integer: Enables or disables the plugin. If set to disabled, the extension will not allow users to plug into mysqlnd to hook mysqlnd calls.
mysqlnd_uh.report_wrong_types integer: Whether to report wrong return value types of user hooks as E_WARNING level errors. This is recommended for detecting errors.

22.9.8.5.4. Resource Types

This extension has no resource types defined.