Comenzando con Zend Framework: IV Parte

Por zsamer en Abril 18, 2008

Retomando el último post del set de artículos "Comenzando con Zend Framework", hoy vamos a ver cómo podemos tener acceso a las tablas de la base de datos para que nuestro sistema sea bastante más interesante. Mi idea, es desarrollar un sistema de comentarios, simple pero útil.

También vamos a ver como implementar en nuestro sistema el componente de configuración que trae ZF llamado Zend_Config, diseñado para tener fácil acceso y usar un archivo de configuración con nuestra aplicación y de esa manera obtener ciertos parámetros fundamentales, tales como el nombre de la base de datos, adaptador o motor, usuario, password y otros parámetros más como por ejemplo el nombre de nuestra aplicación. Además provee funcionalidades muy potentes, entre ellas se destaca el manejo jerarquía de datos, un ejemplo podría ser los recursos de nuestra aplicación para el manejo de Listado de Control de Acceso (ACL) que podríamos implementar con Zend_ACL.

Actualmente Zend_Config ofrece adaptadores de los datos de configuración que se almacenan en archivos de texto con Zend_Config_Ini y archivos XML con Zend_Config_Xml.

En nuestro ejemplo vamos a utilizar a Mysql como nuestro motor de base de datos para guardar los comentarios y luego mostrarlos.

La definición o estructura de las tablas en la base de datos quickstart sería (tienen que crearla con usuario y password "test"):

PLAIN TEXT
MySQL:
  1. --
  2. -- Base de datos: `quickstart`
  3. --
  4.  
  5. -- --------------------------------------------------------
  6.  
  7. --
  8. -- Estructura de tabla para la tabla `comments`
  9. --
  10.  
  11. DROP TABLE IF EXISTS `comments`;
  12. CREATE TABLE IF NOT EXISTS `comments` (
  13. `comment_id` INT(10) UNSIGNED NOT NULL AUTO_INCREMENT,
  14. `comments` TEXT NOT NULL,
  15. PRIMARY KEY  (`comment_id`)
  16. ) ENGINE=MyISAM;

Ahora demos una previa repasada de Zend_Db, sus clases proporcionan una poderosa interfaz de abstracción de base de datos SQL. Zend_Db_Adapter es la clase básica que se utiliza para conectar nuestra aplicación a un RDBMS. Hay una clase diferente de adaptadores para cada tipo de RDBMS, entre ellas tenemos Mysql, Oracle, MSSQL, IBM DB2, PostgreSQL Y SQLite.

Veamos un ejemplo de conexión a Mysql:

PLAIN TEXT
PHP:
  1. require_once 'Zend/Db.php';
  2.  
  3. // Automaticalmente carga la clase Zend_Db_Adapter_Pdo_Mysql y crea una instancia de esta.
  4. $db = Zend_Db::factory('Pdo_Mysql', array(
  5. 'host'     => 'localhost',
  6. 'username' => 'test',
  7. 'password' => 'test',
  8. 'dbname'   => 'quickstart '
  9. ));

Como se puede ver ya se ve algo interesant, se está implementando el patrón de diseño Factory, nosotros le indicamos el adaptador mediante un string pasado en el método, en nuestro caso 'Pdo_Mysql' y nos retorna el objeto del adaptador (Zend_Db_Adapter_Abstract) correspondiente para el acceso y manejo de los datos.

Ahora bien, necesitamos el archivo de configuración para nuestro ejemplo vamos a usar el archivo de texto INI:
quickstart/application/config/quickstart.ini

PLAIN TEXT
CODE:
  1. ; Quickstart configuration data
  2. [default]
  3. ;database
  4. database.adapter         = pdo_mysql
  5. database.params.host     = localhost
  6. database.params.dbname   = quickstart
  7. database.params.username = test
  8. database.params.password = test

Ahora tenemos que hacer ciertos cambios a nuestro index.php (puerta de entrada al sistema), quedando de la siguiente forma:

quickstart/public/index.php

