如何在OpenLiteSpeed中安装Microsoft SQL PDO PHP驱动（优先适配PHP7.4）

前置环境确认 #

• 确认OpenLiteSpeed对应PHP版本的安装路径，PHP7.4默认路径为/usr/local/lsws/lsphp74/，其他PHP7.x版本替换路径中版本号即可（如PHP7.3对应lsphp73）
• 提前安装对应PHP版本的pecl工具：
  • Debian/Ubuntu 系执行：apt install lsphp74-pear
  • CentOS/RHEL 系执行：yum install lsphp74-pear

以下操作均使用root权限执行，普通用户执行时命令前加sudo前缀即可

步骤1：安装Microsoft ODBC驱动 #

Debian/Ubuntu 系操作 #

curl https://packages.microsoft.com/keys/microsoft.asc | apt-key add -
curl https://packages.microsoft.com/config/ubuntu/$(lsb_release -rs)/prod.list > /etc/apt/sources.list.d/mssql-release.list
apt update
ACCEPT_EULA=Y apt install -y msodbcsql17 unixodbc-dev

CentOS/RHEL 系操作 #

curl https://packages.microsoft.com/config/rhel/$(rpm -E %rhel)/prod.repo > /etc/yum.repos.d/mssql-release.repo
ACCEPT_EULA=Y yum install -y msodbcsql17 unixodbc-devel

步骤2：安装sqlsrv与pdo_sqlsrv扩展 #

PHP7.x适配的最高扩展版本为5.10.1，不要安装最新版，使用OpenLiteSpeed自带的pecl工具安装：

/usr/local/lsws/lsphp74/bin/pecl install sqlsrv-5.10.1 pdo_sqlsrv-5.10.1

安装过程中提示输入路径时直接回车使用默认配置即可。

步骤3：配置PHP扩展生效 #

1. 新建扩展配置文件：

nano /usr/local/lsws/lsphp74/etc/php/7.4/mods-available/sqlsrv.ini

写入以下内容：

extension=sqlsrv.so
extension=pdo_sqlsrv.so

2. 建立软链接到PHP生效配置目录：

ln -s /usr/local/lsws/lsphp74/etc/php/7.4/mods-available/sqlsrv.ini /usr/local/lsws/lsphp74/etc/php/7.4/conf.d/30-sqlsrv.ini

步骤4：重启服务验证结果 #

1. 重启OpenLiteSpeed生效配置：
   systemctl restart lsws
2. 验证扩展是否加载成功：
   /usr/local/lsws/lsphp74/bin/php -m | grep sqlsrv
   返回结果包含sqlsrv和pdo_sqlsrv即为安装成功。

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