好了,上面的這些操作都是初步工作,下面正式進入類庫的講解。
類庫講解
首先,我們得實例化 M.class.php,實例化很簡單:
復制代碼 代碼如下:
$m = new M(); //這步操作代表 M.class.php 中的所有功能都封裝在了變量 $m 中
注:
1、M類庫中的方法參數說明,請到 M.class.php 文件中看詳細的注釋,這裡不再進行敘述。建議在學習的時候,對照著看下文件中的參數即注釋。
2、講解代碼中用到的數據庫結構為:
復制代碼 代碼如下:
CREATE TABLE `user` (
`id` int(8) unsigned NOT NULL auto_increment,
`name` varchar(50) default NULL,
`email` varchar(100) default NULL,
`age` smallint(3) default NULL,
`class_id` int(8) default NULL,
`commit_time` int(10) default NULL,
PRIMARY KEY (`id`),
KEY `name` (`name`)
) ENGINE=MyISAM DEFAULT CHARSET=utf8
復制代碼 代碼如下:
CREATE TABLE `class` (
`class_id` int(8) NOT NULL auto_increment,
`class_name` varchar(100) default NULL,
PRIMARY KEY (`class_id`)
) ENGINE=InnoDB DEFAULT CHARSET=utf8
並添加一條測試數據。
3、M類庫中,大部分方法都分兩中類型,即:SQL方法;拼接方法,具體在實例中可以看出
4、以下稱述中的 M 為 M.class.php 文件
方法1、Insert() 添加數據
Insert 方法的全部使用案例如下:
復制代碼 代碼如下:
$m->Insert("user", null, array('焦焦', '[email protected]', '23', time())); // 拼接方法:往`user`表中添加一條數據,返回值為數據庫影響的行數
$m->Insert("user", null, array('焦焦', '[email protected]', '23', time()), true); // 功能同上,返回 last_insert_id(插入的增長id)
$m->Insert("INSERT INTO `user` (`name`, `email`, `age`, `commit_time`) VALUES ('張小花', '[email protected]', '22', '".time()."')"); //SQL方法,返回值為數據庫影響的行數
$m->Insert("INSERT INTO `user` (`name`, `email`, `age`, `commit_time`) VALUES ('張小花', '[email protected]', '22', '".time()."')", true); // 同上,返回 last_insert_id
注:Insert 方法中的第二個參數若為null,可自動獲得插入表除 auto_increment 字段之外的所有字段,詳情請看M源文件;若要返回值為最後插入的 ID,那麼請設置 Insert 方法的最後一個參數為 true(默認是false);
方法2、Update() 修改數據
update 方法的全部使用案例如下:
復制代碼 代碼如下:
$m->Update("user", array('name'=>'李茹茹', 'age'=>24), "id=1"); //拼接方法,修改id為1的數據的名稱為“李茹茹”;年齡為“24”,其方法的返回值為受影響的行數
$m->Update("UPDATE `user` SET `name`='李茹茹', `age`=24 WHERE id = 1"); //SQL 用法,功能同上
方法3、Del() 刪除數據
Del 方法的全部使用案例如下:
復制代碼 代碼如下:
$m->Del('user', 'id=3'); //拼接方法:刪除`user`表中 id 為3的數據,返回受影響的行數
$m->Del("DELETE FROM `user` WHERE id=4"); //SQL方法:刪除`user`表中 id 為4的數據,返回受影響的行數
$m->Del("DELETE FROM `user` WHERE id in (10, 11, 12)"); //SQL方法:刪除多條數據,刪除`user`表中 id 為 10、11、12 的數據,返回受影響的行數
方法4、Total() 獲取記錄數,返回值都為int
Del 方法的全部使用案例如下:
復制代碼 代碼如下:
$m->Total('user'); //拼接方法:返回 `user`表中的記錄數,無條件
$m->Total('user', 'id>1'); //拼接方法:返回 `user`表中 id 大於1的記錄數,有條件
$m->Total("SELECT COUNT(*) AS total FROM `user`"); //SQL方法,注:使用SQL方法,語句中必須使用 "AS total",否則會報錯
方法5、IsExists() 檢查數據是否存在,返回值為boolean
復制代碼 代碼如下:
$m->IsExists('user', "`name`='焦焦'"); //拼接方法:返回`user`表中是否存在`name`為“焦焦”的數據,返回true,若不存在,返回false
方法6、InsertId() 獲取表下一個添加的自動增長id,注意,這裡不進行添加操作,只是獲取下一個增長id
復制代碼 代碼如下:
echo $m->InsertId('user'); //獲取`user` 表下一個添加的自動增長id
方法7、GetRow() 返回單條數據,返回值為一維數組
GetRow 方法的全部使用案例如下:
復制代碼 代碼如下:
$data = $m->GetRow("SELECT `name`,email FROM `user` WHERE id=1"); //SQL方法,返回一維數組,例如:Array ( [name] => 焦焦 [email] => [email protected] )
$data = $m->GetRow("SELECT u.`name`, u.email, c.class_name FROM `user` u, `class` c WHERE u.class_id=c.class_id AND u.id=1"); //SQL方法,多表查詢
$data = $m->GetRow('user', '`name`,email', "id=1"); //拼接方法
$data = $m->GetRow('user as u,`class` c', 'u.`name`,u.email,c.class_name', "u.id=1 AND u.class_id=c.class_id"); //拼接方法,多表查詢
$data = $m->GetRow("SELECT `name`,email FROM `user`"); //如果沒有指定條件應該是顯示全部信息,但是在此方法中將默認顯示第一條(不推薦這麼使用!!!)
$data 是查詢出來的一維數組。
方法8、GetOne() 返回單個數據
GetOne 方法的全部使用案例如下:
復制代碼 代碼如下:
$name = $m->GetOne("SELECT `name` FROM `user` WHERE id=1"); //SQL方法,返回一個字符串,例如:焦焦
$name = $m->GetOne("user", "name", "id=1"); //拼接方法,返回一個字符串,例如:焦焦
方法9、FetchAll() 返回所有記錄
復制代碼 代碼如下:
$data = $m->FetchAll("user"); //返回`user`表中的所有記錄,以二維數組的形式
$data = $m->FetchAll("SELECT * FROM `user`"); //SQL 方法,功能和返回值同上
$data = $m->FetchAll("user", "name,email", "id>1", 'id DESC', '2'); //返回兩條id>1的數據,只顯示name,email,並且以id 為倒序排序。注:請注意該方法的最後一個參數也可以為'0,2',目的是為分頁准備的,如果第一頁為'0,2'的話,那麼第二頁就是'2,2'
//該方法也支持聯表查詢和多表查詢,下面以聯表查詢為例
$data = $m->FetchAll("`user` as u LEFT JOIN `class` as c ON u.class_id=c.class_id", "u.`name`,u.email, c.class_name", "u.id=1"); //注意:該拼接方法中,ON 添加的位置
注:對於該 FetchAll 方法,後續我會寫一篇使用該方法進行完美分頁的文章!!請關注。
方法10、MultiQuery() 執行多條SQL語句
復制代碼 代碼如下:
$sql = "INSERT INTO user (`name`,email, age, class_id, commit_time) VALUES ('賈花花', '[email protected]', '22', '1', '".time()."')"; //添加一個名叫“賈花花”的學生信息
$sql .= ";DELETE FROM `user` WHERE `name`='焦焦'"; //刪除一條名叫“焦焦”的學生信息
//解釋:$sql 是多條 SQL 以英文;(分號)拼接起來的
$data = $m->MultiQuery($sql); //返回為true,代表執行成功;為false,代表執行失敗
類庫講解完畢
到此該類庫的全部功能就講解完畢,希望你能多看看M文件,了解其內部運行的機制。M 文件不會存在執行緩慢情況,請大家放心使用。
如果在使用過程中出現 SQL 拼接錯誤,類庫會報出友善的錯誤提示。
有問題請留言,歡迎大家的批評和建議,加油!學習好運。