¿Quieres registrarte?

Crear una clase para conectar a base de datos con PHP

Por: marcosdev
29 de Octubre del 2008
14,343 visitas

Cuando un programador web comienza con PHP, una de las tareas más habituales es la de realizar conexiones y querys a la base de datos. Normalmente, muchísima gente utiliza funciones php para conectarse a una base de datos directamente en el código como puede ser mysql_connect (para conectarse a una base de datos MySQL) o pg_connect (para conectarse a una base de datos Postgress).

Esta forma de trabajar implica un problema muy serio si nuestro proyecto va orientado a una intranet, en la cual, de la noche a la mañana pueden tener la necesidad de cambiar la base de datos por otra diferente (por ejemplo, que una intranet crezca mucho y necesiten cambiar a una base de datos Oracle por funcionalidades específicas).

Si se da este caso podríamos tener un problema muy grave; deberíamos revisar todo el código que hemos escrito en busca de esas funciones específicas y adaptarlas a la nueva base de datos.

Para solventar este problema (crear una capa que nos abstraiga de que base de datos estemos utilizando) y además crear posibles funcionalidades nuevas, vamos a crear una clase muy sencilla la cual nos permita conectarnos a la base de datos. Esta clase la vamos a crear siguiendo el patrón de diseño Singleton. Los patrones de diseño son soluciones a problemas típicos de programación que se repiten contínuamente. El patrón Singleton nos ayuda a crear una clase la cual, si intentamos llamarla dos veces, realmente sólo es una instancia. En vez intentar crear el objeto, lo que haremos es instanciarlo. Esto nos permite conectarnos a la base de datos en cualquier punto del código (dentro de funciones, dentro de objectos,…) sin necesidad de crear más conexiones o tener que pasarla por parámetro (en el caso de querer que una función determinada que tengamos creada utilice una conexión existente y no cree otra nueva).

La estructura de la clase sería la siguiente:


Código :

<?php

/* Clase encargada de gestionar las conexiones a la base de datos */
Class Db{

   private $servidor='localhost';
   private $usuario='user';
   private $password='test';
   private $base_datos='testDB';
   private $link;
   private $stmt;
   private $array;

   static $_instance;

   /*La función construct es privada para evitar que el objeto pueda ser creado mediante new*/
   private function __construct(){
      $this->conectar();
   }

   /*Evitamos el clonaje del objeto. Patrón Singleton*/
   private function __clone(){ }

   /*Función encargada de crear, si es necesario, el objeto. Esta es la función que debemos llamar desde fuera de la clase para instanciar el objeto, y así, poder utilizar sus métodos*/
   public static function getInstance(){
      if (!(self::$_instance instanceof self)){
         self::$_instance=new self();
      }
      return self::$_instance;
   }

   /*Realiza la conexión a la base de datos.*/
   private function conectar(){
      $this->link=mysql_connect($this->servidor, $this->usuario, $this->password);
      mysql_select_db($this->base_datos,$this->link);
      @mysql_query("SET NAMES 'utf8'");
   }

   /*Método para ejecutar una sentencia sql*/
   public function ejecutar($sql){
      $this->stmt=mysql_query($sql,$this->link);
      return $this->stmt;
   }

   /*Método para obtener una fila de resultados de la sentencia sql*/
   public function obtener_fila($stmt,$fila){
      if ($fila==0){
         $this->array=mysql_fetch_array($stmt);
      }else{
         mysql_data_seek($stmt,$fila);
         $this->array=mysql_fetch_array($stmt);
      }
      return $this->array;
   }

   //Devuelve el último id del insert introducido
   public function lastID(){
      return mysql_insert_id($this->link);
   }

}
?>


En esta clase, cómo podemos observar, existen varios métodos para conectar, obtener resultados de una query así como el último id que se ha creado mediante un Insert en un campo clave autoincremental.

Ahora veamos como utilizar esta clase:

Código :

<?php

/*Incluimos el fichero de la clase*/
require 'Db.class.php';

/*Creamos la instancia del objeto. Ya estamos conectados*/
$bd=Db::getInstance();

/*Creamos una query sencilla*/
$sql='SELECT NOMBRE FROM CLIENTES';

/*Ejecutamos la query*/
$stmt=$bd->ejecutar($sql);

/*Realizamos un bucle para ir obteniendo los resultados*/
while ($x=$bd->obtener_fila($stmt,0)){
   echo $x['NOMBRE'].'<br />';
}

?>


Muy sencillo y práctico.

