• otherCode

    Bienvenidos a otherCode, una web dedicada al Desarrollo Web con PHP, Javascript, HTML5, CSS3 y desarrollo bajo plataforma Joomla!

     

     

  • 1

Capa de Abstracción de Datos PDO

14 Ene 2014

Nueva versión de la clase de acceso a bases de datos, esta vez basada en PDO, ofrece la posibilidad de conectar con varios tipos de bases de datos.

Configuración

Bien, lo primero que debemos hacer para usar la capa de abstracción, es crear una nueva clase a la que llamaremos Config y que contendrá los parámetros de configuración de la BD, así como otros valores de configuración para nuestra aplicación web.

class Config {
    public $driver = 'mysql';
    public $dbhost = 'localhost';
    public $dbuser = 'usuario_basedatos';
    public $dbpass = 'clave_basedatos';
    public $dbname = 'nombre_basedatos';
}

 Una vez que hemos configurado los datos de acceso, debemos importar la configuración y la capa de abstracción:

require 'configuration.php';
require 'database.pdo.class.php';

Uso

Ahora ya podemos usar la capa con total libertad, por ejemplo si queremos realizar una consulta a una tabla primero debemos obtener una instancia de la capa de abstracción, luego definir la consulta que deseamos realizar y finalmente seleccionar como queremos obtener los datos:

$db = database::getInstance();
$db->query('SELECT * FROM usuarios');
$usuarios = $db->loadObjectList();

En el código de arriba vemos que primero obtenemos una instancia, luego ejecutamos la consulta y finalmente obtenemos los datos en forma de lista de objetos. Esta clase nos permite obtener los datos de las siguientes maneras:

  • Resultado unico: loadResult();
  • Lista de resultado de una columna: loadColumn();
  • Objeto unico:loadObject();
  • Lista de objetos:loadObjectList();
  • Array asociada:loadAssocRow();
  • Lista de arrays arrociadas:loadAssocList();
  • Array indexado: loadIndexedRow();
  • Lista de arrays indexados: loadIndexedList();
  • Objeto JSON: loadJsonObject();
  • Lista de Objetos JSON: loadJsonObjectList();
  • Documento XML: loadXmlObjectList();

Podemos realizar consultas preparadas de forma fácil y sencilla, usando el mismo método query(), al cual le pasaremos la consulta preparada y un array opcional con los parámetros de dicha consulta:

$db = database::getInstance();
$sql = "SELECT * FROM usuarios WHERE id = :id";
$params = array(':id' => 2);
$db->query($sql,$params);
$result = $db->loadObject();

Vemos que en el ejemplo de arriba usamos loadObject() para cargar el resultado devuelto por la consulta pero podemos usar cualquiera de los metodos listados anteriormente.

Tambien podemos obtener el numero de filas devueltas en la consulta SELECT realizada:

$count = $db->getCountRows();

XML y JSON

Podemos obtener el resultado de la consulta en formato XML o JSON usando los metodos loadXmlDocument(); y loadJsonObjectList(); respectivamente:

xml:

<?xml version="1.0" encoding="UTF-8"?>
<usuarios>
    <usuario>
        <id>1</id>
        <nombre>Hombre J.</nombre>
        <apellido>Simpson</apellido>
    </usuario>
    <usuario>
        <id>2</id>
        <nombre>Walter</nombre>
        <apellido>White</apellido>
    </usuario>
    <usuario>
        <id>3</id>
        <nombre>Sheldon</nombre>
        <apellido>Cooper</apellido>
    </usuario>
</usuarios>

 json:

[
    {"id":"1","nombre":"Hombre J.","apellido":"Simpson"},
    {"id":"2","nombre":"Walter","apellido":"White"},
    {"id":"3","nombre":"Sheldon","apellido":"Cooper"}
]

Transacciones

También podemos realizar transacciones de una manera muy sencilla usando los métodos startTransaction() y endTransaction() tal y como vemos en el ejemplo:

$db = database::getInstance();
$db->startTransaction();
$db->query("INSERT INTO usuarios VALUES (NULL, 'Tyrande', 'Whisperwind')");
$db->query("INSERT INTO usuarios VALUES (NULL, 'Vincent', 'Vega')");
$db->endTransaction();

El método startTransaction() inicia la transacción y activa la escucha de errores para que cuando se ejecute el método endTransaction() se ejecute commit() si todo a ido bien o rollback() a ocurrido algún fallo en las consultas.

Errores

Esta clase también nos permite obtener los posibles errores de cada consulta usando el método getError(), que nos devolverá un array asociativo con el código de error y la descripción de dicho error:

$db = database::getInstance();
$db->query('SELECT * FROM suarios');
$error = $db->getError();
var_dump($error);

 Al imprimir la variable error veremos:

array (size=2)
  'code' => int 1146
  'desc' => string 'Table 'test.suarios' doesn't exist' (length=34)

Enlaces

API: class-database

GitHub: database-pdo-class