目前项目中选用的开发框架是Laravel4,经过几天的阅读源码以及看社区教程,发现是比较先进和强大的框架.
只是对新手入门这块做的很不给力,虽然官方文档在中文化上比较完整,但是相应的文档都是浅尝辄止,项目中用到的东西讲到的都比较少....
为了方便开发测试,所以把firephp予以集成,具体读源码找文档的时间就不说了,大致如下,在 app/start/global.php 文件中加入行:
Log::getMonolog()->pushHandler(new FirePHPHandler(Logger::DEBUG));
然后在代码中使用Log类就能输出结果...
另外对其db查询器使用不是很赶趟,项目组中的妹子也不会用,所以我把AertDb单独领出来做成了插件形式...
<?php
/**
* laravel Db 简化类
*
* @author xuxiaohan
*/
class Aert_DbRepo
{
private static $_ds_instances = array();
/**
* 为特定存储域选择匹配的存储服务实例
*
* @param string $domain
*
* @return Aert_Db_Query
*/
static function queryNode($domain='')
{
$name = empty($domain) ? 'default' : trim($domain);
if (!isset(self::$_ds_instances[$name]))
{
$dbo = empty($domain) ? DB::connection() : DB::connection($domain);
self::$_ds_instances[$name] = new Aert_Db_Query($dbo);
}
return self::$_ds_instances[$name];
}
/**
* 返回数据库可以接受的日期格式
*
* @param int $timestamp
* @return string
*/
static function dbTimeStamp($timestamp)
{
return date('Y-m-d H:i:s', $timestamp);
}
/**
* 打印输出结果
*
* @param mixed $vars
* @param string $label
* @param bool $return
*
* @return String
*/
static function dump($vars, $label = '', $return = false)
{
$content = "<pre>\n";
if ($label != '') {
$content .= "<strong>{$label} :</strong>\n";
}
$content .= htmlspecialchars(print_r($vars, true),ENT_COMPAT | ENT_IGNORE);
$content .= "\n</pre>\n";
if ($return) { return $content; }
echo $content;
}
}
/**
* 查询接口
*/
class Aert_Db_Query
{
/**
* Db_Actor 对象
*
* @var Aert_Db_Actor
*/
private $actor;
function __construct($dbo)
{
$this->dbo = $dbo;
$this->ds = new Aert_Db_DataSource( $dbo->getPdo() );
$this->actor = new Aert_Db_Actor($this->ds);
}
/**
* 返回数据源对象
*
* @return Aert_Db_DataSource
*/
function getDataSource()
{
return $this->ds;
}
/**
* 从表中检索符合条件的一条记录
*
* @param string $table
* @param mixed $cond
* @param string $fields
* @param string $sort
*
* @return array
*/
function selectRow($table ,$cond=null ,$fields='*', $sort=null)
{
$cond = Aert_Db_SqlHelper::parseCond($this->ds,$cond);
if ($cond) $cond = "WHERE {$cond}";
if ($sort) $sort = "ORDER BY {$sort}";
$qfields = Aert_Db_SqlHelper::qfields($fields,$table);
return $this->actor->read(Aert_Db_Actor::MODE_READ_GETROW, array(
"SELECT {$qfields} FROM {$table} {$cond} {$sort}"
));
}
/**
* 从表中检索符合条件的多条记录
*
* @param string $table
* @param mixed $cond
* @param string $fields
* @param string $sort
* @param int|array $limit 数组的话遵循格式 ( offset,length )
* @param bool $calc_total 计算总个数
*
* @return array
*/
function select($table, $cond=null, $fields='*', $sort=null, $limit=null, $calc_total=false)
{
$cond = Aert_Db_SqlHelper::parseCond($this->ds,$cond);
if ($cond) $cond = "WHERE {$cond}";
if ($sort) $sort = "ORDER BY {$sort}";
$qfields = Aert_Db_SqlHelper::qfields($fields,$table);
$table = Aert_Db_SqlHelper::qtable($table);
return $this->actor->read(Aert_Db_Actor::MODE_READ_GETALL, array(
"SELECT {$qfields} FROM {$table} {$cond} {$sort}",
empty($limit) ? false : $limit,
$calc_total
));
}
/**
* 统计符合条件的记录的总数
*
* @param string $table
* @param mixed $cond
* @param string|array $fields
* @param boolean $distinct
*
* @return int
*/
function count($table, $cond=null, $fields='*', $distinct=false)
{
if ($distinct) $distinct = 'DISTINCT ';
$cond = Aert_Db_SqlHelper::parseCond($this->ds,$cond);
if ($cond) $cond = "WHERE {$cond}";
if (is_null($fields) || trim($fields) == '*') {
$fields = '*';
}
else {
$fields = Aert_Db_SqlHelper::qfields($fields,$table);
}
$table = Aert_Db_SqlHelper::qtable($table);
return (int) $this->actor->read(Aert_Db_Actor::MODE_READ_GETONE, array(
"SELECT COUNT({$distinct}{$fields}) FROM {$table} {$cond}"
));
}
/**
* 插入一条记录
*
* @param string $table
* @param array $row
* @param bool $pkval 是否获取插入的主键值
*
* @return mixed
*/
function insert($table, array $row, $pkval=false)
{
list($holders, $values) = Aert_Db_SqlHelper::placeholder($row);
$holders = implode(',', $holders);
$fields = Aert_Db_SqlHelper::qfields(array_keys($values));
$table = Aert_Db_SqlHelper::qtable($table);
return $this->actor->write(Aert_Db_Actor::MODE_WRITE_INSERT, array(
Aert_Db_SqlHelper::bind($this->ds, "INSERT INTO {$table} ({$fields}) VALUES ({$holders})", $row),
$pkval
));
}
/**
* 更新表中记录
*
* @param string $table
* @param array $row
* @param mixed $cond 条件
*
* @return int
*/
function update($table, array $row, $cond=null)
{
if ( empty($row) ) return false;
list($pairs, $values) = Aert_Db_SqlHelper::placeholderPair($row);
$pairs = implode(',', $pairs);
$table = Aert_Db_SqlHelper::qtable($table);
$sql = Aert_Db_SqlHelper::bind($this->ds, "UPDATE {$table} SET {$pairs}", $row);
$cond = Aert_Db_SqlHelper::parseCond($this->ds, $cond);
if ($cond) $sql .= " WHERE {$cond}";
return $this->actor->write(Aert_Db_Actor::MODE_WRITE_UPDATE, array(
$sql
));
}
/**
* 删除 表中记录
*
* @param string $table
* @param mixed $cond
*
* @return int
*/
function del($table, $cond=null)
{
$cond = Aert_Db_SqlHelper::parseCond($this->ds, $cond);
$table = Aert_Db_SqlHelper::qtable($table);
$sql = "DELETE FROM {$table} " . (empty($cond) ? '' : "WHERE {$cond}");
return $this->actor->write(Aert_Db_Actor::MODE_WRITE_DELETE, array(
$sql
));
}
/**
* 向表中 某字段的值做 "加"运算
*
* @param string $table
* @param string $field
* @param int $incr
* @param mixed $cond
*
* @return int
*/
function incrField($table, $field, $incr=1, $cond=null)
{
if ( empty($field) ) return false;
$table = Aert_Db_SqlHelper::qtable($table);
$field = Aert_Db_SqlHelper::qfield($field);
$sql = "UPDATE {$table} SET {$field}={$field}+{$incr}";
$cond = Aert_Db_SqlHelper::parseCond($this->ds, $cond);
if ($cond) $sql .= " WHERE {$cond}";
return $this->actor->write(Aert_Db_Actor::MODE_WRITE_UPDATE, array(
$sql
));
}
}
class Aert_Db_Actor
{
/**
* 读 记录集
*/
const MODE_READ_GETALL = 1;
/**
* 读 第一条记录
*/
const MODE_READ_GETROW = 2;
/**
* 读 第一条记录的第一个字段
*/
const MODE_READ_GETONE = 3;
/**
* 读 记录集的指定列
*/
const MODE_READ_GETCOL = 4;
/**
* 读 记录集的总个数
*/
const MODE_READ_ALLCOUNT = 5;
/**
* 写 (插入) 操作
*/
const MODE_WRITE_INSERT = 11;
/**
* 写 (更新) 操作
*/
const MODE_WRITE_UPDATE = 12;
/**
* 写 (删除) 操作
*/
const MODE_WRITE_DELETE = 13;
/**
* 数据源对象
*
* @var Aert_Db_DataSource
*/
private $ds;
function __construct(Aert_Db_DataSource $ds)
{
$this->ds = $ds;
}
/**
* 执行 读 操作
*
* @param string $mode 模式 [MODE_READ_GETALL,MODE_READ_GETROW,MODE_READ_GETONE,MODE_READ_GETCOL]
* @param mixed $arguments 参数[不同模式参数不同,缺省为sql字符串]
* @param callback $cb 查询记录集的回调处理函数
*
* @return mixed
*/
function read($mode, $arguments, $cb=NULL){
$arguments = (array) $arguments;
$sql = array_shift($arguments);// 缺省第一个参数是sql字符串
switch ($mode){
case self::MODE_READ_GETALL: // array(sql,limit,counter),如果sql里面带了limit则不能使用counter
$limit = array_shift($arguments);
$counter = array_shift($arguments);
$result = null;
if ($counter)
{
$result = array(
'total' => $this->ds->count($sql),
);
}
if ($limit) $sql = $this->ds->sql_limit($sql, $limit);
if (is_array($result))
{
$result['rows'] = ($result['total'] == 0) ? array() : $this->ds->all($sql);
}
else
{
$result = $this->ds->all($sql);
}
break;
case self::MODE_READ_GETCOL:// array(sql,col,limit,counter) col 下标从 0开始 为第一列
$col = (int) array_shift($arguments);
$limit = array_shift($arguments);
$counter = array_shift($arguments);
$result = null;
if ($counter)
{
$result = array(
'total' => $this->ds->count($sql),
);
}
if ($limit) $sql = $this->ds->sql_limit($sql, $limit);
if (is_array($result))
{
$result['rows'] = ($result['total'] == 0) ? array() : $this->ds->col($sql,$col);
}
else
{
$result = $this->ds->col($sql,$col);
}
break;
case self::MODE_READ_GETROW:
$result = $this->ds->row($sql);
break;
case self::MODE_READ_GETONE:
$result = $this->ds->one($sql);
break;
case self::MODE_READ_ALLCOUNT:
$result = $this->ds->count($sql);
break;
default:
throw Exception("无效[r]: {$mode}");
}
return (empty($cb) || !is_callable($cb)) ? $result : call_user_func_array($cb,array($result));
}
/**
* 执行 更新/删除 操作
*
* @param string $mode 模式 [MODE_WRITE_INSERT,MODE_WRITE_UPDATE,MODE_WRITE_DELETE]
* @param mixed $arguments 参数[不同模式参数不同,缺省为sql字符串]
* @param callback $cb 查询结果集的回调处理函数
*
* @return mixed
*/
function write($mode, $arguments, $cb=NULL){
$arguments = (array) $arguments;
$sql = array_shift($arguments);// 缺省第一个参数是sql字符串
$this->ds->execute($sql);
switch ($mode){
case self::MODE_WRITE_INSERT: // 插入操作可选 得到主键标识
$id = array_shift($arguments);
$result = $id ? $this->ds->insert_id() : $this->ds->affected_rows();
break;
case self::MODE_WRITE_UPDATE:
case self::MODE_WRITE_DELETE:
$result = $this->ds->affected_rows();
break;
default:
throw Exception("无效[w]: {$mode}");
}
return (empty($cb) || !is_callable($cb)) ? $result : call_user_func_array($cb,array($result));
}
}
/**
* Db 数据源
*/
class Aert_Db_DataSource
{
/**
* @var int
*/
private $query_count = 0;
/**
* @var PDO
*/
private $db;
/**
* @var int
*/
protected $affected_rows = 0;
function __construct(PDO $db)
{
$this->db = $db;
}
function begin()
{
$this->db->beginTransaction();
}
function commit()
{
$this->db->commit();
}
function rollback()
{
$this->db->rollBack();
}
function qstr($value)
{
if (is_int($value) || is_float($value)) { return $value; }
if (is_bool($value)) { return $value ? 1 : 0; }
if (is_null($value)) { return 'NULL'; }
return $this->db->quote($value);
}
function insert_id()
{
return $this->db->lastInsertId();
}
function affected_rows()
{
return $this->affected_rows;
}
function execute($sql, array $args = null)
{
$this->affected_rows = 0;
if (!empty($args)) {
$sql = Aert_Db_SqlHelper::bind($this, $sql, $args);
}
Log::debug($sql);
$result = $this->db->exec($sql);
$this->query_count++;
if ($result === false)
{
$error = $this->db->errorInfo();
throw new Exception("QUERY_FAILED: {$error[0]}/{$error[1]}, {$error[2]}\n{$sql}");
}
$this->affected_rows = $result;
}
/**
* @return PDOStatement
*/
private function query($sql)
{
Log::debug($sql);
$statement = $this->db->query($sql);
$this->query_count++;
if ($statement !== false) return $statement;
$error = $this->db->errorInfo();
throw new Exception("QUERY_FAILED: {$error[0]}/{$error[1]}, {$error[2]}\n{$sql}");
}
function all($sql)
{
$res = $this->query($sql);
/* @var $res PDOStatement */
$rowset = $res->fetchAll(PDO::FETCH_ASSOC);
$res = null;
return $rowset;
}
function one($sql)
{
$res = $this->query($sql);
/* @var $res PDOStatement */
$val = $res->fetchColumn(0);
$res = null;
return $val;
}
function row($sql)
{
$res = $this->query($sql);
/* @var $res PDOStatement */
$row = $res->fetch(PDO::FETCH_ASSOC);
$res = null;
return $row;
}
function col($sql, $col=0)
{
$res = $this->query($sql);
/* @var $res PDOStatement */
$rowset = $res->fetchAll(PDO::FETCH_ASSOC,$col);
$res = null;
return $rowset;
}
function count($sql)
{
return (int) $this->one("SELECT COUNT(*) FROM ( $sql ) AS t");
}
function sql_limit($sql, $limit)
{
if (empty($limit)) return $sql;
if (is_array($limit))
{
list($skip, $l) = $limit;
$skip = intval($skip);
$limit = intval($l);
}
else
{
$skip = 0;
$limit = intval($limit);
}
return "{$sql} LIMIT {$skip}, {$limit}";
}
}
class Aert_Db_SqlHelper
{
/**
* 根据 SQL 语句和提供的参数数组，生成最终的 SQL 语句
*
* @param Aert_Db_DataSource $ds
* @param string $sql
* @param array $inputarr
*
* @return string
*/
static function bind(Aert_Db_DataSource $ds, $sql, array $inputarr)
{
$arr = explode('?', $sql);
$sql = array_shift($arr);
foreach ($inputarr as $value) {
if (isset($arr[0])) {
$sql .= $ds->qstr($value) . array_shift($arr);
}
}
return $sql;
}
/**
* 解析查询条件
*
* @param Aert_Db_DataSource $ds
* @param mixed $cond
* @param bool $dash 是否使用括号将返回的条件包括起来
*
* @return string
*/
static function parseCond(Aert_Db_DataSource $ds, $cond, $dash=false)
{
if (empty($cond)) return '';
// 如果是字符串，则假定为自定义条件
if (is_string($cond)) return $cond;
// 如果不是数组，说明提供的查询条件有误
if (!is_array($cond)) return '';
static $equalIN = array('=','IN','NOT IN');
static $betweenAnd = array('BETWEEN_AND','NOT_BETWEEN_AND');
$where = '';$expr = '';
/**
* 不过何种条件形式，一律为 字段名 => (值, 操作, 连接运算符, 值是否是SQL命令) 的形式
*/
foreach ($cond as $field => $d) {
$expr = 'AND';
if (!is_string($field)) {
continue;
}
if (!is_array($d)) {
// 字段名 => 值
$d = array($d);
}
reset($d);
// 第一个元素是值
if (!isset($d[1])) { $d[1] = '='; }
if (!isset($d[2])) { $d[2] = $expr; }
if (!isset($d[3])) { $d[3] = false; }
list($value, $op, $expr, $isCommand) = $d;
$op = strtoupper(trim($op));
$expr = strtoupper(trim($expr));
if (is_array($value)){
do {
if (in_array($op, $equalIN)){
if ($op == '=') $op = 'IN';
$value = '(' . implode(',',array_map(array($ds, 'qstr'),$value)) . ')';
break;
}
if (in_array($op, $betweenAnd)){
$between = array_shift($value);
$and = array_shift($value);
$value = sprintf('BETWEEN %s AND %s',$ds->qstr($between),$ds->qstr($and));
$op = 'NOT_BETWEEN_AND' == $op ? 'NOT' : '';// 此处已经串在 $value 中了
break;
}
// 一个字段对应 多组条件 的实现,比如 a > 15 OR a < 5 and a != 32
// 'a' => array( array( array(15,'>','OR'),array(5,'<','AND'), array(32,'!=') ) , 'FIELD_GROUP')
if ($op == 'FIELD_GROUP'){
$kv = array();
foreach($value as $k => $v){
$kv[":+{$k}+:"] = $v;
}
$value = self::parseConditions($ds,$kv,true);
foreach(array_keys($kv) as $k){
$value = str_ireplace($k,$field,$value);
}
$field = $op = '';// 此处已经串在 $value 中了
break;
}
} while(false);
$isCommand = true;
}
if (!$isCommand) {
$value = $ds->qstr($value);
}
$where .= "{$field} {$op} {$value} {$expr} ";
}
$where = substr($where, 0, - (strlen($expr) + 2));
return $dash ? "({$where})" : $where;
}
static function qtable($table)
{
return "`{$table}`";
}
static function qfield($fieldName, $table = null)
{
$fieldName = ($fieldName == '*') ? '*' : "`{$fieldName}`";
return $table != '' ? self::qtable($table) . '.' . $fieldName : $fieldName;
}
static function qfields($fields, $table = null, $returnArray = false)
{
if (!is_array($fields)) {
$fields = explode(',', $fields);
$fields = array_map('trim', $fields);
}
$return = array();
foreach ($fields as $fieldName) {
$return[] = self::qfield($fieldName, $table);
}
return $returnArray ? $return : implode(', ', $return);
}
static function placeholder(& $inputarr, $fields = null)
{
$holders = array();
$values = array();
if (is_array($fields)) {
$fields = array_change_key_case(array_flip($fields), CASE_LOWER);
foreach (array_keys($inputarr) as $key) {
if (!isset($fields[strtolower($key)])) { continue; }
$holders[] = '?';
$values[$key] =& $inputarr[$key];
}
} else {
foreach (array_keys($inputarr) as $key) {
$holders[] = '?';
$values[$key] =& $inputarr[$key];
}
}
return array($holders, $values);
}
static function placeholderPair(& $inputarr, $fields = null)
{
$pairs = array();
$values = array();
if (is_array($fields)) {
$fields = array_change_key_case(array_flip($fields), CASE_LOWER);
foreach (array_keys($inputarr) as $key) {
if (!isset($fields[strtolower($key)])) { continue; }
$qkey = self::qfield($key);
$pairs[] = "{$qkey}=?";
$values[$key] =& $inputarr[$key];
}
} else {
foreach (array_keys($inputarr) as $key) {
$qkey = self::qfield($key);
$pairs[] = "{$qkey}=?";
$values[$key] =& $inputarr[$key];
}
}
return array($pairs, $values);
}
}
<?php
/**
* AertDb表模型 CRUD 包装器
*
* @author xuxiaohan
*/
class Aert_TObject
{
/**
* 数据库链接节点名
*
* 子类可以覆盖此属性
*
* @var string
*/
protected $queryNode = '';
/**
* 数据表名
*
* 子类可以覆盖此属性
*
* @var string
*/
protected $table;
/**
* 返回 对象实例
*
* @param string $table
* @param string $query_node
*
* @return Aert_TObject
*/
static function instance($table,$query_node='')
{
static $list = array();
$table = trim($table);
if ( empty($table) ) return null;
if (empty($list[$table]))
{
$list[$table] = new self();
$list[$table]->queryNode = $query_node;
$list[$table]->table = $table;
}
return $list[$table];
}
/**
* 从表中检索符合条件的多条记录
*
* @param mixed $cond
* @param string $fields
* @param string $sort
* @param int|array $limit 数组的话遵循格式 ( offset,length )
* @param bool $calc_total 计算总个数
*
* @return array
*/
function getAll($cond=null, $fields='*', $sort=null, $limit=null, $calc_total=false)
{
return Aert_DbRepo::queryNode($this->queryNode)->select($this->table,$cond, $fields, $sort, $limit, $calc_total);
}
/**
* 从表中检索符合条件的一条记录
*
* @param mixed $cond
* @param string $fields
* @param string $sort
*
* @return array
*/
function getOne($cond=null ,$fields='*', $sort=null)
{
return Aert_DbRepo::queryNode($this->queryNode)->selectRow($this->table,$cond, $fields, $sort);
}
/**
* 统计符合条件的记录的总数
*
* @param mixed $cond
* @param string|array $fields
* @param boolean $distinct
*
* @return int
*/
function count($cond=null, $fields='*', $distinct=false)
{
return Aert_DbRepo::queryNode($this->queryNode)->count($this->table,$cond, $fields, $distinct);
}
/**
* 插入一条记录
*
* @param array $row
* @param bool $pkval 是否获取插入的主键值
*
* @return mixed
*/
function insert(array $row, $pkval=false)
{
return Aert_DbRepo::queryNode($this->queryNode)->insert($this->table, $row, $pkval);
}
/**
* 更新表中记录,返回表中被更新行数
*
* @param array $row
* @param mixed $cond 条件
*
* @return int
*/
function update(array $row, $cond=null)
{
return Aert_DbRepo::queryNode($this->queryNode)->update($this->table, $row, $cond);
}
/**
* 删除 表中记录,返回表中被删除行数
*
* @param mixed $cond
*
* @return int
*/
function del($cond=null)
{
return Aert_DbRepo::queryNode($this->queryNode)->del($this->table, $cond);
}
/**
* 向表中 某字段的值做 "加"运算
*
* @param string $field
* @param int $incr
* @param mixed $cond
*
* @return int
*/
function incrField($field, $incr=1, $cond=null)
{
return Aert_DbRepo::queryNode($this->queryNode)->incrField($this->table, $field, $incr, $cond);
}
/**
* 向表中 某字段的值做 "减"运算
*
* @param string $field
* @param int $incr
* @param mixed $cond
*
* @return int
*/
function decrField($field, $decr=1, $cond=null)
{
return Aert_DbRepo::queryNode($this->queryNode)->incrField($this->table, $field, (-1 * $decr), $cond);
}
}
功能虽然木有那么强大,但是也应该能方便不少