Linux y macOS Tutorial de instalación de Drivers de Microsoft para PHP para SQL ServerLinux and macOS Installation Tutorial for the Microsoft Drivers for PHP for SQL Server

Las siguientes instrucciones supone un entorno limpio y muestran cómo instalar PHP 7.x, el controlador ODBC de Microsoft, Apache y Microsoft Drivers para PHP para SQL Server en Ubuntu 16.04 y 17.10, RedHat 7, 12 de Suse 8 y 9, Debian y macOS X 10.11 y 10.12.The following instructions assume a clean environment and show how to install PHP 7.x, the Microsoft ODBC driver, Apache, and the Microsoft Drivers for PHP for SQL Server on Ubuntu 16.04 and 17.10, RedHat 7, Debian 8 and 9, Suse 12, and macOS X 10.11 and 10.12. Estas instrucciones aconseja instalar los controladores con PECL, pero también puede descargar los archivos binarios creada previamente desde la Microsoft Drivers for PHP para SQL Server Github página de proyecto e instalarlos siguiendo las instrucciones de Carga los controladores de Microsoft para PHP para SQL Server.These instructions advise installing the drivers using PECL, but you can also download the prebuilt binaries from the Microsoft Drivers for PHP for SQL Server Github project page and install them following the instructions in Loading the Microsoft Drivers for PHP for SQL Server. Para obtener una explicación de la carga de extensión y por qué no agregar las extensiones en php.ini, vea la sección sobre carga de los controladores.For an explanation of extension loading and why we do not add the extensions to php.ini, see the section on loading the drivers.

Estos instalación instrucción 7.2 PHP de forma predeterminada, vea las notas al principio de cada sección para instalar PHP 7.0 ó 7.1.These instruction install PHP 7.2 by default -- see the notes at the beginning of each section to install PHP 7.0 or 7.1.

Contenido de esta página:Contents of this page:

Instalar a los controladores en Ubuntu 16.04 y 17.10Installing the drivers on Ubuntu 16.04 and 17.10

> [!NOTE]
> To install PHP 7.0 or 7.1, replace 7.2 with 7.0 or 7.1 in the following commands.

Paso 1.Step 1. Instalar PHPInstall PHP

sudo su
add-apt-repository ppa:ondrej/php -y
apt-get update
apt-get install php7.2 php7.2-dev php7.2-xml -y --allow-unauthenticated

Paso 2.Step 2. Instalar los requisitos previosInstall prerequisites

Instalar el controlador ODBC para Ubuntu siguiendo las instrucciones de la página de instalación de Linux y Mac OS.Install the ODBC driver for Ubuntu by following the instructions on the Linux and macOS installation page.

Paso 3.Step 3. Instalar a los controladores PHP para Microsoft SQL ServerInstall the PHP drivers for Microsoft SQL Server

sudo su
echo extension=pdo_sqlsrv.so >> `php --ini | grep "Scan for additional .ini files" | sed -e "s|.*:\s*||"`/30-pdo_sqlsrv.ini
echo extension=sqlsrv.so >> `php --ini | grep "Scan for additional .ini files" | sed -e "s|.*:\s*||"`/20-sqlsrv.ini
exit
sudo pecl install sqlsrv
sudo pecl install pdo_sqlsrv

Paso 4.Step 4. Instalar a Apache y configurar la carga del controladorInstall Apache and configure driver loading

sudo su
apt-get install libapache2-mod-php7.2 apache2
a2dismod mpm_event
a2enmod mpm_prefork
a2enmod php7.2
echo "extension=sqlsrv.so" >> /etc/php/7.2/apache2/php.ini
echo "extension=pdo_sqlsrv.so" >> /etc/php/7.2/apache2/php.ini

Paso 5.Step 5. Reinicie Apache y pruebe el script de ejemploRestart Apache and test the sample script

sudo service apache2 restart

Para probar la instalación, consulte comprobación de la instalación al final de este documento.To test your installation, see Testing your installation at the end of this document.

Instalar a los controladores de Red Hat 7Installing the drivers on Red Hat 7

> [!NOTE]
> To install PHP 7.0 or 7.1, replace remi-php72 with remi-php70 or remi-php71 respectively in the following commands.

Paso 1.Step 1. Instalar PHPInstall PHP

