月度归档:2010年12月

数据库抽象层和Doctrine DBAL 源码简单分析

数据库抽象层和Doctrine DBAL 源码简单分析

【概述】
 数据库抽象层,顾名思义,将数据库抽象出来,作为一个独立的层存在。它存在的作用是当从一个数据库系统向另一个数据库系统迁移时,几乎不用更改太多的程序代码或者只是改一下配置文件,其它的工作都会交给数据库抽象层去做。数据库抽象层会根据使用的数据库自动调整,这样会提高开发效率,但是由于数据库抽象层是在数据库与业务之间增加了一个额外的代码层,从而可能会产生一些性能上的问题。因此,我们在使用一个数据抽象层之前需要按照自己的需求,权衡抽象层带来的性能和效率开销。
【Doctrine DBAL 简述】
Doctrine DBAL是一个轻量级的类似于PDO的数据库抽象接入层。它是一个面向对象的架构,需求PHP5.3版本的支持,因为它的实现用到了命名空间。除了类似于PDO的操作外,它允许人们定制属于自己的数据库支持。DBAL能够被用于ORM,这在Doctrine ORM项目中有体现。
【Doctrine DBAL源码综述】
以下是我在阅读完Doctrine DBAL后形成的文字。
整体结构:
Driver
包括DBAL目录下的Driver.php, DriverManager.php和Driver目录下的所有文件
如果要在DBAL下为一个新的数据库提供支持,在Driver这块需要实现下面的两个接口:
\Doctrine\DBAL\Driver\Driver
\Doctrine\DBAL\Driver\Statement
这两个接口的方法和PDO完全相同。
Driver.php中包含Driver接口,所有的Driver必须实现这个接口。
DriverManager.php是一个工厂类,它会根据不同的driver返回不同的Doctrine\DBAL\Connection实例。当然,它也可以返回我们自定义的Connection类实例。
Driver目录包括各数据库对Driver的实现以及公用的Connection接口,Statement接口等。如果要定制新的数据库支持,我们也需要在这个目录下创建一个新的目录,并在这个目录下实现Connection等接口。
PDOConnection.php文件和PDOStatement.php文件中的类是对于Connection接口及Statement接口的默认实现。

根目录下的Connection类实现了Doctrine\DBAL\Driver\Connection接口,并增加了事件,事务隔离级别,配置,模拟事务嵌套,延迟连接等功能
根目录下的Statement类实现了Doctrine\DBAL\Driver\Statement接口,并增加了日志,DBAL类型映射等功能。
Platform
Platform抽象了查询生成及不同的数据间的细微的差别。它将会被Schema和Statement等调用。
Platform的实现全部在Platform目录下,它会针对每个数据库支持实现不同的平台支持。它会在通过Driver中的getDatabasePlatform方法创建实例而进行初始化。不同的Driver调用对应的Platform。
Statement
Statement提供日志及类型的抽象转化功能集成,主要实现在根目录下的Statement.php文件

Schema
Schema抽象了生成表修改SQL的接口,这些修改操作的对象包括表,序列,外键和索引等。
它包括Schema目录下所有文件。
针对索引,表,外链等都有其独立实现,并且对于SchemaManager,各个数据库都有其不同的实现。
Type
Type抽象了所有数据库的类型,将各数据库的数据类型与DBAL中定义的类型一一对应。在程序调用时针根据选择的数据库映射到对应的类型。
它包括Type目录下的所有文件。所有的类型都继承自Type类。
Type的映射替换操作会在Statement绑定值和绑定参数时进行。
Log
Logging目录下所有文件
在2.0.0版本中仅包括SQLLogger接口,使用echo/var_dump输出日志的EchoSQLLogger类,包含执行过程中SQL的DebugStack类。
貌似这两个类都还在一个不完善的阶段。

Event
包括:
根目录下的Events.php文件
Event目录下的所有文件
Common目录下的EventArgs.php,EventManager.php,EventSubscriber.php文件
Events.php文件中的Event类是一个final类,它仅仅是一个包含所有事件的容器。在2.0.0版本中仅包含postConnect事件。
EventManager.php中的EventManager类是整个事件机制中非常重要的类,它负责整个事件的注册及事件的执行。对于postContent事件将会在Doctrine\DBAL\Connection的connect()方法中触发。
Event目录下的ConnectionEventArgs类负责与Connection的联系,它类似于一个中转站,在Doctrine\DBAL\Connection创建连接时会创建ConnectionEventArgs类的实例,并将Connection的实例作为构造方法的参数传递给ConnectionEventArgs实例。当事件触发时需要调用平台的数据库操作,则通过这个传递过来的Connection实例执行。Event目录下的Listeners目录是针对各个数据库平台的监听事件实现。

