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

Las siguientes instrucciones suponen un entorno limpio y muestran cómo instalar PHP 7.x, el controlador ODBC de Microsoft, Apache y Microsoft Drivers for PHP for SQL Server en Ubuntu 16.04, 17.10 y 18.04, Red Hat 7, Debian 8 y 9, Suse 12 y macOS 10.11 , 10.12 y 10.13.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, 17.10 and 18.04, RedHat 7, Debian 8 and 9, Suse 12, and macOS 10.11, 10.12 and 10.13. Estas instrucciones aconseja instalar los controladores con PECL, pero también puede descargar los archivos binarios creados previamente desde la Microsoft Drivers para PHP para SQL Server Github página project e instalarlos siguiendo las instrucciones de Carga de 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 la 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 instalar PHP 7.2 de instrucciones de forma predeterminada, vea las notas al principio de cada sección para instalar PHP 7.0 ó 7.1.These instructions 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, con 17.10 y 18.04Installing the drivers on Ubuntu 16.04, 17.10 and 18.04

Nota

Para instalar PHP 7.0 ó 7.1, reemplace 7.2 7.0 ó 7.1 en los siguientes comandos.To install PHP 7.0 or 7.1, replace 7.2 with 7.0 or 7.1 in the following commands. Para Ubuntu 18.04, el paso para agregar el repositorio ondrej no es necesario a menos que se necesita PHP 7.0 ó 7.1.For Ubuntu 18.04, the step to add the ondrej repository is not required unless PHP 7.0 or 7.1 is needed. Sin embargo, la instalación de PHP 7.0 ó 7.1 en Ubuntu 18.04 puede no funcionar como paquetes desde el repositorio ondrej vienen con las dependencias que pueden entrar en conflicto con una base de instalación de Ubuntu 18.04.However, installing PHP 7.0 or 7.1 in Ubuntu 18.04 may not work as packages from the ondrej repository come with dependencies that may conflict with a base Ubuntu 18.04 install.

Paso 1.Step 1. Instalación de 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. Requisitos previos de instalaciónInstall prerequisites

Instalar el controlador ODBC para Ubuntu siguiendo las instrucciones de la página instalación de Linux y macOS.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 pecl install sqlsrv
sudo pecl install pdo_sqlsrv
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

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=pdo_sqlsrv.so" >> /etc/php/7.2/apache2/conf.d/30-pdo_sqlsrv.ini
echo "extension=sqlsrv.so" >> /etc/php/7.2/apache2/conf.d/20-sqlsrv.ini
exit

Paso 5.Step 5. Reinicie Apache y probar 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 Red Hat 7Installing the drivers on Red Hat 7

Nota

Para instalar PHP 7.0 ó 7.1, reemplace remi php72 remi php70 o remi-php71 respectivamente en los siguientes comandos.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. Instalación de 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. Requisitos previos de instalaciónInstall prerequisites

Instalar el controlador ODBC para Red Hat 7 siguiendo las instrucciones de la página instalación de Linux y macOS.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, requiere 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 pecl install sqlsrv
sudo pecl install pdo_sqlsrv
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

Un problema en PECL puede impedir la instalación correcta 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 (pasos similares para pdo_sqlsrv):To install, download the packages and compile manually (similar steps for pdo_sqlsrv):

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

También puede descargar los archivos binarios creados previamente desde la página de Github del proyecto, o bien instalar desde el repositorio 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 probar 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

Nota

Para instalar PHP 7.0 ó 7.1, reemplace 7.2 en los siguientes comandos 7.0 ó 7.1.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. Instalación de 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. Requisitos previos de instalaciónInstall prerequisites

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

También es posible que deba generar la configuración regional correcta para obtener un resultado 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 pecl install sqlsrv
sudo pecl install pdo_sqlsrv
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

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=pdo_sqlsrv.so" >> /etc/php/7.2/apache2/conf.d/30-pdo_sqlsrv.ini
echo "extension=sqlsrv.so" >> /etc/php/7.2/apache2/conf.d/20-sqlsrv.ini

Paso 5.Step 5. Reinicie Apache y probar 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

Nota

Para instalar PHP 7.0, omita el siguiente comando Agregar el repositorio - 7.0 es el valor predeterminado PHP en suse 12.To install PHP 7.0, skip the command below adding the repository - 7.0 is the default PHP on suse 12. Para instalar PHP 7.1, reemplace la dirección URL del repositorio a continuación por la dirección URL siguiente: http://download.opensuse.org/repositories/devel:/languages:/php:/php71/SLE_12/devel:languages:php:php71.repoTo 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. Instalación de 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. Requisitos previos de instalaciónInstall prerequisites

Instalar el controlador ODBC para Suse 12, siga las instrucciones de la página instalación de Linux y macOS.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 pecl install sqlsrv
sudo pecl install pdo_sqlsrv
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

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
exit

Paso 5.Step 5. Reinicie Apache y probar 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 Sierra, El capitán y High SierraInstalling the drivers on macOS El Capitan, Sierra and High Sierra

Si no lo tiene, instale brew 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)"

Nota

Para instalar PHP 7.0 ó 7.1, reemplace php@7.2 con php@7.0 o php@7.1 respectivamente en los siguientes comandos.To install PHP 7.0 or 7.1, replace php@7.2 with php@7.0 or php@7.1 respectively in the following commands.

Paso 1.Step 1. Instalación de PHPInstall PHP

brew tap
brew tap homebrew/core
brew install php@7.2

PHP debe estar ahora en la ruta de acceso--ejecutar php -v para comprobar que se está ejecutando la versión correcta de PHP.PHP should now be in your path -- run php -v to verify that you are running the correct version of PHP. Si no es PHP en la ruta de acceso o no es la versión correcta, ejecute lo siguiente:If PHP is not in your path or it is not the correct version, run the following:

brew link --force --overwrite php@7.2

Paso 2.Step 2. Requisitos previos de instalaciónInstall prerequisites

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

Además, deberá 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

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

brew install apache2

Para buscar al Apache archivo de configuración para la instalación de Apache, ejecuteTo find the Apache configuration file for your Apache installation, run

apachectl -V | grep SERVER_CONFIG_FILE

y sustituya la ruta de acceso httpd.conf en los siguientes comandos:and substitute the path for httpd.conf in the following commands:

echo "LoadModule php7_module /usr/local/opt/php@7.2/lib/httpd/modules/libphp7.so" >> /usr/local/etc/httpd/httpd.conf
(echo "<FilesMatch .php$>"; echo "SetHandler application/x-httpd-php"; echo "</FilesMatch>";) >> /usr/local/etc/httpd/httpd.conf

Paso 5.Step 5. Reinicie Apache y probar 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.

Probar 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, base de datos, nombre de usuario y 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
$stmt = sqlsrv_query($conn, $tsql);

// Error handling
if ($stmt === false) {
    die(formatErrors(sqlsrv_errors()));
}
?>

<h1> Results : </h1>

<?php
while ($row = sqlsrv_fetch_array($stmt, SQLSRV_FETCH_ASSOC)) {
    echo $row['SQL_VERSION'] . PHP_EOL;
}

sqlsrv_free_stmt($stmt);
sqlsrv_close($conn);

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/>";
    }
}
?>

Dirija el explorador http://localhost/testsql.php (http://localhost:8080/testsql.php en macOS).Point your browser to http://localhost/testsql.php (http://localhost:8080/testsql.php on macOS). Ahora podrá 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.

Ver 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 de 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