CakePHP 3.X中从PostgreSQL bytea列获取图片数据及查询转换问询

一、解决bytea字段查询返回null的问题 #

默认情况下CakePHP的PostgreSQL驱动可能没正确处理bytea类型读取，可通过以下方式修复：

• 在对应Table类的initialize方法里指定字段类型：

$this->schema()->getColumnType('column_name', 'binary');

• 或者在实体类中定义字段类型与可访问性：

protected $_accessible = [
    // 其他字段按需添加
    'column_name' => true,
];

protected $_types = [
    'column_name' => 'binary',
];

二、原生encode查询转CakePHP 3.x写法 #

要实现select encode(column_name::bytea, 'base64') AS column_name from table1的逻辑，有两种可行写法：

方式1：使用查询构建器的函数表达式 #

$query = $this->Table1->find()
    ->select([
        'column_name' => $this->Table1->query()->func()->encode(
            'column_name::bytea',
            'base64'
        )
    ]);

也可以用闭包形式更严谨地处理标识符与字面量：

$query = $this->Table1->find()
    ->select(function (\Cake\ORM\Query $query) {
        return [
            'column_name' => $query->func()->encode([
                'column_name' => 'identifier',
                "'base64'" => 'literal'
            ])
        ];
    });

方式2：直接使用原生SQL片段 #

如果函数表达式方式不生效，可直接传入原生表达式：

$query = $this->Table1->find()
    ->select([
        'column_name' => \Cake\Database\Expression\QueryExpression::from('encode(column_name::bytea, \'base64\')')
    ]);

三、将图片数据返回给用户 #

获取到base64编码的图片数据后，分两种场景处理：

• 直接返回图片响应（控制器中）：

$entity = $this->Table1->get($id, [
    'select' => [
        'column_name' => $this->Table1->query()->func()->encode('column_name::bytea', 'base64')
    ]
]);
$imageData = base64_decode($entity->column_name);

$this->response->type('image/jpeg');
$this->response->body($imageData);
return $this->response;

• 在页面中展示图片：
  把base64内容拼接成Data URI，传递到视图模板后使用：

// 控制器中生成URI
$imageDataUri = 'data:image/jpeg;base64,' . $entity->column_name;
$this->set(compact('imageDataUri'));

// 视图模板中渲染
// <img src="<?= $imageDataUri ?>" alt="Stored Image">

内容的提问来源于stack exchange，提问作者P P