API плагинов 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()
Нет стандартных определений того, что такое плагин и как он работает.
Часто встречающиеся в плагинах компоненты:
Менеджер плагина
API плагина
Сервисы приложения (или модули)
API сервисов приложения (или API модулей)
Концепция плагина mysqlnd эксплуатирует эту функциональность и, кроме того, радует нас открытой архитектурой.
Нет запретов
Плагин имеет полный доступ ко всем внутренностям mysqlnd. Нет ограничений или запретов, связанных с безопасностью. Все что угодно можно переписать для реализации дружественных или враждебных алгоритмов, так что рекомендуется ставить плагины только из доверенных источников.
Как обсуждалось выше, плагины могут свободно использовать указатели. Эти указатели ничем не ограничены и могут указывать на данные другого плагина. Простейшая арифметическая операция позволит получить доступ к данным другого плагина.
Рекомендуется писать сотрудничающие плагины, которые могут работать сообща с другими плагинами и всегда вызывать родительские методы. Плагины никогда не должны вести себя враждебно к самому mysqlnd.
| Расширение | Указатель mysqlnd.query() | Стек вызова, если вызывается родитель |
|---|---|---|
| ext/mysqlnd | mysqlnd.query() | mysqlnd.query |
| ext/mysqlnd_cache | mysqlnd_cache.query() |
|
| ext/mysqlnd_monitor | mysqlnd_monitor.query() |
|
В этом сценарии загружены плагины кеша(ext/mysqlnd_cache) и мониторинга (ext/mysqlnd_monitor). Оба наследуют класс Connection::query(). регистрация плагинов происходит на этапе MINIT в соответствии с описанной выше логикой. PHP, по умолчанию, вызывает расширения в алфавитном порядке. Плагины не знают друг о друге и не накладывают каких либо зависимостей.
По умолчанию, плагины вызывают родительский метод query из своей, переопределенной, версии этого метода.
Резюме по расширению PHP
Повторение пройденного материала на примере поведения плагина ext/mysqlnd_plugin, использующего API плагинов mysqlnd для PHP:
Любое приложение PHP, использующее MySQL пытается установить соединение по адресу 192.168.2.29
Приложение использует одно из следующих расширений ext/mysql, ext/mysqli или PDO_MYSQL. Все три расширения используют mysqlnd для соединения с 192.168.2.29.
Mysqlnd вызывает метод соединения, который наследуется плагином ext/mysqlnd_plugin.
ext/mysqlnd_plugin вызывает зарегистрированный пользователем метод proxy::connect().
Этот метод подменяет IP адрес соединения с 192.168.2.29 на 127.0.0.1 и возвращает установленное parent::connect() соединение.
ext/mysqlnd_plugin делает то же самое, что и parent::connect(127.0.0.1) вызывая оригинальный метод mysqlnd для соединения.
ext/mysqlnd устанавливает соединение и возвращает его ext/mysqlnd_plugin. ext/mysqlnd_plugin, в свою очередь, передает его дальше.
Без разницы, какое расширение было использовано, оно все равно получит соединение к 127.0.0.1. После этого, расширение возвращает это соединение приложению. Круг замкнулся.