Esta clase es muy (MUY) mejorable. Por ejemplo, en el siguiente tip veremos como utilizar un fichero de configuración que será utilizado por una clase llamada Conf, la cual será utilizada a su vez por esta clase que acabamos de crear. Además, introducir control de errores de conexión, niveles de seguridad para utilizar diferentes perfiles según el ámbito de la conexión,…

Esta clase va dirigida a aquellas personas que todavía no utilizan un Framework y siguen trabajando directamente sobre PHP.

Enviar a twitter Enviar a facebook


También te interesa


Etiquetas php mysql poo singleton

Comentarios | Enviar un comentario
Excelente tip. Felicidades ^^
Por: Zah
Esto se ve genial, gracias por compartirlo ^^ .
Por: Otaku RzO
Excelente tip, yo tengo varias clases genericas que hice para hacer tareas comúnes como está, siempre es bueno tener todo eso a la mano
Por: Aoyama
Gracias por tan excelente tip..!
Por: torrealbaruben
Sería interesante, ya que os habeis puesto con flex y php, que hicierais algún artículo de Zend con Flex.

Saludos.
Por: ozofeliz-blog
Muchas gracias por sus comentarios. El tema de Zend lo tengo apartado ya que en un futuro no muy lejano (juer como suena) saldrá la versión 2 del Zend Framework, la cual no será compatible hacia atrás. Esperaré hasta entonces. Ahora mismo no tengo tanta prisa.
Por: marcosdev
Excelente tip, de verdad muy bueno.
Por: The Fricky!
Bien... pero yo recomendaria utilizar mysqli es una clase nativa de PHP mucho mas optimizada, potente y con nuevas opciones q la extension clasica mysql (en verdad es el nuevo soporte de php a las bases de datos mysql).

Por un lado te ahorras en reinventar la rueda je.
Por: alfathenus
Muy buen tip, como dices se puede mejorar muchísimo, tanto que ya lo han hecho y a lo grande, en realidad esta tarea es algo que empezó por allá de mediados de los 90's y frameworks grandes de desarrollo como Struts o Hibernate ya lo implementan, me refiero al ORM (Object Relational Mapping) para ayudar al desarrollador en la tarea de estar creando los querys y demás. Propel es un ejemplo de ORM para Php, se puede encontrar más información del tema en la página del proyecto:
http://propel.phpdb.org/trac/
Saludos!!!
Por: Tata
Me parece genial tu aporte. :wink:

Mi concepto que manejo es un poco mas abstracto, tengo una clase DAL(Data Access Layer), que es la que invoco en mis PHP. En DAL mediante el archivo de configuración defino el DBMS, aunque por ahora mi FW solo trabaja MySQL.
Dal es a la que le aplico el singletón. Dal crea una instancia de MySQL por cada conexión activa(generalmente es una, pero algunos proyectos requieren mas de una).

Pero sabes, para los recordset(queries, select * FROM), tengo otra clase DataSet.

DataSet es una clase que utilizo en los controles de usuario, un control de usuario, acepta un DataSet nada mas. La ventaja es que los DataSet los puedo formar con un recurso de DB o un simple array, dandole mayor versatilidad a los controles.

Pero bueno, me da gusto ver a gente que trabaja bien el php y esta construyendo alternativas, haber si en estos dias me doy tiempo a publicar algunas clases de mi FW.
Por: Dano
Buenas, este tip es sólo una cosa superficial y que en otros tips iré mostrando como mejorar.

@alfathenus: no estoy intentando reinventar la rueda creando funciones que php ya tiene creada, sino creando una capa de abstracción entre tu proyecto y la base de datos que utilices. Cómo explico al comienzo del tip, se puede mejorar la clase para que en función de un atributo privado de la clase utilice unas funciones u otras dentro de los métodos en función de la base de datos a utilizar.

@Tata: tienes toda la razón, así como las clases que utiliza el Zend Framework. Esto es para proyectos pequeños / medianos, o aquellos proyectos que por X razones no quieran utilizar Clases ORM ya extendas o un Framework con sus propias clases.

@Dano: mi intención es en próximos tips es ir mostrando como esta clase se puede mejorar con un fichero de configuración externo, con variables para diferencia el SGBD, etc... De hecho las clases que utilizo en proyectos reales, son bastante más complejas, pero creo que no sería didáctico para algunos de los visitantes del foro.

