kokspflanze / pdo-dblib-module
MSSQL dbib module for zf
Requires
- php: >=7.0
- ext-pdo: *
- doctrine/doctrine-orm-module: ^4.1.0 || ^5.0.1
This package is auto-updated.
Last update: 2024-11-06 21:41:21 UTC
README
PDO DBlib Module for Zend 2
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.
Dependecies
- pdo_dblib
- FreeTDS
- DoctrineModule
- DoctrineORMModule
For Symphony Bundle: [PDODblibBundle] (https://github.com/trooney/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:
[mssql_freetds]
host = 172.30.252.25
port = 1433
tds version = 8.0
client charset = UTF-8
text size = 20971520
Installing
With composer
-
Add this in your composer.json:
"require": { "mabuzagu/pdo-dblib-module": "dev-master", }
-
Now tell composer to download PDODblibModule by running the command:
$ php composer.phar update
Post Installation
-
Enabling it in your
application.config.php
file.<?php return array( 'modules' => array( // ... 'DoctrineModule', 'DoctrineORMModule', 'PDODblibModule', ), // ... );
-
Add this to your autoload folder
<?php return array( 'doctrine' => array( 'connection' => array( 'orm_default' => array( 'driverClass' => 'PDODblibModule\Doctrine\DBAL\Driver\PDODblib\Driver', 'params' => array( '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.
http://svn.php.net/viewvc/php/php-src/trunk/ext/pdo_dblib/dblib_driver.c?view=log
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 = array( /* ... snip ... */ 'pdo_dblib' => 'Doctrine\DBAL\Driver\PDODblib\Driver', ); }
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