PLAIN TEXT
PHP:
  1. <?php
  2. error_reporting(E_ALL | E_STRICT);
  3.  
  4. /** Seteo y Configuración de Directorios */
  5. $rootPath = dirname(dirname(__FILE__));
  6.  
  7. set_include_path(get_include_path() . PATH_SEPARATOR .
  8. $rootPath . '/application/config' . PATH_SEPARATOR .
  9. $rootPath . '/application/models' . PATH_SEPARATOR .
  10. $rootPath . '/library' . PATH_SEPARATOR .
  11. $rootPath . '/public');
  12.  
  13. /** Carga el archivo de configuración ini */
  14. require_once 'Zend/Config/Ini.php';
  15. $config = new Zend_Config_Ini('quickstart.ini', 'default');
  16.  
  17. /** Base de Datos */
  18. require_once 'Zend/Db.php';
  19. require_once 'Zend/Db/Table/Abstract.php';
  20. $db = Zend_Db::factory($config->database);
  21. Zend_Db_Table_Abstract::setDefaultAdapter($db);
  22.  
  23. require_once 'Zend/Controller/Front.php';
  24. $frontController = Zend_Controller_Front::getInstance();
  25. $frontController->setControllerDirectory($rootPath . '/application/controllers')
  26.                     ->throwExceptions(true)
  27.                     ->dispatch();

Como se puede observar nuestro index ha crecido bastante en comparación a como estaba antes, y nuestra aplicación cada ves va tomando más forma y se hace más robusta.

No hay mucho más que comentar de nuestro nuevo index salvo mencionar que Zend_Db_Table_Abstract::setDefaultAdapter($db) nos guarda nuestro objeto de base de datos de forma estática lo cual nos permitirá después hacer uso de ella en cualquier parte de nuestro sistema mediante Zend_Db_Table_Abstract::getDefaultAdapter();

Hemos avanzado harto, pero todavía falta su resto, definamos nuestra clase Modelo CommentsTable, ubicada dentro de la carpeta application/models/ de nuestra aplicación:

quickstart/application/models/CommentsTable.php

PLAIN TEXT
PHP:
  1. <?php
  2. require_once 'Zend/Db/Table/Abstract.php';
  3. class CommentsTable extends Zend_Db_Table_Abstract
  4. {
  5.     protected $_name = 'comments';
  6.     protected $_primary = 'comment_id';
  7.     public static function getAddCommentForm()
  8.     {
  9.         require_once 'Zend/Form.php';
  10.         $form = new Zend_Form(array(
  11.             'method'   => 'post',
  12.             'elements' => array(
  13.                 'comments' => array('textarea', array(
  14.                     'required' => true,
  15.                     'label' => 'Write your comments'
  16.                 )),
  17.                 'submit' => array('submit', array(
  18.                     'label' => 'Send'
  19.                 ))
  20.             ),
  21.         ));
  22.         return $form;
  23.     }
  24.     public static function getComments()
  25.     {
  26.         $commentsTable = new CommentsTable();
  27.         return $commentsTable->fetchAll();
  28.     }
  29.     public static function createNewComments($data)
  30.     {
  31.         $commentsTable = new CommentsTable();
  32.         $comment = $commentsTable->createRow($data);
  33.         $comment->save();
  34.     }
  35. }

Nuestra clase modelo extiende a la clase Zend_Db_Table_Abstract, esta última implementa un conocido patrón de diseño llamadoTable Data Gateway y Row Data Gateway

Nuestro Controlador IndexController quedaría de la siguiente forma:

quickstart/application/controllers/IndexController.php

PLAIN TEXT
PHP:
  1. <?php
  2. require_once 'Zend/Controller/Action.php';
  3. class IndexController extends Zend_Controller_Action
  4. {
  5.     public function init()
  6.     {
  7.         $this->view->baseUrl = $this->_request->getBaseUrl();
  8.     }
  9.     public function indexAction()
  10.     {
  11.         require_once 'CommentsTable.php';
  12.         $form = CommentsTable::getAddCommentForm();
  13.         if ($this->getRequest()->isPost()) {
  14.             if ($form->isValid($_POST)) {
  15.                 $values = $form->getValues();
  16.                 CommentsTable::createNewComments(array('comments' => $values['comments']));
  17.                 $_POST = array();
  18.             }
  19.         }
  20.         $this->view->form = $form;
  21.         $this->view->title = 'Comentarios';
  22.         $this->view->comments = CommentsTable::getComments();
  23.     }
  24. }

Finalmente la definición de nuestra vista actualizada sería:
quickstart\application\views\scripts\index\index.phtml

