System Requirements for the Microsoft Drivers for PHP for SQL Server

DownloadDownload PHP Driver

This document lists the components that must be installed on your system to access data in a SQL Server or Azure SQL Database using the Microsoft Drivers for PHP for SQL Server.

Versions 3.1 and later of the Microsoft PHP Drivers for SQL Server are officially supported. For full details on support lifecycles and requirements including earlier versions of the PHP drivers, see the support matrix.

PHP

For information about how to download and install the latest stable PHP binaries, see the PHP web site. The Microsoft Drivers for PHP for SQL Server require the following versions of PHP:

PHP for SQL Server driver version →
↓ PHP version
5.2
 
4.3
 
4.0
 
3.2
 
3.1
 
7.2 7.2.1+ on Windows
7.2.0+ on other platforms
7.1 7.1.0+ 7.1.0+
7.0 7.0.0+ 7.0.0+ 7.0.0+
5.6 5.6.4+
5.5 5.5.16+ 5.5.16+
5.4 5.4.32 5.4.32

ODBC Driver

The correct version of the Microsoft ODBC Driver for SQL Server is required on the computer on which PHP is running. Download from the following links:

If you are using a 64-bit operating system, the ODBC 64-bit installer installs both 32-bit and 64-bit ODBC drivers. If you use a 32-bit operating system, use the ODBC x86 installer.

PHP for SQL Server driver version →
↓ ODBC Driver version
5.2
 
4.3
 
4.0
 
3.2
 
3.1
 
ODBC Driver 17 Y
ODBC Driver 13.1 Y Y Y
ODBC Driver 13 Y
ODBC Driver 11 Y Y Y Y Y

If you are using the SQLSRV driver, sqlsrv_client_info returns information about which version of SQL Server Microsoft ODBC Driver for SQL Server is being used by the Microsoft Drivers for PHP for SQL Server. If you are using the PDO_SQLSRV driver, you can use PDO::getAttribute to discover the version.

SQL Server

Azure SQL Databases are supported. For information, see Connecting to Microsoft Azure SQL Database.

PHP for SQL Server driver version →
↓ SQL Server version
5.2
 
4.3
 
4.0
 
3.2
 
3.1
 
Azure SQL Managed Instance
(Extended Private Preview)
Y Y
Azure SQL Data Warehouse Y Y
SQL Server 2017 Y Y
SQL Server 2016 Y Y Y
SQL Server 2014 Y Y Y Y Y
SQL Server 2012 Y Y Y Y Y
SQL Server 2008 R2 Y Y Y Y Y
SQL Server 2008 Y Y Y

Operating Systems

Supported operating systems for the versions of the driver are as follows:

PHP for SQL Server driver version →
↓ Operating system
5.2
 
4.3
 
4.0
 
3.2
 
3.1
 
Windows Server 2016 Y Y
Windows Server 2012 R2 Y Y Y Y Y
Windows Server 2012 Y Y Y Y Y
Windows Server 2008 R2 SP1 Y Y Y
Windows Server 2008 SP2 Y Y Y
Windows 10 Y Y Y
Windows 8.1 Y Y Y Y Y
Windows 8 Y Y Y Y
Windows 7 SP1 Y Y Y
Windows Vista SP2 Y Y Y
Ubuntu 17.10 (64-bit) Y
Ubuntu 16.04 (64-bit) Y Y Y
Ubuntu 15.10 (64-bit) Y
Ubuntu 15.04 (64-bit) Y
Debian 9 (64-bit) Y
Debian 8 (64-bit) Y Y
Red Hat Enterprise Linux 7 (64-bit) Y Y Y
Suse Enterprise Linux 12 (64-bit) Y
macOS Sierra (64-bit) Y Y
macOS El Capitan (64-bit) Y Y

Driver Versions

This section lists the driver files that are included with each version of the Microsoft Drivers for PHP for SQL Server. Each installation package contains SQLSRV and PDO_SQLSRV driver files in threaded and non-threaded variants. On Windows, they are also available in 32-bit and 64-bit variants. To configure the driver for use with the PHP runtime, follow the installation instructions in Loading the Microsoft Drivers for PHP for SQL Server.

