martes, 7 de diciembre de 2010

Implementando El Patrón De Diseño Mvc con PHP

Para implementar este patrón y entenderlo un poco más, veremos como convertir una aplicación PHP básica en una aplicación basada en la arquitectura MVC. En este caso, la aplicación será un listado de posts en un blog. En la manera tradicional de PHP, mostrar un listado de post desde la base de datos, se vería como el siguiente script:

<?php// Connecting, selecting database
$link = mysql_connect('localhost', 'myuser', 'mypassword');
mysql_select_db('blog_db', $link);

// Performing SQL query
$result = mysql_query('SELECT date, title FROM post', $link);
?>
<html>
<head>
<title>List of Posts</title>
</head>
<body>
<h1>List of Posts</h1>
<table>
<tr><th>Date</th><th>Title</th></tr>
<?php
// Printing results in HTML
while($row = mysql_fetch_array($result, MYSQL_ASSOC))
{
echo "<tr>";
printf("<td> %s </td>", $row['date']);
printf("<td> %s </td>", $row['title']);
echo "</tr>";
}
?>
</table>
</body>
</html>
<?php
// Closing connection
mysql_close($link);
?>


El script de arriba es rápido de escribir, rápido de ejecutar, pero es muy poco mantenible; algunos de los problemas que encontramos son que no hay chequeo de error (¿qué ocurre si la conexión a la base de datos falla?), el HTML y el código PHP están mezclados incluso entrelazados, y el código está atado a un base de datos MySQL.

Separando la Presentación

Las llamadas a las funciones echo y printf del script de arriba hacen el código difícil de leer. Modificar el código HTML para mejorar la presentación es un fastidio con la sintáxis actual. Por lo tanto, podemos separar el código en dos partes. Primero, el código PHP con toda la lógica de negocio en un script controlador (controller), como se muestra en el siguiente script (index.php):


<?php// Connecting, selecting database
$link = mysql_connect('localhost', 'myuser', 'mypassword');
mysql_select_db('blog_db', $link);

// Performing SQL query
$result = mysql_query('SELECT date, title FROM post', $link);

// Filling up the array for the view
$posts = array();
while($row = mysql_fetch_array($result, MYSQL_ASSOC))
{
$posts[] = $row;
}

// Closing connection
mysql_close($link);

// Requiring the view
require('view.php');


El código HTML, el cual contiene algo de código PHP, es guardado en un script de vista (view.php):


<html>
<head>
<title>List of Posts</title>
</head>
<body>
<h1>List of Posts</h1>
<table>
<tr><th>Date</th><th>Title</th></tr>
<?php foreach($posts as $post): ?><tr>
<td><?php echo $post['date'] ?></td>
<td><?php echo $post['title'] ?></td>
</tr><?php endforeach; ?>
</table>
</body>
</html>


Una buena regla para determinar si la vista esta lo suficientemente limpia es que esta debería de contener la mínima cantidad de código PHP posible, de este modo la vista puede ser entendida por un diseñador HTML sin conocimientos de PHP. La sintaxis PHP más comunes en la vista son echo, if/endif, foreach/endforeach, y nada más. Además, no debería haber código PHP imprimiendo tags HTML.

Por ende, toda la lógica es movida al controlador, y contiene solo código PHP, sin HTML. Como algo importante, deberías imaginar que el mismo controlador debería poder ser usado para diferentes presentaciones (vistas), tales como paginas HTML, archivos PDF, o en una estructura XML.

Separando la manipulación de datos

La mayoría del código del controlador esta dedicado a la manipulación de datos. Pero que pasa si necesitas listar los posts para otro controlador, por ejemplo, uno que tenga una salida en un feed RSS, o si quieres mantener todas las consultas a la base de datos en un solo lugar, para evitar duplicar código, o bien si decides cambiar el modelo de datos, en donde la table post pase a llamarse weblog_post, o por un requerimiento necesitas cambiarte desde MySQL a PostgreSQL. Para hacer todo esto posible, lo que necesitamos hacer es remover la manipulación de datos del controlador, y poner toda esa lógica en otro script (model.php), el cual será nuestro modelo:


<?phpfunction getAllPosts()
{
// Connecting, selecting database
$link = mysql_connect('localhost', 'myuser', 'mypassword');
mysql_select_db('blog_db', $link);

// Performing SQL query
$result = mysql_query('SELECT date, title FROM post', $link);

// Filling up the array
$posts = array();
while($row = mysql_fetch_array($result, MYSQL_ASSOC))
{
$posts[] = $row;
}

// Closing connection
mysql_close($link);

return $posts;
}


Y modificando el controlador (index.php) para incluir el modelo, tenemos:


<?php// Requiring the model
require_once('model.php');

// Retrieving the list of posts
$posts = getAllPosts();

// Requiring the view
require('view.php');


De este modo, el controlador es totalmente leible, ya que su única tarea es obtener los datos desde el modelo y pasarselo a la vista. En aplicaciones más complejas, el controlador además maneja la petición, la sesión de usuario, la autenticación, y demàs cosas.

El modelo esta dedicado a acceder a los datos y puede ser organizado acordemente. Todos los parametros que no dependen de la capa de datos (como ser los parametros de la petición) deben ser provistos por el controlador y no accedidos directamente por el modelo. De este modo, las funciones del modelo pueden ser facilmente utilizadas en otro controlador.

viernes, 26 de noviembre de 2010

Generar archivos pdf con Dompdf en Codeigniter

Después de haber buscado librerías de pdf para integrarlas al codeigniter llego la conclusión de que la que más se adapta a mis necesidades es dompdf, dado que le puedo pasar una pagina HTML y este la pasa a PDF incluyendo las imágenes y algunas reglas de estilo, a continuación presento el procedimiento.

1. Descargamos la librería en su versión 0.5 dado que no funciona con su versión beta me deje llevar por la manía de usar siempre la última versión en fin descárgala de aquí.
2. Descomprimir el archivo en la ruta ./system/plugins/ lo dejamos con el nombre de dompdf.
3. Creamos un plugin con el nombre to_pdf_pi.php el código para este plugin es el siguiente te recuerdo no dejar espacios porque te generaría el error Unable to stream pdf: headers already sent.


function pdf_create($html, $filename, $stream=TRUE)
{
require_once("dompdf/dompdf_config.inc.php");

$dompdf = new DOMPDF();
$dompdf->load_html($html);
$dompdf->render();
if ($stream) {
$dompdf->stream($filename.".pdf");
} else {
$CI =&amp; get_instance();
$CI->load->helper('file');
write_file("./invoices_temp/invoice_$filename.pdf", $dompdf->output());
}
}


4. En el controlador ingresaremos el siguiente código.


function pdf ()
{
$data = 0;
$this ->load->plugin('to_pdf');
$html = $this->load->view( 'welcome_message' , $data , true );

pdf_create ($html,'pruebas');
}

ShareThis