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.
  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: 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

Article ID: 37
Created On: Fri, Jul 6, 2012 at 2:52 AM
Last Updated On: Thu, Jul 24, 2014 at 7:35 AM
Authored by: Ajay Chadha [help@knowledgebase-script.com]

Online URL: http://www.knowledgebase-script.com/kb/article/using-the-microsoft-sql-server-driver-sqlsrv-for-php-37.html