Home » Categories » Documentation » SQL Server Edition

Using the Microsoft SQL Server Driver (SQLSRV) for PHP

This article is for running PHPKB MSSQL Enterprise Edition 6.0 (and upwards) using the Microsoft SQL Server database. It explains the steps required to install and configure Microsoft SQL Server Driver (php_sqlsrv.dll) for PHP. The steps detailed below must be performed before installing PHPKB knowledge base software. Please note, the minimum required version of MSSQL has been stabilized to MSSQL 2005 (v.9).

Using the SQL Server Driver (SQLSRV) for PHP from Microsoft

  1. Install Microsoft SQL Server including SQL Server Management Studio. (A free version, SQL Server Express Edition is available for testing.)
    Make sure to choose mixed authentication (Windows and local accounts) to keep things simpler later. Define the "sa" account password when requested (it's the default System Administrator account which has full access to all databases by default).
  2. Configure Windows for MSSQL.
    • By default, MSSQL listens to port 1433 for incoming TCP/IP connections and this port needs to be opened in the firewall. This is explicitly configured in the firewall installed (either Windows Firewall in the Control Panel or the configuration interface for other firewalls). If the port was changed when MSSQL was installed, then specify the correct port number to open in the firewall.
    • Confirm that TCP/IP protocol is enabled in: SQL Server Configuration Manager -> Network Configuration -> Protocols -> TCP/IP enabled
  3. Create and configure a new database.
    Open "SQL Server Management Studio" and create a new empty database.
  4. Install PHP and a web server.
  5. Install the SQL Server Driver for PHP.
    On the web server, install SQL Server Driver for PHP including all the pre-requisites listed on the download page. Always use the latest version available for your environment).
    Note: It is critical to install the SQL Server Native Access Client version documented on the download page of the SQL Server Driver for PHP.
  6. Configure PHP to use the appropriate SQLSRV driver. In php.ini, set the following:
    • For PHP 5.2.4 (or later)
      [PHP_SQLSRV]
      extension=php_sqlsrv_52_nts_vc9.dll
    • For PHP 5.3.2 (or later)
      [PHP_SQLSRV]
      extension=php_sqlsrv_53_nts_vc9.dll
    The Microsoft documentation for the SQL Server Driver for PHP is available at this link.
  7. Set the following settings in your php.ini file
    mssql.textlimit = 2147483647
    mssql.textsize = 2147483647
  8. Restart or start your web server and test the database connection with the sample PHP script code below.
  9. Just create a new file called db-test.php in any text editor such as Notepad or TextPad. Copy the code from the example below and change ('server_name', 'db_name', 'db_user', 'db_password') variables to match with your database settings. Then, execute this test script from localhost (http://localhost/db-test.php).
    Source Code (db-test.php)
    $hostname = 'server_name';
    $connection_options = array('Database'=>'db_name', 'UID'=>'db_user', 'PWD'=>'db_password');
    $conn = sqlsrv_connect($hostname, $connection_options);
    if(!is_resource($conn)){ echo 'Could not connect: '; var_dump(sqlsrv_errors(SQLSRV_ERR_ALL)); exit(0); }
    echo 'Connection established successfully.';
    sqlsrv_close($conn);
    ?>
  10. If everything works alright then you can proceed with the Installation of PHPKB Knowledge Base Management Software.
DEBUG INFORMATION

If PHP still cannot communicate with the database server, turn display_startup_errors to "On" in the php.ini file, then restart the web server and check for any errors that may indicate incorrect DLL versions or missing dependencies. These error reports which are turned off by default in PHP, can be very useful in locating a problem with the installation of new extensions.

Custom Fields
  • Applicable To: Enterprise Edition (SQL Server), Enterprise Multi-Language Edition (SQL Server)
4.5 (18)
Article Rating (18 Votes)
Rate this article
  • Icon PDFExport to PDF
  • Icon MS-WordExport to MS Word
Attachments Attachments
There are no attachments for this article.
Comments Comments
There are no comments for this article. Be the first to post a comment.
Related Articles RSS Feed
There are no related articles for this article.