Funções ODBC e DB2 (PDO_ODBC)

Introdução

PDO_ODBC é um driver que implementa a interface aos Objetos de Dados PHP (PDO) para permitir acesso do PHP a bancos de dados através de drivers ODBC ou através da biblioteca IBM DB2 Call Level Interface (DB2 CLI). O PDO_ODBC atualmente suporta três diferentes "sabores" de drivers de banco de dados:

ibm-db2: Suporta acesso aos servidores IBM DB2 Universal Database, Cloudscape e Apache Derby por meio do cliente DB2 express-C gratuito.
unixODBC: Suporta acesso a servidores de banco de dados por meio do gerenciador de driver unixODBC e dos próprios drivers ODBC do banco de dados.
generic: Oferece uma opção de compilação para gerenciadores de driver ODBC que não são explicitamente suportados por PDO_ODBC.

No Windows, php_pdo_odbc.dll deve estar habilitado como extensão no php.ini. Ele está vinculado ao Windows ODBC Driver Manager para que o PHP possa se conectar a qualquer banco de dados catalogado como um DSN de sistema.

Instalação

PDO_ODBC em sistemas UNIX

PDO_ODBC está incluído no código-fonte do PHP. Pode-se compilar a extensão PDO_ODBC como um módulo estático ou compartilhado usando os seguintes comandos configure.
ibm_db2
./configure --with-pdo-odbc=ibm-db2,/opt/IBM/db2/V8.1/
Para construir o PDO_ODBC com o tipo ibm-db2, é necessário ter os cabeçalhos de desenvolvimento do aplicativo DB2 instalados previamente na mesma máquina em que o PDO_ODBC estiver sendo compilado. Os cabeçalhos de desenvolvimento de aplicativos DB2 são uma opção instalável nos servidores DB2 e também estão disponíveis como parte do DB2 Application Development Client, gratuitamente no » site do IBM developerWorks.

Se não for informado um local para as bibliotecas e cabeçalhos do DB2 para o comando configure, o PDO_ODBC usará o caminho padrão /home/db2inst1/sqllib.
unixODBC
./configure --with-pdo-odbc=unixODBC,/usr/local
Se não for informado um local para as bibliotecas e cabeçalhos unixODBC para o comando configure, o PDO_ODBC usará o caminho padrão /usr/local.
generic
./configure --with-pdo-odbc=generic,/usr/local,libname,ldflags,cflags

Constantes pré-definidas

As constantes abaixo são definidas por este driver e só estarão disponíveis quando a extensão tiver sido compilada no PHP ou tiver sido carregada dinamicamente em tempo de execução. Além disso, estas constantes específicas do driver só devem ser usadas se este driver estiver sendo usado. Usar atributos específicos de um driver com outro driver pode resultar em comportamento inesperado. PDO::getAttribute() pode ser usada para obter o atributo PDO::ATTR_DRIVER_NAME para verificar o driver, se o código puder ser executado com vários drivers.

PDO_ODBC_TYPE (string)

PDO::ODBC_ATTR_USE_CURSOR_LIBRARY (int)

Esta opção controla se a biblioteca de cursores ODBC é usada. A biblioteca de cursores ODBC oferece suporte a alguns recursos ODBC avançados (por exemplo, cursores roláveis em bloco), que podem não estar implementados pelo driver. Os seguintes valores são suportados:

PDO::ODBC_SQL_USE_IF_NEEDED (o padrão): usa a biblioteca de cursores ODBC quando necessário.
PDO::ODBC_SQL_USE_DRIVER: nunca usa a biblioteca de cursores ODBC
PDO::ODBC_SQL_USE_ODBC: sempre usa a biblioteca de cursores ODBC

PDO::ODBC_ATTR_ASSUME_UTF8 (bool)

Somente Windows. Se true, os dados de caracteres codificados em UTF-16 (CHAR, VARCHAR e LONGVARCHAR) serão convertidos para UTF-8 ao ler ou gravar dados no banco de dados. Se false (o padrão), a conversão da codificação de caracteres pode ser feita pelo driver.