sudo su
wget https://dl.fedoraproject.org/pub/epel/epel-release-latest-7.noarch.rpm
wget http://rpms.remirepo.net/enterprise/remi-release-7.rpm
rpm -Uvh remi-release-7.rpm epel-release-latest-7.noarch.rpm
subscription-manager repos --enable=rhel-7-server-optional-rpms
yum-config-manager --enable remi-php72
yum update
yum install php php-pdo php-xml php-pear php-devel re2c gcc-c++ gcc

Paso 2.Step 2. Instalar los requisitos previosInstall prerequisites

Instalar el controlador ODBC para Red Hat 7 siguiendo las instrucciones de la página de instalación de Linux y Mac OS.Install the ODBC driver for Red Hat 7 by following the instructions on the Linux and macOS installation page.

Compilar los controladores PHP con PECL con PHP 7.2 necesita un GCC más reciente que el valor predeterminado:Compiling the PHP drivers with PECL with PHP 7.2 requires a more recent GCC than the default:

sudo yum-config-manager --enable rhel-server-rhscl-7-rpms
sudo yum install devtoolset-7
scl enable devtoolset-7 bash

Paso 3.Step 3. Instalar a los controladores PHP para Microsoft SQL ServerInstall the PHP drivers for Microsoft SQL Server

sudo su
echo extension=pdo_sqlsrv.so >> `php --ini | grep "Scan for additional .ini files" | sed -e "s|.*:\s*||"`/30-pdo_sqlsrv.ini
echo extension=sqlsrv.so >> `php --ini | grep "Scan for additional .ini files" | sed -e "s|.*:\s*||"`/20-sqlsrv.ini
exit
sudo pecl install sqlsrv
sudo pecl install pdo_sqlsrv

Un problema en PECL puede impedir la correcta instalación de la versión más reciente de los controladores incluso si ha actualizado GCC.An issue in PECL may prevent correct installation of the latest version of the drivers even if you have upgraded GCC. Para instalar, descargue los paquetes y compile manualmente:To install, download the packages and compile manually:

pecl download sqlsrv
tar xvzf sqlsrv-5.2.0.tgz
cd sqlsrv-5.2.0/
phpize
./configure --with-php-config=/usr/bin/php-config
make
sudo make install

O bien puede descargar los archivos binarios creada previamente desde la página de proyecto de Github, o bien instalar desde el repositorio de Remi:You can alternatively download the prebuilt binaries from the Github project page, or install from the Remi repo:

sudo yum install php-sqlsrv php-pdo_sqlsrv

Paso 4.Step 4. Instalar ApacheInstall Apache

sudo yum install httpd

SELinux se instala de forma predeterminada y se ejecuta en modo aplicar.SELinux is installed by default and runs in Enforcing mode. Para permitir que Apache para conectarse a bases de datos a través de SELinux, ejecute el siguiente comando:To allow Apache to connect to databases through SELinux, run the following command:

sudo setsebool -P httpd_can_network_connect_db 1

Paso 5.Step 5. Reinicie Apache y pruebe el script de ejemploRestart Apache and test the sample script

sudo apachectl restart

Para probar la instalación, consulte comprobación de la instalación al final de este documento.To test your installation, see Testing your installation at the end of this document.

Instalar a los controladores en Debian 8 y 9Installing the drivers on Debian 8 and 9

> [!NOTE]
> To install PHP 7.0 or 7.1, replace 7.2 in the following commands with 7.0 or 7.1.

Paso 1.Step 1. Instalar PHPInstall PHP

sudo su
apt-get install curl apt-transport-https
wget -O /etc/apt/trusted.gpg.d/php.gpg https://packages.sury.org/php/apt.gpg
echo "deb https://packages.sury.org/php/ $(lsb_release -sc) main" > /etc/apt/sources.list.d/php.list
apt-get update
apt-get install –y php7.2 php7.2-dev php7.2-xml

Paso 2.Step 2. Instalar los requisitos previosInstall prerequisites

Instalar el controlador ODBC para Debian siguiendo las instrucciones de la página de instalación de Linux y Mac OS.Install the ODBC driver for Debian by following the instructions on the Linux and macOS installation page.

También debe generar la configuración regional correcta para obtener una salida PHP se muestre correctamente en un explorador.You may also need to generate the correct locale to get PHP output to display correctly in a browser. Por ejemplo, para la configuración regional UTF-8 de en_US, ejecute los siguientes comandos:For example, for the en_US UTF-8 locale, run the following commands:

