PDO_CUBRID es un controlador que implementa la interfaz de Objetos de Datos de PHP (PDO) para habilitar el acceso desde PHP a bases de datos de CUBRID.
Nota:
Por ahora, la versión actual de PDO_CUBRID no admite conexiones persistentes.
Para construir la extensión PDO_CUBRID, CUBRID DBMS debe estar instalado en el mismo sistema donde se ejecute PHP. PDO_CUBRID es una extensión » PECL, por lo que se han de seguir las instrucciones dadas en Instalación de extensiones PECL para instalar la extensión PDO_CUBRID. Ejecute el comando configure para indicar la ubicación del directorio base de CUBRID de la siguiente manera:
$ ./configure --with-pdo-cubrid=/path/to/CUBRID[,shared]
CUBRID.
Actualmente, no hay ninguna DLL disponible para esta extensión PECL. Véase también la sección Compilación en Windows . Para información detallada sobre la instalación manual en Linux y Windows, por favor lea build-guide.html en el paquete PECL CUBRID para obtener referencias.
PDO_CUBRID admite cursores desplazables. El tipo de cursor predeterminado es de sólo avance, y se puede usar el parámetro driver_options de PDO::prepare() para cambiar el tipo de cursor.
PDO_CUBRID admite la configuracion del tiempo de espera de las ejecuciones de sentencias SQL; Se puede utilizar PDO::setAttribute() para establecer el valor del tiempo de espera.
PDO_CUBRID admite autocommit_mode y transacciones, y autocommit_mode está habilitado por omisión. Se puede usar PDO::setAttribute() para cambiar su estado.
Si se usa PDO::beginTransaction() para iniciar una transacción, se desactivará autocommit_mode automaticamente y PDO::rollBack(). Obsérvese que antes de deshabilitar autocommit_mode, cualquier trabajo pendiente es consignado automáticamente.
Nota: Antes de desactivar autocommit_mode cualquier trabajo pendiente se consigna automáticamente.
PDO_CUBRID admite sentencias SQL múltiples. Las sentencias SQL
múltiples están serparadas por puntos y comas (;).
PDO_CUBRID implementa el método PDO::cubrid_schema() para obtener la información del esquema.
PDO_CUBRID admite los tipos de datos BLOB/CLOB. El tipo LOB en PDO es representado como un flujo (stream), por lo que pueden insertarse LOBs vinculando un flujo, y obtener LOBs leyendo de un flujo devuelto por CUBRID PDO. Por ejemplo:
Ejemplo #1 Insertar LOBs en CUBRID PDO
<?php
$fp = fopen('lob_test.png', 'rb');
$sql_stmt = "INSERT INTO lob_test(name, content) VALUES('lob_test.png', ?)";
$stmt = $dbh->prepare($sql_stmt);
$ret = $stmt->bindParam(1, $fp, PDO::PARAM_LOB);
$ret = $stmt->execute();
?>Ejemplo #2 Obtener LOBs en CUBRID PDO
<?php
$sql_stmt = "SELECT content FROM lob_test WHERE name='lob_test.png'";
$stmt = $dbh->prepare($sql_stmt);
$stmt->execute();
$result = $stmt->fetch(PDO::FETCH_NUM);
header("Content-Type: image/png");
fpassthru($result[0]);
?>El método PDOStatement::getColumnMeta() de CUBRID PDO devolverá un array asociativo que contiene los siguientes valores:
PDO_CUBRID admite los tipos de datos SET/MULTISET/SEQUENCE. Si no se especifica el tipo de datos, el predeterminado es char. Por ejemplo:
Ejemplo #3 Insertar un conjunto en CUBRID PDO con el tipo de datos predeterminado.
<?php
$conn_str ="cubrid:dbname=demodb;host=localhost;port=33000";
$cubrid_pdo = new PDO($conn_str, 'dba', '');
$cubrid_pdo->exec("DROP TABLE if exists test_tbl");
$cubrid_pdo->exec("CREATE TABLE test_tbl (col_1 SET(VARCHAR))");
$sql_stmt_insert = "INSERT INTO test_tbl VALUES (?);";
$stmt = $cubrid_pdo->prepare($sql_stmt_insert);
$data = array("abc","def","ghi");
$ret = $stmt->bindParam(1, $data, PDO::PARAM_NULL);
$ret = $stmt->execute();
var_Dump($ret);
?>Ejemplo #4 Especificar un tipo de datos al insertar un conjunto en CUBRID PDO
<?php
$conn_str ="cubrid:dbname=demodb;host=localhost;port=33000";
$cubrid_pdo = new PDO($conn_str, 'dba', '');
$cubrid_pdo->exec("DROP TABLE if exists test_tbl");
$cubrid_pdo->exec("CREATE TABLE test_tbl (col_1 SET(int))");
$sql_stmt_insert = "INSERT INTO test_tbl VALUES (?);";
$stmt = $cubrid_pdo->prepare($sql_stmt_insert);
$data = array(1,2,3,4);
$ret = $stmt->bindParam(1, $data, 0,0,"int");
$ret = $stmt->execute();
var_Dump($ret);
?>Tipos de datos de vinculación de CUBRID para el quinto parámetro de PDOStatement::bindParam():
Estas constantes están definidas por
este controlador, y estarán disponibles sólo cuando la extensión haya sido
compilada con PHP, o bien sea cargada dinámicamente en ejecución. Además, estas
constantes específicas del controlador deberían ser utilizadas sólo si está usando este controlador.
Usar atributos específicos del controlador con otro controlador podría resultar en un
comportamiento inesperado. PDO::getAttribute() puede ser empleado para
obtener el atributo PDO::ATTR_DRIVER_NAME para verificar el
controlador, si el código puede ejecutarse con múltiples controladores.
Las siguientes constantes se puden usar al establecer el atributo de la base de datos. Se puede pasar a PDO::getAttribute() o a PDO::setAttribute().
| Constante | Descripción |
|---|---|
| PDO::CUBRID_ATTR_ISOLATION_LEVEL | Nivel de aislamiento de las transacciones para la conexión de la base de datos. |
| PDO::CUBRID_ATTR_LOCK_TIMEOUT | Tiempo de espera de las transacciones en segundos. |
| PDO::CUBRID_ATTR_MAX_STRING_LENGTH | Sólo lectura. La longitud máxima de cadena para los diversos tipos de datos bit, varbit, char, varchar, nchar, nchar al utilizar la API de CUBRID PDO. |
Las siguientes constantes se puden usar al estableder el nivel de aislamiento de las transacciones. Se pueden pasar a PDO::getAttribute() o ser devueltas por PDO::setAttribute().
| Constante | Descripción |
|---|---|
| PDO::TRAN_COMMIT_CLASS_UNCOMMIT_INSTANCE | El nivel de aislamiento más bajo (1). Podría ocurrir una lectura sucia, no repetible o fantasma para la tupla, y puede ocurrir también una lectura no repetible para la tabla. |
| PDO::TRAN_COMMIT_CLASS_COMMIT_INSTANCE | Un nivel relativamente bajo de aislamiento (2). No ocurre una lectura sucia, pero podría ocurrir una lectura no repetible o fantasma. |
| PDO::TRAN_REP_CLASS_UNCOMMIT_INSTANCE | El nivel predeterminado de aislamiento de CUBRID (3). Podría ocurrir una lectura sucia, no repetible o fantasma para la tupla, pero se garantiza una lectura repetible para la tabla. |
| PDO::TRAN_REP_CLASS_COMMIT_INSTANCE | Un nivel relativamente bajo de aislamiento (4). No ocurre una lectura sucia, pero sí podría ocurrir una lectura no repetible o fantasma. |
| PDO::TRAN_REP_CLASS_REP_INSTANCE | Un nivel de aislamiento relativamente alto (5). No ocurre una lectura sucia o no repetible, pero sí podría ocurrir una lectura fantasma. |
| PDO::TRAN_SERIALIZABLE | El nivel de aislamiento más alto (6). No ocurren los problemas concernientes a la concurrencia (p.ej. lectura sucia, no repetible, fantasma, etc.). |
Las siguientes constantes se pueden usar al obtener la información del esquema. Se pueden pasar a PDO::cubrid_schema().
| Constante | Descripción |
|---|---|
| PDO::CUBRID_SCH_TABLE | Obtener el nombre y el tipo de tabla de CUBRID. |
| PDO::CUBRID_SCH_VIEW | Obtener el nombre y el tipo de vista de CUBRID. |
| PDO::CUBRID_SCH_QUERY_SPEC | Obtener la definición de la consulta de la vista. |
| PDO::CUBRID_SCH_ATTRIBUTE | Obtener los atributos de la columnas de la tabla. |
| PDO::CUBRID_SCH_TABLE_ATTRIBUTE | Obtener los atributos de la tabla. |
| PDO::CUBRID_SCH_METHOD | Obtener el método de instancia. El método de instancia es un método invocado por una instancia de clase. Se usa más a menudo que el método de la clase, ya que se ejecutan más operaciones en la instancia. |
| PDO::CUBRID_SCH_TABLE_METHOD | Obtener el método de la clase. El método de la clase es un método invocado por un objeto de clase. Se usa normalmente para crear una nueva instancia de clase o para inicializarla. También se usa para acceder o actualizar los atributos de la clase. |
| PDO::CUBRID_SCH_METHOD_FILE | Obtener la información del fichero donde el método de la tabla está definido. |
| PDO::CUBRID_SCH_SUPER_TABLE | Obtener el nombre y el tipo de la tabla desde la que se heredan atributos. |
| PDO::CUBRID_SCH_SUB_TABLE | Obtener el nombre y el tipo de la tabla que hereda los atributos desde esta tabla. |
| PDO::CUBRID_SCH_CONSTRAINT | Obtener las restricciones de la tabla. |
| PDO::CUBRID_SCH_TRIGGER | Obtener los disparadores de la tabla. |
| PDO::CUBRID_SCH_TABLE_PRIVILEGE | Obtener la información de privilegios de la tabla. |
| PDO::CUBRID_SCH_COL_PRIVILEGE | Obtener la información de los privilegios de la columna. |
| PDO::CUBRID_SCH_DIRECT_SUPER_TABLE | Obtener la super tabla directa de la tabla. |
| PDO::CUBRID_SCH_PRIMARY_KEY | Obtener la clave primaria de la tabla. |
| PDO::CUBRID_SCH_IMPORTED_KEYS | Obtener las claves importadas de la tabla. |
| PDO::CUBRID_SCH_EXPORTED_KEYS | Obtener las claves exportadas de la tabla. |
| PDO::CUBRID_SCH_CROSS_REFERENCE | Obtener la relación de referencia de las tablas a remolque. |