# 驅動擴展
[上一頁](# "上一頁")[下一頁](# "下一頁")
這里說的驅動擴展是一種泛指,驅動擴展的目錄位于擴展目錄Extend/Driver,包括數據庫驅動、緩存驅動、標簽庫驅動和模板引擎驅動。
### 數據庫驅動
數據庫抽象層的設計是由抽象數據庫類(Db)和數據庫驅動類組成的,內置的數據庫驅動是MySQL和MySQLi驅動類,官方的擴展還提供了MsSQL、PgSQL、Sqlite、Oracle、Ibase、Mongo以及PDO驅動類,可以滿足常用的數據庫操作的需要。
數據庫驅動擴展目錄位于系統擴展目錄Extend/Driver/Db,如果需要擴展其他的數據庫驅動類,只需要繼承Db類,驅動類的命名規范是:
Db+驅動類名稱(首字母大寫)
例如,假如你需要擴展一個ODBC的數據庫驅動,應該命名為:DbOdbc.class.php,并放到系統擴展目錄 Extend/Driver/Db目錄下面。`Class?DbOdbc??extends?Db{
}`每個數據庫驅動必須要實現的方法包括(具體參數可以參考現有的數據庫驅動類庫):
| 驅動方法 | 方法說明 |
|-----|-----|
| 架構方法 | __construct($config='') |
| 數據庫連接方法 | connect($config='',$linkNum=0,$force=false) |
| 釋放查詢方法 | free() |
| 查詢操作方法 | query($str) |
| 執行操作方法 | execute($str) |
| 開啟事務方法 | startTrans() |
| 事務提交方法 | commit() |
| 事務回滾方法 | rollback() |
| 獲取查詢數據方法 | getAll() |
| 獲取字段信息方法 | getFields($tableName) |
| 獲取數據庫的表 | getTables($dbName='') |
| 關閉數據庫方法 | close() |
| 獲取錯誤信息方法 | error() |
| SQL安全過濾方法 | escapeString($str) |
數據庫的CURD接口方法(通常這些方法無需重新定義)
| 方法 | 說明 |
|-----|-----|
| 寫入 | insert($data,$options=array(),$replace=false) |
| 更新 | update($data,$options) |
| 刪除 | delete($options=array()) |
| 查詢 | select($options=array()) |
介于不同數據庫的查詢方法存在區別,所以經常需要對查詢的語句進行重新定義,這就需要修改針對查詢的selectSql屬性。該屬性定義了當前數據庫驅動的查詢表達式,默認的定義是:
'SELECT%DISTINCT% %FIELD% FROM %TABLE%%JOIN%%WHERE%%GROUP%%HAVING%%ORDER%%LIMIT% %UNION%'
驅動可以更改或者刪除個別查詢定義,或者更改某個替換字符串的解析方法,這些方法包括:
| 方法名 | 說明 | 對應 |
|-----|-----|-----|
| parseTable | 數據庫表名解析 | %TABLE% |
| parseWhere | 數據庫查詢條件解析 | %WHERE% |
| parseLimit | 數據庫查詢Limit解析 | %LIMIT% |
| parseJoin | 數據庫JOIN查詢解析 | %JOIN% |
| parseOrder | 數據庫查詢排序解析 | %ORDER% |
| parseGroup | 數據庫group查詢解析 | %GROUP% |
| parseHaving | 數據庫having解析 | %HAVING% |
| parseDistinct | 數據庫distinct解析 | %DISTINCT% |
| parseUnion | 數據庫union解析 | %UNION% |
| parseField | 數據庫字段解析 | %FIELD% |
驅動的其他方法根據自身驅動需要和特性進行添加,例如,有些數據庫的特殊性,需要覆蓋父類Db類中的解析和過濾方法,包括:
| parseKey | 數據庫字段名解析 |
|-----|-----|
| parseValue | 數據庫字段值解析 |
| parseSet | 數據庫set分析 |
| parseLock | 數據庫鎖機制 |
定義了驅動擴展后,需要使用的時候,設置相應的數據庫類型即可:`'DB_TYPE'=>'odbc',?//?數據庫類型配置不區分大小寫`
### 緩存驅動
系統的緩存實現是由緩存類和緩存驅動組成,緩存驅動擴展位于Extend/Driver/Cache目錄下面,目前已經提供了包括APC、Db、Memcache、Shmop、Sqlite、Redis、Eaccelerator和Xcache緩存方式的驅動擴展,緩存驅動必須繼承Cache類,緩存驅動類的命名規范是:
Cache+驅動類名稱(首字母大寫)
并實現下面的驅動接口:
| 方法說明 | 接口方法 |
|-----|-----|
| 架構方法 | __construct($options='') |
| 讀取緩存 | get($name) |
| 寫入緩存 | set($name,$value,$expire=null) |
| 刪除緩存 | rm($name) |
| 清空緩存 | clear() |
注意:有些緩存方式并未提供清空緩存接口,可以無需定義。
所有緩存驅動的有效期參數約定,如果設置為0 則表示永久緩存。如果要讓緩存驅動支持緩存隊列功能,需要在緩存接口的set操作方法設置成功后添加如下代碼:`if($this->options['length']>0)?{
???????//?記錄緩存隊列
???????$this->queue($name);
}`
### Session驅動
新版支持對session 的hander驅動,可以通過驅動更改session的管理機制。Session驅動擴展目錄位于Extend/Driver/Session下面,命名規范是:
Session+驅動類名稱(首字母大寫)
并實現下面的驅動接口:
<table border="0" cellspacing="1" cellpadding="0"><tr><th>方法說明</th> <th>接口方法</th> </tr><tr><td>執行入口</td> <td>execute()并且在方法中調用session_set_save_handler函數指定hander操作機制</td> </tr><tr><td colspan="2">并建議添加下面的接口方法</td> </tr><tr><td>打開Session</td> <td>open($savePath,$sessionName)</td> </tr><tr><td>關閉Session</td> <td>close()</td> </tr><tr><td>讀取Session</td> <td>read($id)</td> </tr><tr><td>寫入Session</td> <td>write($id,$data)</td> </tr><tr><td>刪除Session</td> <td>destory($id)</td> </tr><tr><td>Session過期回收</td> <td>gc($maxlifetime)</td> </tr></table>
### 標簽庫驅動
任何一個模板引擎的功能都不可能是為你量身定制的,具有一個良好的可擴展機制也是模板引擎的另外一個考量,Smarty采用的是插件方法來實現擴展,ThinkTemplate由于采用了標簽庫技術,比Smarty提供了更為強大的定制功能,和Java的TagLibs一樣可以支持自定義標簽庫和標簽,每個標簽都有獨立的解析方法,所以可以根據標簽庫的定義規則來增加和修改標簽解析規則。在ThinkTemplate中標簽庫的體現是采用XML命名空間的方式。
每個標簽庫對應一個標簽庫驅動類,每個驅動類負責對標簽庫中的所有標簽的解析。標簽庫驅動類的作用其實就是把某個標簽定義解析成為有效的模版文件(可以包括PHP語句或者HTML標簽)。
系統的標簽庫驅動擴展目錄位于Extend/Driver/TagLib目錄下面,命名規范是:
TagLib+標簽庫名稱(首字母大寫)
目前已經提供了Html標簽庫驅動支持,標簽庫驅動擴展必須繼承TagLib類,例如我們擴展一個Test標簽庫:`Class?TagLibTest?extends?TagLib{}`首先需要定義標簽庫的標簽定義,標簽定義包含了所有標簽庫中支持的所有標簽,定義方式如下:`protected?$tags???=??array(
??//?定義標簽
'input'=>array('attr'=>'type,name,id,value','close'=>0),?//?input標簽
);`標簽庫的所有支持標簽都在tags屬性中進行定義,tags屬性是一個二維數組,每個元素就是一個標簽定義,索引名就是標簽名,采用小寫定義,調用的時候不區分大小寫。
每個標簽定義支持的屬性包括:
| 屬性名 | 說明 |
|-----|-----|
| attr | 標簽支持的屬性列表,用逗號分隔 |
| close | 標簽是否為閉合方式?(0閉合?1不閉合),默認為不閉合 |
| level | 標簽的嵌套層次(只有不閉合的標簽才有嵌套層次) |
| alias | 標簽別名 |
定義了標簽屬性后,就需要定義每個標簽的解析方法了,每個標簽的解析方法在定義的時候需要添加“_”前綴,可以傳入兩個參數,屬性字符串和內容字符串(針對非閉合標簽)。必須通過return 返回標簽的字符串解析輸出,在標簽解析類中可以調用模板類的實例。下面是一個input解析方法的定義:
`public?function?_input($attr,$content)???{
????????$tag????=?$this->parseXmlAttr($attr,'input');
????????$name???=???$tag['name'];
????????$id????=????$tag['id'];
????????$type???=???$tag['type'];
????????$value???=???$this->autoBuildVar($tag['value']);
????$str?=?'';
????????return?$str;
????}`在每個標簽的解析方法中,首先需要調用`?$this->parseXmlAttr($attr,'input');`表示分析input標簽的標簽定義,并返回input的所有標簽屬性。接下來就是根據具體的屬性值來返回實際的解析內容了。由于是示例,我們沒有對標簽中的全部變量進行解析,只是支持了value屬性的變量傳入。
定義好標簽庫擴展之后,我們就可以在模板中使用了,首先我們必須要告訴模板申明Test標簽庫,用taglib標簽,例如:`<taglib?name='Test'?/>`name屬性支持申明多個標簽庫,用逗號分隔即可。申明Test標簽庫之后,就可以使用Test標簽庫中的所有標簽庫了,調用方式如下:`<test:input?type='radio'?id='test'?name='mail'value='value'?/>`注意:調用擴展標簽庫的標簽的時候,必須加上標簽庫的XML命名空間前綴。
由于我們定義的input標簽是閉合標簽,如果是非閉合方式的話,應該是寫成:`<test:input?type='radio'?id='test'?name='mail'?value='value'></test:input>`Input標簽定義value屬性可以支持變量傳入,所以value被認為是一個變量名,如果在Action中已經給value模板變量賦值,例如:`$this->assign('value','my?test?value');`最后標簽被模板引擎編譯后,就會輸出:`<input?type='radio'?id='test'?name='mail'?value='my?test?value'/>`
### 模板引擎驅動
系統支持模板引擎的擴展機制,模板引擎驅動的擴展目錄位于Extend/Driver/Template下面,并且命名規范為:
Template+模板引擎名(首字母大寫)
模板引擎驅動不需要繼承任何類庫,并且只需要實現一個接口方法:
<table border="0" cellspacing="1" cellpadding="0"><tr><th>接口說明</th> <th>使用說明</th> </tr><tr><td>渲染模板輸出</td> <td>fecth($tempateFie,$var)<br/>tempateFie表示要解析的模板文件名<br/>var表示要傳入的模板變量數組</td> </tr></table>
官方目前已經提供了包括Smarty、EaseTemplate、TemplateLite和Smart在內的第三方模板引擎擴展。
模板引擎擴展必須要配合第三方類庫一起使用,我們以Smarty模板引擎為例,來說明下如何使用第三方模板引擎。首先,下載最新的Smarty模板引擎文件放到系統目錄的Vendor第三方類庫目錄下面,建立Smarty子目錄。
然后,修改項目配置文件,把模板引擎改為擴展的模板引擎名:`'TMPL_ENGINE_TYPE'?=>'Smarty'`就可以用smarty標簽來定義你的模板文件了,改變模板引擎驅動并不會影響系統內部的模板變量輸出和模板文件定位,例如我們在上面提到的用assign賦值模板變量、display和fetch方法的使用、模板文件的定位規則、模板替換功能仍然都可以使用。
對于某些第三方的模板引擎,還可以用TMPL_ENGINE_CONFIG參數進行自定義的配置。
例如對于Smarty模板引擎而言,我們可以進行下面的配置參數定義:`'TMPL_ENGINE_CONFIG'=>array(
????'caching'=>true,
????'template_dir'=>TMPL_PATH,
????'cache_dir'=>TEMP_PATH,
)`一般情況下,無需設置TMPL_ENGINE_CONFIG參數,模板引擎驅動已經有最適合的默認值了。
[上一頁](# "上一頁")[下一頁](# "下一頁")
- 序言
- 1. 入門
- 1.1 簡介
- 1.2 基礎概念
- 1.3 獲取ThinkPHP
- 1.4 環境要求
- 1.5 許可協議
- 1.6 目錄結構
- 1.7 命名規范
- 1.8 MVC分層
- 1.9 CBD架構
- 1.10 特性概述
- 1.11 系統流程
- 1.12 開發流程
- 2. 入口
- 2.1 入口文件
- 2.2 項目目錄
- 2.3 部署目錄
- 2.4 項目編譯
- 2.5 調試模式
- 3. 配置
- 3.1 配置格式
- 3.2 慣例配置
- 3.3 項目配置
- 3.4 調試配置
- 3.5 分組配置
- 3.6 讀取配置
- 3.7 動態配置
- 3.8 擴展配置
- 4. 函數和類庫
- 4.1 函數庫
- 4.2 類庫
- 5. 控制器
- 5.1 URL模式
- 5.2 模塊和操作
- 5.3 定義控制器
- 5.4 空操作
- 5.5 空模塊
- 5.6 模塊分組
- 5.7 URL偽靜態
- 5.8 URL路由
- 5.9 URL重寫
- 5.10 URL生成
- 5.11 URL大小寫
- 5.12 前置和后置操作
- 5.13 跨模塊調用
- 5.14 頁面跳轉
- 5.15 重定向
- 5.16 獲取系統變量
- 5.17 判斷請求類型
- 5.18 獲取URL參數
- 5.19 AJAX返回
- 5.20 Action參數綁定
- 5.21 多層控制器支持
- 6. 模型
- 6.1 模型定義
- 6.2 模型實例化
- 6.3 字段定義
- 6.4 數據主鍵
- 6.5 屬性訪問
- 6.6 跨庫操作
- 6.7 連接數據庫
- 6.8 切換數據庫
- 6.9 分布式數據庫
- 6.10 創建數據
- 6.11 字段映射
- 6.12 連貫操作
- 6.13 CURD操作
- 6.14 ActiveRecord
- 6.15 自動驗證
- 6.16 命名范圍
- 6.17 自動完成
- 6.18 查詢語言
- 6.19 查詢鎖定
- 6.20 字段排除
- 6.21 事務支持
- 6.22 高級模型
- 6.23 視圖模型
- 6.24 關聯模型
- 6.25 Mongo模型
- 6.26 動態模型
- 6.27 虛擬模型
- 6.28 多層模型支持
- 7. 視圖
- 7.1 模板定義
- 7.2 模板賦值
- 7.3 模板輸出
- 7.4 模板替換
- 7.5 獲取內容
- 7.6 模板引擎
- 7.7 布局模板
- 8. 模板引擎
- 8.1 變量輸出
- 8.2 系統變量
- 8.3 使用函數
- 8.4 默認值輸出
- 8.5 使用運算符
- 8.6 內置標簽
- 8.7 包含文件
- 8.8 導入文件
- 8.9 Volist標簽
- 8.10 Foreach標簽
- 8.11 For標簽
- 8.12 Switch標簽
- 8.13 比較標簽
- 8.14 三元運算
- 8.15 范圍判斷標簽
- 8.16 Present標簽
- 8.17 Empty標簽
- 8.18 Defined標簽
- 8.19 Define標簽
- 8.20 Assign標簽
- 8.21 IF標簽
- 8.22 標簽嵌套
- 8.23 使用PHP代碼
- 8.24 模板布局
- 8.25 模板繼承
- 8.26 原樣輸出
- 8.27 模板注釋
- 8.28 引入標簽庫
- 8.29 修改定界符
- 8.30 避免JS混淆
- 9. 日志
- 9.1 日志級別
- 9.2 記錄方式
- 9.3 手動記錄
- 10. 錯誤
- 10.1 異常處理
- 10.2 異常模板
- 10.3 異常顯示
- 11. 調試
- 11.1 運行狀態
- 11.2 頁面Trace
- 11.3 調試方法
- 12. 緩存
- 12.1 緩存方式
- 12.2 動態緩存
- 12.3 緩存隊列
- 12.4 快捷緩存
- 12.5 快速緩存
- 12.6 查詢緩存
- 12.7 SQL解析緩存
- 12.8 靜態緩存
- 13. 擴展
- 13.1 行為擴展
- 13.2 類庫擴展
- 13.3 控制器擴展
- 13.4 模型擴展
- 13.5 驅動擴展
- 13.6 Widget擴展
- 13.7 模式擴展
- 13.8 引擎擴展
- 14. 安全
- 14.1 表單令牌
- 14.2 字段類型驗證
- 14.3 防止SQL注入
- 14.4 輸入過濾
- 14.5 上傳安全
- 14.6 防止XSS攻擊
- 14.7 其他安全建議
- 14.8 目錄安全文件
- 14.9 保護模板文件
- 15. 性能
- 15.1 關閉調試模式
- 15.2 開啟緩存
- 15.3 合并字段緩存
- 15.4 優化SQL
- 15.5 替換入口
- 15.6 前端優化
- 16. 部署
- 16.1 PATH_INFO支持
- 16.2 隱藏index.php
- 16.3 二級域名部署
- 16.4 定制錯誤頁面
- 16.5 設置時區
- 17. SAE支持
- 17.1 SAE介紹
- 17.2 獲取SAE
- 17.3 SAE開發
- 18. REST支持
- 18.1 REST介紹
- 18.2 REST模式
- 18.3 REST配置
- 18.4 REST路由
- 18.5 REST方法
- 19. 雜項
- 19.1 Session支持
- 19.2 Cookie支持
- 19.3 日期和時間
- 19.4 WML開發
- 19.5 多語言
- 19.6 數據分頁
- 19.7 文件上傳
- 19.8 驗證碼
- 19.9 圖片添加水印
- 19.10 IP獲取和定位
- 20. 附錄
- 20.1 常量參考
- 20.2 配置參考
- 20.3 關于升級
- 20.4 大事記
- 鳴謝
- 關于