(PHP 4 >= 4.2.0, PHP 5, PHP 7, PHP 8)
pg_escape_bytea — 转义要插入 bytea 字段的字符串
pg_escape_bytea() 用于转义 bytea 数据类型的字符串。它返回转义后的字符串。
注意:
当您
SELECTbytea 类型时，PostgreSQL 返回以 '\' 为前缀的八进制字节值（例如 \032）。用户应该手动将其转换回二进制格式。此函数需要 PostgreSQL 7.2 或更高版本。在 PostgreSQL 7.2.0 和 7.2.1 中，当您启用多字节支持时，bytea 值必须进行强制转换。例如
INSERT INTO test_table (image) VALUES ('$image_escaped'::bytea);PostgreSQL 7.2.2 或更高版本不需要强制转换。例外情况是客户端和后端字符编码不匹配，并且可能存在多字节流错误。用户必须将数据强制转换为 bytea 以避免此错误。
connection一个 PgSql\Connection 实例。当 connection 未指定时，将使用默认连接。默认连接是 pg_connect() 或 pg_pconnect() 最近建立的连接。
从 PHP 8.1.0 开始，使用默认连接已弃用。
data一个 string，包含要插入 bytea 列的文本或二进制数据。
一个 string，包含转义后的数据。
| 版本 | 描述 |
|---|---|
| 8.1.0 | connection 参数现在期望一个 PgSql\Connection 实例；以前，期望的是一个 resource。 |
示例 #1 pg_escape_bytea() 示例
<?php
// 连接到数据库
$dbconn = pg_connect('dbname=foo');
// 读取二进制文件
$data = file_get_contents('image1.jpg');
// 转义二进制数据
$escaped = pg_escape_bytea($data);
// 将其插入数据库
pg_query("INSERT INTO gallery (name, data) VALUES ('Pine trees', '{$escaped}')");
?>pg_unescape_bytea() 不能完全重现 pg_escape_bytea() 创建的二进制数据的原因是反斜杠 \ 和单引号 ' 被 pg_escape_bytea() 函数双重转义。这会导致从 bytea 字段检索到的图像看起来损坏。正确地将二进制字符串转义和解除转义到 PG bytea 字段的方法如下
<?php
$escaped_data = str_replace(array("\\\\", "''"), array("\\", "'"), pg_escape_bytea($data));
/* 稍后使用以下方法解除 bytea 字段中转义数据的转义以获取原始二进制数据 */
$original_data = pg_unescape_bytea($escaped_data));
?>
更多详情请访问：http://archives.postgresql.org/pgsql-php/2007-02/msg00014.phpPostgreSQL 9.0 引入了一种新的基于十六进制的 bytea 数据表示形式，它优于此函数实现的转义机制。
<?php
function pg_escape_byteahex($binary)
{
return "E'\\\\x".bin2hex($binary)."'";
}
?>为了防止编码出现任何问题，您可以使用十六进制或 Base64 输入来保存和检索数据库中的数据
<?php
// 连接到数据库
$dbconn = pg_connect( 'dbname=foo' );
// 读取二进制文件
$data = file_get_contents( 'image1.jpg' );
// 转义二进制数据
$escaped = bin2hex( $data );
// 将其插入数据库
pg_query( "INSERT INTO gallery (name, data) VALUES ('Pine trees', decode('{$escaped}' , 'hex'))" );
// 获取 bytea 数据
$res = pg_query("SELECT encode(data, 'base64') AS data FROM gallery WHERE name='Pine trees'");
$raw = pg_fetch_result($res, 'data');
// 转换为二进制并发送到浏览器
header('Content-type: image/jpeg');
echo base64_decode($raw);
?>要解除转义 bytea，请使用 stripcslashes()。如果您需要转义 bytea 并且没有 pg_escape_bytea() 函数，则可以使用
<?php
function escByteA($binData) {
/**
* \134 = 92 = 反斜杠, \000 = 00 = NULL, \047 = 39 = 单引号
*
* str_replace() 按顺序替换搜索数组中的内容。因此，我们必须
* 首先处理“反斜杠”字符。如果我们最后处理它，它将
* 替换之前所有搜索中转义的反斜杠。
*/
$search = array(chr(92), chr(0), chr(39));
$replace = array('\\\134', '\\\000', '\\\047');
$binData = str_replace($search, $replace, $binData);
return $binData;
//echo "<pre>$binData</pre>";
//exit;
}
?>此方法与 pg_escape_bytea 的功能相同，尽情使用吧。
public function escape_bytea($data) {
$escaped = '';
for ($i = 0; $i < strlen($data); $i++) {
$char = $data[$i];
$ascii = ord($char);
$escaped.= ($ascii < 32 || $ascii > 126 ? sprintf('\\%03o', $ascii) : ($char == '\\' ? '\\\\' : $char) );
}
return $escaped;
}在不使用 'E' 转义标签的情况下使用 pg_escape_bytea
<?php
// 对二进制数据进行掩码
$escaped = pg_escape_bytea($data);
// 并插入到数据库中（错误/wrong）
pg_query("INSERT INTO gallery (name, data) VALUES ('Pine trees', E'$escaped')");
// 并插入到数据库中（正确/right）
pg_query("INSERT INTO gallery (name, data) VALUES ('Pine trees', '$escaped')");
?>如果您遇到关于在字符串字面量中非标准使用 \\ 的错误，则需要按如下方式转义编码的 bytea
<?php
$escaped = pg_escape_bytea($data);
pg_query("INSERT INTO gallery (name, data) VALUES ('Pine trees', E'$escaped'::bytea)");
?>如果您需要将数据库中的 bytea 更改回普通数据，此方法可以做到这一点
<?php
function pg_unescape_bytea($bytea) {
return eval("return \"".str_replace('$', '\\$', str_replace('"', '\\"', $bytea))."\";");
}
// 使用方法如下
$rs = pg_query($conn, "SELECT image from images LIMIT 1");
$image = pg_unescape_bytea(pg_fetch_result($rs, 0, 0));
?>
/Tobias