mabuzagu/pdo-dblib-module

MSSQL dbib module for zf

PDODblibModule

PDO DBlib Module for Zend, _(*1)

Introduction

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., _(*2)

Dependecies

• pdo_dblib
• FreeTDS
• DoctrineModule
• DoctrineORMModule

For Symphony Bundle: [PDODblibBundle] (https://github.com/trooney/PDODblibBundle) (latest master), _(*3)

FreeTDS configuration

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

[mssql_freetds]
    host = 172.30.252.25
    port = 1433
    tds version = 8.0
    client charset = UTF-8
    text size = 20971520

Installing

With composer

1. Add this in your composer.json:, _(*5)

   "require": {
       "mabuzagu/pdo-dblib-module": "dev-master",
   }
   

2. Now tell composer to download PDODblibModule by running the command:, _(*6)

   $ php composer.phar update
   

Post Installation

1. Enabling it in your application.config.phpfile., _(*7)

   <?php
   return [
       'modules' => [
           // ...
           'DoctrineModule',
           'DoctrineORMModule',
           'PDODblibModule',
       ],
       // ...
   ];
   

2. Add this to your autoload folder, _(*8)

<?php

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:, _(*9)

• 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., _(*10)

http://svn.php.net/viewvc/php/php-src/trunk/ext/pdo_dblib/dblib_driver.c?view=log, _(*11)

See: Revision 300647 - lastInsertId Revision 300628 - transaction support, _(*12)

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:, _(*13)

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:, _(*14)

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