On supported versions of Linux and macOS, the appropriate drivers can be installed using PHP's PECL package system, following the Linux and macOS installation instructions. Alternatively, you can download prebuilt binaries for your platform from the Microsoft Drivers for PHP for SQL Server Github project page -- the tables below list the files found in the prebuilt binary packages.

Microsoft Drivers 5.2 for PHP for SQL Server:

On Windows, the following versions of the driver are included:

Driver file PHP version Thread safe? Use with PHP .dll
32-bit php_sqlsrv_7_nts.dll
32-bit php_pdo_sqlsrv_7_nts.dll
7.0 no 32-bit php7.dll
32-bit php_sqlsrv_7_ts.dll
32-bit php_pdo_sqlsrv_7_ts.dll
7.0 yes 32-bit php7ts.dll
64-bit php_sqlsrv_7_nts.dll
64-bit php_pdo_sqlsrv_7_nts.dll
7.0 no 64-bit php7.dll
64-bit php_sqlsrv_7_ts.dll
64-bit php_pdo_sqlsrv_7_ts.dll
7.0 yes 64-bit php7ts.dll
32-bit php_sqlsrv_71_nts.dll
32-bit php_pdo_sqlsrv_71_nts.dll
7.1 no 32-bit php7.dll
32-bit php_sqlsrv_71_ts.dll
32-bit php_pdo_sqlsrv_71_ts.dll
7.1 yes 32-bit php7ts.dll
64-bit php_sqlsrv_71_nts.dll
64-bit php_pdo_sqlsrv_71_nts.dll
7.1 no 64-bit php7.dll
64-bit php_sqlsrv_71_ts.dll
64-bit php_pdo_sqlsrv_71_ts.dll
7.1 yes 64-bit php7ts.dll
32-bit php_sqlsrv_72_nts.dll
32-bit php_pdo_sqlsrv_72_nts.dll
7.2 no 32-bit php7.dll
32-bit php_sqlsrv_72_ts.dll
32-bit php_pdo_sqlsrv_72_ts.dll
7.2 yes 32-bit php7ts.dll
64-bit php_sqlsrv_72_nts.dll
64-bit php_pdo_sqlsrv_72_nts.dll
7.2 no 64-bit php7.dll
64-bit php_sqlsrv_72_ts.dll
64-bit php_pdo_sqlsrv_72_ts.dll
7.2 yes 64-bit php7ts.dll

On Linux, the following versions of the driver are included:

Driver file PHP version Thread safe?
php_sqlsrv_7_nts.so
php_pdo_sqlsrv_7_nts.so
7.0 no
php_sqlsrv_7_ts.so
php_pdo_sqlsrv_7_ts.so
7.0 yes
php_sqlsrv_71_nts.so
php_pdo_sqlsrv_71_nts.so
7.1 no
php_sqlsrv_71_ts.so
php_pdo_sqlsrv_71_ts.so
7.1 yes
php_sqlsrv_72_nts.so
php_pdo_sqlsrv_72_nts.so
7.2 no
php_sqlsrv_72_ts.so
php_pdo_sqlsrv_72_ts.so
7.2 yes

Microsoft Drivers 4.3 for PHP for SQL Server:

On Windows, the following versions of the driver are included:

Driver file PHP version Thread safe? Use with PHP .dll
32-bit php_sqlsrv_7_nts.dll
32-bit php_pdo_sqlsrv_7_nts.dll
7.0 no 32-bit php7.dll
32-bit php_sqlsrv_7_ts.dll
32-bit php_pdo_sqlsrv_7_ts.dll
7.0 yes 32-bit php7ts.dll
64-bit php_sqlsrv_7_nts.dll
64-bit php_pdo_sqlsrv_7_nts.dll
7.0 no 64-bit php7.dll
64-bit php_sqlsrv_7_ts.dll
64-bit php_pdo_sqlsrv_7_ts.dll
7.0 yes 64-bit php7ts.dll
32-bit php_sqlsrv_71_nts.dll
32-bit php_pdo_sqlsrv_71_nts.dll
7.1 no 32-bit php7.dll
32-bit php_sqlsrv_71_ts.dll
32-bit php_pdo_sqlsrv_71_ts.dll
7.1 yes 32-bit php7ts.dll
64-bit php_sqlsrv_71_nts.dll
64-bit php_pdo_sqlsrv_71_nts.dll
7.1 no 64-bit php7.dll
64-bit php_sqlsrv_71_ts.dll
64-bit php_pdo_sqlsrv_71_ts.dll
7.1 yes 64-bit php7ts.dll

