连接池与切换

插件控制 PHP MySQL 链接，完成同步和负载均衡，他并不会改变现有的 PHP MySQL 扩展的方法使用 (mysqli, mysql, 和 PDO_MYSQL) 现有的应用并不需要更新他们代码，或者使用新的 API，但是若操作行为改变，还是需要一些修改的。

插件结果下面这些扩展对于 MySQL 连接的控制， mysqli, mysql, 和 PDO_MYSQL。并且为 mysqli, mysql, 和 PDO_MYSQL 提供一个本地的连接池完成 MySQL 主从同步的 master 和 slave 通讯控制。插件会代理所有的到达 master 和 slave 的查询请求。在某一时刻一个连接到 master 的链接，会在稍后变更为 slave 连接，或者依然保持 master 连接。在执行非事务处理中，控制和替换 PHP MySQL 的网络链接。

每个 MySQL 连接都有他的状态，在连接池中的每个连接可以有不同的状态。当插件将一个写入连接变更为另外一个的时候，链接状态可能被改变。应用需要关注这个问题。

下面列出连接状态的内容，他可能并不完整。

事务状态
临时表
表锁
Session 系统变量和用户变量
当前使用的数据库 USE 和其他束缚 SQL 指令的状态
预执行语句
HANDLER 变量
通过 GET_LOCK () 获得的锁

连接替换将在语句执行前进行，在下一个语句执行以前，插件不会变更连接。

Note: 同步的问题

请参考 MySQL 参考手册中关于 » replication features 的相关内容。一些限制跟这个 PHP 插件无感，但是与 MySQL 的主从同步相关。

广播消息

插件的设计哲学是只有完全控制的链接，插件会在连接池排列连接的状态，或者由于一些安全因素也会这么做。只有很少的操作改变连接状态会失败，在这样的分类当中。

下面列出了哪些客户端的库，会改变连接状态，并且会将它广播到连接池中所有打开的链接当中。

任何下面列出的内容被执行，插件会轮循所有打开的 master 和 slave 连接，轮循会在操作了所有的服务器后停止。这个轮循不会影响服务器连接失败的状态。库函数的触发器可能以备检测到失败，并且通过用户 API 函数广播。

Library call	Notes	Version
change_user()	Called by the mysqli_change_user() user API call. Also triggered upon reuse of a persistent mysqli connection.	Since 1.0.0.
select_db	Called by the following user API calls: mysql_select_db(), mysql_list_tables(), mysql_db_query(), mysql_list_fields(), mysqli_select_db(). Note, that SQL USE is not monitored.	Since 1.0.0.
set_charset()	Called by the following user API calls: mysql_set_charset(). mysqli_set_charset(). Note, that SQL SET NAMES is not monitored.	Since 1.0.0.
set_server_option()	Called by the following user API calls: mysqli_multi_query(), mysqli_real_query(), mysqli_query(), mysql_query().	Since 1.0.0.
set_client_option()	Called by the following user API calls: mysqli_options(), mysqli_ssl_set(), mysqli_connect(), mysql_connect(), mysql_pconnect().	Since 1.0.0.
set_autocommit()	Called by the following user API calls: mysqli_autocommit(), PDO::setAttribute(PDO::ATTR_AUTOCOMMIT).	Since 1.0.0. PHP >= 5.4.0.
ssl_set()	Called by the following user API calls: mysqli_ssl_set().	Since 1.1.0.

广播和被动连接

连接打开以后，插件无法代理或者记录其上所有的设定。如果采用 lazy connections. 这非常重要。被动连接方式，客户端在发起第一次指令的时候，连接才被建立。插件默认的采用这种被动连接方式。

下面的这些库调用，将在被动连接建立以后执行。这有助于确信所有连接池中连接的状态存在可比性。

Library call	Notes	Version
change_user()	User, password and database recorded for future use.	Since 1.1.0.
select_db	Database recorded for future use.	Since 1.1.0.
set_charset()	Calls set_client_option(MYSQL_SET_CHARSET_NAME, charset) on lazy connection to ensure charset will be used upon opening the lazy connection.	Since 1.1.0.
set_autocommit()	Adds SET AUTOCOMMIT=0\|1 to the list of init commands of a lazy connection using set_client_option(MYSQL_INIT_COMMAND, "SET AUTOCOMMIT=...%quot;).	Since 1.1.0. PHP >= 5.4.0.

Caution

连接状态

连接状态不仅仅会被 API 调用改变。所以，即使插件监控了所有的 API 调用，应用也要在这方面关注变化。最后，对于连接状态的维护，是应用应该完成的事情。

字符集和字符串换码

当使用默认的被动连接时，若应用尝试在连接建立以前对 SQL 语句中的字符进行转码，是不可能完成的。因为连接建立以前，并不知道连接需要的字符集是甚么。

在 1.4.0 以后版本中，通过配置中的 server_charset 设置可以解决这个问题。

需要注意已经转换为某种字符集，但是连接的结果采用了另外一种不同的字符集。插件控制的链接和连接池中的每个连接可能采用了不同的默认字符集，所以建议配置服务器采用统一的默认字符集设定。配置文件中的 server_charset 可以很好的处理这种情况，如果使用它，插件将对每一个新打开的链接设定默认的字符集。

add a note

User Contributed Notes 1 note

down

m at louislivi dot com ¶

3 months ago


SMProxy
A MySQL database connection pool based on MySQL protocol and Swoole.
https://github.com/louislivi/SMProxy

add a note

官方地址：https://www.php.net/manual/en/mysqlnd-ms.pooling.php

有任何技术问题请点击这里网站运营推广招聘

IT PHP 编程语言 Linux 开发编程科技 Elasticsearch HTML/CSS/XML 网络数据库面试 JAVA NoSQL C/C++ Golang Git 算法操作系统正则表达式 Redis 互联网 MySql JavaScript 运维软件国际架构设计 Mac OS TCP/IP Excel Vim Windows Socket Oracle VR MongoDB Python 运营 MemCache 商业硬件电子娱乐设计 nginx 摄影游戏 WordPress HTTP 团建数码电器

php7 安装fileinfo扩展 preg_split — 通过一个正则表达式分隔字符串 php位值,解决 PHP 中 usort 在值相同时改变原始位置的问题 [PHP] inet_pton/inet_ntop IP地址转换函数 PHP 8.1 [鸟哥]PHP_INT_MIN 和 -9223372036854775808 opcache预加载 ADORecordSet对象 Composer的Packagist资源 adodb手册 mysql面试题 array_multisort() 多字段排序 PHP json解析（json_decode）页面工具 php设置cookie为httponly防止xss攻击 php中几种注释规范 PHP获取指定函数定义在哪个文件中及行号两千行PHP学习笔记 PHP mkdir()写出来的权限与mode值不符合 [鸟哥]PHP FFI详解 - 一种全新的PHP扩展方式 PHPMailer设置utf8 PHPMailer字符集CharSet

略微加速

PHP官方手册 - 互联网笔记

连接池与切换

连接状态

User Contributed Notes 1 note