PgsqlDriver
扩展 PdoDriverPostgreSQL PDO 数据库驱动
自 |
1.5.0 |
---|---|
包 |
Joomla 框架 |
方法
__construct
数据库对象构造函数
__construct(mixed||string|int options) :
自 |
1.5.0 |
---|
参数
- options
array<string|int, mixed>
用于配置连接的选项列表
返回值
混合
__destruct
析构函数。
__destruct() :
自 |
1.0 |
---|
返回值
混合
__get
用于访问数据库驱动程序属性的魔术方法。
__get( name) :
自 |
1.4.0 |
---|---|
已弃用 |
3.0 由于 $this->name 之前是公有的,因此这是一个向后兼容的代理 |
参数
- name
string
属性的名称。
返回值
mixed
如果属性名称有效,则为一个值,否则为 null。
__sleep
PDO 不支持序列化
__sleep() : mixed||string|int
自 |
1.0 |
---|
返回值
array<string|int, mixed>
__wakeup
序列化后唤醒
__wakeup() :
自 |
1.0 |
---|
返回值
空
alterDbCharacterSet
更改数据库的字符集。
alterDbCharacterSet( dbName) : bool|resource
自 |
2.0.0 |
---|---|
抛出 |
|
参数
- dbName
string
将要更改的数据库名称
返回值
布尔值 | 资源
connect
根据需要连接到数据库。
connect() :
自 |
1.5.0 |
---|---|
抛出 |
|
返回值
空
connected
确定与服务器的连接是否处于活动状态。
connected() :
自 |
1.0 |
---|---|
抛出 |
|
返回值
bool
如果已连接到数据库引擎,则为 True。
createDatabase
使用 $options 对象中的信息创建一个新的数据库。
createDatabase(\stdClass options, utf = true) : bool|resource
自 |
2.0.0 |
---|---|
抛出 |
|
参数
- options
stdClass
用于将用户和数据库名称传递给数据库驱动程序的对象。此对象必须设置“db_name”和“db_user”。- utf
bool
如果数据库支持 UTF-8 字符集,则为 True。
返回值
布尔值 | 资源
createQuery
创建一个新的 DatabaseQuery 对象。
createQuery() : \Joomla\Database\QueryInterface
decodeBinary
将表示二进制字段的特殊占位符替换为原始字符串。
decodeBinary(string|resource data) :
自 |
1.7.0 |
---|
参数
- data
string|resource
编码的字符串或资源。
返回值
string
原始字符串。
disconnect
断开数据库连接。
disconnect() :
自 |
2.0.0 |
---|
返回值
空
dispatchEvent
分派事件。
dispatchEvent(\Joomla\Event\EventInterface event) :
dropTable
从数据库中删除一个表。
dropTable( table, ifExists = true) :
自 |
2.0.0 |
---|---|
抛出 |
|
参数
- table
string
要删除的数据库表的名称。- ifExists
bool
可选地指定表必须存在才能删除。
返回值
$this
escape
用于转义 SQL 语句中使用的字符串的方法。
escape( text, extra = false) :
Oracle 转义参考:http://www.orafaq.com/wiki/SQL_FAQ#How_does_one_escape_special_characters_when_writing_SQL_queries.3F
SQLite 转义说明:http://www.sqlite.org/faq.html#q14
方法主体与 Zend Framework 中实现的方法相同
注意:使用具有绑定变量的查询对象优于以下方法。
自 |
1.0 |
---|
参数
- text
string
要转义的字符串。- extra
bool
未使用的可选参数,用于提供额外的转义。
返回值
string
转义后的字符串。
execute
执行 SQL 语句。
execute() :
自 |
1.0 |
---|---|
抛出 |
|
返回值
布尔值
fetchArray
用于从结果集游标中获取一行作为数组的方法。
fetchArray() :
自 |
1.0 |
---|
返回值
mixed
结果集中的下一行,或者如果没有更多行,则为 false。
fetchAssoc
用于从结果集游标中获取一行作为关联数组的方法。
fetchAssoc() :
自 |
1.0 |
---|
返回值
mixed
结果集中的下一行,或者如果没有更多行,则为 false。
fetchObject
用于从结果集游标中获取一行作为对象的方法。
fetchObject() :
注意,应在使用 StatementInterface::setFetchMode()
调用此方法之前配置获取模式。
自 |
1.0 |
---|
返回值
mixed
结果集中的下一行,或者如果没有更多行,则为 false。
freeResult
用于释放结果集使用的内存的方法。
freeResult() :
自 |
1.0 |
---|
返回值
空
getAffectedRows
获取先前执行的 SQL 语句的影响行数。
getAffectedRows() :
自 |
2.0.0 |
---|
返回值
int
先前操作中受影响的行数
getAlterDbCharacterSet
获取更改数据库字符集的查询字符串。
getAlterDbCharacterSet( dbName) :
自 |
1.5.0 |
---|
参数
- dbName
string
数据库名称
返回值
string
更改数据库查询字符串的查询
getCollation
用于获取数据库中使用的数据库排序规则的方法,方法是采样表中的文本字段。
getCollation() : string|bool
自 |
1.5.0 |
---|---|
抛出 |
|
返回值
string|bool
数据库中使用的排序规则,或者如果不受支持,则为布尔值 false。
getConnectedQuery
获取要运行并验证数据库是否可操作的查询。
getConnectedQuery() :
自 |
1.0 |
---|
返回值
string
用于检查数据库运行状况的查询。
getConnection
提供对底层数据库连接的访问的方法。
getConnection() :
自 |
1.0 |
---|
返回值
resource
底层数据库连接资源。
getConnectionCollation
用于获取数据库连接中使用的数据库排序规则的方法,方法是采样表中的文本字段。
getConnectionCollation() : string|bool
自 |
1.6.0 |
---|---|
抛出 |
|
返回值
string|bool
数据库连接中使用的排序规则(字符串),或者如果不受支持,则为布尔值 false。
getConnectionEncryption
用于获取正在使用的数据库加密详细信息(密码和协议)的方法。
getConnectionEncryption() :
自 |
2.0.0 |
---|---|
抛出 |
|
返回值
string
数据库加密详细信息。
getConnectors
获取可用数据库连接器的列表。
getConnectors() : mixed||string|int
此列表仅填充存在类的连接器以及环境支持其使用的连接器。这使我们能够拥有多个连接器类,这些类能够自我识别它们是否能够在给定系统上使用。
自 |
1.0 |
---|
返回值
array<string|int, mixed>
可用数据库连接器的数组。
getCount
获取数据库驱动程序执行的 SQL 语句总数。
getCount() :
自 |
1.0 |
---|
返回值
int
getCreateDatabaseQuery
返回创建新数据库的查询字符串。
getCreateDatabaseQuery(\stdClass options, utf) :
自 |
2.0.0 |
---|
参数
- options
stdClass
用于将用户和数据库名称传递给数据库驱动程序的对象。此对象必须设置“db_name”和“db_user”。- utf
bool
如果数据库支持 UTF-8 字符集,则为 True。
返回值
string
创建数据库的查询
getCreateDbQuery
以正确的 PostgreSQL 语法返回创建新数据库的查询字符串。
getCreateDbQuery( options, utf) :
自 |
1.5.0 |
---|
参数
- options
object
来自“初始化”函数的对象,用于将用户和数据库名称传递给数据库驱动程序。- utf
bool
如果数据库支持 UTF-8 字符集,则为 True,在 PostgreSQL“CREATE DATABASE”查询中未使用。
返回值
string
创建数据库的查询,由 $options['user'] 拥有
getDatabase
获取此连接使用的数据库名称。
getDatabase() :
自 |
1.0 |
---|
返回值
string
getDateFormat
返回与数据库驱动程序兼容的 PHP date() 函数日期格式。
getDateFormat() :
自 |
1.0 |
---|
返回值
string
getDefaultSchema
用于获取当前 PostgreSQL 连接的默认模式名称的内部函数。
getDefaultSchema() :
即 Joomla 创建表的模式。
自 |
1.8.0 |
---|
返回值
string
getDispatcher
获取事件分派器。
getDispatcher() : \Joomla\Event\DispatcherInterface
getExporter
获取导出器类对象。
getExporter() : \Joomla\Database\DatabaseExporter
getImporter
获取导入器类对象。
getImporter() : \Joomla\Database\DatabaseImporter
getInstance
用于根据给定选项返回 DatabaseDriver 实例的方法。
getInstance(mixed||string|int options = []) : \Joomla\Database\DatabaseDriver
有三个全局选项,其余选项特定于数据库驱动程序。
- “driver”选项定义用于连接的 DatabaseDriver 类——默认值为“mysqli”。
- “database”选项确定用于连接的数据库。
- “select”选项确定连接器是否应自动选择选定的数据库。
实例对于给定的选项是唯一的,并且仅在将唯一的选项数组传递到方法时才会创建新对象。这确保我们不会最终拥有不必要的数据库连接资源。
自 |
1.0 |
---|---|
抛出 |
|
已弃用 |
3.0 请改用 DatabaseFactory::getDriver() |
参数
- options
array<string|int, mixed>
要传递给数据库驱动程序的参数。
返回值
getIterator
获取当前查询的新迭代器。
getIterator( column = null, class = stdClass::class) : \Joomla\Database\DatabaseIterator
getMinimum
获取最低支持的数据库版本。
getMinimum() :
自 |
1.0 |
---|
返回值
string
getMonitor
获取查询监视器。
getMonitor() : \Joomla\Database\QueryMonitorInterface|null
getName
获取数据库驱动程序的名称。
getName() :
如果 $this->name 未设置,它将尝试从类名中猜测驱动程序名称。
自 |
1.4.0 |
---|
返回值
string
getNamesKey
获取此索引索引的列名列表。
getNamesKey( table, indKey) :
自 |
2.0.0 |
---|---|
抛出 |
|
参数
- table
string
表的名称。- indKey
string
表的列号列表
返回值
string
表的列名列表。
getNullDate
获取数据库驱动程序的时间戳的空或零表示形式。
getNullDate() :
自 |
1.0 |
---|
返回值
string
getNumRows
获取先前执行的 SQL 语句返回的行数。
getNumRows() :
自 |
2.0.0 |
---|
返回值
int
返回的行数。
getOption
检索 PDO 数据库连接属性 https://php.ac.cn/manual/en/pdo.getattribute.php
getOption( key) :
用法: $db->getOption(PDO::ATTR_CASE);
自 |
1.0 |
---|
参数
- 键
mixed
PDO::ATTR_* 常量之一
返回值
混合
getPrefix
获取数据库驱动程序的公共表前缀。
getPrefix() :
自 |
1.0 |
---|
返回值
string
公共数据库表前缀。
getQuery
获取当前查询对象或一个新的 DatabaseQuery 对象。
getQuery( new = false) : \Joomla\Database\DatabaseQuery
自 |
1.0 |
---|
参数
- 新
bool
如果为 False,则返回当前查询对象,如果为 True,则返回一个新的 DatabaseQuery 对象。$new 参数在 2.2 中已弃用,将在 4.0 中移除,请改用 createQuery()。
返回值
getRandom
生成随机值
getRandom() :
自 |
1.5.0 |
---|
返回值
float
生成的随机数
getSequenceIsCalled
获取序列的 is_called 属性的方法。
getSequenceIsCalled( sequence) :
自 |
2.0.0 |
---|---|
抛出 |
|
参数
- 序列
string
序列的名称。
返回值
bool
序列的 is_called 属性。
getSequenceLastValue
获取数据库中序列的最后一个值的方法。
getSequenceLastValue( sequence) :
自 |
2.0.0 |
---|---|
抛出 |
|
参数
- 序列
string
序列的名称。
返回值
int
序列的最后一个值。
getServerType
获取服务器族类型。
getServerType() :
如果 $this->serverType 未设置,它将尝试从驱动程序名称中猜测服务器族类型。如果这不可行,则将返回驱动程序名称。
自 |
1.4.0 |
---|
返回值
string
getStringPositionSql
获取字符串中的子字符串位置
getStringPositionSql( substring, string) :
自 |
1.5.0 |
---|
参数
- 子字符串
string
要查找的字符串- string
string
要搜索的字符串/列
返回值
int
$substring 在 $string 中的位置
getTableColumns
检索关于给定表的字段信息。
getTableColumns( table, typeOnly = true) : mixed||string|int
自 |
1.5.0 |
---|---|
抛出 |
|
参数
- table
string
数据库表的名称。- typeOnly
bool
如果为 True,则仅返回字段类型。
返回值
array<string|int, mixed>
数据库表的字段数组。
getTableCreate
显示创建给定表的表 CREATE 语句。
getTableCreate( tables) : mixed||string|int
PostgreSQL 不支持此功能。
自 |
1.5.0 |
---|---|
抛出 |
|
参数
- 表
mixed
表名或表名列表。
返回值
array<string|int, mixed>
空数组,因为 PostgreSQL 不支持此函数。
getTableKeys
获取表的键的详细信息列表。
getTableKeys( table) : mixed||string|int
自 |
1.5.0 |
---|---|
抛出 |
|
参数
- table
string
表的名称。
返回值
array<string|int, mixed>
表的列规范数组。
getTableList
获取数据库中所有表数组的方法。
getTableList() : mixed||string|int
自 |
1.5.0 |
---|---|
抛出 |
|
返回值
array<string|int, mixed>
数据库中所有表的数组。
getTableSequences
获取表的序列的详细信息列表。
getTableSequences( table) : mixed||string|int
自 |
1.5.0 |
---|---|
抛出 |
|
参数
- table
string
表的名称。
返回值
array<string|int, mixed>
表的序列规范数组。
getVersion
获取数据库连接器的版本。
getVersion() :
自 |
1.5.0 |
---|
返回值
string
数据库连接器版本。
hasUtfSupport
确定数据库引擎是否支持 UTF-8 字符编码。
hasUtfSupport() :
自 |
1.0 |
---|
返回值
bool
如果数据库引擎支持 UTF-8 字符编码,则为 True。
insertid
获取上次 INSERT 语句的自动递增值的方法。
insertid() :
自 |
1.0 |
---|
返回值
string
上次插入行的自动递增字段的值。
insertObject
根据对象的属性将一行插入表中。
insertObject( table, &object, key = null) :
自 |
1.5.0 |
---|---|
抛出 |
|
参数
- table
string
要插入的数据库表的名称。- 对象
object
对对象的引用,其公共属性与表字段匹配。- 键
string
主键的名称。如果提供,则更新对象属性。
返回值
bool
成功时为 True。
isConnectionEncryptionSupported
测试数据库 TLS 连接加密是否受支持的方法。
isConnectionEncryptionSupported() :
自 |
2.0.0 |
---|
返回值
bool
数据库是否支持 TLS 连接加密。
isMinimumVersion
检查已安装的数据库版本是否受数据库驱动程序支持的方法
isMinimumVersion() :
自 |
1.0 |
---|
返回值
bool
如果数据库版本受支持,则为 True
isSupported
测试 PostgreSQL 连接器是否可用。
isSupported() :
自 |
1.5.0 |
---|
返回值
bool
成功时为 True,否则为 False。
loadAssoc
获取数据库查询结果集的第一行作为关联数组 ['field_name' => 'row_value'] 的方法。
loadAssoc() :
自 |
1.0 |
---|---|
抛出 |
|
返回值
mixed
返回值或如果查询失败则为 null。
loadAssocList
获取数据库查询结果集行的数组的方法,其中每一行都是 ['field_name' => 'row_value'] 的关联数组。行数组可以选择以字段名称为键,但默认为顺序数字数组。
loadAssocList( key = null, column = null) :
注意:选择以非唯一字段名称为结果数组键可能会导致意外行为,应避免。
自 |
1.0 |
---|---|
抛出 |
|
参数
- 键
string
要为结果数组设置键的字段的名称。- column
string
可选列名。代替整行,只有此列值将出现在结果数组中。
返回值
mixed
返回值或如果查询失败则为 null。
loadColumn
获取数据库查询结果集中每一行的 $offset 字段的值数组的方法。
loadColumn( offset) :
自 |
1.0 |
---|---|
抛出 |
|
参数
- 偏移量
int
用于构建结果数组的行偏移量。
返回值
mixed
返回值或如果查询失败则为 null。
loadObject
获取数据库查询结果集的第一行作为对象的方法。
loadObject( class = stdClass::class) :
自 |
1.0 |
---|---|
抛出 |
|
参数
- class
string
要用于返回的行对象的类名。
返回值
mixed
返回值或如果查询失败则为 null。
loadObjectList
获取数据库查询结果集行的数组的方法,其中每一行都是一个对象。对象数组可以选择以字段名称为键,但默认为顺序数字数组。
loadObjectList( key = '', class = stdClass::class) :
注意:选择以非唯一字段名称为结果数组键可能会导致意外行为,应避免。
自 |
1.0 |
---|---|
抛出 |
|
参数
- 键
string
要为结果数组设置键的字段的名称。- class
string
要用于返回的行对象的类名。
返回值
mixed
返回值或如果查询失败则为 null。
loadResult
获取数据库查询结果集的第一行的第一个字段的方法。
loadResult() :
自 |
1.0 |
---|---|
抛出 |
|
返回值
mixed
返回值或如果查询失败则为 null。
loadRow
获取数据库查询结果集的第一行作为数组的方法。
loadRow() :
列按数字索引,因此结果集中的第一列可以通过 $row[0] 等访问。
自 |
1.0 |
---|---|
抛出 |
|
返回值
mixed
返回值或如果查询失败则为 null。
loadRowList
获取数据库查询结果集行的数组的方法,其中每一行都是一个数组。对象数组可以选择以字段偏移量为键,但默认为顺序数字数组。
loadRowList( key = null) : mixed||string|int
注意:选择以非唯一字段为结果数组键可能会导致意外行为,应避免。
自 |
1.0 |
---|---|
抛出 |
|
参数
- 键
string
要为结果数组设置键的字段的名称。
返回值
array<string|int, mixed>
结果数组。
lockTable
锁定数据库中的表。
lockTable( tableName) :
自 |
1.5.0 |
---|---|
抛出 |
|
参数
- 表名
string
要解锁的表的名称。
返回值
$this
prepareStatement
准备 SQL 语句以供执行
prepareStatement( query) : \Joomla\Database\StatementInterface
q
quote 方法的别名
q(array|string text, escape = true) :
自 |
1.0 |
---|
参数
- text
array<string|int, mixed>|string
要引用的字符串或字符串数组。- escape
bool
True(默认)以转义字符串,False 以保持不变。
返回值
string
引用的输入字符串。
qn
quoteName 方法的别名
qn(array|string name, array|string as = null) : array|string
自 |
1.0 |
---|
参数
- name
array<string|int, mixed>|string
要括在引号中的标识符名称,或要括在引号中的标识符名称数组。每种类型都支持点表示法名称。- 作为
array<string|int, mixed>|string
与 $name 关联的 AS 查询部分。它可以是字符串或数组,在后者情况下,它必须与 $name 的长度相同;如果为 null,则字符串或数组元素将没有任何 AS 部分。
返回值
array<string|int, mixed>|string
引用的名称,与 $name 类型相同。
quote
引用并可选地转义字符串以满足数据库查询的数据库要求。
quote(array|string text, escape = true) : array|string
自 |
1.0 |
---|
参数
- text
array<string|int, mixed>|string
要引用的字符串或字符串数组。- escape
bool
True(默认)以转义字符串,False 以保持不变。
返回值
array<string|int, mixed>|string
引用的输入字符串。
quoteBinary
引用二进制字符串以满足数据库查询的数据库要求。
quoteBinary( data) :
自 |
1.7.0 |
---|
参数
- data
string
要引用的二进制字符串。
返回值
string
引用的二进制输入字符串。
quoteName
将 SQL 语句标识符名称(如列、表或数据库名称)括在引号中,以防止注入风险和保留字冲突。
quoteName(array|string name, array|string as = null) : array|string
自 |
1.0 |
---|
参数
- name
array<string|int, mixed>|string
要括在引号中的标识符名称,或要括在引号中的标识符名称数组。每种类型都支持点表示法名称。- 作为
array<string|int, mixed>|string
与 $name 关联的 AS 查询部分。它可以是字符串或数组,在后者情况下,它必须与 $name 的长度相同;如果为 null,则字符串或数组元素将没有任何 AS 部分。
返回值
array<string|int, mixed>|string
引用的名称,与 $name 类型相同。
quoteNameStr
引用来自 quoteName 调用的字符串。
quoteNameStr(mixed||string|int strArr) :
自 |
1.0 |
---|---|
已弃用 |
2.0 使用 quoteNameString 代替 |
参数
- strArr
array<string|int, mixed>
来自 quoteName 点扩展的字符串数组。
返回值
string
引用的部分的点连接字符串。
quoteNameString
引用来自 quoteName 调用的字符串。
quoteNameString( name, asSinglePart = false) :
自 |
1.7.0 |
---|
参数
- name
string
要引用的标识符名称。- asSinglePart
bool
将名称视为标识符的单个部分。
返回值
string
引用的标识符字符串。
renameTable
重命名数据库中的表。
renameTable( oldTable, newTable, backup = null, prefix = null) :
自 |
1.5.0 |
---|---|
抛出 |
|
参数
- 旧表
string
要重命名的表的名称- 新表
string
表的新的名称。- 备份
string
PostgreSQL 不使用。- 前缀
string
PostgreSQL 不使用。
返回值
$this
replacePrefix
此函数将字符串标识符替换为配置的表前缀。
replacePrefix( sql, prefix = '#__') :
自 |
1.5.0 |
---|
参数
- sql
string
要准备的 SQL 语句。- 前缀
string
表前缀。
返回值
string
处理后的 SQL 语句。
select
选择要使用的数据库。
select( database) :
自 |
1.0 |
---|---|
抛出 |
|
参数
- 数据库
string
要选择使用的数据库的名称。
返回值
bool
如果数据库已成功选择,则为 True。
setDispatcher
设置要使用的调度程序。
setDispatcher(\Joomla\Event\DispatcherInterface dispatcher) :
setMonitor
设置查询监视器。
setMonitor(\Joomla\Database\QueryMonitorInterface|null monitor = null) :
setOption
在 PDO 数据库句柄上设置属性。
setOption( key, value) :
https://php.ac.cn/manual/en/pdo.setattribute.php
用法: $db->setOption(PDO::ATTR_CASE, PDO::CASE_UPPER);
自 |
1.0 |
---|
参数
- 键
int
PDO::ATTR_* 常量之一- 值
mixed
与特定属性键相关的关联 PDO 常量之一。
返回值
布尔值
setQuery
设置 SQL 语句字符串以供以后执行。
setQuery(string|\Joomla\Database\QueryInterface query, offset, limit) :
自 |
1.0 |
---|---|
抛出 |
|
参数
- 查询
string|QueryInterface
要设置的 SQL 语句,可以是 Query 对象或字符串。- 偏移量
int
要设置的受影响行偏移量。{@deprecated 请改用 LimitableInterface::setLimit()}- 限制
int
要设置的最大受影响行数。{@deprecated 请改用 LimitableInterface::setLimit()}
返回值
$this
setUtf
将连接设置为使用 UTF-8 字符编码。
setUtf() :
自 |
1.0 |
---|
返回值
bool
成功时为 True。
showTables
返回一个包含数据库表列表的数组。
showTables() : mixed||string|int
自 |
1.5.0 |
---|
返回值
array<string|int, mixed>
数据库的表列表。
splitSql
将多个查询的字符串拆分为单个查询的数组。
splitSql( sql) : mixed||string|int
自 |
1.0 |
---|
参数
- sql
string
要拆分为单个查询的输入 SQL 字符串。
返回值
array<string|int, mixed>
sqlValue
此函数将字段值作为准备好的字符串返回,以便在 SQL 语句中使用。
sqlValue(mixed||string|int columns, fieldName, fieldValue) :
自 |
1.5.0 |
---|
参数
- 列
array<string|int, mixed>
由 ::getTableColumns 返回的表的列数组。- fieldName
string
表字段的名称。- fieldValue
string
要引用并返回的变量值。
返回值
string
引用的字符串。
transactionCommit
提交事务的方法。
transactionCommit( toSavepoint = false) :
自 |
1.0 |
---|---|
抛出 |
|
参数
- toSavepoint
bool
如果为 true,则提交到最后一个保存点。
返回值
空
transactionRollback
回滚事务的方法。
transactionRollback( toSavepoint = false) :
自 |
1.0 |
---|---|
抛出 |
|
参数
- toSavepoint
bool
如果为 true,则回滚到最后一个保存点。
返回值
空
transactionStart
初始化事务的方法。
transactionStart( asSavepoint = false) :
自 |
1.0 |
---|---|
抛出 |
|
参数
- asSavepoint
bool
如果为 true 且事务已处于活动状态,则将创建一个保存点。
返回值
空
truncateTable
截断表的方法。
truncateTable( table) :
自 |
1.0 |
---|---|
抛出 |
|
参数
- table
string
要截断的表
返回值
空
unlockTables
解锁数据库中的表,此命令在 PostgreSQL 中不存在,它会在提交或回滚时自动执行。
unlockTables() :
自 |
1.5.0 |
---|---|
抛出 |
|
返回值
$this
updateObject
根据对象的属性更新表中的一行。
updateObject( table, &object, array|string key, nulls = false) :
自 |
1.5.0 |
---|---|
抛出 |
|
参数
- table
string
要更新的数据库表的名称。- 对象
object
对对象的引用,其公共属性与表字段匹配。- 键
array<string|int, mixed>|string
主键的名称。- 空值
bool
是否更新空字段,true 表示更新,false 表示忽略。
返回值
布尔值
属性
数据库
数据库的名称。
自 |
1.0 |
---|
类型
string
name
数据库驱动程序名称
自 |
1.5.0 |
---|
类型
string
服务器类型
此驱动程序支持的数据库服务器系列的类型。
自 |
1.4.0 |
---|
类型
string
连接
数据库连接资源。
自 |
1.0 |
---|
类型
PDO
连接器
保存可用数据库连接器的列表。
自 |
1.0 |
---|
类型
array<string|int, mixed>
计数
数据库驱动程序执行的 SQL 语句数量。
自 |
1.0 |
---|
类型
int
游标
上次查询的数据库连接游标。
自 |
1.0 |
---|
类型
资源
已执行
包含当前查询执行状态
自 |
2.0.0 |
---|
类型
布尔值
限制
当前 SQL 语句受影响的行数限制。
自 |
1.0 |
---|
类型
int
名称引用
用于引用 SQL 语句名称(如表名或字段名等)的字符。子类应根据需要定义此字符。如果是一个字符字符串,则相同字符用于引用的名称的两侧,否则第一个字符将用于开始引用,第二个字符将用于结束引用。
自 |
1.5.0 |
---|
类型
string
空日期
数据库驱动程序的时间戳的空或零表示形式。这应该在子类中定义,以保存引擎的相应值。
自 |
1.5.0 |
---|
类型
string
偏移量
要应用于当前 SQL 语句的受影响行偏移量。
自 |
1.0 |
---|
类型
int
options
在实例化时传入并保存。
自 |
1.0 |
---|
类型
array<string|int, mixed>
sql
要执行的当前 SQL 语句。
自 |
1.0 |
---|
类型
混合
表前缀
常见的数据库表前缀。
自 |
1.0 |
---|
类型
string
utf
如果数据库引擎支持 UTF-8 字符编码,则为 true。
自 |
1.0 |
---|
类型
布尔值
错误号
数据库错误号。
自 |
1.0 |
---|
类型
int
错误消息
数据库错误消息。
自 |
1.0 |
---|
类型
string
数据库最小版本
最低支持的数据库版本。
自 |
1.5.0 |
---|
类型
string
事务深度
当前事务的深度。
自 |
1.0 |
---|
类型
int
连接运算符
用于连接的运算符
自 |
1.5.0 |
---|
类型
string