## L'API du plugin mysqlnd

Voici la liste des fonctions fournies dans l'API plugin `mysqlnd` :

- mysqlnd_plugin_register()

- mysqlnd_plugin_count()

- mysqlnd_plugin_get_plugin_connection_data()

- mysqlnd_plugin_get_plugin_result_data()

- mysqlnd_plugin_get_plugin_stmt_data()

- mysqlnd_plugin_get_plugin_net_data()

- mysqlnd_plugin_get_plugin_protocol_data()

- mysqlnd_conn_get_methods()

- mysqlnd_result_get_methods()

- mysqlnd_result_meta_get_methods()

- mysqlnd_stmt_get_methods()

- mysqlnd_net_get_methods()

- mysqlnd_protocol_get_methods()

Il n'y a pas de définition formelle de ce qu'est un plugin ainsi de la façon dont fonctionne un plugin.

Les composants les plus souvent trouvés dans les mécanismes de plugin sont :

- Un gestionnaire de plugin

- Une API du plugin

- Les services applicatifs (ou modules)

- Les APIs des services applicatifs (ou APIs du module)

Le concept d'un plugin `mysqlnd` utilise ces fonctionnalités, ainsi que d'autres joyeusetés d'architecture ouverte.

Aucune restriction

Un plugin a un accès total aux travaux internes de `mysqlnd`. Il n'y a aucune limite de sécurité ou de restrictions. Tout peut être écrasé pour implémenter des algorithmes utiles ou hostiles. Il est recommandé de ne déployer que des plugins depuis des sources de confiance.

Tel que discuté précédemment, les plugins peuvent utiliser librement des pointeurs. Ces pointeurs ne sont restreints en aucune manière, aussi, vous pouvez pointer vers les données d'un autre plugin. Une simple position arithmétique peut être utilisée pour lire les données d'un autre plugin.

Il est recommandé d'écrire des plugins coopératifs, et ainsi, appeler toujours la méthode parent. Les plugins devraient toujours coopérer avec `mysqlnd`.

Enjeux : un exemple de chaînage et de coopération
Extension | Pointeur mysqlnd.query() | Pile d'appel si on appelle le parent
--- | --- | ---
ext/mysqlnd | mysqlnd.query() | mysqlnd.query
ext/mysqlnd_cache | mysqlnd_cache.query() | mysqlnd_cache.query() mysqlnd.query
ext/mysqlnd_monitor | mysqlnd_monitor.query() | mysqlnd_monitor.query() mysqlnd_cache.query() mysqlnd.query

Dans ce scénario, un plugin cache (`ext/mysqlnd_cache`) et un plugin de surveillance (`ext/mysqlnd_monitor`) sont chargés. Les 2 ont une sous-classe de `Connection::query()`. L'enregistrement du plugin survient lors du `MINIT` en utilisant la logique évoquée précédemment. PHP appelle les extensions dans un ordre alphabétique par défaut. Les plugins ne sont pas au courant les uns les autres et ne peuvent fixer de dépendances.

Par défaut, les plugins appellent l'implémentation du parent de la méthode de requête dans leur version de la méthode dérivée.

Récapitulatif de l'extension PHP

Voici un récapitulatif de ce qui survient lors de l'utilisation d'un plugin d'exemple, `ext/mysqlnd_plugin`, qui expose l'API C du plugin `mysqlnd` à PHP :

- Toutes les applications PHP MySQL tente d'établir une connexion à l'adresse 192.168.2.29

- L'application PHP utilisera `ext/mysql`, `ext/mysqli` ou `PDO_MYSQL`. Ces 3 extensions PHP MySQL utilisent `mysqlnd` pour établir la connexion à l'adresse 192.168.2.29.

- `Mysqlnd` appelle sa méthode de connexion, qui a été sous-classé par `ext/mysqlnd_plugin`.

- `ext/mysqlnd_plugin` appelle la méthode de l'espace utilisateur `proxy::connect()` enregistrée par l'utilisateur.

- L'espace utilisateur modifie l'hôte de connexion de 192.168.2.29 à 127.0.0.1 et retourne la connexion établie par `parent::connect()`.

- `ext/mysqlnd_plugin` exécute l'équivalent de `parent::connect(127.0.0.1)` en appelant la méthode originale de `mysqlnd` pour établir une connexion.

- `ext/mysqlnd` établit une connexion et redonne la main à `ext/mysqlnd_plugin`. `ext/mysqlnd_plugin` retourne également.

- Quelque soit l'extension PHP MySQL utilisée par l'application, elle reçoit une connexion à 127.0.0.1. L'extension PHP MySQL redonne la main à l'application PHP. Le cycle est clos.