sudo su
sed -i 's/# en_US.UTF-8 UTF-8/en_US.UTF-8 UTF-8/g' /etc/locale.gen
locale-gen

Paso 3.Step 3. Instalar a los controladores PHP para Microsoft SQL ServerInstall the PHP drivers for Microsoft SQL Server

sudo su
echo extension=pdo_sqlsrv.so >> `php --ini | grep "Scan for additional .ini files" | sed -e "s|.*:\s*||"`/30-pdo_sqlsrv.ini
echo extension=sqlsrv.so >> `php --ini | grep "Scan for additional .ini files" | sed -e "s|.*:\s*||"`/20-sqlsrv.ini
exit
sudo pecl install sqlsrv
sudo pecl install pdo_sqlsrv

Paso 4.Step 4. Instalar a Apache y configurar la carga del controladorInstall Apache and configure driver loading

sudo su
apt-get install libapache2-mod-php7.2 apache2
a2dismod mpm_event
a2enmod mpm_prefork
a2enmod php7.2
echo "extension=sqlsrv.so" >> /etc/php/7.2/apache2/php.ini
echo "extension=pdo_sqlsrv.so" >> /etc/php/7.2/apache2/php.ini

Paso 5.Step 5. Reinicie Apache y pruebe el script de ejemploRestart Apache and test the sample script

sudo service apache2 restart

Para probar la instalación, consulte comprobación de la instalación al final de este documento.To test your installation, see Testing your installation at the end of this document.

Instalar a los controladores en Suse 12Installing the drivers on Suse 12

> [!NOTE]
> To install PHP 7.0, skip the command below adding the repository - 7.0 is the default PHP on suse 12.
> To install PHP 7.1, replace the repository URL below with the following URL:
  `http://download.opensuse.org/repositories/devel:/languages:/php:/php71/SLE_12/devel:languages:php:php71.repo`

Paso 1.Step 1. Instalar PHPInstall PHP

sudo su
zypper -n ar -f http://download.opensuse.org/repositories/devel:languages:php/SLE_12/devel:languages:php.repo
zypper --gpg-auto-import-keys refresh
zypper -n install php7 php7-pear php7-devel

Paso 2.Step 2. Instalar los requisitos previosInstall prerequisites

Instalar el controlador ODBC para Suse 12 siguiendo las instrucciones de la página de instalación de Linux y Mac OS.Install the ODBC driver for Suse 12 by following the instructions on the Linux and macOS installation page.

Paso 3.Step 3. Instalar a los controladores PHP para Microsoft SQL ServerInstall the PHP drivers for Microsoft SQL Server

sudo su
echo extension=pdo_sqlsrv.so >> `php --ini | grep "Scan for additional .ini files" | sed -e "s|.*:\s*||"`/pdo_sqlsrv.ini
echo extension=sqlsrv.so >> `php --ini | grep "Scan for additional .ini files" | sed -e "s|.*:\s*||"`/sqlsrv.ini
exit
sudo pecl install sqlsrv
sudo pecl install pdo_sqlsrv

Paso 4.Step 4. Instalar a Apache y configurar la carga del controladorInstall Apache and configure driver loading

sudo su
zypper install apache2 apache2-mod_php7
a2enmod php7
echo "extension=sqlsrv.so" >> /etc/php7/apache2/php.ini
echo "extension=pdo_sqlsrv.so" >> /etc/php7/apache2/php.ini

Paso 5.Step 5. Reinicie Apache y pruebe el script de ejemploRestart Apache and test the sample script

sudo systemctl restart apache2

Para probar la instalación, consulte comprobación de la instalación al final de este documento.To test your installation, see Testing your installation at the end of this document.

Instalar a los controladores en macOS El capitán y SierraInstalling the drivers on macOS El Capitan and Sierra

Si no lo tiene, instale cerveza como sigue:If you do not already have it, install brew as follows:

/usr/bin/ruby -e "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/master/install)"
> [!NOTE]
> To install PHP 7.0 or 7.1, replace php72 with php70 or php71 respectively in the following commands.

Paso 1.Step 1. Instalar PHPInstall PHP

