<?php
// +----------------------------------------------------------------------
// | ThinkPHP [ WE CAN DO IT JUST THINK IT ]
// +----------------------------------------------------------------------
// | Copyright (c) 2006-2014 http://thinkphp.cn All rights reserved.
// +----------------------------------------------------------------------
// | Licensed ( http://www.apache.org/licenses/LICENSE-2.0 )
// +----------------------------------------------------------------------
// | Author: liu21st <liu21st@gmail.com>
// +----------------------------------------------------------------------
namespace Think\Db\Driver;
use Think\Db\Driver;
/**
* Firebird数据库驱动
* Firebird特性介绍firebird是一个全功能的，强大高效的，轻量级，免维护的数据库。它很容易让您从单用户，单数据库升级到企业级的应用。 给中小型企业提供了一个很好的工具，一些需要小的数据库的软件!
*/
class Firebird extends Driver{
// 这个 生成的 sql 语句
protected $selectSql = 'SELECT %LIMIT% %DISTINCT% %FIELD% FROM %TABLE%%JOIN%%WHERE%%GROUP%%HAVING%%ORDER%';
/**
* 解析pdo连接的dsn信息
* @access public
* @param array $config 连接信息
* @return string
* 可以直接返回 dsn 系列
*/
protected function parseDsn($config){
$dsn = 'firebird:dbname='.$config['hostname'].'/'.($config['hostport']?:3050).':'.$config['database'];
return $dsn;
}
/**
* 执行语句
* @access public
* @param string $str sql指令
* @param boolean $fetchSql 不执行只是获取SQL
* @return mixed
* 这种铁定是执行语句了
*/
public function execute($str,$fetchSql=false) {
$this->initConnect(true);
if ( !$this->_linkID ) return false;
$this->queryStr = $str;
if(!empty($this->bind)){
$that = $this;
$this->queryStr = strtr($this->queryStr,array_map(function($val) use($that){ return '\''.$that->escapeString($val).'\''; },$this->bind));
}// 这个骨头其实我是没有啃懂
if($fetchSql){
return $this->queryStr;
}
//释放前次的查询结果
if ( !empty($this->PDOStatement) ) $this->free();
$this->executeTimes++;
N('db_write',1); // 兼容代码
// 记录开始执行时间
$this->debug(true); // 开启调试模式
$this->PDOStatement = $this->_linkID->prepare($str); // 数据准备
if(false === $this->PDOStatement) {
E($this->error());
}// 准备失败的话呢？
foreach ($this->bind as $key => $val) { // 如果还有一些其它的特殊的东西，特殊在来一次了
if(is_array($val)){
$this->PDOStatement->bindValue($key, $val[0], $val[1]);
}else{
$this->PDOStatement->bindValue($key, $val);
}
}
$this->bind = array(); // 清空 数据池子
$result = $this->PDOStatement->execute(); // 执行资源
$this->debug(false);// 结束调试
if ( false === $result) { //
$this->error();
return false;
} else {
$this->numRows = $this->PDOStatement->rowCount();// 返回影响行数
return $this->numRows;
}
}
// 搞定执行完成
// 值得注意的是，上面的那个是 $this-> 跟 系统提供的函数的一个区别，其实这个firebird so 难懂
/**
* 取得数据表的字段信息
* @access public
* 获取字段信息，这个在很早之前，其实，我不是很喜欢这个，因为他不是传统的 增删改查里面的一个语句
* 其实是个 mysql 类似于编辑跟配置的语句
*/
public function getFields($tableName) {
$this->initConnect(true);
list($tableName) = explode(' ', $tableName);
$sql='SELECT RF.RDB$FIELD_NAME AS FIELD,RF.RDB$DEFAULT_VALUE AS DEFAULT1,RF.RDB$NULL_FLAG AS NULL1,TRIM(T.RDB$TYPE_NAME) || \'(\' || F.RDB$FIELD_LENGTH || \')\' as TYPE FROM RDB$RELATION_FIELDS RF LEFT JOIN RDB$FIELDS F ON (F.RDB$FIELD_NAME = RF.RDB$FIELD_SOURCE) LEFT JOIN RDB$TYPES T ON (T.RDB$TYPE = F.RDB$FIELD_TYPE) WHERE RDB$RELATION_NAME=UPPER(\''.$tableName.'\') AND T.RDB$FIELD_NAME = \'RDB$FIELD_TYPE\' ORDER By RDB$FIELD_POSITION';
$result = $this->query($sql);
$info = array();// 好吧，上面的同学，你赢了，
if($result){
foreach($result as $key => $val){
$info[trim($val['field'])] = array( // 变成了一个统一的格式，这个我喜欢
'name' => trim($val['field']),
'type' => $val['type'],
'notnull' => (bool) ($val['null1'] ==1), // 1表示不为Null
'default' => $val['default1'],
'primary' => false,
'autoinc' => false,
);
}
}
//获取主键
$sql='select b.rdb$field_name as field_name from rdb$relation_constraints a join rdb$index_segments b on a.rdb$index_name=b.rdb$index_name where a.rdb$constraint_type=\'PRIMARY KEY\' and a.rdb$relation_name=UPPER(\''.$tableName.'\')';
$rs_temp = $this->query($sql);
foreach($rs_temp as $row) {
$info[trim($row['field_name'])]['primary']= true;
}
return $info;
}
// 哎呦，不错哦，就是那两个sql语句，我没怎么搞懂，哈哈
// 但是没什么关系了，第一获取了字段0语句的基本含义
// 第二：加 了个是否主键的一个判定
/**
* 取得数据库的表信息
* @access public
* 上面刚刚获取完成字段
* 下来就开始获取表了
*/
public function getTables($dbName='') {
$sql='SELECT DISTINCT RDB$RELATION_NAME FROM RDB$RELATION_FIELDS WHERE RDB$SYSTEM_FLAG=0';
$result = $this->query($sql);
$info = array();
foreach ($result as $key => $val) {
$info[$key] = trim(current($val));
//current — 返回数组中的当前单元
/**
$transport = array('foot', 'bike', 'car', 'plane');
$mode = current($transport); // $mode = 'foot';
*
*/
}
return $info;
}
//
/**
* SQL指令安全过滤
* @access public
* @param string $str SQL指令
* @return string
* 这个过滤，还是算是厉害的吧
*/
public function escapeString($str) {
return str_replace("'", "''", $str);
}
/**
* limit
* @access public
* @param $limit limit表达式
* @return string
*/
public function parseLimit($limit) {
$limitStr = '';
if(!empty($limit)) { // 这个我表示 秒不懂，哈哈
$limit = explode(',',$limit);
if(count($limit)>1) {
$limitStr = ' FIRST '.$limit[1].' SKIP '.$limit[0].' ';
}else{
$limitStr = ' FIRST '.$limit[0].' ';
}
}
return $limitStr;
}
}
// 总结，对于一个不是很常用的 firebird 看来，是没什么希望了
// 就是 解析了自己独有的部分，哈哈。
// 获取了 表单、字段、 处理了自己的特有的 条件限制语句，嘿嘿。
