EasySQL 使用说明

EasySQL是一个一个简单的PHP封装库，只需要一个文件就可以快速连接数据库数据表。

可以少用，乃至不用写出SQL语句就可以简单操作数据库。

如何使用？

很简单，下载后 放置在你需要的目录就可以。

然后在你需要使用的PHP文件中载入，就像这样：

include "$ADDRESS/EasySQL.php"; 

即可引用。

即使你修改这个文件名也没有影响，只需要在引用的时候也改成一样即可。

使用方法

1.申请一个EasySQL类的对象

$TEST = new EasySQL(参数1;参数2;参数3;参数4;参数5);

其中：

• 参数1：你的主机名

• 参数2：你的登陆用户名

• 参数3：你的登陆密码

• 参数4：你的数据库名

• 参数5：你的数据表名

如果一切正确，你已经直接连接到了数据库及其数据表，且成功设置了UTF-8语言格式。

2.获取数据信息

(1) 获取数据表长度

调用 size() 方法，可以直接获得目标数据表的长度。

$length = $TEST->size();

这里默认是查询已经连接的数据表。

如果你还想查询同一个数据库内的别的数据表的长度，你也可以直接加入参数：

$length = $TEST->size($AnotherTableName);

而对于已经连接的数据表，可以这样直接获得数据长度：

$length = $TEST->length;

(2)获取指定条件的数据

假设我们想要获得目标 name="Roger" 的数据其他的信息(如age等)我们可以先指定一个mysql语句：

$sql = "SELECT * FROM {$TEST->TABLE} WHERE name='Roger'";

然后可以调用 get() 方法：

$TSET->get($sql);

然后就可以直接使用 GET[] 数组获得数据：

echo $TSET->GET['age'];

(3)增加、修改、删除指定数据

三种目的对应同一个方法 run()。

都是需要一条SQL语句，然后调用方法完成操作。

$sql = "INSERT INTO {$TABLE} (name,age) VALUES 'Mark',18";  //增加数据

$sql = "UPDATE {$TABLE} SET age=XXX WHERE name='Roger'";  //修改数据

$sql = "DELETE FROM {$TABLE} WHERE name='Roger'";  //删除数据

然后均执行run() 方法即可：

$TSET->run($sql);

(4)直接查询数据表内的字段

对于一个未知的数据表，我们可以直接检索其所有的字段名和其数量。

使用 col() 方法我们就可以获得其中的数据。

(TIPS: 已连接的数据表的方法在构造时已经自动调用，所以在使用时不必重复调用，但我们如若需要其他数据表的内容，可以使用col($AnotherTableName)来完成)

通过该方法的参数，我们提供了一个参数和数组：

echo $TSET->width;  //输出字段数 (从0开始)

print_r($TSET->COL);  //输出字段名的数组 

(5)简单获取数据，EasyGet的eget()方法

这是最近更新增加的方法 (2019年7月15日)。

调用自带的 eget() 方法，可以在需要直接查询单个条件数据的其他字段信息时比较方便，但若条件满足的数据不唯一，则只能获取第一个数据，因此并不建议使用。

使用方法：

$TSET->eget($已知字段名,$已知数据);  
echo $TSET->GET['$其他字段名'];

使用该方法的好处是无需写出sql语句，在可以写出sql时候完全可以用 get() 方法替代。

(6)遍历所有数据 IMPORTANT

所有的表中的数据在对象构造的时候都被储存在一个二维数组 $this->CROSS 内，使用的是 cross() 方法，构造时自动调用，无需再次调用。

如此一来，所有的数据表都变成了二维数组！

print_r($TEST->CROSS);  //直接输出所有数据内容

echo $TEST->CROSS[m][n];  //输出表中坐标(m,n)的数据

案例

1.假设我们在数据库year2019、数据表table02，有学生的姓名和学校数据：

利用 EasySQL.php 我们可以很简短地写出代码：

include "EasySQL.php"; //引入文件

$conn = new EasySQL('HOST','USER','PASSWORD','year2019','table02'); //连接数据库

for($t=0;$t<$conn->length;$t++) {

    for($p=0;$p<$conn->width;$p++){
    
        echo $conn->CROSS[$t][$p]."\r\n";
    }
}

拓展 无SQL进行数据表操作

我们可以把一行所在的各个字段的数据写为一个数组：

$test_array=array("字段名1","字段名2","字段名3","字段名4",...); //对应各个字段的数据，若不修改则留空

利用对数组的方法，我们可以不写出SQL语句就可以进行检索、添加、修改、删除的操作。

1.获取相关数据所在行数

利用文件包含的 seek() 方法，我们可以快速得到待检索数据所在的行数。

$TEST->seek($test_array);

然后符合条件的数据所在的行数就储存在 $this->seek 数组内，符合的个数就是 $this->seeker 的值。

for($temp=0;$temp<$TEST->seeker;$temp++) {
echo $TEST->seek[$temp]; //输出所在行数
}

2.添加数据

利用文件包含的 add() 方法，我们可以快速添加一行数据。

$TEST->add($test_array);

3.修改数据

利用文件包含的 edit() 方法，我们可以快速修改一行数据，我们还需要该数据所在的行数。

(TIPS: 行数可以由 seek() 方法查询)

$TEST->edit($line,$test_array);  //$line为所在行数

(TIPS: 其中数组中必须有对应数量的值，不修改也需要写成 "" ，否则后面的数据字段会前移，留空则表示这个字段不修改。)

4.删除数据

利用文件包含的 delete() 方法，我们可以快速删除一行数据，我们还需要该数据所在的行数。

(TIPS: 行数可以由 seek() 方法查询)

$TEST->delete($line);  //$line为所在行数

5.全局排序

利用文件包含的 order() 方法，我们可以快速根据其中一列，对数据表进行排序。

需要注意的是，order() 方法有两个参数，一个是排序的列序，还一个是排序所需的bool函数

$TEST->order($columnId,functionName);  //$line为所在行数

对排序的bool函数，也需要两个参数，对应数据库中该列的不同行数的值，举例如下：

如需将某一列从小到大排序：

function functionName($temp1,$temp2) {
    if($temp1<$temp2){
        return true;
    } else {
        return false;
    }
}

然后使用 order() 方法，如此则之后的二维数组 $this->CROSS 已经重新改写。

$TEST->order($columnId,functionName);
$TEST->CROSS;  //已经发生了变化

如需恢复原始数据表顺序 ，我们只需再次调用 cross() 方法恢复原始状态。

该方法在构造时已经调用过一次，再次调用即可恢复构造初始状态。

6.其他方法返回值

1. xy() 方法

$TEST->xy(m,n);  //返回表中坐标(m,n)的数据

2. row() 方法

$TEST->row(m);  //返回表中第m行的数据的数组

3. line() 方法

$TEST->line(n);  //返回表中第n列的数据的数组