It took me a while But I've found out where I was going wrong and I now have DataTables working with SQL Server through server side scripts. I'm posting this solution in the hope that it will help anyone else like me who was having issues. I've broken my answer into parts.
The PHP Environment
The SQLSRV drivers for php can be found here. Download the SQLSRV30.EXE installer package. You may find that when you try and run this executable that you get the error "This is not a valid win32 application" If this is the case unzip the executable with something like 7-zip. The resulting file will have the files you require inside.
When you've unzipped the package you need to select the right driver. Most windows installations use the non thread safe drivers these are:
php version 5.3:
php_sqlsrv_53_nts.dll
php_pdo_sqlsrv_53_nts.dll
php version 5.4:
php_sqlsrv_54_nts.dll
php_pdo_sqlsrv_54_nts.dll
Copy the appropriate files to the ext folder within your php directory. Now modify your php.ini file to have a reference to these files. Do this by adding an entry under the dynamic extensions section. The result would be something like this:
extension=php_sqlsrv_54_nts.dll
And then add a section for the driver under the Module section settings like this:
[sqlsrv]
sqlsrv.LogSubSystems=-1
sqlsrv.LogSeverity=-1
sqlsrv.WarningsReturnAsErrors=0
The documentation for these settings can be found here.
Once you have added these drivers and added a reference to them in the php.ini file you must also ensure that the Microsoft SQL Server Client Profile 2012 is also installed.
These Links have been taken from the PHP.net website:
Microsoft SQL Server Client Profile 2012 x86 Microsoft SQL Server Client profile 2012 x64
Once you have performed these steps restart your web server. The driver should now be installed and ready to use. You can check this using your info.php page.
The Server Side Script:
Now that the web-server has been configured to use the SQL SRV driver we can now use it to query a SQL Server database. I've used the server side script available here. Here are some issues I found with it:
<?php
/* Indexed column (used for fast and accurate table cardinality) */
$sIndexColumn = "";
/* DB table to use */
$sTable = "";
/* Database connection information */
$gaSql['user'] = "";
$gaSql['password'] = "";
$gaSql['db'] = "";
$gaSql['server'] = "";
/*
* Columns
* If you don't want all of the columns displayed you need to hardcode $aColumns array with your elements.
* If not this will grab all the columns associated with $sTable
*/
$aColumns = array();
/* * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * *
* If you just want to use the basic configuration for DataTables with PHP server-side, there is
* no need to edit below this line
*/
/*
* ODBC connection
*/
$connectionInfo = array("UID" => $gaSql['user'], "PWD" => $gaSql['password'], "Database"=>$gaSql['db'],"ReturnDatesAsStrings"=>true);
$gaSql['link'] = sqlsrv_connect( $gaSql['server'], $connectionInfo);
$params = array();
$options = array( "Scrollable" => SQLSRV_CURSOR_KEYSET );
/* Ordering */
$sOrder = "";
if ( isset( $_GET['iSortCol_0'] ) ) {
$sOrder = "ORDER BY ";
for ( $i=0 ; $i<intval( $_GET['iSortingCols'] ) ; $i++ ) {
if ( $_GET[ 'bSortable_'.intval($_GET['iSortCol_'.$i]) ] == "true" ) {
$sOrder .= $aColumns[ intval( $_GET['iSortCol_'.$i] ) ]."
".addslashes( $_GET['sSortDir_'.$i] ) .", ";
}
}
$sOrder = substr_replace( $sOrder, "", -2 );
if ( $sOrder == "ORDER BY" ) {
$sOrder = "";
}
}
/* Filtering */
$sWhere = "";
if ( isset($_GET['sSearch']) && $_GET['sSearch'] != "" ) {
$sWhere = "WHERE (";
for ( $i=0 ; $i<count($aColumns) ; $i++ ) {
$sWhere .= $aColumns[$i]." LIKE '%".addslashes( $_GET['sSearch'] )."%' OR ";
}
$sWhere = substr_replace( $sWhere, "", -3 );
$sWhere .= ')';
}
/* Individual column filtering */
for ( $i=0 ; $i<count($aColumns) ; $i++ ) {
if ( isset($_GET['bSearchable_'.$i]) && $_GET['bSearchable_'.$i] == "true" && $_GET['sSearch_'.$i] != '' ) {
if ( $sWhere == "" ) {
$sWhere = "WHERE ";
} else {
$sWhere .= " AND ";
}
$sWhere .= $aColumns[$i]." LIKE '%".addslashes($_GET['sSearch_'.$i])."%' ";
}
}
/* Paging */
$top = (isset($_GET['iDisplayStart']))?((int)$_GET['iDisplayStart']):0 ;
$limit = (isset($_GET['iDisplayLength']))?((int)$_GET['iDisplayLength'] ):10;
$sQuery = "SELECT TOP $limit ".implode(",",$aColumns)."
FROM $sTable
$sWhere ".(($sWhere=="")?" WHERE ":" AND ")." $sIndexColumn NOT IN
(
SELECT $sIndexColumn FROM
(
SELECT TOP $top ".implode(",",$aColumns)."
FROM $sTable
$sWhere
$sOrder
)
as [virtTable]
)
$sOrder";
$rResult = sqlsrv_query($gaSql['link'],$sQuery) or die("$sQuery: " . sqlsrv_errors());
$sQueryCnt = "SELECT * FROM $sTable $sWhere";
$rResultCnt = sqlsrv_query( $gaSql['link'], $sQueryCnt ,$params, $options) or die (" $sQueryCnt: " . sqlsrv_errors());
$iFilteredTotal = sqlsrv_num_rows( $rResultCnt );
$sQuery = " SELECT * FROM $sTable ";
$rResultTotal = sqlsrv_query( $gaSql['link'], $sQuery ,$params, $options) or die(sqlsrv_errors());
$iTotal = sqlsrv_num_rows( $rResultTotal );
$output = array(
"sEcho" => intval($_GET['sEcho']),
"iTotalRecords" => $iTotal,
"iTotalDisplayRecords" => $iFilteredTotal,
"aaData" => array()
);
while ( $aRow = sqlsrv_fetch_array( $rResult ) ) {
$row = array();
for ( $i=0 ; $i<count($aColumns) ; $i++ ) {
if ( $aColumns[$i] != ' ' ) {
$v = $aRow[ $aColumns[$i] ];
$v = mb_check_encoding($v, 'UTF-8') ? $v : utf8_encode($v);
$row[]=$v;
}
}
If (!empty($row)) { $output['aaData'][] = $row; }
}
echo json_encode( $output );
?>
The Indexed Column
When you specify an indexed column to use for searches make sure that it is included in the column array! if you leave it out when specifying which columns to use the paging will not work. The paging of datatables with this code works be performing a select query of all primary keys when not in the TOP X results from another query.
The Connection Parameters
Ensure that the connection parameters are complete and correct. These are necessary to allow the script to connect to the database. If there aren't any parameters or the parameters are not correct to a SQL server login then the script will never be able to connect to the database.
The Column Array
I found that using this code without specified columns returned incorrect or NULL data. The best way to stop this was to fill the array with the column names I wanted to select each enclosed by quotes and separated by commas. It also stands to reason as why send anything but the required data back to the client?
The Client Side
HTML
DataTables requires a well formed html table to operate. This means having a table with full tags. If all of the tags are not there for the data being returned then DataTables will return an error. If you have columns that you want to return but not show then you can use the ColVis exntension and set a default column view setting in the java script.
Datatable uses its own CCS file so make sure you include it!
The java script
DataTables uses Jquery and its own Javascrpt file so make sure you include references to them within your script tags!
//Datatables Basic server side initilization
$(document).ready(function () {
//Datatable
var table = $('#tableID').DataTable({
"bProcessing": true,
"bServerSide": true,
"sAjaxSource": "serverSideScript.php"
});
});
These are the basic functions required for this server side script to work. It will get the top 10 rows on initial draw using the database parameters you specify in the php page. From here you can add the extensions you want such as ColVis and TableTools. Full Documentation for these Extensions and other initialization options for data tables can be found here.
I Hope this answer helps anyone else who is having the same issues that I had.