Configurações em Execução

O comportamento destas funções é afetado pelas configurações do php.ini.

**Opções de Configuração do PDO_ODBC**
Nome	Padrão	Modificável	Registro de Alterações
pdo_odbc.connection_pooling	"strict"	`INI_ALL`
pdo_odbc.db2_instance_name	NULL	`INI_SYSTEM`	Este recurso defasado certamente será removido no futuro.

Para mais detalhes e definições dos modos INI_*, consulte os Onde uma configuração deve ser definida.

Aqui está uma breve explicação das diretivas de configuração.

pdo_odbc.connection_pooling string

Informa se as conexões ODBC devem ser agrupadas. Pode ser "strict", "relaxed" ou "off" (igual a ""). O parâmetro descreve quão rigoroso o gerenciador de conexões deve ser ao comparar parâmetros de conexão com conexões agrupadas existentes. strict é o padrão recomendado e resultará no uso de conexões em cache somente quando todos os parâmetros de conexão tiverem correspondência exata. relaxed resultará no uso de conexões em cache quando parâmetros de conexão semelhantes forem usados. Isso pode resultar no aumento do uso do cache, correndo o risco de sangrar informações de conexão entre (por exemplo) servidores virtuais.

Esta configuração só pode ser alterada no arquivo php.ini e afeta todo o processo; quaisquer outros módulos carregados no processo que usem as mesmas bibliotecas ODBC também serão afetados, incluindo a extensão ODBC unificada.

Aviso

A correspondência relaxed não deve ser usada em um servidor compartilhado, por motivos de segurança.

Dica

Esta configuração deve ser mantida na configuração padrão strict a menos que exista um bom motivo para alterá-la.

pdo_odbc.db2_instance_name string

Se você o PDO_ODBC for compilado usando o tipo db2, esta configuração definirá o valor da variável de ambiente DB2INSTANCE nos sistemas operacionais Linux e UNIX para o nome especificado da instância do DB2. Isso permite que o PDO_ODBC resolva o local das bibliotecas DB2 e estabeleça conexões catalogadas com bancos de dados DB2.

Esta configuração não tem efeito no Windows.

Índice

PDO_ODBC DSN — Conectando-se a bancos de dados ODBC ou DB2

Melhore Esta Página

Aprenda Como Melhorar Esta Página • Envie uma Solicitação de Modificação • Reporte um Problema

＋adicione uma nota

Notas Enviadas por Usuários (em inglês) 5 notes

down

tuomas ¶

15 years ago

If you want to avoid installing DB2 Connect and/or PECL modules ibm_db2 and PDO_IBM, you can also use IBM DB2 databases trough unixODBC.

