Geobject es una librería desarrollada en PHP para facilitar los procesos del CRUD (créate, read, update, delete), permite cargar tablas y filas de bases de datos en Mysql; Representándolas como objetos de php que ofrecen métodos para trabajar comodamente.
- Servidor web con soporte php 5.3 o superior y Mysql
This software is licenced under the licencia MIT.. Please read LICENSE for information on the software availability and distribution.
Descarga gecObject clonándolo desde tu pc. Si no estás familiarizado con GIT o simplemente quieres el archivo comprimido has click en “Donwload zip” en la parte derecha de la pantalla.
Luego copia la carpeta gecobject y su contenido en la raíz de tu proyecto php.
Gecobject provee el archivo autoload.php que se encarga de cargar automáticamente los archivos necesarios para el correcto funcionamiento de la librería. Si usa una versión de php anterior a la 5.3 no funcionara correctamente el autoload ni la librería ya que esta implementa namespace que están presentes solo a partir de php 5.3 o superior. Sin embargo si llegase a presentar problemas en la carga de archivos y estas utilizando la versión correcta de php revisa los comentarios en el archivo autoload.php.
Finalmente un require 'gecobject/config.php'; para cargar la librería y todo debería funcionar!
Define la configuración para conectarse a la base de datos en el archivo config.php
Especialmente en windows 7 la conexion con la base de datos podria ser un poco mas lenta para solucionarlo en DB_HOST escribe la ip de tu servidor en vez de "localhost" ej: define("DB_HOST", "127.0.0.1");. Explicación del problema en stackoverflow
<?php
/** Nombre del host en la base de datos
*Nota: Si presenta lentitud al generarse la conexion con la base de datos en vez de "localhost" pon
* la direccion ip de tu servidor que por defecto es: 127.0.0.1
* @global string DB_HOST
*/
define("DB_HOST", "127.0.0.1");
/** Nombre de la base de datos
* @global string DB_NAME
*/
define("DB_NAME", "database_name");
/** Usuario de la base de datos
* @global string DB_USER
*/
define("DB_USER", "database_user");
/** Password para acceder a la base de datos
* @global string DB_PASSWORD
*/
define("DB_PASSWORD", "database_pass");
/**Si es true Imprime el registro de mensajes
* @global boolean LOG
*/
define("LOG", true);
/** Si es true guarda las excepsiones generadas en consultas
* mysql en un archivo de texto ubicado en LogMysql/error-mysql.txt
*
* @global boolean ERROR_EXCEPTION
*/
define("ERROR_EXCEPTION", false);
?>- Tan sencillo como:
require 'gecobject/config.php';- Recuperar registros de una tabla: =========
//Cambia 'tbl' por el nombre que quieras e instacia por medio de este la clase Table()
use GecObject\DataBase\Table as tbl;
//Devuelve todos los registros de la tabla
$tabla = tbl::get('tableName')->findAll();
foreach ($tabla as $row) {
echo $row->fieldName."<br>";
}El metodo tbl::get('tableName')->findAll($cols = '*', $where = array(), $order = array(), $limit = '') retorna un conjunto de registros de la tabla que cumpla con las condiciones recibidas como parámetro.
Donde:
$where debe ser un array de condiciones con la siguiente estructura:
array(
fieldName => value,
)
fieldName es el nombre del campo de la tabla que será utilizado en las condiciones de la consulta. En value pueden utilizarse algunos operadores de comparación (>, <, >=, <=, != y LIKE). Si value no incluye ningún operador de comparación, se asume una comparación de igualdad.
Por ejemplo, array("precio" => ">100") devolverá todos las filas de la tabla que su precio sea superior a 100 (SELECT * from tabla WHERE precio > 100).
$cols debe ser una cadena con los campos que desea consultar separados por una "," (p.ej., fieldname1, fieldname2, fieldname).
$order debe ser un Arreglo Asociativo
array(
'type' => ASC | DESC
'columns' => array('column1', 'column2')
);
Ejemplo:
//Cambia 'tbl' por el nombre que quieras e instancia por medio de este la clase Table()
use GecObject\DataBase\Table as tbl;
$tabla = tbl::get('tableName')->findAll(
//las columnas que quieres seleccionar
'fieldname1, fieldname2,fieldname3',
//la cunsulta mysql que quieres ejecutar
array(
"nombre" => "LIKE david",
"edad"=> "< 25",
"ciudad" => "bogota"
),
//ordenar las filas
array(
//order ASC o DESC
'type' => "DESC",
//Ordenar por las columnas deseadas
'columns' => array('fieldname1')
),
$limit = 10
);
foreach ($tabla as $row) {
echo $row->fieldName."<br>";
}- Recuperar registros por su primaryKey:
La función findByPk() puedo retornar uno o varios registros dependiendo si recibe como parámetro un array() o una unica clave primaria:
//Cambia 'tbl' por el nombre que quieras e instacia por medio de este la clase Table()
use GecObject\DataBase\Table as tbl;
//Devuelve el registro al que pertenezca el identificador recibido como parámetro
$tabla = tbl::get('tableName')->findByPk('id');
echo $row->fieldName;
//or
//Devuelve los registro a los que pertenezca los identificadores recibidos como parámetro
tbl::get('user')->findByPk(
array('id1','id2','id3')
);- Añadir un registro: =========
//Cambia 'Row' por el nombre que quieras e instacia por medio de este la clase RowTbl()
use GecObject\DataBase\RowTbl as Row;
$row = new Row('user');
$row->nombre = "David";
$row->email = "stylegeco@gmail.com";
//$row->add() devueve false si algo salio mal o el valor del campo primary key
if ($id = $row->add()) {
echo 'Nuevo registro insertado en la tabla: ' . $row->getTableName() . "<br>";
echo "Id de la ultima inserccion: $id";
}- Modificar un registro: =========
//Cambia 'tbl' por el nombre que quieras e instacia por medio de este la clase Table()
use GecObject\DataBase\Table as tbl;
$tabla = tbl::get('user');
$row = $tabla->findByPk(1);
$row->nombre = "petronila";
$row->email = "stylegeco@gmail.com";
//$row->save() devueve false si algo salio mal o true si no hay errores
if ($row->save()) {
echo $row->nombre. "<br>";
echo $row->email. "<br>";
}Esta en desarrollo una documentación mas amplia, si tienes algun comentario no dudes en comunicarmelo, envialo al correo stylegeco@gmail.com o en twitter @stylegeco.
Si quieres ayudarme en el desarrollo de este proyecto no lo dudes, tienes a tu disposición todos los script.