Se tratan temas como la estructura de directorios, nombres de archivos y clases, dependencias entre clases, como trabajar con el repositorio, etc.

En la misma wiki puedes ver una lista completa de los problemas q este nuevo estándar quiere solventar. Es realmente interesante la nueva característica unzip-and-go de las PEAR2, permite a quien quiera usar sólo una o dos clases PEAR se las pueda descargar y utilizar directamente sin necesidad de usar el instalador.

Vía PEAR Blog

Entradas relacionadas:

• Nuevo blog para las “nuevas” PEAR
• Cache de páginas estáticas para PHP
• PHPBarcelona.org, el nuevo portal para el Grupo PHP

La Transferencia de Estado Representacional (Representational State Transfer) o REST describe una interfaz web simple utilizando peticiones HTTP y datos XML pero sin capas adicionales como SOAP, frecuentemente usadas en los servicios web. Precisamente el otro día estuve charlando con mi colega Manuel Aguilar acerca de las ventajas de usar servicios REST en muchos escenarios frente a los clásicos servicios web basados en SOAP o basados en protocolos propios, tema que se trato en la pasada PHP Conference 2007 spring edition celebrada en Stuttgart a la que Manuel asistió.

Sin ánimo de entrar en más detalles de lo que es REST (puedes consultar la definición de la wikipedia que enlazo, está muy bien) vamos a ver como trabajar con del.icio.us desde PHP usando la clase Services_Delicious.

Services_Delicious es una clase todavía en fase beta que no implementa todo lo que nos ofrece el servicio web de del.icio.us, pero que ya permite hacer todas las operaciones básicas cómodamente, como guardar y borrar enlaces, listar los tags, cambiarles el nombre, etc. Son poco más de 400 lineas bastante bien escritas, aunque en PHP4, donde se utiliza HTTP_Request para realizar las peticiones HTTP y XML_serializer para trabajar con los datos XML.

A continuación describo como hacer una nube de tags de una cuenta determinada de del.icio.us y como guardar un nuevo enlace. Esto son sólo dos ejemplos de utilización de algunas de las funciones que nos proporciona Services_Delicious, puedes ver todas las funciones disponibles en el siguiente listado:

1. getTags()
2. renameTag($old, $new)
3. getDates()
4. getPosts($tags, $date)
5. getRecentPosts($tags, $max)
6. getAllPosts()
7. addPost($url, $description, $extended, $tags, $date, $shared)
8. deletePost($url)

Instalación de Services_Delicious

Asumiendo que tenemos las PEAR disponibles lo primero que hemos de hacer es instalar la clase en cuestión:

$ pear install --onlyreqdeps Services_Delicious-beta

Si estamos trabajando con la versión estable de las PEAR, lo más habitual, será necesario añadir "-beta" al nombre del paquete o cambiar la variable de configuración preferred_state. La instalación con el frontend web de las PEAR es igualmente sencilla, lo único a tener en cuenta es que necesita el paquete XML_Serializer que no se instalará automáticamente si tenemos preferred_state=stable ya que también se encuentra en fase beta.

Guardando un enlace en del.icio.us

El código necesario para guardar un enlace es el siguiente:

Con los nombres de las variables se entiende perfectamente como funciona el tema.

Generando una nube de tags

A continuación una utilización un poco más divertida, generar una nube con todas las etiquetas de una cuenta determinada:

Lo anterior sólo es un ejemplo rápido, dependiendo de la cantidad de etiquetas y enlaces se debería hacer algo más con el font-size. Puedes ver funcionando el anterior código sobre mi cuenta en del.icio.us en este ejemplo de nube de tags.

Con Services_Delicious se ha de tener en cuenta que aunque podemos enviar datos con la clásica codificación iso-8859-1 las respuestas vienen en UTF-8, hemos de trabajar con UTF-8 o usar las funciones utf8_encode() y utf8_decode() según convenga, otra opción es modificar Services_Delicious y cambiar la forma de trabajar con XML_Serializer.

Aplicaciones

Aunque la API es muy sencilla nos permite añadir tags a prácticamente cualquier tipo de aplicación PHP, por ejemplo con el anterior código fácilmente nos curramos un pluguin para WordPress que cada vez que colgamos un post lo guarde en del.icio.us, que permita generar una nube de tags, etc. (si es que todavía no existe). Otro ejemplo es con una aplicación de comercio electrónico con stock online como un supermercado o una web de viajes, podemos hacer un script que recorra la BD de turno guardando todos los productos en del.icio.us y permitiendo trabajar con tags, que los usuarios puedan actualizarlos, generar nubes con ellos, etc.

Si a pesar de disponer de tu aplicación PHP en tus servidores o en tu servicio de hosting te gusta sacarte el trabajo de encima con servicios como FeedBurner para los RSS, Flickr para las imágenes, YouTube para los Vídeos... ¿porque no usar del.icio.us para tus tags?

