我最近启动了一个项目,要求我将Microsoft SQL Server数据库与Laravel 5.5应用程序连接起来,所以我想我会记录如何安装pdo_sqlsrv模块并在Docker中安装PHP的Microsoft驱动程序。
安装驱动程序后,您可以轻松配置Laravel以使用Microsoft SQL Server连接:
DB_CONNECTION=sqlsrv
我在大多数PHP项目中都使用Docker - 我将在下周发布一本关于使用Docker和PHP的书 - 所以我想我会告诉你使用PDO驱动程序获得SQL服务器连接的方法。
这是Dockerfile安装perquisites和pdo_sqlsrvPECL模块所需的:
FROM php:7.1-apache
ENV ACCEPT_EULA=Y
# Microsoft SQL Server Prerequisites
RUN apt-get update \
&& curl https://packages.microsoft.com/keys/microsoft.asc | apt-key add - \
&& curl https://packages.microsoft.com/config/debian/9/prod.list \> /etc/apt/sources.list.d/mssql-release.list\
&& apt-get install -y --no-install-recommends \locales \apt-transport-https \
&&echo"en_US.UTF-8 UTF-8"> /etc/locale.gen \
&& locale-gen \
&& apt-get update \
&& apt-get -y --no-install-recommends install \unixodbc-dev \msodbcsql17
RUN docker-php-ext-install mbstring pdo pdo_mysql \
&& pecl install sqlsrv pdo_sqlsrv xdebug \
&& docker-php-ext-enable sqlsrv pdo_sqlsrv xdebug
COPY index.php /var/www/html/
我在使用Debian Stretch和PHP 7.2安装必要的软件包时遇到了困难,因此我使用官方的PHP 7.1 Docker镜像作为我在撰写本文时延伸的基本图像。
我正在演示apache版本,因此很容易提供index.php文件来验证安装。在我的大多数项目中,我使用Caddy或Nginx作为Web服务器,但Apache也是一个很好的选择!
第一个RUN指令安装成功安装msodbcsql17和unixodbc-dev包所需的包:
# Microsoft SQL Server Prerequisites
RUN apt-get update \
&& curl https://packages.microsoft.com/keys/microsoft.asc | apt-key add - \
&& curl https://packages.microsoft.com/config/debian/9/prod.list \> /etc/apt/sources.list.d/mssql-release.list\
&& apt-get install -y --no-install-recommends \locales \apt-transport-https \
&&echo"en_US.UTF-8 UTF-8"> /etc/locale.gen \
&& locale-gen \
&& apt-get update \
&& apt-get -y --no-install-recommends install \
unixodbc-dev \
msodbcsql17
这些软件包是为SQL Server的PDO驱动程序安装PECL模块所必需的。您可以在Microsoft / msphpsql GitHub项目自述文件中找到各种平台的安装说明。
同样重要的是要注意我们设置运行时所需的ACCEPT_EULA环境变量。它表示您在安装软件包时已接受最终用户许可协议。Yapt-get install msodbcsql
下一个RUN指令使用官方PHP映像的docker-php-ext-install脚本安装PHP扩展。在这种情况下,我安装Laravel前提mbstring沿pdo,并且pdo_mysql:
RUN apt-get update \
&& apt-get -y --no-install-recommends install \
libxml2-dev \
&& docker-php-ext-install mbstring pdo pdo_mysql soap \
&& pecl install sqlsrv pdo_sqlsrv xdebug \
&& docker-php-ext-enable sqlsrv pdo_sqlsrv xdebug
最后,这个RUN指令最重要的部分,我们pecl用来安装sqlsrv和pdo_sqlsrv模块,然后使用docker-php-ext-enable它们来启用它们。我也在安装Xdebug,因为我通常在大多数图像中安装它以进行开发。
构建和运行容器
最后Dockerfile一条指令是COPY指令,它复制一个index.php我们现在将从命令行创建的简单文件:
$echo"<?php phpinfo();"> index.php
当我们构建映像时,Dockerfile会将index.php文件复制到Apache将要查找的位置,我们可以验证SQL Server驱动程序是否已安装并使用PHP。
您可以使用docker build命令构建映像以快速尝试:
$ docker build --pull -t sqlserver-demo .
图像将需要几分钟,具体取决于您的连接速度。构建完成后,您可以从命令行运行它:
$ docker run --rm -p 8080:80 sqlserver-demo
该docker run命令运行容器,并在-p 8080:80标志的帮助下,我们已映射8080到正在侦听端口的容器80。--rm一旦退出,该标志将移除容器。
容器运行后,您应该在控制台中看到一些Apache日志,并且您可以在浏览器中访问http:// localhost:8080以验证是否已启用SQL Server模块:
您现在应该能够连接到PHP 7.1应用程序中的SQL Server数据库!我保持这个例子很简单,只关注安装SQL Server PDO驱动程序所需的步骤,但我希望你能看到Docker如何帮助减轻从PHP应用程序连接到Microsoft SQL数据库的麻烦。