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.
| Extension | Pointeur mysqlnd.query() | Pile d'appel si on appelle le parent |
|---|---|---|
| ext/mysqlnd | mysqlnd.query() | mysqlnd.query |
| ext/mysqlnd_cache | mysqlnd_cache.query() |
|
| ext/mysqlnd_monitor | mysqlnd_monitor.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.