在Laravel PHP中如何向SQL Server的image类型字段上传文件

问题根因 #

现有代码仅指定了PHP侧的二进制流编码规则，没有显式声明SQL侧参数对应image类型的映射规则，因此默认会被识别为varbinary类型写入。

修复方案 #

1. 原生SQL参数绑定写法（兼容现有写法） #

仅需在绑定参数中新增第四个参数，显式指定SQL端类型为SQLSRV_SQLTYPE_IMAGE即可：

// 读取文件二进制内容
$image  = file_get_contents($file);
// 插入SQL
$sql    = "INSERT INTO tabla (CONTENIDO) VALUES (?);";
// 修正参数绑定，指定SQL端类型为image
$params = [
    [
        $image, 
        SQLSRV_PARAM_IN, 
        SQLSRV_PHPTYPE_STRING(SQLSRV_ENC_BINARY), 
        SQLSRV_SQLTYPE_IMAGE // 关键配置：指定SQL端对应image类型
    ]
];
// Laravel中直接用sqlsrv连接执行即可
DB::connection('sqlsrv')->statement($sql, $params);

2. Eloquent ORM写法 #

如果使用Laravel的ORM操作，可在对应模型中自定义字段修改器，无需手动写原生SQL：
首先定义对应表的模型：

<?php

namespace App\Models;

use Illuminate\Database\Eloquent\Model;
use Illuminate\Support\Facades\DB;

class Tabla extends Model
{
    // 指定SQL Server连接
    protected $connection = 'sqlsrv';
    // 对应表名
    protected $table = 'tabla';
    // 可批量赋值字段
    protected $fillable = ['CONTENIDO'];

    // 自定义CONTENIDO字段的设置逻辑，自动转换为image类型
    public function setContenidoAttribute($value)
    {
        $this->attributes['CONTENIDO'] = DB::raw('CONVERT(IMAGE, ?)', [$value]);
    }
}

调用时直接传入二进制内容即可：

$imageContent = file_get_contents($file);
\App\Models\Tabla::create([
    'CONTENIDO' => $imageContent
]);

提示：SQL Server官方已将image类型标记为废弃状态，未来版本会移除该类型，业务条件允许的情况下建议优先使用varbinary(max)类型替代，兼容现有二进制存储逻辑的同时扩展性更好。

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