Y por cierto, gracias a todos por vuestros comentarios.
Por: marcosdev
Genial tip, excelente explicación, una actitud muy humilde y sobre todo respetuosa del amigo marcosdev, un profesionalismo en la manera de ir manejando poco a poco, y de menos a más difícil su tip, me parece perfecto. No vengo a presumir lo que tengo, solo vengo a felicitar al autor de este consejo, y sobre todo, a aprender de los mejores, gracias, amigo.
Por: Oz Nuñez
vale muy bien por el manejo de instancias
Por: jpcw
Buenisimo aporte, gracias ya venia presentando ese tipo de problemas y ya lo teno resuelto gracias a ustedes
Por: picasoft-blog
marcosdev, tu dices que usas Singleton, pero no es así. El objetivo principal de singleton es crear una única instancia de clase y asegurarse de que no se creen más, además de que solo se pueda accesar a esa instancia única por un punto global y no directamente. En esta clase, no aseguras eso, veamos:

  • static $instance; <-- esto es publico, puede acceder desde donde sea.
  • __clone, ese método mágico con solo la declaración no me impide que clone el objeto. Debes generar un error para detener la ejecución del script por operación inválida.
  • Tomaste en cuenta el clonado del objeto ¡Bien!, pero ¿Y la deserialización?. Debes apoyarte de __wakeup, de nuevo, tienes que generar un error.



Ya estoy haciendo un artículo sobre singleton en php que será publicado pronto, falta hacer algunos retoques.


saludos
Por: Maikel
Lo de __clone esta bien, no habia visto que lo habías declarado private :wink:
Por: Maikel
Maikel..pues ami me parece bueno el ejemplo y si maneja bien el singleton

marcosdev, hubiese sido mas interesante si utilizas el PDO como manejador de acceso a BD para que sirve para varios drivers y no solo para MySql.

Y para los que esten interesados en productos ya terminados, en cuanto a estas soluciones como lo manifiesta Tata existen librerias ya dedicadas al [url="http://en.wikipedia.org/wiki/Data_access_layer"]DAL[/url] y a los [url="http://es.wikipedia.org/wiki/ORM"]ORM[/url] como [url="http://propel.phpdb.org/trac/"]Propel[/url] que lo utiliza framworks como symphony, yo en particular estoy mas casado con Zend, aunque no utilizo su capa de modelo, la reemplazo con [url="http://www.doctrine-project.org/"]doctrine[/url] que me parece muy potente y ya con una versión liberada.

Y con respecto a solución entre Flex y PHP trabajo con Flex aplicando MVC, AMFPHP como la capa de comunicación entre el front-end y el back-end y el Core de Zend en conjunto con Doctrine, esto me a ahorrado trabajo y me a resultado mucho ma compacto realizar aplicaciones con estas herramientas!
Por: vanvanero
PD: a mi todavíame toma del pelo estas etiquetas del clab XD XD XD sorry! sera para la próxima
Por: vanvanero
Ahh también se me olvidaba para la versión 2 del framework de Zend tienen prevista incluir una libreria nativa para el manejo de AMF se llamaría Zend_AMF, Wade Arnold es el responsable y colaborador, les dejo la referencia y el video tutorial de su implementación respectivamente http://framework.zend.com/wiki/display/ZFPROP/Zend_Amf+-+Wade+Arnold

http://www.gotoandlearn.com/play?id=90
Por: vanvanero
Muy bueno, me voy a ahorrar lineas de codigo!
Por: Ikkaro-blog
como hago para que el sistema encuentre el fichero de la clase?
Por: Joe-blog
Joe-blog, si te fijas en la segunda parte del código, hay una línea que pone:


/*Incluimos el fichero de la clase*/
require 'Db.class.php';


Esto es para que el sistema pueda utilizar la clase que hemos creado y guardado en dicho fichero.
Por: marcosdev
si, lo vi... lo que paso es que en la version de php que tengo se llama DB.php y popr eso no la encontraba... gracias

me aparece este error tambien:

Fatal error: Call to a member function ejecutar() on a non-object in C:\xampp\htdocs\prueba.php on line 13

linea 13: $stmt=$bd->ejecutar($sql);
Por: Joe-blog
Joe-blog he comprobado el código para ver que no existiera ningún problema, y el código funciona correctamente, ¿qué versión de PHP tienes?.

Normalmente ese error aparece cuando no se ha instanciado el objeto.
Por: marcosdev
tengo php 5
Por: Joe-blog
@Joe-blog: si quieres, escribe aquí tu código para poder ver dónde está el error.

Un saludo
Por: marcosdev
<?php

