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

在使用微软官方提供的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-essential和g++包，确保编译环境完整。

2. 微软ODBC驱动：通过微软官方仓库安装msodbcsql18和mssql-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数据库的能力。