Exception
异常仅有根目录下的DBALException异常类。类中包含了若干静态方法,以显示不同的异常。对于这点,个人认为可以将不同的异常拆分成新的异常类,这比捕获DBALException异常后再调用相关的静态方法的扩展性会好一些。

Cache
缓存,这在每个系统或者每个大型架构中都会存在的模块。
在Common目录下的Cache文件夹包含了所有的缓存操作。这里提供了Apc,Array,Memcache,Xcache四种缓存。

【Doctrine DBAL调用过程】
以初始化一个连接,执行一条查询语句为例:

1
2
3
4
5
6
7
8
9
10
11
12
13
$config = new \Doctrine\DBAL\Configuration();
$connectionParams = array(
    'dbname' => 'mydb',
    'user' => 'user',
    'password' => 'secret',
    'host' => 'localhost',
    'driver' => 'pdo_mysql',
);
$conn = DriverManager::getConnection($connectionParams);
 
$statement = $conn->prepare('SELECT * FROM user');
$statement->execute();
$users = $statement->fetchAll();

第1~9行,配置并通过一个DriverManager创建一个Connection。这是一个工厂方法,它会依据driver调用不同的Driver类,这里会调用 Doctrine\DBAL\Driver\PDOMySql\Driver类,创建mysql的Driver。它会创建包装器实例,默认情况下是Doctrine\DBAL\Connection,我们可以通过在函数的参数中指定wrapperClass,从而创建自定义的包装器。最后返回一个包装类的实现。
第11行,调用Connection的prepare准备SQL语句,这里它会连接数据库,在连接时会依据Driver的不同,连接不同的数据库,并且会触发定义在connect方法中的Events::postConnect事件。最后,返回一个创建的Statement实例。
第12行,调用Statement的execute方法。在这个方法中会调用Log模块,记录SQL的日志,并且通过包装器中转调用相对应数据库的Statement实例的execute方法。
第13行,取数据。和上面的execute类似,调用对应Satement实例的fetchAll方法返回数据。

–EOF–

思考PHP语言四:接口和抽象类

思考PHP语言四:接口和抽象类
【概述】
在写PHP的日子里,我们多是按照需求完成相关功能,对于一些设计的工作较少的接触,也许是PHP的历史遗留问题或者其它,对于PHP的接口与抽象类使用得较少,但是对于一个支持面向对象的语言,接口与抽象是两个非常重要的内容。这里我们介绍接口与抽象类的一些基础知识,思考一些关于面向对象的东西。
【接口】
接口是一些方法特征的集合,这里的方法没有实现,只有声明。如果一个类继承了某个接口,则需要实现这个接口的所有方法。接口除了声明方法外,还可以定义常量。如下所示:

1
2
3
4
interface IFoo {
	const CONST_VAR = 'martin';
	public function method($str);
}

接口中方法的声明需要包含方法的名称,参数。不用包含参数类型和返还类型(PHP的函数本来就不用定义参数类型和返还类型)。
接口的方法只能是public,这说明接口本身包含的对外开放的意义在访问控制中体现出来了,并且当我们实现接口的方法时,也不能修改方法的访问控制权限。

接口是可以继承的,接口可以继承接口(和类继承一样,使用extends关键字),类可以继承接口(我们称之为接口继承,用implements关键字)

实现同一个接口的两个类可能功能完全不同,但是他们有相同的方法以及方法参数,并且都是公开的,从而他们可以提供相类似的服务,从而具有相同的接口。

接口的可插入性
在一个拥有多个层次结构的类组织中,如果要给某个处于中间位置的类添加父类,如果我们没有接口,则我们需要修改这个类的所有父类,打乱整个类的层次结构。当有了接口后,任何一个类都可以实现一个接口,此时,接口不会影响父类,但是会影响所有的子类,此类将必须实现这个接口的所有方法(抽象类可以不用实现所有方法,只是将实现下移到子类),子类则可以自动从此类继承实现后的方法。这就是接口的可插入性。

接口通常被用来声明一个新的类型,并且会作为一个类组织结构的起点,特别是当某个实体属于多个类型时,此时接口的作用就体现出来了。另外,理想情况下(现实中没发现过)一个类只应该实现接口或抽象类所声明的方法,纯理想呵。

【抽象类】
抽象类是类的一种,通过在类定义前添加abstract关键字实现。如下示例:

1
2
3
abstract class AbstarctFoo {
	abstract public function method();
}

