首页
/ 在Ubuntu容器中安装PHP SQLSRV扩展的解决方案

在Ubuntu容器中安装PHP SQLSRV扩展的解决方案

2025-07-07 11:47:59作者:邵娇湘

在使用微软官方提供的PHP SQL Server驱动(microsoft/msphpsql)时,开发人员可能会遇到在Ubuntu容器环境中安装失败的问题。本文将详细介绍如何正确配置Ubuntu 22.04容器环境以成功安装SQLSRV和PDO_SQLSRV扩展。

问题背景

当尝试在Ubuntu 22.04容器中通过PECL安装SQLSRV扩展时,系统会报错提示C++预处理器检查失败。这是因为容器环境中缺少必要的编译工具链,导致无法正确编译PHP扩展。

解决方案

1. 安装必备的编译工具

在Ubuntu容器中,需要先安装构建PHP扩展所需的基础编译工具包:

RUN apt-get update && apt-get install -y build-essential g++

build-essential是Ubuntu/Debian系统中包含GCC编译器、make工具和其他构建软件所需工具的元数据包。g++是C++编译器,对于需要C++预处理的PHP扩展编译过程是必需的。

2. 完整的Dockerfile配置

以下是经过验证可用的完整Dockerfile配置示例:

FROM ubuntu:22.04

ENV DEBIAN_FRONTEND noninteractive

# 安装基础依赖和编译工具
RUN apt-get update \
    && apt-get install -y software-properties-common build-essential g++ \
    && LC_ALL=C.UTF-8 add-apt-repository -y ppa:ondrej/php \
    && apt-get install -yq --no-install-recommends \
        sudo \
        curl \
        php8.3 \
        php8.3-dev \
        php8.3-fpm \
        php8.3-pdo \
        php8.3-xml \
        php8.3-zip \
        php8.3-curl \
        php8.3-gd \
        php8.3-imap \
        php8.3-mbstring \
        php8.3-soap \
        php8.3-bcmath \
        php8.3-xdebug \
        php-pear \
        nginx \
    && curl https://packages.microsoft.com/keys/microsoft.asc | sudo tee /etc/apt/trusted.gpg.d/microsoft.asc \
    && curl https://packages.microsoft.com/config/ubuntu/$(lsb_release -rs)/prod.list | sudo tee /etc/apt/sources.list.d/mssql-release.list \
    && apt-get update \
    && sudo ACCEPT_EULA=Y apt-get install -y msodbcsql18 mssql-tools18 unixodbc-dev \
    && echo 'export PATH="$PATH:/opt/mssql-tools18/bin"' >> ~/.bashrc \
    && apt-get autoremove --purge -y \
        software-properties-common \
    && apt-get -y clean \
    && rm -rf /var/lib/apt/lists/* /var/tmp/*

# 安装PHP扩展
RUN pecl channel-update pecl.php.net \
    && pecl config-set php_ini /etc/php/8.3/fpm/php.ini \
    && pecl install sqlsrv \
    && pecl install pdo_sqlsrv \
    && printf "; priority=20\nextension=sqlsrv.so\n" > /etc/php/8.3/mods-available/sqlsrv.ini \
    && printf "; priority=30\nextension=pdo_sqlsrv.so\n" > /etc/php/8.3/mods-available/pdo_sqlsrv.ini \
    && phpenmod -v 8.3 sqlsrv pdo_sqlsrv

3. 关键步骤说明

  1. 基础工具安装:在安装PHP之前,先安装build-essentialg++包,确保编译环境完整。

  2. 微软ODBC驱动:通过微软官方仓库安装msodbcsql18mssql-tools18,这是PHP连接SQL Server的基础。

  3. PECL安装扩展:使用PECL工具安装SQLSRV和PDO_SQLSRV扩展时,系统会自动编译源代码,因此需要完整的编译工具链。

  4. 扩展配置:安装完成后,需要创建ini文件并启用扩展,确保PHP运行时能够加载这些扩展。

常见问题排查

如果在按照上述步骤操作后仍然遇到问题,可以考虑以下排查步骤:

  1. 检查容器中是否确实安装了g++编译器:g++ --version

  2. 查看PECL安装过程中的详细日志,通常位于/tmp/pear/temp/目录下

  3. 确保安装的PHP开发包版本(php8.3-dev)与PHP运行时版本一致

  4. 验证ODBC驱动是否正确安装:odbcinst -j

通过以上步骤,大多数情况下可以成功在Ubuntu容器环境中安装并配置PHP的SQL Server驱动扩展,为应用程序提供连接SQL Server数据库的能力。

登录后查看全文
热门项目推荐

项目优选

收起
ohos_react_nativeohos_react_native
React Native鸿蒙化仓库
C++
136
214
leetcodeleetcode
🔥LeetCode solutions in any programming language | 多种编程语言实现 LeetCode、《剑指 Offer(第 2 版)》、《程序员面试金典(第 6 版)》题解
Java
51
15
RuoYi-Vue3RuoYi-Vue3
🎉 (RuoYi)官方仓库 基于SpringBoot,Spring Security,JWT,Vue3 & Vite、Element Plus 的前后端分离权限管理系统
Vue
645
434
openGauss-serveropenGauss-server
openGauss kernel ~ openGauss is an open source relational database management system
C++
98
152
Cangjie-ExamplesCangjie-Examples
本仓将收集和展示高质量的仓颉示例代码,欢迎大家投稿,让全世界看到您的妙趣设计,也让更多人通过您的编码理解和喜爱仓颉语言。
Cangjie
300
1.03 K
MateChatMateChat
前端智能化场景解决方案UI库,轻松构建你的AI应用,我们将持续完善更新,欢迎你的使用与建议。 官网地址:https://matechat.gitcode.com
697
96
cherry-studiocherry-studio
🍒 Cherry Studio 是一款支持多个 LLM 提供商的桌面客户端
TypeScript
505
42
RuoYi-Cloud-Vue3RuoYi-Cloud-Vue3
🎉 基于Spring Boot、Spring Cloud & Alibaba、Vue3 & Vite、Element Plus的分布式前后端分离微服务架构权限管理系统
Vue
115
81
carboncarbon
轻量级、语义化、对开发者友好的 golang 时间处理库
Go
8
2
openHiTLSopenHiTLS
旨在打造算法先进、性能卓越、高效敏捷、安全可靠的密码套件,通过轻量级、可剪裁的软件技术架构满足各行业不同场景的多样化要求,让密码技术应用更简单,同时探索后量子等先进算法创新实践,构建密码前沿技术底座!
C
109
255