Trabajar con del.icio.us para los tags de tu web tiene la ventaja de que del.icio.us en si es un buen sistema de promoción, mucha gente anda suscrita a RSS de determinados tags, se busca bastante directamente en del.icio.us, etc., y también tiene su efecto en SEO, cada nuevo tag representa un backlink hacia nosotros desde la página de dicho tag. El inconveniente de trabajar con un tercero está claro, que el usuario se pierda por del.icio.us y no vuelva a nuestra tienda o a nuestro blog, aunque siempre podemos usar del.icio.us y no enlazarlos.

A parte de añadir la dimensión de "tag" a nuestra aplicación otro ejemplo de uso de la API de del.icio.us es acceder a nuestros bookmarks de una forma totalmente personalizada y poder mostrarlos como queramos. Un ejemplo de esto es lo que hace Pau Iglesias en la sección de enlaces de su blog, aunque usando otra clase para acceder a la API de del.icio.us que también está muy bien, de hecho es un proyecto más maduro que Services_Delicious.

Esta otra clase es una modificación del mismo Pau Iglesias de la clase original de Dietrich Ayala, autor de las conocidas NuSOAP. En comparación Services_Delicious me gusta más porque básicamente me gusta trabajar con PEAR y usa XML_Serializer/HTTP_Request que, a parte de que ya me las conozco, hacen que el código sea muy limpio y fácilmente adaptable a tus necesidades, pero si no te gustan las PEAR el proyecto del.icio.us PHP API de Pau Iglesias se merece una ojeada, proporciona más o menos las mismas funcionalidades que Services_Delicious pero con el añadido de un interesante sistema de cache.

Entradas relacionadas:

• Leyendo XML desde PHP con SimpleXML
• Envío de emails desde PHP usando varios métodos (PEAR Mail_mime, mail y error_log)
• Como interactuar con Google desde PHP usando Zend Framework

Instalación por consola

Si disponemos de acceso SSH, Telnet, o directo a la consola del servidor este es el procedimiento a seguir.

[1] Iniciamos la sesión de usuario.

[2] Creamos una configuración por defecto para las PEAR:

$ pear config-create $HOME .pearrc

[3] Creamos un directorio temporal en nuestra cuenta para evitarnos problemas de permisos en el directorio "/tmp" del sistema:

$ mkdir $HOME/tmp

[4] Cambiamos las variables necesarias para que trabajen con nuestro directorio temporal:

$ pear config-set download_dir $HOME/tmp/download
$ pear config-set temp_dir $HOME/tmp

[5] Verificamos la correcta configuración:

$ pear config-show

[6] Instalamos el sistema base:

$ pear install -o PEAR

[7] Instalamos las clases PEAR que necesitemos:

$ pear install <clase>

o si queremos instalar alguna versión beta:

$ pear install <clase>-beta

Instalación vía web

Si sólo disponemos de acceso por FTP o Web (como yo con HostGator) o si no queremos trabajar con comandos estos son los pasos necesarios para realizar una instalación vía web.

[1] Vamos a http://go-pear.org/ y guardamos el script PHP que aparece como go-pear.php.

[2] Creamos un directorio en nuestro servidor, por ejemplo "pear", y copiamos go-pear.php dentro.

[3] Abrimos con un navegador la URL correspondiente, por ejemplo:
http://ejemplo.com/pear/go-pear.php

[4] Seguimos los pasos que nos aparecen por pantalla, las opciones por defecto son válidas en la mayoría de ocasiones.

[5] Posteriormente podremos gestionar las clases PEAR instaladas abriendo:
http://ejemplo.com/pear/
Allí nos encontraremos el Web-based PEAR Frontend que nos permitirá instalar, desinstalar y actualizar clases, buscar nuevas clases, cambiar la configuración, etc.

[6] Es importante proteger el directorio de las PEAR para que no sea accesible al público. Al estar dentro del DocumentRoot del servidor Apache cualquiera podrá acceder a la configuración de nuestras PEAR a no ser que protejamos el directorio con usuario+contraseña y/o filtrando por IP.

Snapshot del frontend web de las PEAR:

Configuraciones finales

Una vez completado con éxito cualquiera de los dos procedimientos anteriores sólo nos faltará añadir el directorio que contiene las clases PEAR, en el ejemplo "pear/PEAR", al include_path del PHP para que funciones como include() y require() puedan encontrar las nuevas clases:

Se ha de cambiar "/home/usuario" por la ruta física a tu home de usuario. En el último paso del proceso de instalación vía web se muestra la ruta física a las clases, si has realizado una instalación por consola teclea pwd en tu home y añade "pear/PEAR".

Entradas relacionadas:

