在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. 关键步骤说明
-
基础工具安装:在安装PHP之前,先安装
build-essential
和g++
包,确保编译环境完整。 -
微软ODBC驱动:通过微软官方仓库安装
msodbcsql18
和mssql-tools18
,这是PHP连接SQL Server的基础。 -
PECL安装扩展:使用PECL工具安装SQLSRV和PDO_SQLSRV扩展时,系统会自动编译源代码,因此需要完整的编译工具链。
-
扩展配置:安装完成后,需要创建ini文件并启用扩展,确保PHP运行时能够加载这些扩展。
常见问题排查
如果在按照上述步骤操作后仍然遇到问题,可以考虑以下排查步骤:
-
检查容器中是否确实安装了g++编译器:
g++ --version
-
查看PECL安装过程中的详细日志,通常位于
/tmp/pear/temp/
目录下 -
确保安装的PHP开发包版本(
php8.3-dev
)与PHP运行时版本一致 -
验证ODBC驱动是否正确安装:
odbcinst -j
通过以上步骤,大多数情况下可以成功在Ubuntu容器环境中安装并配置PHP的SQL Server驱动扩展,为应用程序提供连接SQL Server数据库的能力。
- KKimi-K2-InstructKimi-K2-Instruct是月之暗面推出的尖端混合专家语言模型,拥有1万亿总参数和320亿激活参数,专为智能代理任务优化。基于创新的MuonClip优化器训练,模型在知识推理、代码生成和工具调用场景表现卓越,支持128K长上下文处理。作为即用型指令模型,它提供开箱即用的对话能力与自动化工具调用功能,无需复杂配置即可集成到现有系统。模型采用MLA注意力机制和SwiGLU激活函数,在vLLM等主流推理引擎上高效运行,特别适合需要快速响应的智能助手应用。开发者可通过兼容OpenAI/Anthropic的API轻松调用,或基于开源权重进行深度定制。【此简介由AI生成】Python00
- QQwen3-235B-A22B-Instruct-2507Qwen3-235B-A22B-Instruct-2507是一款强大的开源大语言模型,拥有2350亿参数,其中220亿参数处于激活状态。它在指令遵循、逻辑推理、文本理解、数学、科学、编程和工具使用等方面表现出色,尤其在长尾知识覆盖和多语言任务上显著提升。模型支持256K长上下文理解,生成内容更符合用户偏好,适用于主观和开放式任务。在多项基准测试中,它在知识、推理、编码、对齐和代理任务上超越同类模型。部署灵活,支持多种框架如Hugging Face transformers、vLLM和SGLang,适用于本地和云端应用。通过Qwen-Agent工具,能充分发挥其代理能力,简化复杂任务处理。最佳实践推荐使用Temperature=0.7、TopP=0.8等参数设置,以获得最优性能。00
cherry-studio
🍒 Cherry Studio 是一款支持多个 LLM 提供商的桌面客户端TypeScript042GitCode百大开源项目
GitCode百大计划旨在表彰GitCode平台上积极推动项目社区化,拥有广泛影响力的G-Star项目,入选项目不仅代表了GitCode开源生态的蓬勃发展,也反映了当下开源行业的发展趋势。04note-gen
一款跨平台的 Markdown AI 笔记软件,致力于使用 AI 建立记录和写作的桥梁。TSX00PDFMathTranslate
PDF scientific paper translation with preserved formats - 基于 AI 完整保留排版的 PDF 文档全文双语翻译,支持 Google/DeepL/Ollama/OpenAI 等服务,提供 CLI/GUI/DockerPython08
热门内容推荐
最新内容推荐
项目优选









