There is no license information available for the latest version (dev-master) of this package.

MSSQL dbib module for zf

dev-master 2016-10-13 10:52 UTC

This package is not auto-updated.

Last update: 2020-07-10 17:11:05 UTC


PDO DBlib Module for Zend


Doctrine 2 does support any method of connecting to SQL Server on a Linux box. Here's a simple driver that supports PDO DBlib. Many tests fail, but most are related to shortcomings of the PDODBlib driver. There is a patch in the PHP repo to add transaction and lastInsertId support, but this package has some minor work arounds.


For Symphony Bundle: [PDODblibBundle] ( (latest master)

FreeTDS configuration

DBLib requires FreeTDS. We can't go into detail about configuring FreeTDS, but the connection configured should look something like following:

    host =
    port = 1433
    tds version = 8.0
    client charset = UTF-8
    text size = 20971520


With composer

  1. Add this in your composer.json:

    "require": {
        "mabuzagu/pdo-dblib-module": "dev-master",
  2. Now tell composer to download PDODblibModule by running the command:

    $ php composer.phar update

Post Installation

  1. Enabling it in your application.config.phpfile.

    return [
        'modules' => [
            // ...
        // ...
  2. Add this to your autoload folder


return [
		'doctrine' => [
				'connection' => [
						'orm_default' => [
								'driverClass' => PDODblibModule\Doctrine\DBAL\Driver\PDODblib\Driver::class,
								'params' => [
										'host'     => '<host>',
										'port'     => '<port>',
										'user'     => '<user>',	
										'password' => '<password>',
										'dbname'   => '<dbname>',

Putting everything together

Getting everything together wasn't easy. You need to complete the following steps, checking each installation is successful by connecting with the appropriate tools:

  • Install FreeTDS and configure a server connection
    • Verify with ./tsql -S mssql_freetds -U yourusername -P yourpassword
  • Install the PHP DBLib extension -- verify with PHP script containing
    • Verify $pdo = new PDO('dblib:host=mssql_freetds;dbname=yourdb', 'yourusername', 'yourpassword');
  • Install and configure the PDODblibBundle
    • Verify Some kind of SQL against your database

FYI - PHP pdo_dblib patch

You can find a patch for some of the short-comings of pdo_dblib on SVN.

See: Revision 300647 - lastInsertId Revision 300628 - transaction support

FYI - Doctrine Test Suite

Doctrine2's test suite does not allow you to add database drivers on the fly. If you want to test this package, modify Doctrine/DBAL/Driver/DriverManager::$_driverMap as follows:

final class DriverManager
    private static $_driverMap = [
		/* ... snip ... */
        'pdo_dblib' => Doctrine\DBAL\Driver\PDODblib\Driver::class,

FYI - Generating Entities from database

It's possible, but not easy. Here's what I did:

  • Map any non-compatible column types to string
  • Hack the Doctrine core to skip any tables without primary keys