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,文件内容如下:
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);
获取所有记录
getAll方法用来从数据库中获取满足条件的所有记录。getAllCached是它的缓存版本,cache key是该方法的第二个参数,如果缓存有效,直接返回缓存结果,否则重新执行数据库查询。
将下面的代码加到test_mysql.php的最后:
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_mysql.php执行结果如下:
Array ( [0] => Array ( [user_id] => 1 [user_name] => admin [email] => admin@admin.com ) [1] => Array ( [user_id] => 2 [user_name] => bjgonghuo1 [email] => bj@163.com ) [2] => Array ( [user_id] => 3 [user_name] => shhaigonghuo1 [email] => shanghai@163.com ) [3] => Array ( [user_id] => 4 [user_name] => amonest [email] => amonest@foxmail.com ) )
获取单行记录
getRow方法用来从数据库中获取满足条件的单行记录,或者说是第一条记录。getRowCached是它的缓存版本,cache key是该方法的第二个参数,如果缓存有效,直接返回缓存结果,否则重新执行数据库查询。
将下面的代码加到test_mysql.php的最后:
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_mysql.php执行结果如下:
1 Array 2 ( 3 [user_id] => 1 4 [user_name] => admin 5 [email] => admin@admin.com 6 )
获取某栏位的所有值
getCol方法用来从数据库中获取满足条件的某个栏位的所有值。getColCached是它的缓存版本,cache key是该方法的第二个参数,如果缓存有效,直接返回缓存结果,否则重新执行数据库查询。
将下面的代码加到test_mysql.php的最后:
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_mysql.php执行结果如下:
1 Array 2 ( 3 [0] => admin@admin.com 4 [1] => bj@163.com 5 [2] => shanghai@163.com 6 [3] => amonest@foxmail.com 7 )
获取单个值
getOne方法用来从数据库中获取满足条件的单个值。getOneCached是它的缓存版本,cache key是该方法的第二个参数,如果缓存有效,直接返回缓存结果,否则重新执行数据库查询。
将下面的代码加到test_mysql.php的最后:.
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_mysql.php执行结果如下:
1 amonest@foxmail.com
执行数据库查询
query方法用来执行数据库查询,例如INSERT,UPDATE,DELETE等。
将下面的代码加到test_mysql.php的最后:
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_mysql.php执行结果如下:
1 你有一封新邮件!
数据库表操作
autoExecute方法用来简化对数据表的INSERT和UPDATE。
将下面的代码加到test_mysql.php的最后:
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_mysql.php执行结果如下:
goods_manage