En el anterior artículo presentamos Spoon, unas librerías de código abierto que puedes utilizar libremente para acelerar el desarrollo de tus aplicaciones PHP 5. Ahora vamos a ofrecer unas notas de interés para las personas que deseen utilizar Spoon y beneficiarse de la implementación de diversos componentes habituales en el desarrollo de sitios web.

Estas notas están inspiradas en los tutoriales que ofrece el sitio web de Spoon para dar los primeros pasos con las librerías, por lo que muchas de las veces no son más que una traducción libre. Sin embargo, para mejorar en la medida de lo posible la documentación ya publicada, desde DesarrolloWeb.com hemos ampliado los textos con algunas notas de uso adicionales, para que este sistema sea aun más fácil de entender.

Descargar Spoon

Está claro que tendremos que descargar el código fuente de Spoon para comenzar a utilizarlo. La descarga la podemos realizar desde el sitio web de Spoon, donde encontraremos la versión más moderna de las librerías.

En el momento de escribir este texto la última versión publicada es la 1.1.5, la cual podemos descargar desde el servidor de DesarrolloWeb.com a partir de este enlace. Pero por favor, antes de intentar descargar esta versión, entrar en Spoon para ver qué novedades hay y cuál es la versión que ofrecen actualmente, que puede estar ampliada con nuevas funcionalidades y haber resuelto posibles problemas o errores.

Una vez descargadas las librerías, las podemos descomprimir y colocar en cualquier lugar que deseemos dentro de nuestro servidor. Como veremos, en el archivo que descargamos hay una carpeta llamada "spoon" que contiene todos los archivos y carpetas de las librerías. Ojo para mantener siempre esa carpeta "spoon" con su nombre original, puesto que si lo cambiamos fallarán los includes a las librerías.

En mi caso, estoy haciendo pruebas con Spoon en un ordenador que tiene sistema operativo Windows y donde he instalado PHP por medio del paquete Xampp.

He colocado Spoon dentro del directorio de publicación que se crea al instalar Xampp, que tiene la ruta: C:/xampp/htdocs

Incluir las librerías Spoon

El primer paso que tenemos que realizar si pretendemos usar Spoon es incluir las librerías. Pero como el código fuente de Spoon dispone de diversos archivos, que además se incluyen unos a otros, debemos realizar un paso previo, que es incluir el directorio donde está Spoon en el "include path" o ruta de inclusión de archivos PHP.

Como digo, este paso es fundamental para que todo funcione correctamente, porque si incluimos nosotros un archivo de Spoon independiente, puede que este archivo necesite de otros y para asegurarnos que esos otros archivos también se encuentran, necesitamos modificar la ruta donde PHP busca los archivos a incluir. Eso se consigue con las siguientes líneas:

define('PATH_LIBRARY', 'ruta_donde_está_la_carpeta_spoon');

set_include_path(get_include_path() . PATH_SEPARATOR . PATH_LIBRARY);

Ojo, que en el anterior código tendremos que sustituir ruta_donde_está_la_carpeta_spoon por la ruta absoluta para llegar a la carpeta donde esté Spoon, que será algo como C:/xampp/htdocs. En mi caso lo hago con la siguiente línea:

define('PATH_LIBRARY', 'C:/xampp/htdocs/');

Esto quiere decir que el propio Spoon está en la carpeta C:/xampp/htdocs/spoon/.

Una vez definido el "include path" podemos incluir Spoon y cualquiera de sus componentes.

require_once 'spoon/spoon.php';
require_once 'spoon/template/template.php';

Podemos ver el código completo de este primer ejemplo, en el que sólo incluimos Spoon.

<?php
//Definir el directorio donde está la carpeta con las librerías
define('PATH_LIBRARY', 'C:/xampp/htdocs/');

// Añadir ese directorio a la ruta de includes
set_include_path(get_include_path() . PATH_SEPARATOR . PATH_LIBRARY);

//Se puede incluir ahora spoon
require_once 'spoon/spoon.php';
require_once 'spoon/template/template.php';
?>