ECShop - 数据库操作类

ECShop v2.7.2没有使用一些开源的数据库操作类，比如adodb或者PEAR，而是封装了自己的实现。这样做的好处是实现非常轻量，只有一个文件，27Kb，大大减小了分发包的文件大小。另外，当网站需要做memcached缓存时，也可以很方便的实现。当然，这样做的后果就是数据库的选择非常狭窄，无法实现其它的非MySQL数据库。

 

ECShop的数据操作类文件是includes/cls_mysql.php，类名是cls_mysql。该类主要提供了下面 一些比较有用的方法：

• getAll($sql)和getAllCached($sql, $cached = 'FILEFIRST')：获取所有记录。
• getRow($sql, $limited = false)和getRowCached($sql, $cached = 'FILEFIRST')：获取单行记录。
• getCol($sqlse)和getColCached($sql, $cached = 'FILEFIRST')：获取某栏位的所有值。
• getOne($sql, $limited = false)和getOneCached($sql, $cached = 'FILEFIRST')：获取单个数值。
• query($sql)：执行数据库查询。
• autoExecute($table, $field_values, $mode = 'INSERT', $where = '')：数据库表操作。

现在我们以实例的方式来说明这些方法如何使用。首先，在ecshop/admin目录下新增文件test_mysql.php，文件内容如下：

[php] view plain copy print ?

1. <?php  
2.   
3. define('IN_ECS', true);   
4. define('EC_CHARSET', 'utf-8');  
5. define('ROOT_PATH', 'D:/Program Files/Zend/Apache2/htdocs/ecshop/');  
6. define('DATA_DIR', 'data');  
7.   
8. $db_host = "localhost:3306";   
9. $db_name = "ecshop";   
10. $db_user = "root";   
11. $db_pass = "";   
12.   
13. require('../includes/cls_mysql.php');   
14. $db = new cls_mysql($db_host, $db_user, $db_pass, $db_name);  

<?php
define('IN_ECS', true);
define('EC_CHARSET', 'utf-8');
define('ROOT_PATH', 'D:/Program Files/Zend/Apache2/htdocs/ecshop/');
define('DATA_DIR', 'data');
$db_host = "localhost:3306";
$db_name = "ecshop";
$db_user = "root";
$db_pass = "";
require('../includes/cls_mysql.php');
$db = new cls_mysql($db_host, $db_user, $db_pass, $db_name);

 

 获取所有记录

getAll方法用来从数据库中获取满足条件的所有记录。getAllCached是它的缓存版本，cache key是该方法的第二个参数，如果缓存有效，直接返回缓存结果，否则重新执行数据库查询。

 

将下面的代码加到test_mysql.php的最后：

[php] view plain copy print ?

1. test_getAll();  
2.   
3. function test_getAll()  
4. {  
5.     global $db;  
6.       
7.     $sql = "SELECT user_id, user_name, email FROM ecs_admin_user";  
8.     $result = $db->getAll($sql);  
9.     print_r($result);  
10. }  

test_getAll();
function test_getAll()
{
global $db;
$sql = "SELECT user_id, user_name, email FROM ecs_admin_user";
$result = $db->getAll($sql);
print_r($result);
}

修改以后的test_mysql.php执行结果如下：

[php] view plain copy print ?

1. Array  
2. (  
3.     [0] => Array  
4.         (  
5.             [user_id] => 1  
6.             [user_name] => admin  
7.             [email] => [email protected]  
8.         )  
9.   
10.     [1] => Array  
11.         (  
12.             [user_id] => 2  
13.             [user_name] => bjgonghuo1  
14.             [email] => [email protected]  
15.         )  
16.   
17.     [2] => Array  
18.         (  
19.             [user_id] => 3  
20.             [user_name] => shhaigonghuo1  
21.             [email] => [email protected]  
22.         )  
23.   
24.     [3] => Array  
25.         (  
26.             [user_id] => 4  
27.             [user_name] => amonest  
28.             [email] => [email protected]  
29.         )  
30.   
31. )  

Array
(
    [0] => Array
        (
            [user_id] => 1
            [user_name] => admin
            [email] => [email protected]
        )
    [1] => Array
        (
            [user_id] => 2
            [user_name] => bjgonghuo1
            [email] => [email protected]
        )
    [2] => Array
        (
            [user_id] => 3
            [user_name] => shhaigonghuo1
            [email] => [email protected]
        )
    [3] => Array
        (
            [user_id] => 4
            [user_name] => amonest
            [email] => [email protected]
        )
)

 

 获取单行记录

getRow方法用来从数据库中获取满足条件的单行记录，或者说是第一条记录。getRowCached是它的缓存版本，cache key是该方法的第二个参数，如果缓存有效，直接返回缓存结果，否则重新执行数据库查询。

 

将下面的代码加到test_mysql.php的最后：

[php] view plain copy print ?

1. test_getRow();  
2.   
3. function test_getRow()  
4. {  
5.     global $db;  
6.       
7.     $sql = "SELECT user_id, user_name, email FROM ecs_admin_user LIMIT 1";  
8.     $result = $db->getRow($sql);  
9.     print_r($result);  
10. }  

test_getRow();
function test_getRow()
{
global $db;
$sql = "SELECT user_id, user_name, email FROM ecs_admin_user LIMIT 1";
$result = $db->getRow($sql);
print_r($result);
}

修改以后的test_mysql.php执行结果如下：

[php] view plain copy print ?

1. Array  
2. (  
3.     [user_id] => 1  
4.     [user_name] => admin  
5.     [email] => [email protected]  
6. )  

