PHPackages windwork/db - PHPackages - PHPackages [Skip to content](#main-content)[PHPackages](/)[Directory](/)[Categories](/categories)[Trending](/trending)[Leaderboard](/leaderboard)[Changelog](/changelog)[Analyze](/analyze)[Collections](/collections)[Log in](/login)[Sign up](/register) 1. [Directory](/) 2. / 3. [Database & ORM](/categories/database) 4. / 5. windwork/db ActiveLibrary[Database & ORM](/categories/database) windwork/db =========== windwork db component.Windwork MySQL数据库访问组件 0.7.3(8y ago)08412MITPHPPHP >=5.5.0 Since May 20Pushed 8y agoCompare [ Source](https://github.com/windwork/wf-db)[ Packagist](https://packagist.org/packages/windwork/db)[ RSS](/packages/windwork-db/feed)WikiDiscussions master Synced 2mo ago READMEChangelog (8)DependenciesVersions (9)Used By (2) Windwork MySQL数据库访问组件 ===================== [](#windwork-mysql数据库访问组件) 可通过选择不同的驱动连接MySQL查询。 安装 -- [](#安装) 该组件已包含在Windwork框架中，如果你已安装Windwork框架则可以直接使用。 - 安装方式一：通过composer安装（推荐） ``` composer require windwork/wf ``` - 安装方式二：传统方式安装 [下载源码](https://github.com/windwork/wf/releases)后，解压源码到项目文件夹中，然后require\_once $PATH\_TO\_WF/core/lib/Loader.php文件，即可自动加载组件中的类。 数据库读写 ----- [](#数据库读写) ### 数据库实例创建 [](#数据库实例创建) ``` // 在config/app.php设置数据库参数 // 获取数据库操作实例 $db = wfDb(); ``` 数据库操作对象可执行如下方法进行数据库读写： ``` /** * 获取所有记录 * * @param string $sql * @param array $args = [] sql格式化参数值列表 */ public function getAll($sql, array $args = []); /** * 获取第一列 * * @param string $sql * @param array $args = [] sql格式化参数值列表 */ public function getRow($sql, array $args = []); /** * 获取第一列第一个字段 * * @param string $sql * @param array $args =[] sql格式化参数值列表 */ public function getColumn($sql, array $args = []); /** * 执行写入SQL * 针对没有结果集合返回的写入操作， * 比如INSERT、UPDATE、DELETE等操作，它返回的结果是当前操作影响的列数。 * * @param string $sql * @param array $args = [] sql格式化参数值列表 * @throws \wf\db\Exception * @return int */ public function exec($sql, array $args = []); /** * 取得上一步 INSERT 操作产生的 ID * * @return string */ public function lastInsertId(); /** * 插入多行数据 * 过滤掉没有的字段 * * @param array $rows * @param string $table 插入表 * @param array $fieldArr 允许插入的字段名 * @param string $isReplace = false 是否使用 REPLACE INTO插入数据，false为使用 INSERT INTO */ public function insertRows(array $rows, $table, $fieldArr = [], $isReplace = false); ``` 使用案例 ``` $dbCfgs = [ // 数据库设置 'host' => '127.0.0.1', // 本机测试 'port' => '3306', // 数据库服务器端口 'name' => 'windworkdb', // 数据库名 'user' => 'root', // 数据库连接用户名 'pass' => '123456', // 数据库连接密码 'tablePrefix' => 'wk_', // 表前缀 'debug' => 0, 'class' => 'PDOMySQL', // MySQLi|PDOMySQL ]; $class = "\\wf\\db\\adapter\\{$dbCfg['class']}"; $db = new $class($dbCfgs); // 获取所有记录 $rows = $db->getAll("SELECT * FROM my_table"); // 获取一条记录 $row = $db->getRow("SELECT * FROM my_table LIMIT 1"); // 获取一行中的第一列 $column = $db->getColumn("SELECT * FROM my_table LIMIT 1"); // 执行sql $db->exec("INSERT INTO my_table (f1, f2) VALUE ('fff1', 'ffff2')"); ``` SQL防注入 ------ [](#sql防注入) 我们通过sql格式化以后，可有效防注入。 以%作为标识，%后面的字符为格式化参数的数据类型。支持的类型有： - %t：表名(Table)，将被进行数据表名称反注入处理； - %c：字段名(Column)，将被进行数据表字段名反注入处理； - %n：数字值(Number)，将被过滤掉非数字和.的字符； - %i：整形(Int)，将被强制转换为整形； - %f：浮点型(Float)，将被强制转换为浮点型； - %s：字符串值(String)，将被进行字符串值反注入处理; - %x：保留不处理 例如： ``` $sql = 'SELECT %f FROM %t WHERE uid > %i AND uname LIKE %s'; $arg = ['nickname, uid, email', 'user', 5, '%马%']; $db->getAll($sql, $arg); // 执行的SQL被格式化为如下SQL // SELECT `nickname`, `uid`, `email` FROM `user` WHERE uid > 5 AND uname LIKE '%马%' ``` 使用事务 ---- [](#使用事务) 使用事务的前提是：你使用的引擎必须支持事务。MyISAM、MEMORY引擎不支持事务，InnoDB引擎支持事务。MySQL经过多年的发展，InnoDB引擎已经是MySQL引擎中最有优势的引擎，所以推荐你优先使用InnoDB引擎。 可以嵌套启用事务，最终只在最上一级事务提交后才会真正执行事务。 使用事务的案例： ``` try { // 开启事务 $trans = wfDb()->beginTransaction(); // 数据库写入业务代码 // 事务中应只做数据库写入操作，其它逻辑应放在事务之前完成，以防事务锁死。 // …… // 没异常则提交事务 $trans->commit(); } catch(\Exception $e) { // 出现异常则回滚事务 $trans->rollback(); } ``` 数据库连接配置参数 --------- [](#数据库连接配置参数) ``` // config/db.php return [ // 主数据库 'default' => [ 'class' => '\\wf\\db\\adapter\\PDOMySQL', // MySQLi/PDOMySQL 'host' => '127.0.0.1', // 本机测试 'port' => '3306', // 数据库服务器端口 'name' => 'windworkdb', // 数据库名 'user' => 'root', // 数据库连接用户名 'pass' => '123456', // 数据库连接密码 'tablePrefix' => 'wk_', // 表前缀 'debug' => 0, ], // 主从分离，启用后，从slave读，从default写 /* 'slave' => array( // 数据库设置 'class' => '\\wf\\db\\adapter\\PDOMySQL', 'host' => '127.0.0.1', // 本机测试 'port' => '3306', // 数据库服务器端口 'name' => 'windworkdb', // 数据库名 'user' => 'root', // 数据库连接用户名 'pass' => '123456', // 数据库连接密码 'tablePrefix' => 'wk_', // 表前缀 'debug' => 0, ), */ ]; ``` TODO ---- [](#todo) - 完善使用文档 - 改进文档注释 ### 要了解更多？ [](#要了解更多) > - [官方完整文档首页](http://docs.windwork.org/manual/) > - [官方源码首页](https://github.com/windwork) ### Health Score 26 — LowBetter than 43% of packages Maintenance20 Infrequent updates — may be unmaintained Popularity10 Limited adoption so far Community11 Small or concentrated contributor base Maturity53 Maturing project, gaining track record Bus Factor1 Top contributor holds 100% of commits — single point of failure How is this calculated?**Maintenance (25%)** — Last commit recency, latest release date, and issue-to-star ratio. Uses a 2-year decay window. **Popularity (30%)** — Total and monthly downloads, GitHub stars, and forks. Logarithmic scaling prevents top-heavy scores. **Community (15%)** — Contributors, dependents, forks, watchers, and maintainers. Measures real ecosystem engagement. **Maturity (30%)** — Project age, version count, PHP version support, and release stability. ### Release Activity Cadence Every ~36 days Recently: every ~54 days Total 8 Last Release 3022d ago ### Community Maintainers ![](https://www.gravatar.com/avatar/500cd48271ed61b12fbac17502e33a2b7ff364948c9ffe2d4a86d5d4d63540fb?d=identicon)[windwork](/maintainers/windwork) --- Top Contributors [![cmpan](https://avatars.githubusercontent.com/u/399927?v=4)](https://github.com/cmpan "cmpan (37 commits)") --- Tags databasedatabase-accessdatabase-adapterdatabase-finderdatabase-strategyquery-builder ### Embed Badge ![Health badge](/badges/windwork-db/health.svg) ``` [![Health](https://phpackages.com/badges/windwork-db/health.svg)](https://phpackages.com/packages/windwork-db) ``` ### Alternatives [doctrine/orm Object-Relational-Mapper for PHP 10.2k285.3M6.2k](/packages/doctrine-orm)[jdorn/sql-formatter a PHP SQL highlighting library 3.9k115.1M102](/packages/jdorn-sql-formatter)[illuminate/database The Illuminate Database package. 2.8k52.4M9.3k](/packages/illuminate-database)[mongodb/mongodb MongoDB driver library 1.6k64.0M543](/packages/mongodb-mongodb)[ramsey/uuid-doctrine Use ramsey/uuid as a Doctrine field type. 90340.3M209](/packages/ramsey-uuid-doctrine)[reliese/laravel Reliese Components for Laravel Framework code generation. 1.7k3.4M16](/packages/reliese-laravel) PHPackages © 2026 [Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)