PLAIN TEXT
PHP:
  1. <!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Strict//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-strict.dtd">
  2. <html xmlns="http://www.w3.org/1999/xhtml">
  3.   <head>
  4.     <meta http-equiv="Content-Type" content="text/html; charset=utf-8" />
  5.     <title>Zend Framework Quick Start</title>
  6.   </head>
  7.   <body>
  8.   <h1><?php echo $this->title; ?></h1>
  9. <ul>
  10. <?php foreach ($this->comments as $comment) :?>
  11.     <li><?php echo $this->escape($comment->comments); ?></li>
  12. <?php endforeach; ?>
  13. </ul>
  14.     <?= $this->form; ?>
  15.   </body>
  16. </html>

Hemos llegado al final de nuestro artículo, en el próximo y último capitulo de esta serie Comenzando con Zend Framework explicaremos como implementar un sistema de layout en nuestro sistema con Zend_Layout, no se lo pierdan y nos vemos próximamente.

Categoría: PHP5, Zend Framwork

 

Comentarios

29 Responses to “Comenzando con Zend Framework: IV Parte”

  1. Enrique Place on Abril 18th, 2008 4:48 pm

    Muy buen artículo, estimado! ;-)

    Pregunta (desde el desconocimiento), ¿me puedes explicar por qué (conceptualmente) agregas el “getAddCommentForm” en el Modelo?

    Muchas veces yo tampoco tengo muy claro donde poner dentro del MVC algunas funcionalidades (falta de experiencia), pero en este caso estaría el Modelo resolviendo la creación del Form, algo más de la capa de Presentación… a mi se me hubiera ocurrido hacerlo más en el Controller (pero no quiere decir que esté bien).

    ¿Me iluminas? ;-)

  2. zsamer on Abril 18th, 2008 5:28 pm

    Enrique, en el Modelo deberían estar todas las clases relacionadas con los datos, teniendo en cuenta que Zend_Form hace manejo de estos almacenando los valores ingresados por el usuario para procesarlos, todo ese procesamiento llámese validación filtro etc., perfectamente podría ir en la capa de Modelo.

    Estuve investigando bastante sobre la manera en que Magento Ecommerce implemento ZF en su sistema, ellos guardan todas las clases que se relacionan con los datos del sistema en el modelo (Mage_Core_Model), tales como las de configuraciones con simpleXML, Sesiones, Validaciones, cookie, Date, Base de datos, email etc.

    También pasa por un tema de diseño de cada desarrollador, dejarlo en el controlador también es una correcta forma de hacerlo.

    saludos,

  3. _imc_ on Abril 21st, 2008 11:48 am

    Buena serie de artículos!
    Estoy esperando como sigue…
    Un saludo

    Isidro

  4. zsamer on Abril 21st, 2008 5:52 pm

    Luego seguiremos con Zend_Layout.

  5. Enrique Place on Abril 21st, 2008 9:26 pm

    Estimado, también estuve viendo Magento (entre otros proyectos) y sus criterios no me terminaron de convencer.

    Lamentablemente no he encontrado hasta el momento una guía conceptual clara sobre cómo estructurar un sistema usando -particularmente- un MVC, y -particularmente- con las posibilidades de Zend.

  6. Enrique Place on Abril 29th, 2008 1:25 pm

    Acabo de encontrar un artículo donde hacen otra implementación: colocan el Form en un Helper.

    “Teóricamente” me ajusta más que el Form quede resuelto en el ámbito de las vistas y no en el Modelo o en el Controler en sí.


    Zend Form, donde generar el html

  7. zsamer on Abril 29th, 2008 1:36 pm

    Estimado, esta buena la forma de implementarlo en las vistas como helper, tiene lógica.
    ;-)

  8. Psycho on Mayo 8th, 2008 7:56 pm

    Muy buen post, hacen falta bastante posts del ZF en español :D
    Saludos

  9. Gabriel on Julio 25th, 2008 8:46 pm

    Hola, no logro hacerlo andar, me da el siguiente error:

    “Fatal error: Uncaught exception ‘Zend_Db_Table_Exception’ with message ‘No adapter found for CommentsTable’ in C:\wamp\www\LibreriaV1\library\Zend\Db\Table\Abstract.php:548 Stack trace: #0 C:\wamp\www\LibreriaV1\library\Zend\Db\Table\Abstract.php(531): Zend_Db_Table_Abstract->_setupDatabaseAdapter() #1 C:\wamp\www\LibreriaV1\library\Zend\Db\Table\Abstract.php(268): Zend_Db_Table_Abstract->_setup() #2 C:\wamp\www\LibreriaV1\application\models\CommentsTable.php(26): Zend_Db_Table_Abstract->__construct() #3 C:\wamp\www\LibreriaV1\application\controllers\IndexController.php(22): CommentsTable::getComments() #4 C:\wamp\www\LibreriaV1\library\Zend\Controller\Action.php(502): IndexController->indexAction() #5 C:\wamp\www\LibreriaV1\library\Zend\Controller\Dispatcher\Standard.php(293): Zend_Controller_Action->dispatch(’indexAction’) #6 C:\wamp\www\LibreriaV1\library\Zend\Controller\Front.php(914): Zend_Controller_Dispatcher_Standard->dispatch(Object(Zend_Controller_Request_Http), Object(Zend_Controller_Response_Http)) #7 C:\wamp\ in C:\wamp\www\LibreriaV1\library\Zend\Db\Table\Abstract.php on line 548″

    Que puede ser?

  10. zsamer on Julio 25th, 2008 8:56 pm

    Te faltó lo más importante “ver bien las instrucciones y leer con cuidado”.

    El error claramente dice que no encuentra el adaptador de base de datos en el objeto Table “específicamente en CommentsTable”

    ¿cómo lo hago?
    fácil, en el bootstrap file:
    $db = Zend_Db::factory($config->database);
    Zend_Db_Table_Abstract::setDefaultAdapter($db);

  11. jose on Septiembre 1st, 2008 5:11 am

    excelente tutorial, ahora una duda, por que guardo en un .ini el user y password, este archivo puede ser editado desde afuera.. por que no se guarda en un php como siempre haciamos (?)

  12. zsamer on Septiembre 1st, 2008 2:09 pm

    en un ambiente de producción el ini se debería de colocar fuera del root del web server o bien con restricciones .htaccess.

    Además Zend_Config recibe la configuración como un array, por lo tanto es perfectamente posible incluir un archivo conf.php el cual declare el array con las configuraciones, en el manual se explica bien como.

    saludos.

  13. alex on Septiembre 30th, 2008 4:40 pm

    Muy buenas!!! a ver, he seguido el manual paso a paso, incluso al final he tenido que copiar literalmente el código del ejemplo. El caso es que no soy capaz de sacarlo del todo :S. No sé porqué pero no aparece el form al final, me muestra:

    Comentarios
    form; ?>

    Creo que me falla aquí f ($form->isValid($_POST))
    ¿Teneis alguna idea de porqué?
    gracias ;)

  14. alex on Septiembre 30th, 2008 4:41 pm

    perdón, el comentario era para la anterior entrada no para esta, jeje, la pondré allí también.

  15. alex on Octubre 2nd, 2008 4:16 pm

    Has visto como nos volveríamos a leer? jeje.
    Perdona mi ignorancia, pero estoy empezando con esto. ¿En qué directorio debe almacenarse la base de datos física?
    Gracias de nuevo ;).

  16. zsamer on Octubre 2nd, 2008 5:46 pm

    La base de datos, en general es un motor y funciona con un servicio. El directorio los configuras según el motor de bd

  17. xolzpmcfy aylwjxkc on Octubre 15th, 2008 6:53 am

    jauszkdl vyrtzcp uwbq uwtnelrfp edtshnm wdiyqot fqsvpwhtc

  18. Jeryyms on Octubre 25th, 2008 3:37 pm

    Nice site you have

  19. larry on Diciembre 17th, 2008 8:04 pm

    Buenas tardes.
    saludos.

    estoy comenzando a trabajar con el Zend Frameworks.

    y estoy probando el codigo de conexion a base de datos el aqui publicado y me arroja el siguiente error. Agradeceria cualquier ayuda al respecto. ya que las otras 3 partes de este blogs me funcionaron a la perfeccion.

  20. larry on Diciembre 17th, 2008 8:05 pm

    disculpen el error es el siguiente:

    Fatal error: Uncaught exception ‘Zend_Config_Exception’ with message ‘parse_ini_file(quickstart.ini) [function.parse-ini-file]: failed to open stream: No such file or directory’ in /var/www/ejemploZend2/library/Zend/Config/Ini.php:117 Stack trace: #0 /var/www/ejemploZend2/public/index.php(14): Zend_Config_Ini->__construct(’quickstart.ini’, ‘default’) #1 {main} thrown in /var/www/ejemploZend2/library/Zend/Config/Ini.php on line 117

  21. liebe on Marzo 1st, 2009 4:06 pm

    Sie haben eine sch?ne Seite!

  22. Guillermo on Mayo 11th, 2009 3:48 am

    Me salio el mismo error que a larry.
    Se debe modificar una linea del codigo de ejemplo:
    en quickstart/public/index.php
    linea 8 dice
    $rootPath . ‘/application/config’ . PATH_SEPARATOR .

    deberia decir:
    $rootPath . ‘/application/configs’ . PATH_SEPARATOR .

    (falto la “s” a “configs”)

    Bueno, espero haber ayudado, mejor tarde quue nunca XD

  23. Lissette on Agosto 11th, 2009 8:49 pm

    excelente tutorial.. solo q la misma consulta en el tutorial de ZendFramework getting action (o como se escriba :$)… ponen los formularios dentro del model y cada una clase como UserForm.. etc etc ahi cada clase hace un extend a Zend_Form.. como hablando con otro amigo me cuenta q el html lo ingresa en los actions dentro de los controllers. Entonces.. mi duda mas q todo como me guio a estructurar una aplicacion… tanto en la parte de formularios, en la parte de acciones, en modulos de la aplicacion.. sinceramente tengo un mix de conceptos en mi cabeza q no me ayudan mucho… alguna sugerencia.. ??

  24. Alejando on Agosto 28th, 2009 5:24 pm

    Hola.

    excelente tutorial, una duda que hay es la con la función $this->escape($comment->comments);

    supongo que es para mostrar los datos del formulario, pero esta se declara en en algún lado??

  25. Caro on Septiembre 15th, 2009 4:24 pm

    Hola!! necesito q alguien m ayude, xq cuando yo estoy creando un proyecto nuevo y l cambio los nombres al controlador,modelo y vista m sale el sgte error:
    The requested URL /pruebaAlbum/prueba was not found on this server.
    es algo q no he podido entender xq en un ejemplo q tome d internet si m funciona, pero los nombres son index todos y al cambiarles el nombre no funciona.. :(

  26. Caro on Septiembre 15th, 2009 8:51 pm

    Ya me di cuenta cual es el error… :)

  27. Milena on Septiembre 22nd, 2009 3:17 pm

    Hola que tal? soy nueva en esto de zend y probando lo de los radio quisiera saber si hay alguna manera de saber de que al seleccionar una opcion del radio pueda aparecer cajas de texto y con la otra opcion aparecer otras cajas de texto.

    y que despues obtener cual de los dos esta selecionado para saber en que tabla es que tengo que guardar.

    El ejemplo que estoy usando es el registro de usuarios naturales y juridicos

  28. Milena on Octubre 6th, 2009 3:26 pm

    Hola que tal!

    Es que estoy intentando pasar valores que recibo en una vista a otra vista, las vistas son identicas en cuanto a los campos o tributos lo que cambia es que la primera tiene el boton que envia los valores a la otra vista.

    Te muestro el codigo que tengo, y cuando hago el getValues no se trae los datos, carga el arreglo pero vacio.

    en la primera vista el boton enviar tiene lo siguiente:
    public function enviarAction()
    {

    $request = $this->getRequest();
    $form = new Default_Form_Ejemplo();
    if (!$form->isValid($request->getPost())) {
    $variables = $form->getValues();
    print_r($variables);
    die();
    }
    $form = new Default_Form_Ejemplo2($variables);
    $this->view->form = $form;
    }

    pero no hace nada en la segunta vista que es Ejemplo2 se quedan en blanco todas la cajas de texto.

    Gracias espero puedan ayudarme…

  29. eac on Noviembre 2nd, 2009 1:04 pm

    Muy buen artículo, sigue así.

Deja tu comentario




XHTML: puedes usar estas etiquetas: <a href="" title=""> <abbr title=""> <acronym title=""> <b> <blockquote cite=""> <cite> <code> <del datetime=""> <em> <i> <q cite=""> <strike> <strong>