ThinkPHP5连接SQLServer数据库的配置方法-ThinkPHP-PHP中文网

thinkphp5 连接 sqlserver 必须同时满足：php 已启用 sqlsrv 或 pdo_sqlsrv 扩展，且 database.php 中 type 值严格设为 'sqlsrv'；否则报“系统不支持:sqlsrv”。

thinkphp5连接sqlserver数据库的配置方法

ThinkPHP5 能连 SQLServer，但必须同时满足两个硬性条件：PHP 环境已启用 sqlsrv 或 pdo_sqlsrv 扩展，且配置中 type 值明确设为 sqlsrv —— 缺一不可，否则必然报“系统不支持:sqlsrv”。

确认 PHP 已加载 sqlsrv 扩展

这是最常卡住的第一步。TP5 报错“系统不支持:sqlsrv”，90% 是因为 PHP 根本没加载对应扩展，而不是 TP 配置错了。

运行 php -m | findstr sqlsrv（Windows）或 php -m | grep sqlsrv（Linux/macOS），确认输出包含 sqlsrv 和/或 pdo_sqlsrv
若无输出，需手动安装：Windows 下下载 Microsoft 官方驱动（如 php_pdo_sqlsrv_82_ts.dll），复制到 ext/ 目录，并在 php.ini 中添加两行：
extension=php_pdo_sqlsrv_82_ts.dll
extension=php_sqlsrv_82_ts.dll
Linux 用户建议用 pecl install sqlsrv + pecl install pdo_sqlsrv，并确保 odbcinst.ini 和 unixODBC 已就位
重启 Web 服务（Apache/Nginx）和 CLI 的 PHP 进程，phpinfo() 页面里必须能看到 “sqlsrv” 模块信息

database.php 中正确配置 sqlsrv 连接

TP5 不接受模糊写法，type 必须是字符串 'sqlsrv'，且所有关键字段不能省略，否则会静默 fallback 到 mysql 驱动，最终抛出 Class 'PDO' not found 等误导性错误。

PHP

编写健壮的PHP代码，规避类型转换陷阱、数组怪癖及常见安全漏洞。

下载

在 config/database.php 的 connections 数组中定义命名连接，例如：

'sqlserver_db' => [
    'type'     => 'sqlsrv',
    'hostname' => '192.168.1.100',
    'database' => 'MyAppDB',
    'username' => 'sa',
    'password' => 'YourStrongPass!',
    'hostport' => '1433',
    'charset'  => 'utf8',
    'prefix'   => '',
]

hostname 若为远程地址，注意 SQL Server 默认禁用 TCP/IP，需在 SQL Server Configuration Manager 中启用并重启服务
端口不要用冒号写成 192.168.1.100:1433，而应分开填 hostname 和 hostport；实测某些版本对冒号格式解析失败
charset 设为 'utf8' 即可，SQL Server 实际使用 UTF-16（nvarchar），但 PDO 层自动处理，无需改 utf16

代码中调用时只传预定义键名

Db::connect() 只认 config/database.php 里 connections 数组中已声明的键名，传数组、DSN 或拼错名字都会失败，且错误提示极不友好。

✅ 正确：Db::connect('sqlserver_db')->table('users')->select()
❌ 错误：Db::connect(['type'=>'sqlsrv', ...]) —— 高并发下触发连接耗尽，且绕过连接池
❌ 错误：Db::connect('SQLSERVER_DB') —— 键名大小写敏感，必须全小写
❌ 错误：Db::connect('sqlserver.db') —— 点号会被框架解析器截断，报 Connection not found
首次使用前务必执行 php think clear:config，否则旧缓存可能掩盖配置更新

常见报错与对应检查点

实际部署时，错误往往不是单一原因，而是多个环节叠加失效，需按顺序排查。

system not support: sqlsrv → 检查 php -m 输出，确认扩展已加载；再确认 type 值是 'sqlsrv' 字符串，不是 'mssql' 或空格
SQLSTATE[08001]: [Microsoft][ODBC Driver 17 for SQL Server]Login timeout expired → 检查防火墙是否放行 1433 端口、SQL Server 是否启用混合认证、用户名密码是否含特殊字符（需 URL 编码或改用配置数组传参）
SQLSTATE[HY000]: General error: 20018 Invalid object name 'users' → 表名未加 schema 前缀，SQL Server 默认 schema 是 dbo，应写成 Db::connect(...)->table('dbo.users')->select()
查询返回中文乱码 → 不是 charset 配置问题，而是 SQL Server 数据库默认排序规则不支持 UTF-8，需确认数据库/表字段为 nvarchar 类型，并在连接参数中加入：
'params' => [\PDO::ATTR_EMULATE_PREPARES => false]