brew tap
brew tap homebrew/dupes
brew tap homebrew/versions
brew tap homebrew/homebrew-php
brew install php72 --with-pear --with-httpd24 --with-cgi
echo 'export PATH="/usr/local/sbin:$PATH"' >> ~/.bash_profile
echo 'export PATH="/usr/local/bin:$PATH"' >> ~/.bash_profile
source ~/.bash_profile

Paso 2.Step 2. Instalar los requisitos previosInstall prerequisites

Instalar el controlador ODBC para macOS siguiendo las instrucciones de la página de instalación de Linux y Mac OS.Install the ODBC driver for macOS by following the instructions on the Linux and macOS installation page.

Además, debe instalar las herramientas de creación de GNU:In addition, you may need to install the GNU make tools:

brew install autoconf automake libtool

Paso 3.Step 3. Instalar a los controladores PHP para Microsoft SQL ServerInstall the PHP drivers for Microsoft SQL Server

chmod -R ug+w /usr/local/opt/php72/lib/php
pear config-set php_ini /usr/local/etc/php/7.2/php.ini system
sudo pecl install sqlsrv
sudo pecl install pdo_sqlsrv

Paso 4.Step 4. Instalar a Apache y configurar la carga del controladorInstall Apache and configure driver loading

(echo "<FilesMatch .php$>"; echo "SetHandler application/x-httpd-php"; echo "</FilesMatch>";) >> /usr/local/etc/httpd/httpd.conf

Paso 5.Step 5. Reinicie Apache y pruebe el script de ejemploRestart Apache and test the sample script

sudo apachectl restart

Para probar la instalación, consulte comprobación de la instalación al final de este documento.To test your installation, see Testing your installation at the end of this document.

Comprobación de la instalaciónTesting Your Installation

Para probar esta secuencia de comandos de ejemplo, cree un archivo denominado testsql.php en la raíz del documento de su sistema.To test this sample script, create a file called testsql.php in your system's document root. Se trata de /var/www/html/ en Ubuntu, Debian y Redhat, /srv/www/htdocs en SUSE, o /usr/local/var/www en macOS.This is /var/www/html/ on Ubuntu, Debian, and Redhat, /srv/www/htdocs on SUSE, or /usr/local/var/www on macOS. Copie el script siguiente, reemplazando el servidor, la base de datos, el nombre de usuario y la contraseña según corresponda.Copy the following script to it, replacing the server, database, username, and password as appropriate.

<?php
$serverName = "yourServername";
$connectionOptions = array(
    "Database" => "yourDatabase",
    "Uid" => "yourUsername",
    "PWD" => "yourPassword"
);

//Establishes the connection
$conn = sqlsrv_connect($serverName, $connectionOptions);
if( $conn === false ) {
    die( FormatErrors( sqlsrv_errors()));
}

//Select Query
$tsql= "SELECT @@Version as SQL_VERSION";

//Executes the query
$getResults= sqlsrv_query($conn, $tsql);

//Error handling
if ($getResults == FALSE)
    die(FormatErrors(sqlsrv_errors()));
?>

<h1> Results : </h1>

<?php
while ($row = sqlsrv_fetch_array($getResults, SQLSRV_FETCH_ASSOC)) {
    echo ($row['SQL_VERSION']);
    echo ("<br/>");
}

sqlsrv_free_stmt($getResults);

function FormatErrors( $errors )
{
    /* Display errors. */
    echo "Error information: <br/>";
    foreach ( $errors as $error )
    {
        echo "SQLSTATE: ".$error['SQLSTATE']."<br/>";
        echo "Code: ".$error['code']."<br/>";
        echo "Message: ".$error['message']."<br/>";
    }
}
?>

El explorador a http://localhost/testsql.php (http://localhost:8080/testsql.php en Mac OS).Point your browser to http://localhost/testsql.php (http://localhost:8080/testsql.php on macOS). Ahora debe ser capaz de conectarse a la base de datos SQL de SQL Server o SQL Azure.You should now be able to connect to your SQL Server/Azure SQL database.

Vea tambiénSee Also

Introducción a los controladores de Microsoft para PHP para SQL ServerGetting Started with the Microsoft Drivers for PHP for SQL Server

Carga los controladores de Microsoft para PHP para SQL ServerLoading the Microsoft Drivers for PHP for SQL Server

Requisitos del sistema para los controladores de Microsoft para PHP para SQL ServerSystem Requirements for the Microsoft Drivers for PHP for SQL Server