宝塔安装sqlsrv扩展，PHP连接 Sqlserver

PHP7.4

宝塔面板

#【加入微软源】

curl https://packages.microsoft.com/config/rhel/7/prod.repo > /etc/yum.repos.d/mssqlrelease.repo


#Download appropriate package for the OS version
#Choose only ONE of the following, corresponding to your OS version

#RHEL 7 and Oracle Linux 7
curl https://packages.microsoft.com/config/rhel/7/prod.repo | sudo tee /etc/yum.repos.d/mssql-release.repo

#RHEL 8 and Oracle Linux 8
curl https://packages.microsoft.com/config/rhel/8/prod.repo | sudo tee /etc/yum.repos.d/mssql-release.repo

#RHEL 9
curl https://packages.microsoft.com/config/rhel/9/prod.repo | sudo tee /etc/yum.repos.d/mssql-release.repo

sudo yum remove unixODBC-utf16 unixODBC-utf16-devel #to avoid conflicts
sudo ACCEPT_EULA=Y yum install -y msodbcsql18
# optional: for bcp and sqlcmd
sudo ACCEPT_EULA=Y yum install -y mssql-tools18
echo 'export PATH="$PATH:/opt/mssql-tools18/bin"' >> ~/.bashrc
source ~/.bashrc
# optional: for unixODBC development headers
sudo yum install -y unixODBC-devel

其他版本对应自行到官网查询
https://packages.microsoft.com/config/rhel/7/

#【安装驱动】

yum install msodbcsql mssql-tools unixODBC-devel

#如果驱动安装出错请使用尝试

错误：安装pyodbc和django-pyodbc时，报错：src/pyodbc.h:56:17: fatal error: sql.h: No such file or directory #include <sql.h>

yum install unixODBC-devel

驱动支持PHP7版本

#【下载pdo_sqlsrv扩展包】

wget http://pecl.php.net/get/pdo_sqlsrv-5.8.1.tgz

更多版本：http://pecl.php.net/package/pdo_sqlsrv
特别说明：如果在第五步安装时出现报错，请根据更换版本尝试，一般最新版本可行。

#【解压并进入目录】

tar -zxvf pdo_sqlsrv-5.8.1.tgz

cd pdo_sqlsrv-5.8.1

#【执行安装命令】

/www/server/php/74/bin/phpize

./configure --with-php-config=/www/server/php/74/bin/php-config

make && make install

当前为宝塔，路径如下，使用对应php版本的phpize
74代表的是php的版本号，如果你是7.2的。可能是目录就是72

#【非宝塔环境，按如下操作：】

/usr/local/php/bin/phpize 

./configure --with-php-config=/usr/local/php/bin/php-config

以上仅为通用环境下安装sqlsrv扩展，宝塔环境安装sqlsrv扩展请略过此处按步骤来操作

echo "extension = pdo_sqlsrv.so" >> /www/server/php/74/etc/php.ini
/etc/init.d/php-fpm-74 reload

#【检查扩展是否安装成功】

/www/server/php/74/bin/php -m|grep -i  sqlsrv

或者直接去宝塔面板 - 软件管理 - PHP7.4 - phpinfo 查看。

测试代码

function mssql_user($username){
	$host="远程服务器IP,MSSQL端口";
	$dbname="数据库名称";
	$user="数据库用户名";
	$pass="数据库密码";
	try {
    	$dbh = new PDO("sqlsrv:Server=$host;Database=$dbname", $user, $pass);
	} catch(PDOException $e) {
    	echo $e->getMessage();
    	exit;
	}
	unset($dbh); unset($stmt);
}

#运行时提示“ssl_choose_client_version”版本高于服务器版本

curl/wget
错误：routines:ssl_choose_client_version:unsupported protocol

网上找的的方式没有用，感觉不是协议的问题

最终解决方案

运行下面命令完美解决

update-crypto-policies --set LEGACY

service sssd restart

更新sqlsrv驱动后，产生TLS加密的问题，问题如下：

SQLSTATE[08001]: [Microsoft][ODBC Driver 18 for SQL Server]SSL Provider: [error:1416F086:SSL routines:tls_process_server_certificate:certificate verify failed:self signed certificate]

原因：

该问题由SSL使用TLS加密通讯引起的证书问题，与代码无关。使用旧版的17驱动即可恢复正常。

解决办法：

如果是使用\PDO连接，

在连接的DSN信息增加TrustServerCertificate=1,Encrypt=1即可，在options增加无效。

例：

sqlsrv:Server=IP,端口;Database=dbname;TrustServerCertificate=1;Encrypt=1

'sqlsrv' => [
    'driver' => 'sqlsrv',
    'host' => env('DB_HOST', 'localhost'),
    'database' => env('DB_DATABASE', 'forge'),
    'username' => env('DB_USERNAME', 'forge'),
    'password' => env('DB_PASSWORD', ''),
    'charset' => 'utf8',
    'prefix' => '',
    'encrypt' => 'yes', // 增加属性
    'trust_server_certificate' => 'true', // 增加属性
], 

参考https://www.php.net/manual/zh/ref.pdo-sqlsrv.connection.php