在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数据库的能力。
PaddleOCR-VLPaddleOCR-VL 是一款顶尖且资源高效的文档解析专用模型。其核心组件为 PaddleOCR-VL-0.9B,这是一款精简却功能强大的视觉语言模型(VLM)。该模型融合了 NaViT 风格的动态分辨率视觉编码器与 ERNIE-4.5-0.3B 语言模型,可实现精准的元素识别。Python00- DDeepSeek-OCRDeepSeek-OCR是一款以大语言模型为核心的开源工具,从LLM视角出发,探索视觉文本压缩的极限。Python00
openPangu-Ultra-MoE-718B-V1.1昇腾原生的开源盘古 Ultra-MoE-718B-V1.1 语言模型Python00
HunyuanWorld-Mirror混元3D世界重建模型,支持多模态先验注入和多任务统一输出Python00
AI内容魔方AI内容专区,汇集全球AI开源项目,集结模块、可组合的内容,致力于分享、交流。03
Spark-Scilit-X1-13B科大讯飞Spark Scilit-X1-13B基于最新一代科大讯飞基础模型,并针对源自科学文献的多项核心任务进行了训练。作为一款专为学术研究场景打造的大型语言模型,它在论文辅助阅读、学术翻译、英语润色和评论生成等方面均表现出色,旨在为研究人员、教师和学生提供高效、精准的智能辅助。Python00
GOT-OCR-2.0-hf阶跃星辰StepFun推出的GOT-OCR-2.0-hf是一款强大的多语言OCR开源模型,支持从普通文档到复杂场景的文字识别。它能精准处理表格、图表、数学公式、几何图形甚至乐谱等特殊内容,输出结果可通过第三方工具渲染成多种格式。模型支持1024×1024高分辨率输入,具备多页批量处理、动态分块识别和交互式区域选择等创新功能,用户可通过坐标或颜色指定识别区域。基于Apache 2.0协议开源,提供Hugging Face演示和完整代码,适用于学术研究到工业应用的广泛场景,为OCR领域带来突破性解决方案。00- HHowToCook程序员在家做饭方法指南。Programmer's guide about how to cook at home (Chinese only).Dockerfile014
Spark-Chemistry-X1-13B科大讯飞星火化学-X1-13B (iFLYTEK Spark Chemistry-X1-13B) 是一款专为化学领域优化的大语言模型。它由星火-X1 (Spark-X1) 基础模型微调而来,在化学知识问答、分子性质预测、化学名称转换和科学推理方面展现出强大的能力,同时保持了强大的通用语言理解与生成能力。Python00- PpathwayPathway is an open framework for high-throughput and low-latency real-time data processing.Python00