Array
(
    [user_id] => 1
    [user_name] => admin
    [email] => [email protected]
)

 

 获取某栏位的所有值

getCol方法用来从数据库中获取满足条件的某个栏位的所有值。getColCached是它的缓存版本，cache key是该方法的第二个参数，如果缓存有效，直接返回缓存结果，否则重新执行数据库查询。

 

将下面的代码加到test_mysql.php的最后：

[php] view plain copy print ?

1. test_getCol();  
2.   
3. function test_getCol()  
4. {  
5.     global $db;  
6.       
7.     $sql = "SELECT email FROM ecs_admin_user";  
8.     $result = $db->getCol($sql);  
9.     print_r($result);  
10. }  

test_getCol();
function test_getCol()
{
global $db;
$sql = "SELECT email FROM ecs_admin_user";
$result = $db->getCol($sql);
print_r($result);
}

修改以后的test_mysql.php执行结果如下：

[php] view plain copy print ?

1. Array  
2. (  
3.     [0] => [email protected]  
4.     [1] => [email protected]  
5.     [2] => [email protected]  
6.     [3] => [email protected]  
7. )  

Array
(
    [0] => [email protected]
    [1] => [email protected]
    [2] => [email protected]
    [3] => [email protected]
)

 

 获取单个值

getOne方法用来从数据库中获取满足条件的单个值。getOneCached是它的缓存版本，cache key是该方法的第二个参数，如果缓存有效，直接返回缓存结果，否则重新执行数据库查询。

 

将下面的代码加到test_mysql.php的最后：

[php] view plain copy print ?

1. test_getOne();  
2.   
3. function test_getOne()  
4. {  
5.     global $db;  
6.       
7.     $sql = "SELECT email FROM ecs_admin_user WHERE user_id = 4";  
8.     $result = $db->getOne($sql);  
9.     print_r($result);  
10. }  

test_getOne();
function test_getOne()
{
global $db;
$sql = "SELECT email FROM ecs_admin_user WHERE user_id = 4";
$result = $db->getOne($sql);
print_r($result);
}

修改以后的test_mysql.php执行结果如下：

[php] view plain copy print ?

1. [email protected]  

[email protected]

 

 执行数据库查询

query方法用来执行数据库查询，例如INSERT，UPDATE，DELETE等。 

将下面的代码加到test_mysql.php的最后：

[php] view plain copy print ?

1. test_query();  
2.   
3. function test_query()  
4. {  
5.     global $db;  
6.       
7.     $sql = "UPDATE ecs_admin_user SET todolist = '你有一封新邮件!' WHERE user_id = 4";  
8.     $db->query($sql);  
9.     $sql = "SELECT todolist FROM ecs_admin_user WHERE user_id = 4";  
10.     $result = $db->getOne($sql);  
11.     print_r($result);  
12. }  

test_query();
function test_query()
{
global $db;
$sql = "UPDATE ecs_admin_user SET todolist = '你有一封新邮件!' WHERE user_id = 4";
$db->query($sql);
$sql = "SELECT todolist FROM ecs_admin_user WHERE user_id = 4";
$result = $db->getOne($sql);
print_r($result);
}

修改以后的test_mysql.php执行结果如下：

[php] view plain copy print ?

1. 你有一封新邮件!  

你有一封新邮件!

 

 数据库表操作

autoExecute方法用来简化对数据表的INSERT和UPDATE。 

将下面的代码加到test_mysql.php的最后：

[php] view plain copy print ?

1. test_autoExecute();  
2.   
3. function test_autoExecute()  
4. {  
5.     global $db;  
6.       
7.     $table = "ecs_role";  
8.     $field_values = array("role_name" => "总经理办", "role_describe" => "总经理办", "action_list" => "all");  
9.     $db->autoExecute($table, $field_values, "INSERT");  
10.     // 执行的SQL：INSERT INTO ecs_role (role_name, action_list, role_describe) VALUES ('总经理办', 'all', '总经理办')  
11.   
12.     $role_id = $db->insert_id(); // 新记录的ID：5  
13.       
14.     $field_values = array("action_list" => "goods_manage");  
15.     $db->autoExecute($table, $field_values, "UPDATE", "role_id = $role_id");  
16.     // 执行的SQL：UPDATE ecs_role SET action_list = 'goods_manage' WHERE role_id = 5  
17.   
18.     $sql = "SELECT action_list FROM ecs_role WHERE role_id = $role_id";  
19.     $result = $db->getOne($sql);  
20.     print_r($result);  
21. }  

test_autoExecute();
function test_autoExecute()
{
global $db;
$table = "ecs_role";
$field_values = array("role_name" => "总经理办", "role_describe" => "总经理办", "action_list" => "all");
$db->autoExecute($table, $field_values, "INSERT");
// 执行的SQL：INSERT INTO ecs_role (role_name, action_list, role_describe) VALUES ('总经理办', 'all', '总经理办')
$role_id = $db->insert_id(); // 新记录的ID：5
$field_values = array("action_list" => "goods_manage");
$db->autoExecute($table, $field_values, "UPDATE", "role_id = $role_id");
// 执行的SQL：UPDATE ecs_role SET action_list = 'goods_manage' WHERE role_id = 5
$sql = "SELECT action_list FROM ecs_role WHERE role_id = $role_id";
$result = $db->getOne($sql);
print_r($result);
}

修改以后的test_mysql.php执行结果如下：

[php] view plain copy print ?

1. goods_manage