• Nuevo blog para las “nuevas” PEAR
• Datos XML bonitos y más leíbles en PHP usando PEAR XML_Beautifier
• Envío de emails desde PHP usando varios métodos (PEAR Mail_mime, mail y error_log)

La nueva constitución aprobada recientemente que ha tenido como consecuencia la elección democrática de un nuevo PEAR Group junto con el nacimiento de este blog son una buena limpieza de cara para el proyecto PEAR.

De momento lo más interesante del blog es el último post donde se anuncia el nuevo instalador Pyrus, todavía en fase pre-devel, para las nuevas clases PHP5+.

Vía Joshua Eichorn's Blog

Entradas relacionadas:

• Nuevos estándares para las PEAR2
• Usando mod_rewrite y FeedBurner para las feeds de un blog con WordPress
• PHPBarcelona.org, el nuevo portal para el Grupo PHP

Normalmente en las transacciones XML los datos se transfieren sin saltos de linea, ni espacios extra, etc. Esto, dependiendo de la complejidad del XML, hace casi imposible la lectura por un humano. La clase XML_Beautifier nos ayudará a separar en distintas líneas, tabular correctamente el código entendiendo los tags, simplificar los comentarios, cambiar mayúsculas por minúsculas, reemplazar caracteres por su entidad HTML, etc. Si no quieres estar copiando constantemente los XML en un navegador para poder leer algo te puede ayudar bastante.

Su uso es el siguiente:

En $archivo tenemos el contenido del archivo XML, por ejemplo la respuesta de una petición cURL, y en $resultado obtendremos el XML formateado. También disponemos de la alternativa a formatString() q es:

Con esto se trabaja sobre archivos en disco y no variables. Dispone de distintas opciones de configuración q nos permitirán fijar el número de espacios de los tabs y demás.

Una advertencia acerca de esta clase... Consume bastante memoria y tiempo para realizar la transformación. Es por esto que si estás soportando muchas transacciones XML es aconsejable sólo usar XML_Beatufier en el momento de leer los XML y no siempre.

Ah! por cierto, de momento está sin maintainer, ten controlado donde la usas pq quizás has de dejar de hacerlo... aunque funciona perfectamente.

Entradas relacionadas:

• Leyendo XML desde PHP con SimpleXML
• Envío de emails desde PHP usando varios métodos (PEAR Mail_mime, mail y error_log)
• Transfiriendo datos con la librería cURL en PHP

Función mail()

Para enviar emails sencillos en modo texto el uso de la función mail() es sin lugar a dudas lo más cómodo. Su uso es el siguiente:

Devuelve TRUE en caso de éxito y FALSE en caso contrario. También podemos pasarle cabeceras adicionales como cuarto parámetro, esto puede ser útil, por ejemplo, para enviar mensajes HTML usando mail() pero a la mínima q necesites enviar emails un poco más complejos es recomendable usar las PEAR.

Función error_log()

Para todos aquellos emails de debug o alertas internas de nuestro software podemos usar error_log(). Con esta función podemos hacer log a distintos destinos: el log del sistema, un archivo, la conexión de debug y también enviar por email. Por ejemplo para enviarnos por email información acerca de una exception q nos salta en nuestro código:

Clase PEAR Mail_mime

Como comentaba esta es una de las clases existentes para el envío de emails con soporte de extensiones MIME, lo que permite enviar HTML con imágenes, vídeo, archivos adjuntos, etc. Este es un ejemplo sencillo de como enviar un email HTML con su versión texto y con un archivo adjunto:

Todos los métodos anteriormente descritos necesitan de un servidor de correo funcionando y las directivas de configuración del PHP correctamente fijadas. Si tienes un ISP un poco decente casi seguro q no tendrás ningún problema.

Una técnica alternativa a todos estos métodos y que no necesita de servidor de correo es usar sockets (función fsockopen()) para mandar nosotros mismos los mensajes desde nuestro código. Se trata de hacer desde PHP el trabajo q antes nos hacía el servidor. Esto, en general, no es recomendable ya q puede presentar serios problemas d rendimiento y gestión de errores (nunca funcionará mejor nuestro código PHP q un Qmail :) y la única ventaja destacable q presenta, a parte de no necesitar d un servidor d correo, es disponer de un mayor control de lo que pasa cuando se envía el email. Podemos por ejemplo saber en el momento si el servidor del destinatario del correo existe y nos acepta el mensaje, etc... Aunque con los métodos descritos y leyendo los mensajes devueltos por el servidor de correo también puedes saber si todo va bien... como consejo, si tienes un servidor de correo úsalo.

Entradas relacionadas:

• Datos XML bonitos y más leíbles en PHP usando PEAR XML_Beautifier
• Como interactuar con Google desde PHP usando Zend Framework
• Instalar clases PEAR en un hosting compartido