如何在cPanel中配置Laravel连接SQL Server及解决驱动缺失问题

注意：cPanel服务器不支持Windows的.dll文件 #

本地XAMPP用的php_pdo_sqlsrv_74_nts_x64.dll是Windows平台的扩展，cPanel服务器通常为Linux系统，需要安装对应Linux版本的扩展和ODBC驱动。

1. 确认PHP版本匹配 #

登录cPanel，打开Select PHP Version工具，确认当前PHP版本为7.4，且为非线程安全（NTS）版本，和本地环境保持一致。

2. 安装ODBC Driver 17 for SQL Server #

有SSH权限的情况： #

• 针对CentOS/RHEL系统，执行以下命令：

  sudo curl https://packages.microsoft.com/config/rhel/7/prod.repo > /etc/yum.repos.d/mssql-release.repo
  sudo ACCEPT_EULA=Y yum install -y msodbcsql17
  

• 针对Ubuntu/Debian系统，执行以下命令：

  sudo curl https://packages.microsoft.com/keys/microsoft.asc | apt-key add -
  sudo curl https://packages.microsoft.com/config/ubuntu/20.04/prod.list > /etc/apt/sources.list.d/mssql-release.list
  sudo apt-get update
  sudo ACCEPT_EULA=Y apt-get install -y msodbcsql17
  

无SSH权限的情况： #

直接联系主机服务商，请求帮忙安装ODBC Driver 17 for SQL Server。

3. 安装PHP的pdo_sqlsrv扩展 #

方法一：通过cPanel扩展管理器快速安装 #

在Select PHP Version页面切换到Extensions标签，搜索pdo_sqlsrv，找到后勾选启用即可。如果列表中没有该扩展，改用方法二。

方法二：SSH手动编译安装（适配PHP7.4） #

1. 下载对应版本的扩展源码：

   pecl download pdo_sqlsrv-5.9.0 # 该版本适配PHP7.4
   tar -xzf pdo_sqlsrv-5.9.0.tgz
   cd pdo_sqlsrv-5.9.0
   

2. 编译并安装：

   phpize
   ./configure --with-php-config=/usr/local/bin/php-config
   make && make install
   

3. 启用扩展：打开cPanel的MultiPHP INI Editor，在对应PHP版本的配置中添加一行：

   extension=pdo_sqlsrv.so
   

4. 保存后，通过cPanel的Restart Services工具重启PHP服务。

4. 验证配置是否生效 #

• 创建测试PHP文件，内容如下：

  <?php
  phpinfo();
  ?>
  

• 访问该文件，搜索pdo_sqlsrv和ODBC关键词，确认扩展已成功加载。
• 最后测试数据库连接，确保.env中的配置（服务器地址、端口、账号权限）符合远程SQL Server的访问规则。

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