Manual de adodb

Pagina principal ADODB en español

Libreria ADOdb para PHP V4.92 29 Ago 2006 (c) 2000-2006 John Lim (jlim#natsoft.com) Este programa tiene licencia dual BSD-Style y LGPL. Esto significa que lo puedes usar tanto en productos comerciales como en propietarios.

Ligas utules de ADOdb: Descarga Otros manuales (en ingles) Otros manuales (en español

Introduccion Caracteristicas Unicas Como se esta usando actualmente ADOdb Solicitud de mejoras y reporte de fallas Instalacion Instalacion Minima Codigo de Inicio y Ejemplos de conexion Soporte a DSN (Data Source Name) Ejemplos de conexion

ADOdb de alta velocidad - trucos de optimizacion Modificando y extendiendo ADOdb con seguridad Caracteristicas para PHP5 foreach iterators exceptions

Base de datos soportadas Tutoriales Ejemplo 1: Select Ejemplo 2: Select avanzado Ejemplo 3: Insert Ejemplo 4: Depurando Ejemplo rs2html Ejemplo 5: MySQL y Menus Ejemplo 6: Conectarase a multiples bases de datos al mismo tiempo Ejemplo 7: Generando enunciados SQL de Update e Insert Ejemplo 8: Implementando cursores con Siguiente y Anterior Ejemplo 9: Exportando a formatos delimitados por Tabulador o comas Ejemplo 10: Filtros a la medida Ejemplo 11: Transacciones inteligentes

Usando manejadores de errores a la medida o de PEAR Nombres de DSN Memoria intermedia (Caching) Tablas Pivote REFERENCIA Variables: $ADODB_COUNTRECS $ADODB_ANSI_PADDING_OFF $ADODB_CACHE_DIR $ADODB_FORCE_TYPE $ADODB_FETCH_MODE $ADODB_LANG Constantes: ADODB_ASSOC_CASE ADOConnection Conecciones: Connect PConnect NConnect IsConnected Ejecutando SQL: Execute CacheExecute SelectLimit CacheSelectLimit Param Prepare PrepareSP InParameter OutParameter AutoExecute GetOne CacheGetOne GetRow CacheGetRow GetAll CacheGetAll GetCol CacheGetCol GetAssoc CacheGetAssoc Replace ExecuteCursor (oci8 unicamente) Generando enunciados SQL: GetUpdateSQL GetInsertSQL Concat IfNull length random substr qstr Param OffsetDate SQLDate DBDate DBTimeStamp BindDate BindTimeStamp Blobs: UpdateBlob UpdateClob UpdateBlobFile BlobEncode BlobDecode Paginacion/Desplazamiento: PageExecute CachePageExecute Limpieza: CacheFlush Close Transacciones: StartTrans CompleteTrans FailTrans HasFailedTrans BeginTrans CommitTrans RollbackTransSetTransactionMode Recuperando Datos: SetFetchMode Cadenas: concat length qstr quote substr Fechas: DBDate DBTimeStamp UnixDate UnixTimeStamp OffsetDate SQLDate Renglones: Affected_Rows Insert_ID RowLock GenID CreateSequence DropSequence Manejo de Errores: ErrorMsg ErrorNo MetaError MetaErrorMsg IgnoreErrors Diccionario de datos (metadata): MetaDatabases MetaTables MetaColumns MetaColumnNames MetaPrimaryKeys MetaForeignKeys ServerInfo Estadisticas y modifacion de SQL: LogSQL fnExecute and fnCacheExecute Descontinuado: Bind BlankRecordSet Parameter

ADORecordSet Regresa un campo: Fields Regresa un renglon:FetchRow FetchInto FetchObject FetchNextObject FetchObj FetchNextObj GetRowAssoc Regresa todos los renglones:GetArray GetRows GetAssoc Desplazamiento:Move MoveNext MoveFirst MoveLast AbsolutePosition CurrentRow AtFirstPage AtLastPage AbsolutePage Generacion de Menu:GetMenu GetMenu2 Fechas:UserDate UserTimeStamp UnixDate UnixTimeStamp Informacion del Recordset:RecordCount PO_RecordSet NextRecordSet Informacion de un campo:FieldCount FetchField MetaType Limpieza: Close converted by Web2PDFConvert.com

rs2html ejemplo

Diferencias entre ADOdb y ADO

Guia para manejadores de base de datos Bitacora de cambios

Introduccion Las funciones de acceso a base de datos en PHP no estan estandarizadas. Esto requiere una libreria que esconda las diferencias entre cada API de base de datos (encapsular las diferencias) para que podamos cambiar facilmente de base de datos. Se requiere la version de PHP 4.0.5 o posterior (debido a que usamos la funcion str_replace con arreglos). Actualmente manejamos MySQL, Oracle, Microsoft SQL Server, Sybase, Sybase SQL Anywhere, Informix, PostgreSQL, FrontBase, SQLite, Interbase (versiones de Firebird y Borland), Foxpro, Access, ADO, DB2, SAP DB and ODBC. Tenemos noticias que se puede conectar a Progress y CacheLite via ODBC. Esperamos que mas personas contribuyan con drivers para manejar mas base de datos. PHP4 maneja variables de sesion. Puedes almacenar la informacion de tu sesion usando ADOdb para tener una verdadera portabilidad y escalabilidad. Para mas informacion ve el archivo adodb-session.php. Tambie lee tips_portable_sql-es.htm (tambien dispobible en ingles en el archivo tips_portable_sql.htm) para consejos para escribir enunciados SQL portables.

Caracteristicas especiales de ADOdb Facil para programadores Windows debido a que muchas de las convenciones son similares al ADO de Microsoft. A diferencia de otras clases PHP de base de datos que se enfocas unicamente en el enunciado SELECT. ADOdb soporta codigo para manajar INSERT y UPDATE que son rapidamente adaptables a multiples bases de datos. Tambien hay metodos para manejo de fechas, concatenacion de cadenas y encomillado de cadenas para diferentes bases de datos. Tiene un systema de metatipos (metatype) para poder determinar cuales tipos como CHAR, TEXT and STRING son equivalentes en diferentes bases de datos. Es facil de portar debido a que todo el codigo que depende de la base de datos esta en funciones. Tu no tienes que portar la logica principal de las clases. Creacion de tablas e indices portable con las clases de diccionario de datos datadict. Monitor de rendimiento de base de datos y ajuste de enunciados SQL con la clase de performance monitoring. Sesiones en base de datos con la clase session management. Maneja notificacion por sesion vencida. Mapeo a Objectos Relacionales uando la clase ADOdb_Active_Record.

Como se esta usando ADOdb Aqui hay algunos ejemplos de personas que usan ADOdb (para una lista mas larga, visita http://adodb.sourceforge.net/): PhpLens es un componente comercial de cudricula de datos que permite tanto a programadores expertos como a inexpertos desarrollar y mantener bases de datos en la Web facilmente. Desarrollado por el autor de ADOdb. PHAkt: PHP Extension for DreamWeaver Ultradev permite hacer programas PHP en el popular editor de paginas Web. El manejo de la base de datos es con ADOdb. Analysis Console for Intrusion Databases (ACID): Motor de analisis para buscar y procesar una base de datos de incidentes de seguridad generada por otros programas como IDSes y firewalls (e.g. Snort, ipchains). Por Roman Danyliw. PostNuke es una sistema de control de contenidos muy popular. Maneja un soporte completo de CSS, cumple con HTML 4.01, un sistema avanzado de bloques, y es completamente multilenguaje. EasyPublish CMS es otro sistema de control de contenidos. Para el manejo de informacion y modulos integrados para tu internet, intranet y extranet. Noruego. NOLA es una apliacion completa de contabilidad, inventarios y control de trabajo. Su licencia es GPL, desarrollado por Noguska.

Solicitud de mejoras y reporte de fallas Las solicitudes de mejoras o reporte de fallas pueden ser enviadas por correo electronico a jlim#natsoft.com.my o publicadas en el foro de ayuda de ADOdb en http://phplens.com/lens/lensforum/topics.php?id=4.

Guia de Instalacion Asegurate de estar usando PHP 4.0.5 o posterior. Descomprime todos los archivos en un directorio accesible por tu servidor Web. Para probar, intenta modificar algunos de los ejemplos del tutorial. Asegurate de corregir los parametros de coneccion a tus converted by Web2PDFConvert.com

necesidades. Puedes depurar el codigo usando $db->debug = true como se muestra a continuacion:

Instalacion Minima Para los desarrolladores que quieran distribuir una version minima de ADOdb, se requieren los siguientes archivos: adodb.inc.php adodb-lib.inc.php adodb-time.inc.php drivers/adodb-$database.inc.php license.txt (por razones legales) adodb-php4.inc.php adodb-iterator.inc.php (funcionaldiad para PHP5) Opcionalmente: adodb-error.inc.php y lang/adodb-$lang.inc.php (si usas MetaError()) adodb-csvlib.inc.php (si usas recordsets en memoria - CacheExecute(), etc) adodb-exceptions.inc.php y adodb-errorhandler.inc.php (si usas el manejo de errores de ADOdb o excepciones de PHP5). adodb-active-record.inc.php si usas Active Records.

Ejemplos de Codigo de Inicio Al ejecutar ADOdb, al menos se cargan dos archivos. Primero adodb/adodb.inc.php, que contienen todas las funciones usadas por todas las clases de bases de datos. El codigo especifico a una base de datos en particular esta en el archivo adodb/driver/adodb????.inc.php. Por ejemplo, para conectarse a una base de datos mysql: include('adodb/adodb.inc.php'); $conn = &ADONewConnection('mysql');

Cada vez que necesitas conectarte a una base de datos, debes de crear un objeto de conexion usando la funcion ADONewConnection($driver). NewADOConnection($driver) es un nombre alterno para la misma funcion. En este momento, no estas conectado a la base de datos (ya no es cierto si como parametro usas un dsn). Primero tienes que decidir si vas a usar una coneccion persistente o no persistente. La ventaja de las conexiones persistentes es que son mas rapidas, debido a que la conexion no es cerrada nunca (aun si usas Close()). Las conexiones No persistentes consumen menos recursos reduciendo el riesgo de sobrecargar la base de datos o el servidor Web. Para conexiones persistentes, usa $conn->PConnect(), o $conn->Connect() para conexiones no persistentes. Algunas bases de datos tambien manejan NConnect(), la cual forza la creacion de una nueva conexion.

Problemas con Conexiones: Si creas dos conexiones, pero ambas usan el mismo usuario y contraseña, PHP compartira las conexiones. Esto puede causar problemas si se supone que las conexiones son a diferentes bases de datos. La solucion es usar siempre diferentes usuarios para diferentes bases de datos o usar NConnect().

Soporte a Data Source Name (DSN) Desde la version 4.51 de ADOdb, te puedes conectar a la base de datos pasando como argumento a NewADOConnection() (o ADONewConnection, que es la misma funcion) un dsn. El formato del dsn es: $driver://$username:$password@hostname/$database?options[=value]

NewADOConnection() llama a Connect() o PConnect() internamente por ti. Si la conexion falla, te regresa false. # Conexion no persistente $dsn = 'mysql://root:pwd@localhost/mydb'; $db = NewADOConnection($dsn); if (!$db) die("Conexion incorrecta"); # no se requiere llamar connect/pconnect!

converted by Web2PDFConvert.com

$arr = $db->GetArray("select * from table"); # conexion persistente $dsn2 = 'mysql://root:pwd@localhost/mydb?persist';

Si tienes caracteres especiales como /:?_ en tu dsn, entonces tienes que invocar a rawurlencode primero: $pwd = rawurlencode($pwd); $dsn = "mysql://root:$pwd@localhost/mydb"; $dsn2=rawurlencode("sybase_ase")."://user:pass@host/path?query";

Las opciones permitidas son: Para todas los drivers Interbase/Firebird M'soft ADO MySQL MySQLi Oci8

'persist', 'persistent', 'debug', 'fetchmode', 'new' 'dialect','charset','buffers','role' 'charpage' 'clientflags' 'port', 'socket', 'clientflags' 'nls_date_format','charset'

Para todos los drivers, cuando se activa la opcion persist o persistent, se forza una conexionpersistente; asi mismo, cuando se activa new, entonces la conexion se creara usando NConnect si el driver lo maneja. La opcion debug habilita la depuracion. La opcion fetchmode invoca SetFetchMode(). Si no se le indica el valor a alguna oopcion se asume el valor de 1. La version DSN de ADOdb DSN es compatible con el formato de la version 1.0 de PEAR DB.

Ejemplos de Conexion a Bases de Datos MySQL y la mayoria de bases de datos Las conexiones a MySQL son muy sencillas, y los parametros son identicos a mysql_connect: $conn = &ADONewConnection('mysql'); $conn->PConnect('localhost','usuario','contraseña','database'); # o dsn $dsn = 'mysql://user:pwd@localhost/mydb'; $conn = ADONewConnection($dsn); # no necesita Connect() # o dsn persistente $dsn = 'mysql://user:pwd@localhost/mydb?persist'; $conn = ADONewConnection($dsn); # no necesita PConnect() # un ejemplo mas complejo: $pwd = urlencode($pwd); $flags = MYSQL_CLIENT_COMPRESS; $dsn = "mysql://user:$pwd@localhost/mydb?persist&clientflags=$flags"; $conn = ADONewConnection($dsn); # no need for PConnect()

La mayoria de las demas bases de datos usan la misma convencion: Connect($servidor, $usuario, $contraseña, $database). Las excepciones se enlistas a continuacion.

PDO PDO, que solo funciona en PHP5, acepta una cadena de driver especifica: $conn =& NewADConnection('pdo'); $conn->Connect('mysql:host=localhost',$user,$pwd,$mydb); $conn->Connect('mysql:host=localhost;dbname=mydb',$user,$pwd); $conn->Connect("mysql:host=localhost;dbname=mydb;username=$user;password=$pwd");

El mecanismo via DSN tambien funciona: $conn =& NewADConnection("pdo_mysql://user:pwd@localhost/mydb?persist"); # persist es opcional

PostgreSQL PostgreSQL 7 y 8 acepta conexiones usando: a. La cadena estandard de conexcion: converted by Web2PDFConvert.com

$conn = &ADONewConnection('postgres'); $conn->PConnect('host=localhost port=5432 dbname=maria');

b. Los 4 parametros clasicos: $conn->PConnect('localhost','usuario','contraseña','database');

c. dsn: $dsn = 'postgres://user:pwd@localhost/mydb?persist'; # persist es opcional $conn = ADONewConnection($dsn); # no se requiere Connect/PConnect

LDAP Este es un ejemplo de busqueda en un servidor LDAP. Gracias a Josh Eldridge por el driver y este ejemplo:

Using DSN: $dsn = "ldap://ldap.baylor.edu/ou=People,o=Baylor University,c=US"; $db = NewADOConnection($dsn);

Interbase/Firebird Hay que definir la base de datos en el parametro $host: $conn = &ADONewConnection('ibase'); $conn->PConnect('localhost:c:\ibase\employee.gdb','sysdba','masterkey');

O con dsn:

converted by Web2PDFConvert.com

$dsn = 'firebird://user:pwd@localhost/mydb?persist&dialect=3'; # persist es opcional $conn = ADONewConnection($dsn); # no se requiere Connect/PConnect

SQLite Sqlite creara la base de datos si no existe. $conn = &ADONewConnection('sqlite'); $conn->PConnect('c:\path\to\sqlite.db'); # sqlite la creara si no existe

O con dsn: $path = urlencode('c:\path\to\sqlite.db'); $dsn = "sqlite://$path/?persist"; # persist es opcional $conn = ADONewConnection($dsn); # no se requiere Connect/PConnect

Oracle (oci8) Con oci8 te puedes conectar de varias maneras. a. PHP y Oracle estan en la misma maquina, usar SID. $conn->Connect(false, 'scott', 'tiger');

b. Nombre TNS definido en tnsnames.ora (o ONAMES o HOSTNAMES), ej. 'miTNS' $conn->PConnect(false, 'scott', 'tiger', 'miTNS');

o $conn->PConnect('miTNS', 'scott', 'tiger');

c. Direccion del servidor y SID $conn->connectSID = true; $conn->Connect('192.168.0.1', 'scott', 'tiger', 'SID');

d. Direccion del servidor y nombre del servicio $conn->Connect('192.168.0.1', 'scott', 'tiger', 'servicename');

e. Cadena de conexion de Oracle: $cstr = "(DESCRIPTION=(ADDRESS=(PROTOCOL=TCP)(HOST=$host)(PORT=$port))(CONNECT_DATA=(SID=$sid)))"; $conn->Connect($cstr, 'scott', 'tiger');

f. ADOdb dsn: $dsn = 'oci8://user:pwd@tnsname/?persist'; # persist is optional $conn = ADONewConnection($dsn); # no need for Connect/PConnect $dsn = 'oci8://user:pwd@host/sid'; $conn = ADONewConnection($dsn); $dsn = 'oci8://user:pwd@/'; # oracle on local machine $conn = ADONewConnection($dsn);

Tamnbien puedes usar el charSet para Oracle 9.2 y posterior, soportado desde PHP 4.3.2, ADOdb 4.54: $conn->charSet = 'we8iso8859p1'; $conn->Connect(...); # o $dsn = 'oci8://user:pwd@tnsname/?charset=WE8MSWIN1252'; $db = ADONewConnection($dsn);

DSN-less ODBC (ejemplos con access and mssql) Las conexiones DSN via ODBC pueden ser creadas en el panel de control de ODBC, o puedes usar una conexion DSN-less. Para converted by Web2PDFConvert.com

usar una conexion DSN-less se necesita PHP version 4.3 o posterior. Para Microsoft Access: $db =& ADONewConnection('access'); $dsn = "Driver={Microsoft Access Driver (*.mdb)};Dbq=d:\\northwind.mdb;Uid=Admin;Pwd=;"; $db->Connect($dsn);

Para Microsoft SQL Server: $db =& ADONewConnection('odbc_mssql'); $dsn = "Driver={SQL Server};Server=localhost;Database=northwind;"; $db->Connect($dsn,'userid','password');

o si lo prefieres, se puede usar la extension mssql (que esta limitada a la funcionalildad de la version 6.5): $db =& ADONewConnection('mssql'); $db->Execute('localhost', 'userid', 'password', 'northwind');

Para DB2: $dbms = 'db2'; # or 'odbc_db2' if db2 extension not available $db =& ADONewConnection($dbms); $dsn = "driver={IBM db2 odbc DRIVER};Database=sample;hostname=localhost;port=50000;protocol=TCPIP;". "uid=root; pwd=secret"; $db->Connect($dsn);

Conexiones DSN-less con ADO Si estas usando una version de PHP anterior a 4.3.0, Las conexiones DSN-less solo trabajaran con el ADO de Microsoft, el cual esta basada en las APIs COM de Microsoft. Un ejemplo de uso de la libreria ADOdb y el ADO de Microsoft:

ADOdb de alta velocidad - trucos de optimizacion La libreria ADOdb es una clase grande, aun asi regularmente derrota a las 'otras' clases PHP en rendimiento. Esto es por su diseño en forma de capas, como una cebolla, con las funciones mas rapidas en la capa mas profunda. Usa principalmente estas funciones para el mejor rendimiento:

Capa mas profunda Connect, PConnect, NConnect Execute, CacheExecute SelectLimit, CacheSelectLimit MoveNext, Close qstr, Affected_Rows, Insert_ID La manera mas rapida de acceder a los campos es usando el arreglo array $recordset->fields. Tambien hay que asignar la variable global $ADODB_FETCH_MODE = ADODB_FETCH_NUM, y (para oci8, ibase/firebird y odbc) $ADODB_COUNTRECS = false antes de conectarse a la base de datos. Esto al momento (Dec 2003). Considera usar parametros posisicionales (bind) si tu base de datos los soporta, ya que mejora la reutilizacion de los planes de ejecucion. Usa el sistema de 'performance tuning de ADodb para identificar rapidamente los cuellos de botella. Finalmente asegurate de que tienes un acelerador de PHP instalado como APC, Turck MMCache, Zend Accelerator o ionCube. Algunos ejemplos:

Recuperacion de datos mas rapida usando PHP Recuperacion de datos mas rapida usando la extension ADOdb $rs =& $rs->Execute($sql); while (!$rs->EOF) { var_dump($rs->fields); $rs->MoveNext();

$rs =& $rs->Execute($sql); $array = adodb_getall($rs); var_dump($array);

converted by Web2PDFConvert.com

}

Sugerencias Avanzadas Si tienes instalada la extension C ADOdb, puedes modificar tus llamados a $rs->MoveNext() por adodb_movenext($rs). Esto duplica la velocidad de esta operacion. Para obtener todo un conjunto de rsultados en una operacion, usa GetArray(), el cual usa internamente la funcion de alta velocidad de la extension adodb_getall($rs). Execute() es la manera usal para ejecutar enunciados SQL. Puedes usar la funcion de bajo nivel _Execute() y _query() para reducir el costo. Ambas funciones comparten los mismos parametros que Execute(). Si no tienes ningun parametro posicional o si tu base de datos soporta los parametros posicionales (sin emulacion), entonces puedes llamar _Execute() directamente. AL invocar esta funcion eliminas la emulacion de parametros. La depuracion tambien es manejada por _Execute(). Si no requuieres depuracion ni emulacion de parametros, no requieres obtener un recordset, entonces puedes llamar _query. Es muy buena para inserts, updates y deletes. Al invocar esta funcion omites la emulacion de parametros, la depuracion y el majejo de recordsets. _query() regresa el resultid, true o false. Recomendacion para INFORMIX: Desabilita los cursores navegables 'scroll' con $db->cursorType = 0.

Modfificando ADOdb con seguridad Tu puedes modificar ADOdb para tus propios usos. Por suerte puedes mantener la compatibilidad extendiendo las clases de ADodb y por medio de la variable $ADODB_NEWCONNECTION. $ADODB_NEWCONNECTION nos permite modificar el comportamiento de ADONewConnection(). ADOConnection() verifica esta variable e invocara la funcion cuyo nombre tenga la variable. En el siguiente ejemplo, se le agrega mas funcionabilidad al objeto de conexion por medio de las clases hack_mysql y hack_postgres7. La convencion en el nombre de las clases recordset se controla por medio de la propiedad $rsPrefix. En este caso se le asigna el valor de 'hack_rs_', lo que proboca que ADOdb use hack_rs_mysql y hack_rs_postgres7 como los nombres de las clases recordset. En caso de que se requiera usar los drivers normales de ADODB hay que regresar el valor 'false' en la funcion. class hack_mysql extends adodb_mysql { var $rsPrefix = 'hack_rs_'; /* aqui van las modificaciones */ } class hack_rs_mysql extends ADORecordSet_mysql { /* aqui van las modificaciones */ } class hack_postgres7 extends adodb_postgres7 { var $rsPrefix = 'hack_rs_'; /* aqui van las modificaciones */ } class hack_rs_postgres7 extends ADORecordSet_postgres7 { /* aqui van las modificaciones */ } $ADODB_NEWCONNECTION = 'hack_factory'; function& hack_factory($driver) { if ($driver !== 'mysql' && $driver !== 'postgres7') return false; $driver = 'hack_'.$driver; $obj = new $driver(); return $obj; } include_once('adodb.inc.php');

No olvides invocar el constructor de la clase padre.

Caracteristicas para PHP5 A partir de la version 4.02 ADOdb determina automaticamente que version de PHP estas usando. Si detecta la version PHP5, activa automaticamente las siguientes caracteriticas:

PDO: estan disponibles los drivers de PDO. Ve los ejemplos de conexion. Actualemte los drivers PDO no son tan poderosos como los drivers nativos, y deben de ser tomados como experimentales.

Foreach iterators: Es una forma muy clara de procesar un 'recordset':

converted by Web2PDFConvert.com

$ADODB_FETCH_MODE = ADODB_FETCH_NUM; $rs = $db->Execute($sql); foreach($rs as $k => $row) { echo "r1=".$row[0]." r2=".$row[1].""; }

Exceptions: Unicamente hay que incluir adodb-exceptions.inc.php y ya se pueden atrapar las excepciones conforme ocurran los errores. include("../adodb-exceptions.inc.php"); include("../adodb.inc.php"); try { $db = NewADOConnection("oci8"); $db->Connect('','scott','bad-password'); } catch (exception $e) { var_dump($e); }

Nota: Alcanzar el fin de archivo (EOF) NO es considerado ni un error ni una excepcion.

Bases de Datos soportadas La columna nombre es el valor que se le pasa a NewADOConnection($nombre) para crear el objecto de conexion para esa base de datos.

Nombre

Verificada Base de datos

sirve PreSistemas operativos RecordCount() requisitos

access ado

B B

S/N ? depende de la base de datos

Microsoft Access/Jet. Hay que crear el DSN en el ODBC. ADO generico, no esta optimizado para ninguna base de datos especifica. Permite conexiones DSN-less. Para un mejor rendimiento, utilizar un proveedor de OLEDB. Esta la clase basa para todos los drivers ado.

Hay que configurar $db->codePage antes de conextarse. Microsoft Access/Jet usando ADO. Permite conexiones DSN- S/N less. Para mejor rendimiento usar un proveedor OLEDB.

ODBC ADO o proveedor OLEDB

Windows unicamente Windows unicamente

ADO o proveedor OLEDB ADO o proveedor OLEDB Interfase CLI/ODBC de DB2

Windows unicamente

ado_access

B

ado_mssql

B

Microsoft SQL Server usando ADO. Permite conexiones DSN- S/N less. Para mejor rendimiento usar un proveedor OLEDB.

db2

A

DB2. Debe de funcionar satisfactoriamente porque se base en S/N el driver ODBC based on ODBC.

odbc_db2

C

Se conecta a DB2 usando la extesion ODBC generica.

S/N

Interfase CLI/ODBC de DB2

vfp fbsql ibase

A C B

Microsoft Visual FoxPro. Hay que crear un DSN. FrontBase. Interbase 6 o anterior. Algunos usuarios dicen que puedes necesitar esta sintaxis para conectarte $db->PConnect('localhost:c:/ibase/employee.gdb', "sysdba", "masterkey") . Actualmente le falta Affected_Rows.

S/N S S/N

ODBC ? cliente Interbase

S/N

cliente Interbase cliente Interbase Cliente Informix Cliente Informix Extension LDAP cliente Mssql

firebird

C

borland_ibase C

Antes de conectarte puedes modificarle $db->dialect, $db>buffers y $db->charSet. version Firebird de interbase.

informix72

C

informix

C

version Borland de Interbase 6.5 o posterior. S/N Desafortunadamente las version son diferentess. Versiones Informix anteriores a 7.3 que no soportan SELECT S/N FIRST. Driver generico para informix. S/N

ldap

C

Driver LDAP driver. Ver el ejemplo para informacion de uso.

mssql

A

Microsoft SQL Server 7 y posterior. Tanbien funciona con S/N Microsoft SQL Server 2000. Toma en cuenta que el formato de las fechas es problematico con este driver. Por ejemplo, la extension mssql de PHP no regresa los segundos de los

Windows unicamente

Unix y Windows. Trucos de instalacion en Unix. Hay reportes de que los parametros $host y $database del Connect() tienen que ir invertidos si se usa la interfase CLI. Unix y Windows. sugerencias para instalacion en Unix. Tengo reportes que los parametros $host y $database tienen que ser invertidos en el Connect() cuando se usa la interfase CLI. Windows unicamente Unix y Windows Unix y Windows

Unix y Windows Unix y Windows Unix y Windows Unix y Windows ? Unix y Windows. Guia de instalacion de Unix y otra mas.

converted by Web2PDFConvert.com

mssqlpo

A

mysql

A

mysqlt or maxsql

A

oci8

A

campos datetime! Driver portable de mssql. Es identico al driver de mssqk anteriorm excepto que el operador de concatenacion '||' se convirtio a '+'. Esto es util para migrar codigo desde otras versiones de SQL.

S/N

Cliente Mssql

Unix y Windows. Guia de instlacion en Unix.

MySQL sin manejo de transacciones. Puedes usar $dbS/N >clientFlags antes de conectarte. MySQL con soporte de transacciones. Recomendamos usar S/N || como el operador de concatenacion para una mejor portabilidad. Esto se logra ejectuando MySQL con: mysqld --ansi o mysqld --sql-mode=PIPES_AS_CONCAT Oracle 8/9. Tiene mas funcionabilidad que el driver oracle (ej. S/N Affected_Rows). Puedes tener que hacer un putenv('ORACLE_HOME=...') antes del Connect/PConnect.

Cliente MySQL Cliente MySQL

Unix y Windows

Cliente Oracle

Unix y Windows

Cliente Oracle

Unix y Windows

Cliente Oracle

Unix y Windows

? depende de la base de datos

ODBC

Unix y Windows. Trucos para Unix.

S/N S/N S/N

ODBC ODBC odbtp

Unix y Windows. Unix y Windows. Unix y Windows

S/N S/N

odbtp Cliente Oracle ?

Unix y Windows Unix y Windows

Cliente PostgreSQL Cliente PostgreSQL Cliente PostgreSQL Cliente PostgreSQL Cliente ODBC de SAPdb Cliente ODBC de SQL Anywhere ODBC -

Unix y Windows.

-

Unix y Windows.

Unix y Windows

hay dos maneras de conectarse - Con la direccion IP del servidor y el nombre del servicio: PConnect('serverip:1521','scott','tiger','service') o en base a un renglon en TNSNAMES.ORA o ONAMES o HOSTNAMES: PConnect(false, 'scott', 'tiger', $oraname).

oci805

C

oci8po

A

odbc

A

odbc_mssql odbc_oracle odbtp

C C C

odbtp_unicode C oracle C

A partir de la version 2.31, se manejan las variables de cursores REF directamente (ver ExecuteCursor). Maneja un funcionaldiad reducida para la version 8.0.5 de S/N Oracle. SelectLimit no es tan eficiente como en los drivers oci8 o oci8po. Driver portable de Oracle 8/9. Esta es casi identica al driver S/N oci8 execpto que (a) Las variables 'bind' en los Prepare() usan ? en lugar de :bindvar, (b) los nombres de campos estan en minusculas (la manera mas usual en PHP). Usa este driver si la portabilidad de tu codigo a otras bases de datos es importante. En caso contrario usa el driver oci8 ya que da mejor rendimiento. Driver generico para ODBC, no esta optimizado para ninguna base de datos especifica. Para conectarse usa PConnect('DSN','user','pwd'). Esta es la clase base para todos los drivers basados en ODBC . Usa ODBC para conectarse a MSSQL Usa ODBC para conectarse a Oracle Driver odbtp generico. Odbtp es un programa para poder usar los DSN en el ODBC de Windows desde OTROS sistemas operativos (ej. Linux). Odtbp con soporte unicode Implementa el viejo API de Oracle 7. Si te es posible usa el driver oci8 para un mejor rendimiento. Driver para Netezza. Netezza esta basado en el codigo base de postgres. Driver generico PostgreSQL. Actualmente es identico al driver postgres7. Para PostgreSQL 6.4 y anteriores que no manejan LIMIT internamente. PostgreSQL que soporta LIMIT y caracteristicas de la version 7. PostgreSQL que maneja la funcionalidad de la version 8.

netezza

C

Y

postgres

A

postgres64

A

postgres7

A

postgres8

A

sapdb

C

SAP DB. Debe de funcionar bien ya que esta basado en el driver ODBC.

S/N

sqlanywhere

C

Sybase SQL Anywhere. Debe de funcionar bien ya que esta basado en el driver ODBC.

S/N

sqlite

B

SQLite. Unicamente verificada en PHP5.

S

sqlitepo

B

Driver portable para SQLLite. Es debido a que el modo S asociativo no funciona como en los otros drivers. Al seleccionar multiples tablas (joining), se incluye el nombre de la tabla en la llave del arreglo asociativo.

S S S S

?

Unix y Windows. Unix y Windows. Unix y Windows. ?

?

Unix y Windows.

En el driver "sqlitepo", el nombre de la tabla es eliminado del nombre de la columna. Cuando hay conflictos, el primer campo tiene preferencia.

converted by Web2PDFConvert.com

sybase

C

Sybase.

S/N

sybase_ase

C

Sybase ASE.

S/N

Cliente Sybase Cliente Sybase

Unix y Windows. Unix y Windows.

La columna "Verificada" indica que tan profusamente el codigo a sido verificado y usado. A = bien verificado y usado con mucha gente B = verificado y usable, pero algunas caracteristicas pueden no estar implementadas C = driver proporcionado por los usuarios o experimental. Puede no manejar todas las ultimas caracteristcicas de ADOdb. La columna "sirve RecordCount()" indica si RecordCount() regresa la cantidad de renglones o regresa -1 cuando se ejectuta un enunciado SELECT. Si la columna muestra S/N entonces RecordCount() es simulado cuando la variable global $ADODB_COUNTRECS=true (esto es el valor por omision). Nota que para recordsets muy grandes, puede ser mejor desabilitar la emulacion de RecordCount()debido a la gran cantidad de memoria para leer el recordset para contarlo. Tambien hay una penalizacion del 40-50% si se tiene que emular la funcion. Es emulada en la mayoria de las bases de datos excepto para PostgreSQL y MySQL. Esta variable es verificada cada vez que se ejecuta un SELECT, por lo que puedes escoger selectivamente cuales recordset contar.

Tutoriales Ejemplo 1: SELECT Tarea: Conectarse al DSN MS Access de la base de datos Nortwind, mostrar las primeras 2 columnas de cada renglon. En este ejemplo, se crea un objeto ADOConnection que representa la conexion a la base de datos. La conexion se inicia con PConnect, que es una conexion persistente. Para interrogar a las base de datos llamamos a la funcion ADOConnection.Execute() . Esto regresa un objeto ADORecordSet que es de hecho un cursor que contiene el renglon actual en el arreglo fields[]. Tambien usamos el metodo MoveNext() para avanzar de renglon en renglon. Nota: Una funcion muy util que NO usamos en este ejemplo es SelectLimit, que nos permite limitar la cantidad de renglones a mostrar.

La variable $recordSet obtenida contiene el renglon actual en el arreglo $recordSet->fields , indexado por numero de columna (empezando en cero). Usamos el metodo MoveNext() para avanxar al renglon siguiente. La propiedad EOF tiene valor verdadero (true) cuando se llega al final del archivo. Si hay algun error en el Execute() se regresa falso (false) en lugar del recordset. El arreglo $recordSet->fields[] es generado por la extension PHP de la base de datos correspondiente. Algunas extensiones unicamente indexan por numero y no por nombre del campo. Para provocar que se indexe por nombre (o sea con arreglos asociativos) hay que usar la funcion SetFetchMode. Cada recordset almacena y usa el metodo que estuvo vigente cuando se creo el recordset con un Execute() o SelectLimit(). $db->SetFetchMode(ADODB_FETCH_NUM); $rs1 = $db->Execute('select * from table'); $db->SetFetchMode(ADODB_FETCH_ASSOC); $rs2 = $db->Execute('select * from table'); print_r($rs1->fields); # muestra array([0]=>'v0',[1] =>'v1') print_r($rs2->fields); # muestra array(['col1']=>'v0',['col2'] =>'v1')

Para obtener el numero de renglones en el enunciado SELECT, se puede usar la funcion $recordSet->RecordCount(). Observa que la funcion puede regresar -1 si no se puede determinar la cantidad de renglones.

Ejemplo 2: SELECT Avanzado con objetos de campos Seleccionar los registros de una tabla, desplegar las primeras dos columnas. Si la segunda columna es un campo DATE o

converted by Web2PDFConvert.com

TIMESTAMP entonces reformatear la fecha al formato americano.

En este ejemplo se verifica el tipo de campo de la segunda columna usando la funcion FetchField(). Esto obtiene un objeto con al menos tres propiedades.

name: Nombre de la columna (campo) type: Tipo nativo del campo de la columna max_length: Longitid maxima del campo. Algunas bases de datos como MySQL no regresan la longitud maxima del campo adecuadamente. En estos casos max_length contendra -1. Posteriormente usamos MetaType() para traducir el tipo nativo a un tipo generico. Actualmente estan definidos los siguientes tipos genericos:

C: Campo caracter que se debe de mostrar en etiquetas . X: TeXtos, campos de texto largo (indefinido) que se deben de mostrar en B: Blobs, u Objectos Binarios Largos (BYTE). Normalmente son imagenes. D: Campo fecha T: Campo Timestamp o datetime L: Campo logico (boleano o de bit) I: Campo entero N: Campo numerico. Incluye auto incrementales (seriales), numericos, punto flotante, reales y enteros. R: Campo serial. Incluye serial, enteros auto incrementales integers. Funciona solo para algunas bases de datos. Si el metatype es de tipo date o timestamp, entonces se imprime usando la funcion definida por el usuario UserDate(), la cual convierte la cadena de texto en formato PHP SQL al formato definido por el usuario. otro uso para la funcion MetaType() es para validar los datos antes de ejecutar un enunciado SQL de INSERT o UPDATE.

Ejemplo 3: Insert Insertar un renglon en la tabla Orders conteniendo fechas y cadenas de caracteres que necesitan ser encomillados antes de que sean aceptados por la base de datos, por ejemplo el apostrofo en la palabra John's.