Workerman/MySQL

说明

常驻内存的程序在使用mysql时经常会遇到mysql gone away的错误，这个是由于程序与mysql的连接长时间没有通讯，连接被mysql服务端踢掉导致。本数据库类可以解决这个问题，当发生mysql gone away错误时，会自动重试一次。

依赖的扩展

该mysql类依赖pdo和pdo_mysql两个扩展，缺少扩展会报Undefined class constant 'MYSQL_ATTR_INIT_COMMAND' in ....错误。

命令行运行php -m会列出所有php cli已安装的扩展，如果没有pdo 或者 pdo_mysql，请自行安装。

centos系统

PHP5.x

  1. yum install php-pdo
  2. yum install php-mysql

PHP7.x

  1. yum install php70w-pdo_dblib.x86_64
  2. yum install php70w-mysqlnd.x86_64

如果找不到包名，请尝试用yum search php mysql查找

ubuntu/debian系统

PHP5.x

  1. apt-get install php5-mysql

PHP7.x

  1. apt-get install php7.0-mysql

如果找不到包名，请尝试用apt-cache search php mysql查找

以上方法无法安装？

如果以上方法无法安装，请参考workerman手册-附录-扩展安装-方法三源码编译安装。

安装 Workerman/MySQL

方法1：

可以通过composer安装，命令行运行以下命令(composer源在国外，安装过程可能会非常慢)。

  1. composer config -g repo.packagist composer https://mirrors.aliyun.com/composer/
  2. composer require workerman/mysql

上面命令成功后会生成vendor目录，然后在项目中引入vendor下的autoload.php。

  1. require_once __DIR__ . '/vendor/autoload.php';

方法2：

下载源码，解压后的目录放到自己项目中(位置任意)，直接require源文件。

  1. require_once '/your/path/of/mysql-master/src/Connection.php';

注意

强烈建议在onWorkerStart回调中初始化数据库连接，避免在Worker::runAll();运行前就初始化连接，在Worker::runAll();运行前初始化的连接属于主进程，子进程会继承这个连接，主进程和子进程共用相同的数据库连接会导致错误。

示例

  1. use Workerman\Worker;
  2. use Workerman\Connection\TcpConnection;
  3. require_once __DIR__ . '/vendor/autoload.php';
  5. $worker = new Worker('websocket://0.0.0.0:8484');
  6. $worker->onWorkerStart = function($worker)
  7. {
  8.     // 将db实例存储在全局变量中(也可以存储在某类的静态成员中)
  9.     global $db;
  10.     $db = new \Workerman\MySQL\Connection('host', 'port', 'user', 'password', 'db_name');
  11. };
  12. $worker->onMessage = function(TcpConnection $connection, $data)
  13. {
  14.     // 通过全局变量获得db实例
  15.     global $db;
  16.     // 执行SQL
  17.     $all_tables = $db->query('show tables');
  18.     $connection->send(json_encode($all_tables));
  19. };
  20. // 运行worker
  21. Worker::runAll();

具体MySQL/Connection用法

  1. // 初始化db连接
  2. $db = new \Workerman\MySQL\Connection('host', 'port', 'user', 'password', 'db_name');
  4. // 获取所有数据
  5. $db->select('ID,Sex')->from('Persons')->where('sex= :sex AND ID = :id')->bindValues(array('sex'=>'M', 'id' => 1))->query();
  6. //等价于
  7. $db->select('ID,Sex')->from('Persons')->where("sex= 'M' AND ID = 1")->query();
  8. //等价于
  9. $db->query("SELECT ID,Sex FROM `Persons` WHERE sex='M' AND ID = 1");
  12. // 获取一行数据
  13. $db->select('ID,Sex')->from('Persons')->where('sex= :sex')->bindValues(array('sex'=>'M'))->row();
  14. //等价于
  15. $db->select('ID,Sex')->from('Persons')->where("sex= 'M' ")->row();
  16. //等价于
  17. $db->row("SELECT ID,Sex FROM `Persons` WHERE sex='M'");
  20. // 获取一列数据
  21. $db->select('ID')->from('Persons')->where('sex= :sex')->bindValues(array('sex'=>'M'))->column();
  22. //等价于
  23. $db->select('ID')->from('Persons')->where("sex= 'F' ")->column();
  24. //等价于
  25. $db->column("SELECT `ID` FROM `Persons` WHERE sex='M'");
  27. // 获取单个值
  28. $db->select('ID')->from('Persons')->where('sex= :sex')->bindValues(array('sex'=>'M'))->single();
  29. //等价于
  30. $db->select('ID')->from('Persons')->where("sex= 'F' ")->single();
  31. //等价于
  32. $db->single("SELECT ID FROM `Persons` WHERE sex='M'");
  34. // 复杂查询
  35. $db->select('*')->from('table1')->innerJoin('table2','table1.uid = table2.uid')->where('age > :age')->groupBy(array('aid'))->having('foo="foo"')->orderByASC/*orderByDESC*/(array('did'))
  36. ->limit(10)->offset(20)->bindValues(array('age' => 13));
  37. // 等价于
  38. $db->query('SELECT * FROM `table1` INNER JOIN `table2` ON `table1`.`uid` = `table2`.`uid`
  39. WHERE age > 13 GROUP BY aid HAVING foo="foo" ORDER BY did LIMIT 10 OFFSET 20');
  41. // 插入
  42. $insert_id = $db->insert('Persons')->cols(array(
  43.     'Firstname'=>'abc',
  44.     'Lastname'=>'efg',
  45.     'Sex'=>'M',
  46.     'Age'=>13))->query();
  47. 等价于
  48. $insert_id = $db->query("INSERT INTO `Persons` ( `Firstname`,`Lastname`,`Sex`,`Age`)
  49. VALUES ( 'abc', 'efg', 'M', 13)");
  51. // 更新
  52. $row_count = $db->update('Persons')->cols(array('sex'))->where('ID=1')
  53. ->bindValue('sex', 'F')->query();
  54. // 等价于
  55. $row_count = $db->update('Persons')->cols(array('sex'=>'F'))->where('ID=1')->query();
  56. // 等价于
  57. $row_count = $db->query("UPDATE `Persons` SET `sex` = 'F' WHERE ID=1");
  59. // 删除
  60. $row_count = $db->delete('Persons')->where('ID=9')->query();
  61. // 等价于
  62. $row_count = $db->query("DELETE FROM `Persons` WHERE ID=9");
  64. // 事务
  65. $db->beginTrans();
  66. ....
  67. $db->commitTrans(); // or $db->rollBackTrans();