Mi primera aplicación CakePHP (1)

Tras hacer una presentación y ver su instalación, empezaremos a realizar una aplicación de ejemplo utilizando CakePHP. Me he decidido a empezar un gestor de enlaces al estilo de delicious o mister wong.

No voy a utilizar algunas utilidades de CakePHP como la herramienta de línea de comando bake (a la que espero dedicar una entrada en el futuro).

Lo primero que hacemos es crear una tabla en la base de datos para nuestros enlace. Para ello entramos en phpMyAdmin con el usuario que creamos en el paso de instalación y creamos una tabla. Nos queda algo así:

Hay que destacar algunas características en la tabla creada:

• El nombre de la tabla no es negociable. Es el plural (en inglés) del modelo al que representa.
• La clave primaria id es obligatoria. El nombre tampoco es negociable.
• El campo created también es de nombre fijo.

En general estas limitaciones son salvables, pero si seguimos el estándar de CakePHP será todo más sencillo y ahorraremos líneas de código.

Lo primero creamos el modelo (por convención lo guardamos en app/models como link.php):

class Link extends AppModel {
	var $name = 'Link';

	var $validate = array(
        'title' => array(
            'rule' => array('maxLength', '30'),
            'allowEmpty' => false,
            'message' => 'Titulo no valido'
		),
        'url' => array(
			'rule' => 'url',
            'required' => true,
            'message' => 'Debe introducir un email correcto'
		)
    );
}

Como podemos ver, un modelo en principio es bastante sencillo. La parte que más líneas acapara es la validación, una de las facilidades que nos aporta CakePHP. En este caso, al título le damos una longitud máxima y a la url le forzamos a que sea una url .

Ahora vamos con el controlador (igualmente por convención lo guardamos en app/controllers como links_controller.php):

class LinksController extends AppController {

	var $name = 'Links';

	function add() {
		if (!empty($this->data)) {
			if ($this->Link->save($this->data)) {
				$this->flash('Enlace añadido.','/links');
			}
		}
	}

	function index() {
		$this->set('links', $this->Link->findAll());
	}
}

El controlador probablemente sea la parte más compleja de nuestra aplicación. En este caso hemos definido dos acciones, una que hemos llamado index (acción por defecto de ese controlador) que nos mostrará todos los enlaces y add que nos permitirá añadir un enlace. Destacamos los siguientes puntos:

• Con !empty($this->data) comprobamos si hemos recibido el formulario de añadir enlace con información.
• Cuando se hace referencia a $this->Link, estamos haciendo referencia al modelo, y utilizamos sus métodos, tanto para guardar un nuevo enlace (save) como para recuperar los enlaces existentes (find('all')).
• Con $this->set() le pasamos información a la vista correspondiente.
• $this->flash() es un método bastante utilizado en CakePHP para hacer una transición a otra página tras mostrar un mensaje.

Por último necesitaremos dos vistas, una por cada acción del controlador. Ambas las pondremos en app/views/links y serán add.thtml e index.thtml. Primero vemos el index:

<h1>Enlaces disponibles</h1>
<?php foreach ($links as $link): ?>

<a href="<?php echo $link['Link']['url']; ?>"><?php echo $link['Link']['title']; ?></a>

Añadido: <?php echo $link['Link']['created']; ?>
<?php endforeach; ?>

<?php echo $html->link('Añadir enlace', '/links/add');?>

Destacamos la utilización de $links suministrado por el controlador mediante el método set(). También la utilización del Helper html, en este caso para crear un enlace ($html->link()).

Y finalmente la vista de añadir:

Añadir
<?php
echo $form->create('Link');
echo $form->input('title');
echo $form->input('url');
echo $form->end('Agregar');
?>

Aquí destacamos la utilización del Helper de formularios, para la creación de todos los elementos del formulario.

Si ahora apuntamos nuestro navegador al proyecto CakePHP y añadimos /links/ al final de la ruta (en CakePHP una ruta /controller/action hace referencia al controlador controller método action) nos dirigimos a la acción por defecto del controlador links y obtenemos:

Destacamos algunas cosas:

• El diseño de cabecera y pie nos lo ha colocado CakePHP. Esto lo modificaremos creando un layout en /app/views.
• En la parte inferior nos aparece información sobre las querys ejecutadas. Esto se debe al nivel de debug que tenemos seleccionado. Mientras desarrollamos yo aconsejo no cambiarlo. Para un sitio en producción lógicamente pondremos el nivel a 0.
• Tenemos un enlace que apunta a la acción add del controlador links (/links/add).
• La lista de enlaces está vacía. Claro, ¡CakePHP tampoco hace magia!.

Si pinchamos en el enlace de añadir, vemos nuestro formulario de añadir:

Podemos hacer algunas pruebas de la validación que CakePHP nos aporta y que nosotros hemos indicado en el modelo (incluido el mensaje que aparece). Cuando finalmente introducimos unos valores válidos llegamos a:

Esta es la pantalla que nos ha generado el $this->flash() que vimos en el controlador. Su funcionamiento también depende del nivel de debug. En el nivel de desarrollo, el mensaje que aportamos es un enlace a la ruta también indicada en $this->flash().

Finalmente ya tenemos el listado de enlaces con contenido:

En la siguiente entrada de esta serie, continuaremos con nuestro gestor de favoritos: solucionaremos algunas pegas que han aparecido hasta ahora, añadiremos comentarios sobre los enlaces de la lista y alguna cosa más.

¡Manteneos en línea!

Actualización: Segunda parte