Making a PHP Site on Linux Work with a Microsoft SQL Server Database
by David Perrin
A recent project at my current employer called for creating a new web frontend to an existing MSSQL database. My boss, having created a sophisticated MySQL and PHP-driven black diamond web site in PHP was enthused about the prospects of further web development with PHP. He suggested trying to get PHP on a Linux box to connect to a MSSQL database server.
An attempt at this task made months before ended in frustration. This time, after nibbling away at the task for a couple of days on a standard Red Hat system, success was had. Here’s how.
Similar to Windows, one method of connecting to a MSSQL database is through an ODBC DSN (open database connection, data source name). The ODBC DSN specifies a MSSQL driver to make the connection to the database. Recent versions of Red Hat include the utility for creating the ODBC DSN, but not the driver.
The driver chosen and discussed in this article is a FreeTDS driver. TDS (tabular datastream) is a protocol used by Sybase and MSSQL. This driver enables the Linux machine to connect to the MSSQL server.
Once the driver is installed, you can configure an ODBC connection on your Linux machine to use the driver, which then allows a connection to MSSQL. Start by downloading and saving the FreeTDS driver.
Next, uncompress, configure and make the FreeTDS driver.
[root@localhost]# tar xvfz freetds-0.60.tgz
[root@localhost]# cd freetds-0.60
[root@localhost]# ./configure –with-tdsver=7.0 –with-unixodbc
su to root if you are not already root.
[root@localhost]# make install
[root@localhost]# make clean
Now test the ability of FreeTDS to connect to your MSSQL server:
[root@localhost]# /usr/local/bin/tsql -S -U
With luck, you’ll see the following prompt
Then, use Ctrl-C to exit.
If the tsql command doesn’t return the 1> prompt, verify that you can get to your MSSQL server with
[root@localhost]# telnet 1433
If you’re able to telnet to port 1433, try opening the Microsoft Query Analyzer. Use the login combination you tried above to verify that a user name and password combination exists for your SQL server.
Once you can get the 1> prompt from tsql, we can configure the TDS driver and make the ODBC connection.
[root@localhost]# cd /usr/local/etc
From /usr/local/etc/, edit freetds.conf. At the end of this file, add an entry something like this:
host = mssql.serverhost.com
port = 1433
tds version = 7.0
Set Up the ODBC Data Source
Red Hat comes with a graphic interface tool called ODBCConfig. We’ll use it to set up our DSN.
From KDE, select K -> System -> ODBCConfig
From GNOME, select G -> Programs -> System -> ODBCConfig
Click on the Drivers Tab and click Add. The window should contain the following data:
Description: v0.60 with Protocol v7.0
The rest can be blank. Click the check-mark in the upper left-hand corner. Select the TDS driver and click OK.
Description: TDS MSSQL (description isn’t important)
Then click the System DSN tab and select Add. Test out the unixODBC connection with:
[root@localhost]# isql -v MSSQLServer username password
| Connected! |
| sql-statement |
| help [tablename] |
| quit |
SQL> use Northwind
0 rows affected
SQL> SELECT TOP 1 CategoryName from Categories
| CategoryName |
| Beverages |
1 rows affected
Now to test it using PHP, put this page in a web-viewable directory and try to view it from the browser.
— begin odbctest.php—
// connect to DSN MSSQL with a user and password
$connect = odbc_connect(“MSSQLServer”, “username”, “password”) or die
odbc_exec($connect, “use Northwind”);
$result = odbc_exec($connect, “SELECT CompanyName, ContactName ” .
print(odbc_result($result, “CompanyName”) .
‘ ‘ . odbc_result($result, “ContactName”) . “
— end odbctest.php —
Should a SQL statement contain an error, PHP will return a cryptic, incomprehensible warning message via the driver. In debugging, it has been helpful to echo out the offending queries.
The web application that instigated this setup is now in its third month of production and is performing quite well.