PHP之MySQLi类讲解

痛定思痛。 2024-04-18 12:39 14阅读 0赞

# **目录** #

> 1 引言 
> 
> 2 MySQLi属性及描述 
> 
> 3 MySQLi方法及描述
> 
> 4 获取MySQLi属性信息
> 
> 5 常用的MySQLi方法

--------------------

# #

## 1 引言  ##

在web开发中，php与mysql可谓是最合适不过的搭档了，这两兄弟经常一起合作，作为开发者的我们得要好好的了解一下它们是如何相处的，下面笔者做了些小笔记，方便日后查阅，同时也希望能够帮助到大家，再次之前我们可以先阅读一下php的官方描述，两者结合阅读效果更佳。

> php官方MySQLI类传送门：[https://www.php.net/manual/zh/class.mysqli.php][https_www.php.net_manual_zh_class.mysqli.php]

# #

## 2 MySQLi属性及描述  ##

int $affected_rows;    // 受影响的条数
    int $connect_errno;    // 最后一次连接的错误代码
    string $connect_error; // 最后一次连接的错误描述
    int $errno;            // 错误号
    array $error_list;     // 上次执行的命令中的错误列表。
    string $error;         // 错误信息
    int $field_count;
    string $client_info; // 客户端信息
    int $client_version; // 客户端版本
    string $host_info;   // 主机信息
    string $protocol_version;// 协议版本
    string $server_info; // 服务的信息
    int $server_version; // 服务端版本
    string $info;        // 提示信息
    mixed $insert_id;    // 最后插入的id
    string $sqlstate;    // SQL状态码
    int $thread_id;
    int $warning_count;  // 警告条数

# #

## 3 MySQLi方法及描述 ##

mysqli::$affected_rows — 上一次MySQL操作中受影响的行数。
    mysqli::autocommit     — 打开或关闭本次数据库连接的自动命令提交事务模式
    mysqli::begin_transaction  — 开启事务
    mysqli::change_user        — 更改指定数据库连接的用户
    mysqli::character_set_name — 返回当前数据库连接的默认字符编码
    mysqli::close  — 关闭先前打开的数据库连接
    mysqli::commit — 提交一个事务
    mysqli::$connect_errno  — 返回上次连接调用中的错误代码。
    mysqli::$connect_error  — 返回上一个连接错误的描述
    mysqli::__construct     — 构造函数
    mysqli::debug           — debug
    mysqli::dump_debug_info — 将调试信息输出到日志
    mysqli::errno        — 返回最近函数调用的错误代码
    mysqli::$error_list  — 返回上次执行的命令中的错误列表。
    mysqli::$error       — 返回上一个错误的描述
    mysqli::$field_count — 返回查询的列数。
    mysqli::get_charset  — 返回字符集对象
    mysqli::$client_info — 获取 MySQL 客户端信息
    mysqli_get_client_version    — 作为一个整数返回MySQL客户端的版本
    mysqli::get_connection_stats — 返回客户端连接的统计数据
    mysqli::$host_info        — 返回一个表述使用的连接类型的字符串
    mysqli::$protocol_version — 返回MySQL使用的协议版本号
    mysqli::$server_info      — 返回MySQL服务器的版本号
    mysqli::$server_version   — 作为一个整数返回MySQL服务器的版本
    mysqli::get_warnings — 警告信息
    mysqli::$info        — 返回最近执行的 SQL 语句的信息
    mysqli::init         — 初始化 MySQLi 并返回一个资源类型的值，这个值可以作为 mysqli_real_connect() 函数的传入参数
    mysqli::$insert_id   — 返回最后一条插入语句产生的自增 ID
    mysqli::kill         — 让服务器杀掉一个 MySQL 线程
    mysqli::more_results — 检查批量查询中是否还有查询结果
    mysqli::multi_query  — 执行查询
    mysqli::next_result  — 为读取 multi_query 执行之后的下一个结果集做准备
    mysqli::options      — 设置选项
    mysqli::ping         — ping 一个连接，或者如果连接处于断开状态，重新连接
    mysqli::poll    — 轮询连接
    mysqli::prepare — 准备执行一个 SQL 语句
    mysqli::query   — 对数据库执行一次查询
    mysqli::real_connect       — 建立一个 MySQL 服务器连接
    mysqli::real_escape_string — 根据当前连接的字符集，对于 SQL 语句中的特殊字符进行转义
    mysqli::real_query         — 执行一个mysql查询
    mysqli::reap_async_query   — 获取异步查询的结果
    mysqli::refresh            — 刷新
    mysqli::release_savepoint  — 从当前事务的保存点中移除一个命名保存点
    mysqli::rollback       — 回退当前事务
    mysqli::rpl_query_type — 返回 RPL 查询类型
    mysqli::savepoint      — 在当前事务中增加一个命名保存点
    mysqli::select_db      — 选择用于数据库查询的默认数据库
    mysqli::send_query     — 发送请求并返回结果
    mysqli::set_charset    — 设置默认字符编码
    mysqli::set_local_infile_default — 取消用户指定的回调函数
    mysqli::set_local_infile_handler — 设置 LOAD DATA LOCAL INFILE 命令的回调函数
    mysqli::$sqlstate    — 返回上一次 SQL 操作的 SQLSTATE 错误信息
    mysqli::ssl_set      — 使用 SSL 建立到数据库之间的安全连接
    mysqli::stat         — 获取当前系统状态信息
    mysqli::stmt_init    — 初始化一条语句并返回一个用于mysqli_stmt_prepare(调用)的对象
    mysqli::store_result — 转移上一次查询返回的结果集
    mysqli::$thread_id   — 返回当前连接的线程 ID
    mysqli::thread_safe  — 返回是否是线程安全的
    mysqli::use_result     — 启动结果集检索
    mysqli::$warning_count —返回上次查询中的警告数

--------------------

# #

## 4 获取MySQLi属性信息 ##

**4.1 打印MySQLi连接信息**

<?php
    $link = new mysqli('localhost','root','root','test');
    $link->set_charset('utf8');
    print_r($link);
    ?>

**打印结果 **

mysqli Object
    (
        [affected_rows] => 0
        [client_info] => mysqlnd 5.0.12-dev - 20150407 - $Id: 241ae00989d1995ffcbbf63d579943635faf9972 $
        [client_version] => 50012
        [connect_errno] => 0
        [connect_error] =>
        [errno] => 0
        [error] =>
        [error_list] => Array
            (
            )
    
        [field_count] => 0
        [host_info] => localhost via TCP/IP
        [info] =>
        [insert_id] => 0
        [server_info] => 8.0.12
        [server_version] => 80012
        [stat] => Uptime: 306  Threads: 2  Questions: 10  Slow queries: 0  Opens: 111  Flush tables: 2  Open tables: 89  Queries per second avg: 0.032
        [sqlstate] => 00000
        [protocol_version] => 10
        [thread_id] => 10
        [warning_count] => 1
    )

**4.2 打印服务端信息**

<?php
    $link = new mysqli('localhost','root','root','test');
    $link->set_charset('utf8');
    print_r($link->server_info);
    ?>

**打印结果**

8.0.12

> 注：获取MySQLi属性的方式都一样，这里就不一一试了，相信大家都可以触类旁通的。

# #

## 5 常用的MySQLi方法 ##

**创建并选定数据库**

$mysqli = new mysqli('localhost','root','root','test');

**设置字符集**

$mysqli->set_charset('utf8');

> 注：如果在创建时没有指定数据库，我们可以通过mysqli::select\_db来选择数据库，例如

$mysqli->select_db('test');

** 获取上一次MySQL操作中受影响的行数。**

$mysqli->affected_rows();

**返回上次连接调用中的错误代码。**

$mysqli->connect_errno()

**返回上一个连接错误的描述 **

$mysqli->connect_error();

**单语句查询（**mysqli\_result对象将在另一篇文章介绍 **）**

$sql = 'SELECT * FROM user'; 
    $result = $mysqli->query($sql);

>  注：mysqli::query对于SELECT、DESC、SHOW、EXPLAIN、DESCRIBE语句执行成功则返回mysqli\_result对象，执行失败则返回false，对于其它的SQL语句的话，执行成功返回true，执行失败返回false。

**多语句查询**

$sql = 'SELECT * FROM user'; 
    $sql.= 'SELECT * FROM admin';
    $result = $mysqli->multi_query($sql);

**SQL预处理**（mysql\_stmt对象将在另一篇文章介绍 ）

$sql = 'SELECT * FROM user WHERE name = ?'; 
    $mysql_stmt = $mysqli->prepare($sql);

**事务处理**

<?php
    $mysql = new mysqli('localhost','root','root','test');
    $mysqli->autocommit(false); 
    $sql  = "UPDATE user SET money = money+100 WHERE name='trevor' ";    
    $sql. = "UPDATE user SET money = money-100 WHERE name='brell' ";  
    $result = $mysqli->multi_query($sql);
    if($result){
    	$mysqli->commit();
    	$mysqli->autocommit(true); 
    }else{
    	$mysqli->rollback();
    }

**关闭数据库连接 **

$mysqli->close();

# #

## 6 预告 ##

mysqli对象、mysqli\_result对象、mysqli\_stmt对象之间的关系图

![watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L2x3cUJyZWxs_size_16_color_FFFFFF_t_70][]

[https_www.php.net_manual_zh_class.mysqli.php]: https://www.php.net/manual/zh/class.mysqli.php
[watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L2x3cUJyZWxs_size_16_color_FFFFFF_t_70]: https://image.dandelioncloud.cn/pgy_files/images/2024/04/18/b26e0653ea9d4500af823c715f4629db.png