Connect to MS SQL Server with PHP 5.3+

Connect to a Microsoft SQL Server database with PHP 5.3+ using the SQLSRV API and sqlsrv_connect. As of PHP 5.3.2 you have to use the SQLSRV API functions to connect to an Microsoft SQL Server database from PHP. For example, use sqlsrv_connect() to create a connection resource and open a connection. The main difference with the older mssql functions of PHP is that SQLSRV requires an Array() with connection information, instead of strings.

Learn how to install the SQLSRV driver and PHP extension on Windows Server.

PHP connect to SQL Server

An example you can use to connect from PHP to SQL Server with sqlsrv_connect() is:

<?php
/*
 * Follow me on Twitter: @Jan_Reilink
 * Donate: https://www.paypal.me/jreilink
 */

function connectMssql($hostname, $username, $dbname, $passwd) {
	$connectionInfo = array("UID" => $username, "PWD" => $passwd, "Database" => $dbname);
	$link = sqlsrv_connect($hostname, $connectionInfo);
	if ($link) {
		return TRUE;
	} else {
		return FALSE;
	}
}
 
if(connectMssql("sql.domain.tld", "user", "deebaase", "passw0rd")) {
	echo "We're connected!";
	// do stuff here, then close the SQL Server connection
	sqlsrv_close($link);
}
?>Code language: HTML, XML (xml)

Support for multiple PHP versions

Suppose you want to support both older and newer versions of PHP. You can use phpversion() to check the version you’re currently using. Then use the SQL Server sqlsrv/mssql_connect() function for that specific version, like:

<?php
/*
 * Follow me on Twitter: @Jan_Reilink
 * Donate: https://www.paypal.me/jreilink
 *
 * Pseudo code for illustration only
 */

function connectMssql($hostname, $username, $dbname, $passwd) {
	if(strnatcmp(phpversion(),"5.3.2") >= 0) {
		/*
		 * PHP versie 5.3.2 or higher needs sqlsrv-driver:
		 * http://msdn.microsoft.com/en-us/library/cc296161%28SQL.90%29.aspx
		 */

		$connectionInfo = array("UID" => $username, "PWD" => $passwd, "Database"=> $dbname);
		$link = sqlsrv_connect($hostname, $connectionInfo);
		if ($link) {
			return TRUE;
			sqlsrv_close($link);
			exit;
		}
	}

	else {
		$link = mssql_connect($hostname, $username, $passwd);
		if ((!$link) || (!mssql_select_db($dbname, $link))) {
			return FALSE;
		}
		else { return TRUE; }
		if ($link) { mssql_close($link); }
	}
}

// execute the function
connectMssql("sql.domain.tld", "user", "deebaase", "passw0rd");
?>Code language: HTML, XML (xml)

SQLSRV Driver API Reference

You can find more information on the SQLSRV API on Microsofts MSDN website: SQLSRV Driver API Reference (Microsoft Drivers for PHP for SQL Server)

List all table names in an SQL Server database – sqlsrv_query() show tables example

You can use this PHP example, using sqlsrv_query(), to perform a SHOW TABLES query:

<?php
/*
 * Follow me on Twitter: @Jan_Reilink
 * Donate: https://www.paypal.me/jreilink
 *
 */

$connectionInfo = array("UID" => "db-user", "PWD" => "passw0rd", "Database" => "deebaase");
$link = sqlsrv_connect("sql.domain.tld", $connectionInfo);
$sql = "SELECT table_name FROM information_schema.tables";

$stmt = sqlsrv_query( $link, $sql);
while( $row = sqlsrv_fetch_array( $stmt, SQLSRV_FETCH_ASSOC) ) {
	echo $row['table_name']."<br />";
}

if( $stmt === false ) {
	die( print_r( sqlsrv_errors(), true));
}
?>Code language: HTML, XML (xml)

sqlsrv_query – Prepares and executes a query.

Jan Reilink

Hi, my name is Jan. I am not a hacker, coder, developer or guru. I am merely an application manager / systems administrator, doing my daily thing at Embrace - The Human Cloud. In the past I worked for clidn and Vevida. With over 20 years of experience, my specialties include Windows Server, IIS, Linux (CentOS, Debian), security, PHP, websites & optimization. I blog at https://www.saotn.org.