On Linux, the following versions of the driver are included:

Driver file PHP version Thread safe?
php_sqlsrv_7_nts.so
php_pdo_sqlsrv_7_nts.so
7.0 no
php_sqlsrv_7_ts.so
php_pdo_sqlsrv_7_ts.so
7.0 yes
php_sqlsrv_71_nts.so
php_pdo_sqlsrv_71_nts.so
7.1 no
php_sqlsrv_71_ts.so
php_pdo_sqlsrv_71_ts.so
7.1 yes

Microsoft Drivers 4.0 for PHP for SQL Server:

On Windows, the following versions of the driver are included:

Driver file PHP version Thread safe? Use with PHP .dll
php_sqlsrv_7_nts_x86.dll
php_pdo_sqlsrv_7_nts_x86.dll
7.0 no 32-bit php7.dll
php_sqlsrv_7_ts_x86.dll
php_pdo_sqlsrv_7_ts_x86.dll
7.0 yes 32-bit php7ts.dll
php_sqlsrv_7_nts_x64.dll
php_pdo_sqlsrv_7_nts_x64.dll
7.0 no 64-bit php7.dll
php_sqlsrv_7_ts_x64.dll
php_pdo_sqlsrv_7_ts_x64.dll
7.0 yes 64-bit php7ts.dll

On Linux, the following versions of the driver are included:

Driver file PHP version Thread safe?
php_sqlsrv_7_nts.so
php_pdo_sqlsrv_7_nts.so
7.0 no
php_sqlsrv_7_ts.so
php_pdo_sqlsrv_7_ts.so
7.0 yes

Microsoft Drivers 3.2 for PHP for SQL Server:

On Windows, the following versions of the driver are included:

Driver file PHP version Thread safe? Use with PHP .dll
php_sqlsrv_54_nts.dll
php_pdo_sqlsrv_54_nts.dll
5.4 no php5.dll
php_sqlsrv_54_ts.dll
php_pdo_sqlsrv_54_ts.dll
5.4 yes php5ts.dll
php_sqlsrv_55_nts.dll
php_pdo_sqlsrv_55_nts.dll
5.5 no php5.dll
php_sqlsrv_55_ts.dll
php_pdo_sqlsrv_55_ts.dll
5.5 yes php5ts.dll
php_sqlsrv_56_nts.dll
php_pdo_sqlsrv_56_nts.dll
5.6 no php5.dll
php_sqlsrv_56_ts.dll
php_pdo_sqlsrv_56_ts.dll
5.6 yes php5ts.dll

Microsoft Drivers 3.1 for PHP for SQL Server:

On Windows, the following versions of the driver are included:

Driver file PHP version Thread safe? Use with PHP .dll
php_sqlsrv_54_nts.dll
php_pdo_sqlsrv_54_nts.dll
5.4 no php5.dll
php_sqlsrv_54_ts.dll
php_pdo_sqlsrv_54_ts.dll
5.4 yes php5ts.dll
php_sqlsrv_55_nts.dll
php_pdo_sqlsrv_55_nts.dll
5.5 no php5.dll
php_sqlsrv_55_ts.dll
php_pdo_sqlsrv_55_ts.dll
5.5 yes php5ts.dll

See Also

Getting Started with the Microsoft Drivers for PHP for SQL Server

Programming Guide for the Microsoft Drivers for PHP for SQL Server

SQLSRV Driver API Reference

PDO_SQLSRV Driver API Reference