/* Clase encargada de gestionar las conexiones a la base de datos */
Class Db{

private $servidor='localhost';
private $usuario='';
private $password='';
private $base_datos='inventario';
private $link;
private $stmt;
private $array;

static $_instance;

/*La función construct es privada para evitar que el objeto pueda ser creado mediante new*/
private function __construct(){
$this->conectar();
}

/*Evitamos el clonaje del objeto. Patrón Singleton*/
private function __clone(){ }

/*Función encargada de crear, si es necesario, el objeto. Esta es la función que debemos llamar desde fuera de la clase para instanciar el objeto, y así, poder utilizar sus métodos*/
public static function getInstance(){
if (!(self::$_instance instanceof self)){
self::$_instance=new self();
}
return self::$_instance;
}

/*Realiza la conexión a la base de datos.*/
private function conectar(){
$this->link=mysql_connect($this->servidor, $this->usuario, $this->password);
mysql_select_db($this->base_datos,$this->link);
@mysql_query("SET NAMES 'utf8'");
}

/*Método para ejecutar una sentencia sql*/
public function ejecutar($sql){
$this->stmt = mysql_query($sql,$this->link);
return $this->stmt;
}

/*Método para obtener una fila de resultados de la sentencia sql*/
public function obtener_fila($stmt,$fila){
if ($fila==0){
$this->array=mysql_fetch_array($stmt);
}else{
mysql_data_seek($stmt,$fila);
$this->array=mysql_fetch_array($stmt);
}
return $this->array;
}

//Devuelve el último id del insert introducido
public function lastID(){
return mysql_insert_id($this->link);
}

}
?>
Por: Joe-blog
<?php

/*Incluimos el fichero de la clase*/
require 'Db.php';

/*Creamos la instancia del objeto. Ya estamos conectados*/
$bd=DB::getInstance();

/*Creamos una query sencilla*/
$sql='SELECT Nombre FROM contacto';

/*Ejecutamos la query*/
$stmt=$bd->ejecutar($sql);

/*Realizamos un bucle para ir obteniendo los resultados*/
while ($x=$bd->obtener_fila($stmt,0)){
echo $x['Nonmbre'].'<br />';
}

?>
Por: Joe-blog
Joe-blog, no has definido ningún usuario a utilizar, al igual que la contraseña. Aunque una base de datos sea local, es necesario utilizar usuario y contraseña (o al menos usuario sin contraseña).
Por: marcosdev
Donde esta el control de errores?
El ORM?
La depuracion de los errores?

Falta un poco pero para novatos esta super bien.

Recomiendo CakePHP :)

Saludos.
Por: Fabian Ramirez-blog
Fabian Ramirez-blog, ya comenté que esto es para ir enseñando a la gente a crearse clases, a crear capas de abstracción entre la base de datos y nuestra aplicación,...
Por: marcosdev
seria bueno si dejaras un link para q se pueda descargar el archivo completo
Por: edwub-blog
Ok edwub-blog, lo colgaré esta semana en mi blog.

Un saludo
Por: marcosdev
edwub-blog ya he colgado en mi blog en enlace a los ficheros con todo el código que se explica en el código.
Por: marcosdev
Chévere y útil el tutorial. Pilas con la ortografía.
Por: afpera
Hola, ¿funciona el enlace que has puesto en tu blog a los ficheros fuente? Al pinchar en él me redirecciona a la página principal.

Gracias.
Por: Jesualdo-blog
Hola,

No veo que se cierre la conexión en ningún momento. mysql.close();

¿A qué se debe? ¿Acaso no es necesario?

Gracias.
Por: dinamik-blog
Duda resuelta: No es necesario cerrar las conexiones NO PERSISTENTES a partir de PHP4, ya que se cierran automaticamente. (Aparece en la documentacion del método mysql_close de php.net)
Por: dinamik-blog
Por que reescribir lo ya hecho?

Eso lo hace PEAR DB
Por: Nico-blog
no ley nada aburidooo muy largo
Por: azul-blog
perdon por lo q puse .pero no me gustan los textos muy largos me aburren , me duermen ... de todos modos gracias
Por: azul-blog
Muy buen artículo!! Programemos con calidad, desarrollemos orientado a objetos!!
Saludos a todos
Por: Teodoro-blog
jjkjkj
Por: ololo-blog
Deja un comentario
IMPORTANTE

Recuerda ser respetuoso, no insultes a otras personas, ni uses palabrotas, hay una persona al otro lado de la pantalla.

Habla bien, NO ESCRIBAS EN MAYUSCULA TODO, no escribas como en un SMS, evita cosas como "ke", "x q" y demás abreviaciones.

Aquí funcionan las etiquetas de los foros, puedes usar [b] para negrita, [img] para las imágenes, [url] para los enlaces, etc.

Si tienes preguntas técnicas, envíalas mejor al foro.