属性 |
值 |
命名空间 |
fize\db\realization\pgsql\mode\driver |
类名 |
Pgsql |
构造时创建连接
public function __construct (
string $connection_string,
bool $pconnect = false,
int $connect_type = null
)
参数: |
名称
|
说明
|
connection_string
|
连接字符串
|
pconnect
|
是否使用长连接
|
connect_type
|
PGSQL_CONNECT_FORCE_NEW使用新连接
|
|
析构时关闭连接
public function __destruct ()
取消异步查询
public function cancelQuery () : bool
取得客户端编码方式
public function clientEncoding () : string
关闭连接
正在进行尝试轮询 PostgreSQL 链接状态
public function connectPoll () : int
返回值: | 返回常量 PGSQL_POLLING_FAILED, PGSQL_POLLING_READING, PGSQL_POLLING_WRITING, PGSQL_POLLING_OK, 或者 PGSQL_POLLING_ACTIVE |
打开一个 PostgreSQL 连接
public function connect (
string $connection_string
)
参数: |
名称
|
说明
|
connection_string
|
连接字符串
|
|
获知连接是否为忙
public function connectionBusy () : bool
重置连接(再次连接)
public function connectionReset () : bool
获得连接状态
public function connectionStatus () : int
返回值: | 可能的状态为 PGSQL_CONNECTION_OK 和 PGSQL_CONNECTION_BAD |
读取连接上的输入
public function consumeInput () : bool
将关联的数组值转换为适合 SQL 语句的格式
public function convert (
string $table_name,
array $assoc_array,
int $options = 0
) : array
参数: |
名称
|
说明
|
table_name
|
表名
|
assoc_array
|
键值对
|
options
|
常量PGSQL_CONV_IGNORE_DEFAULT, PGSQL_CONV_FORCE_NULL, PGSQL_CONV_IGNORE_NOT_NULL
|
|
根据数组将记录插入表中
public function copyFrom (
string $table_name,
array $rows,
string $delimiter = null,
string $null_as = null
) : bool
参数: |
名称
|
说明
|
table_name
|
表名
|
rows
|
要插入的记录
|
delimiter
|
间隔符
|
null_as
|
NULL值的替代
|
|
将一个表拷贝到数组中
public function copyTo (
string $table_name,
string $delimiter = null,
string $null_as = null
) : array
参数: |
名称
|
说明
|
table_name
|
表名
|
delimiter
|
间隔符
|
null_as
|
NULL值的替代
|
|
获得数据库名
public function dbname () : string
删除记录
public function delete (
string $table_name,
array $assoc_array,
int $options = 512
) : bool|string
参数: |
名称
|
说明
|
table_name
|
表名
|
assoc_array
|
以 field=>value 格式给出的条件
|
options
|
常量PGSQL_CONV_FORCE_NULL, PGSQL_DML_NO_CONV, PGSQL_DML_EXEC or PGSQL_DML_STRING
|
|
返回值: | 选项带PGSQL_DML_STRING时返回SQL语句,其他情况返回bool
|
与 PostgreSQL 后端同步
public function endCopy () : bool
转义 bytea 类型的二进制数据
public function escapeBytea (
string $data
) : string
转义用于插入文本字段的标识符
public function escapeIdentifier (
string $data
) : string
转义用于插入文本字段的文字
public function escapeLiteral (
string $data
) : string
转义 text/char 类型的字符串
public function escapeString (
string $data
) : string
发送一个请求来执行带有给定参数的准备好的语句,并等待结果
public function execute (
string $stmtname,
array $params
) : \fize\db\realization\pgsql\mode\driver\pgsql\Result|bool
参数: |
名称
|
说明
|
stmtname
|
SQL预处理语句
|
params
|
绑定参数
|
|
返回值: | Result对象来进行数据集操作,失败时返回false
|
刷新链接中已处理的数据查询
public function flush () : mixed
Ping 数据库连接
public function getNotify (
int $result_type = null
) : array
取得后端(数据库服务器进程)的 PID
public function getPid () : int
取得异步查询结果
public function getResult () : \fize\db\realization\pgsql\mode\driver\pgsql\Result|bool
返回值: | Result对象来进行数据集操作,失败时返回false |
返回和某连接关联的主机名
public function host () : string
将数组插入到表中
public function insert (
string $table_name,
array $assoc_array,
int $options = 512
) : mixed
参数: |
名称
|
说明
|
table_name
|
表名
|
assoc_array
|
数组
|
options
|
常量PGSQL_CONV_OPTS, PGSQL_DML_NO_CONV, PGSQL_DML_EXEC, PGSQL_DML_ASYNC or PGSQL_DML_STRING
|
|
得到某连接的最后一条错误信息
public function lastError () : string
返回 PostgreSQL 服务器最新一条公告信息
public function lastNotice () : string
新建一个大型对象
public function loCreate () : int
将大型对象导出到文件
public function loExport (
int $oid,
string $pathname
) : bool
参数: |
名称
|
说明
|
oid
|
要导出的数据库里的大型对象的 OID
|
pathname
|
要导出的数据库里的大型对象的文件在客户端上完整路径和文件名
|
|
将文件导入为大型对象
public function loImport (
string $pathname,
mixed $object_id = null
) : int
参数: |
名称
|
说明
|
pathname
|
变量指明了要导入为大型对象的文件名
|
object_id
|
尝试用该对象ID创建
|
|
打开一个大型对象
public function loOpen (
int $oid,
string $mode
) : \fize\db\realization\pgsql\mode\driver\pgsql\Lo|bool
参数: |
名称
|
说明
|
oid
|
指定了有效的大型对象的 oid
|
mode
|
可以为 "r","w" 或者 "rw"。
|
|
返回值: | 失败则返回 FALSE
|
删除一个大型对象
public function loUnlink (
int $oid
) : bool
获得表的元数据
public function metaData (
string $table_name
) : array
获得和连接有关的选项
public function options () : string
查找服务器的当前参数设置
public function parameterStatus (
string $param_name
) : string
Ping 数据库连接
public function ping () : bool
返回该连接的端口号
public function port () : int
提交一个请求,用给定的参数创建一个准备好的语句,并等待完成
public function prepare (
string $stmtname,
string $query
) : resource
参数: |
名称
|
说明
|
stmtname
|
名称
|
query
|
语句
|
|
向 PostgreSQL 后端发送以 NULL 结尾的字符串
public function putLine (
string $data
) : bool
向服务器提交一个命令并等待结果,同时能够独立于SQL命令文本传递参数
public function queryParams (
string $query,
array $params
) : \fize\db\realization\pgsql\mode\driver\pgsql\Result|bool
参数: |
名称
|
说明
|
query
|
SQL语句,支持占位符
|
params
|
绑定参数
|
|
返回值: | 失败时返回false
|
执行查询
public function query (
string $query
) : \fize\db\realization\pgsql\mode\driver\pgsql\Result|bool
选择记录
public function select (
string $table_name,
array $assoc_array,
int $options = 512
) : array|string
参数: |
名称
|
说明
|
table_name
|
表名
|
assoc_array
|
条件数组
|
options
|
选项常量
|
|
返回值: | 如果选项带PGSQL_DML_STRING则返回SQL语句,其他返回结果数组
|
发送一个请求来执行带有给定参数的准备好的语句,而不需要等待结果
public function sendExecute (
string $stmtname,
array $params
) : bool
参数: |
名称
|
说明
|
stmtname
|
预处理语句名称
|
params
|
绑定参数
|
|
发送一个请求,使用给定的参数创建一个准备好的语句,而不需要等待完成
public function sendPrepare (
string $stmtname,
string $query
) : bool
参数: |
名称
|
说明
|
stmtname
|
预处理语句名称
|
query
|
SQL语句
|
|
在不等待结果的情况下向服务器提交命令和单独的参数
public function sendQueryParams (
string $query,
array $params
) : bool
参数: |
名称
|
说明
|
query
|
SQL语句
|
params
|
绑定参数
|
|
发送异步查询
public function sendQuery (
string $query
) : bool
设定客户端编码
public function setClientEncoding (
string $encoding
) : int
确定消息的冗长
public function setErrorVerbosity (
int $verbosity
) : int
参数: |
|
返回值: | 常量PGSQL_ERRORS_TERSE, PGSQL_ERRORS_DEFAULT 或 PGSQL_ERRORS_VERBOSE
|
获取PostgreSQL连接下套接字的只读句柄
public function socket () : resource
启动一个 PostgreSQL 连接的追踪功能
public function trace (
string $pathname,
string $mode = "w"
) : bool
参数: |
名称
|
说明
|
pathname
|
记录到 pathname 指定的文件中
|
mode
|
模式
|
|
返回服务器的当前事务内状态
public function transactionStatus () : int
返回该连接的 tty 号
public function tty () : string
取消 bytea 类型中的字符串转义
public static function unescapeBytea (
string $data
) : string
关闭 PostgreSQL 连接的追踪功能
public function untrace () : bool
更新表
public function update (
string $table_name,
array $data,
array $condition,
int $options = 512
) : bool|string
参数: |
名称
|
说明
|
table_name
|
表名
|
data
|
数据
|
condition
|
条件
|
options
|
选项常量
|
|
返回值: | 选项带PGSQL_DML_STRING时返回SQL语句,其他情况返回bool
|
返回一个包含客户端、协议和服务器版本的数组(如果可用)
public function version () : array