ecshop運算元據庫類

wensongyu發表於2013-10-11

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 plaincopy
  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的最後：

 

[php] view plaincopy
  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執行結果如下：

 

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

 

 

 

 

 獲取單行記錄

getRow方法用來從資料庫中獲取滿足條件的單行記錄，或者說是第一條記錄。getRowCached是它的快取版本，cache key是該方法的第二個引數，如果快取有效，直接返回快取結果，否則重新執行資料庫查詢。

 

將下面的程式碼加到test_mysql.php的最後：

 

[php] view plaincopy
  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執行結果如下：

 

[php] view plaincopy
  1. Array  
  2. (  
  3.     [user_id] => 1  
  4.     [user_name] => admin  
  5.     [email] => admin@admin.com  
  6. )  

 

 

 

 

 獲取某欄位的所有值

getCol方法用來從資料庫中獲取滿足條件的某個欄位的所有值。getColCached是它的快取版本，cache key是該方法的第二個引數，如果快取有效，直接返回快取結果，否則重新執行資料庫查詢。

 

將下面的程式碼加到test_mysql.php的最後：

 

[php] view plaincopy
  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執行結果如下：

 

[php] view plaincopy
  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的最後：

 

[php] view plaincopy
  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執行結果如下：

 

 

 

 

 

 執行資料庫查詢

query方法用來執行資料庫查詢，例如INSERT，UPDATE，DELETE等。 

將下面的程式碼加到test_mysql.php的最後：

 

[php] view plaincopy
 
  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執行結果如下：

 

 

 

 

 

 資料庫表操作

autoExecute方法用來簡化對資料表的INSERT和UPDATE。 

將下面的程式碼加到test_mysql.php的最後：

 

[php] view plaincopy
 
  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執行結果如下：

 

[php] view plaincopy
  1. goods_manage  

 


相關文章