Doctrine常用方法大全详细说明【原创】

Doctrine 是一个 PHP 的 ORM （对象关联映射框架），基于强大的 DBAL (数据库抽象层)。其中一个最主要的功能就是使用面向对象的方式执行数据库查询。
方法总结
public string
getDatabase( )
获取名称连接到数据库的连接.

Returns

string

$database
public string
getHost( )
当前连接数据库的主机名.

Returns

string

string
public mixed
getPort( )
获取当前连接数据库的端口.

Returns

mixed

mixed
public string
 getUsername( )
使用此连接的用户名.

Returns

string

string
public string
 getPassword( )
使用此连接的用户密码.

Returns

string

string
 public Doctrine\DBAL\Configuration
 getConfiguration( )

使用此连接的配置.
Returns

Doctrine\DBAL\Configuration

\Doctrine\DBAL\Configuration
 public boolean
 connect( )
建立与数据库的连接。

Returns

boolean

TRUE 如果成功建立连接, FALSE 如果连接已经打开.
 public array
 fetchAssoc( string $statement, array $params = array() )
准备并执行一个SQL查询并返回结果的第一行作为一个关联数组中.

Parameters
$statement
SQL查询.
$params
查询参数.
Returns

array

数组
 public array
 fetchArray( string $statement, array $params = array() )

准备并执行一个SQL查询并返回结果的第一行数字索引数组.

Parameters
$statement
要执行的sql查询
$params
事先准备好的声明中参数
Returns

array

数组
 public mixed
 fetchColumn( string $statement, array $params = array(), integer $colnum = 0 )

准备并执行一个SQL查询,并返回一个列的值结果的第一行.

Parameters
$statement
要执行的sql查询
$params
事先准备好的声明中参数
$colnum
从0开始索引列号检索
Returns

mixed

混合类型的值
 public boolean
 isConnected( )

是否实际的建立到数据库的连接.

Returns

boolean

boolean
 public integer
 delete( string $tableName, array $identifier )

在一个表里执行SQL删除语句.

Parameters
$tableName
$table 删除的表的名称.
$identifier
删除标准。关联数组包含列-值对。
Returns

integer

受影响的行数.
 public
 close( )

关闭连接.
 public integer
 update( string $tableName, array $data, array $identifier, array $types = array() )

在一个表里执行SQL更新语句.

Parameters
$tableName
$table 更新的表的名称.
$data
$identifier 更新标准。关联数组包含列-值对。
$identifier
$types 类型合并后的 $data 和 $identifier 数组的顺序.
$types
Returns

integer

受影响的行数.
 public integer
 insert( string $tableName, array $data, array $types = array() )

插入一个指定的数据表的行.

Parameters
$tableName
$table 将数据插入的表的名称.
$data
一个关联数组包含列-值对.
$types
插入的数据的类型.
Returns

integer

受影响的行数.
 public
 setCharset( string $charset )

在当前连接设置给定的字符集.

Parameters
$charset
字符集设置.
 public array
 fetchAll( string $sql, array $params = array() )

准备并执行一个SQL查询并返回结果作为一个关联数组中.

Parameters
$sql
SQL查询.
$params
查询参数.
Returns

array

数组
 public Doctrine\DBAL\Driver\Statement
 executeQuery( string $query, array $params = array(), array $types = array(), Doctrine\DBAL\Cache\QueryCacheProfile $qcp = null )

执行一个,可选参数化SQL查询。
如果参数化查询,一份事先准备好的声明中使用。如果一个SQLLogger配置,执行记录。
Parameters
$query
要执行的SQL查询.
$params
参数绑定到查询,如果有的话.
$types
前面的参数类型.
$qcp
Returns

Doctrine\DBAL\Driver\Statement

执行语句.
 public Doctrine\DBAL\Driver\Statement
 query( )

执行一条SQL语句,语句对象返回一个结果集.

Returns

Doctrine\DBAL\Driver\Statement

Doctrine\DBAL\Driver\Statement
Implementation of

Doctrine\DBAL\Driver\Connection::query()
 public integer
 executeUpdate( string $query, array $params = array(), array $types = array() )

执行一个SQL插入/更新/删除查询与给定的参数,并返回受影响的行数。
这种方法支持PDO绑定类型以及DBAL映射类型。
Parameters
$query
SQL查询.
$params
查询参数.
$types
参数类型.
Returns

integer

受影响的行数.
 public integer
 exec( string $statement )

执行一条SQL语句并返回受影响的行数.

Parameters
$statement
Returns

integer

受影响的行数.
Implementation of

Doctrine\DBAL\Driver\Connection::exec()
 public string
 lastInsertId( string $seqName = null )

返回ID的最后插入的行,或从序列对象,最后一个值取决于底层驱动程序。
注意:这个方法可能不会返回一个有意义的或一致的结果在不同的驱动程序,因为底层数据库甚至不支持AUTO_INCREMENT /标识列或序列的概念。
Parameters
$seqName
序列的名称应该返回对象的ID.
Returns

string

一个字符串表示最后插入的ID.
Implementation of

Doctrine\DBAL\Driver\Connection::lastInsertId()
 public
 commit( )

提交当前事务.

Throws

Doctrine\DBAL\ConnectionException

如果提交失败由于没有活动事务或只因为事务被标记为回滚.
Implementation of

Doctrine\DBAL\Driver\Connection::commit()
 public
 rollback( )

取消任何数据库变化在当前事务完成。
这种方法可以监听onPreTransactionRollback和onTransactionRollback eventlistener方法
Throws

Doctrine\DBAL\ConnectionException

如果回滚操作失败.