If you have DB2 database on a i server you need to install IBM iAccess (http://www.ibm.com/systems/i/software/access/linux/index.html) and unixODBC. Just install the libraries (rpm) and modify configurations in /etc/odbcinst.ini (sample configuration in /opt/ibm/iSeriesAccess/unixodbcregistration) and /etc/odbc.ini.

To my experience this is much easier way than installing DB2 Connect.

down

ChristianF ¶

8 years ago

I just spent a couple of hours trying to track down the Exception "Could not find driver". This was despite having ODBC and PDO_ODBC installed, and all of the configuration seemed to be correct.

Turned out the problem was that I used ODBC in upper-case in the dsn. As soon as I changed the dns to "odbc:database" it worked.

As this code used to work a few months ago, this sudden case-sensitivity threw me for a loop. So in case you get this error, check the casing first.

down

ethan dot nelson at ltd dot org ¶

16 years ago

Using SQL 2005, PDO_ODBC and datetime fields is a royal pain.  MSDN documentation on CAST CONVERT shows that there is supposed to be an implicit convert between character types and datetime types.  That's true... until you put it in a stored procedure and use variable declarations.

For instance this fails:

declare @date varchar;
SET @date = '20080101';
SELECT cast(@date AS datetime) AS poo

While this succeeds:
declare @date varchar(19);
SET @date = '20080101';
SELECT cast(@date AS datetime) AS poo

The PDO Driver appears to attempt an implicit conversion and so it fails whenever you try to insert data into datetime column types.

So to workaround this nuance in SQL, declare a character column type with explicit width.  Then your implicit type conversion will work.

down

Ariz Jacinto ¶

12 years ago

Using SQL Server Native Client 11.0 on Linux as a PDO_ODBC driver:



Download the SQL Server Native Client 11.0 on Linux ODBC Driver:

http://www.microsoft.com/download/en/details.aspx?id=28160



Configuration ODBC:



/usr/local/etc/odbcsys.ini

--

[SQL Server Native Client 11.0]

Description = Microsoft SQL Server ODBC Driver V1.0 for Linux

Driver = /opt/microsoft/sqlncli/lib64/libsqlncli-11.0.so.1720.0

UsageCount = 1



/usr/local/etc/odbc.ini

--

[MSSQLServer]

Driver = SQL Server Native Client 11.0

Description = Sample Database

Trace = Yes

Server = 

Port = 1433

Database = 



Test the connection:

mssqltest.php

--

<?php

    putenv('ODBCSYSINI=/usr/local/etc');

    putenv('ODBCINI=/usr/local/etc/odbc.ini');

    $username = "";

    $password = "";

    try {

      $dbh = new PDO("odbc:MSSQLServer",

                    "$username",

                    "$password"

                   );

    } catch (PDOException $exception) {

      echo $exception->getMessage();

      exit;

    }

    echo var_dump($dbh);

    unset($dbh);

?>

down

-1

harry dot forum at p-boss dot com ¶

14 years ago

MSSQL - PHP on Apache - Linux Redhat

When using php 5.2.10 please beaware of this error:

http://bugs.php.net/bug.php?id=42068

Standard odbc_connect will not work, you must use pdo_odbc

Connecting to MSSQL using pdo odbc - walkthrough.. 

1. Download and configure FreeTDS with-unixodbc

./configure --prefix=/opt/SYSfreetds --with-unixodbc

make;make test; make install

2. install php-odbc and unixODBC

         php-odbc-5.2.10-1.x86_64.rpm
         unixODBC.x86_64.x86x64

3. Setup ODBC links

a)
Create a tds.driver file with the following contents

  [FreeTDS]
  Description     = v0.63 with protocol v8.0
  Driver          = /opt/SYSfreetds/lib/libtdsodbc.so

Register the ODBC driver - the tds.driver file

  odbcinst -i -d -f tds.driver

b)
Creating a tds.datasource file - ODBC Data Source with contents:

  [SOURCENAME]
  Driver=FreeTDS
  Description=Test MS SQL Database with FreeTDS
  Trace=No
  Server=BobTheServer
  Port=1433
  TDS Version=8.0
  Database=youDBname

Register the ODBC data source

  odbcinst -i -s -f tds.datasource

Beware that the odbc.ini file will be installed in the current users home directory. This may need to be used if you are using a webserver as the apache home directory could be different.

Ensure .odbc.ini is in apaches home directory, possibly "/var/www"

4. Test the ODBC link on the command line

  isql -v SOURCENAME 'username' 'password'

  +---------------------------------------+
  | Connected!                            |
  |                                       |
  | sql-statement                         |
  | help [tablename]                      |
  | quit                                  |
  |                                       |
  +---------------------------------------+
 SQL>

5. Edit /etc/php.ini

  Make sure the following is set:
     mssql.secure_connection = On
 

6. Restart apache gracefully

7. PHP to run:

  <?
  $dbh= new PDO('odbc:SOURCENAME', 'username', 'password');
  $stmt = $dbh->prepare("$query");
  $stmt->execute();
  while ($row = $stmt->fetch()) {
      print_r($row);
  }
  unset($dbh); unset($stmt);
  ?>

Trouble-shooting:

Please try strace/ truss if you encounter issues. It could be you are referencing wrong libraries somewhere.

Ensure you have restarted apache once the odbc files are in place

＋adicione uma nota