抽象类不能实例化,一般作为类组织结构中枝节点或根节点存在。
抽象类提供一个类型的部分实现,抽象类可以有实例变量,可以有构造方法,可以有抽象方法,同时也可以有具体的方法实现。抽象类的构造方法可以被子类调用,只是需要显式调用。
我们在做设计时需要注意的是一般不要从具体类继承,具体类是用来实例化的。
在类的组织结构中,一般抽象类是枝节点,具体类是叶节点,在设计结构时应该尽量将公共代码放到作为父类的抽象类中,这样可以提高代码的复用性,与公共代码的移动相反,数据应该尽量放到具体类。
在继承过程中,子类的责任是扩展父类,而不是置换或取消掉父类的职责,当有取消或置换父类的职责的情况发生时,此时可能你的设计有问题了,需要考虑他们是否是is-a的关系?
抽象类和接口有相同的方法时
在PHP中,如果一个类继承了一个抽象类并且实现了一个接口,如果此时这个抽象类和接口中有相同名称的方法,则此时对于接口的实现会报错。与此相同,当一个抽象类实现一个接口时,如果接口已经声明了方法A,则在抽象方法中将不能再次声明此方法。

思考PHP语言三:异常处理

思考PHP语言三:异常处理
【概述】
异常处理是指在语言中能够使程序按照一种标准的方法对于某些运行时错误和其他程序所检测到的异常事件做出反应。异常发生的时间是不可以确定的,如果一种语言不包括异常处理机制,这就会给语言带来额外的复杂性。
一般来说,对于异常的处理有三种方案:
1、将一个额外的参数作为状态变量,通过标记这个状态值判断是否发生了异常。在C的标准库中许多函数使用返回值作为出错的状态变量。
2、将一个标号参数传给子程序,当异常发生时,通过标号将程序调用跳转到程序中的不同位置
3、将一个异常处理独立出来,作为专门的子程序或类存在。

在基于C的语言中,将异常出现称之为thrown,而不是raise,是因为在标准的C程序库中已经存在一个叫做raise的函数。
在PHP5中使用第3种方式。
【PHP中的异常处理】
在PHP5以后,PHP添加了异常处理模块。PHP的异常处理模块与java有一些类似,异常可被 throw 语句抛出并被 catch 语句捕获。需要进行异常处理的代码都必须放入 try 代码块内,以便捕获可能存在的异常。每一个 try 至少要有一个与之对应的 catch。使用多个 catch 可以捕获不同的类所产生的异常(嗯,这里没有throws子句)。当 try 代码块不再抛出异常或者找不到 catch 能匹配所抛出的异常时,PHP 代码就会在跳转到最后一个 catch 的后面继续执行。所以在安排catch的顺序时,需要将详细或子类的异常类放到前面。在有一些情况下,不管try子句是否抛出异常,也不管是否捕获了异常,程序都要执行一个过程,此时我们就需要finally子句,只是在PHP中并没有finally子句(HOHO)。
一个异常的简单示例:

1
2
3
4
5
try {
	throw new Exception("error msg");
}catch(Exception $e) {
	 echo 'Caught exception: ',  $e->getMessage(), "\n";
}

PHP提供了Exception类,以及在SPL中提供了一些内置的异常类,我们可以通过继承Exception类而实现属于自己的异常类。在一个面向对象系统的设计中我们需要考虑关于错误的处理情况,是以PHP的内部错误报告,还是以异常的方式给出,此时我们需要规划一套专属于我们系统的异常子系统。并且对于PHP的内部错误报告我们可以使用ErrorException进行转换,如下所示帮助文档中的代码:

1
2
3
4
5
6
7
function exception_error_handler($errno, $errstr, $errfile, $errline ) {
    throw new ErrorException($errstr, 0, $errno, $errfile, $errline);
}
set_error_handler("exception_error_handler");
 
/* Trigger exception */
strpos();

【断言】
断言常常被用于防错性的程序设计。在一个程序中可以有多条断言,以便确保程序计算的正确性。
PHP提供了assert函数,当执行到此函数时,如果条件为真,则什么都不执行,如果条件为假,则警告并中断程序: Warning: assert() [function.assert]: Assertion failed
经常我们会用echo或die来调试我们的程序,在调试完后我们需要删除相关调试代码。使用assert语句可以在出现问题时将程序调用,而不需要在后面将这些断言删除,这样可以节省删除操作并且在以后的维护过程中也可以重用这些语句,这里就有点测试的感觉了。
当然,我们也可以将断言和异常一起使用,如下所示代码:

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
 
/**
 * 断言回调函数,抛出异常
 */
function assert_callcack() {
    throw new Exception("msg");
}
 
// Set our assert options
assert_options(ASSERT_ACTIVE,   true);
assert_options(ASSERT_BAIL,     true);
assert_options(ASSERT_WARNING,  true); // 必须为true
assert_options(ASSERT_CALLBACK, 'assert_callcack');
 
/* 触发一个断言*/
assert(0);
 
echo 'Never reached';

断言和异常的结合处在于断言的回调函数,只是需要注意的是:assert_options(ASSERT_WARNING, true);
因为断言的错误级别为warning。