Utilizar una librería PHP para trabajar con el API de Twitter

Hasta este momento en el Manual del API de Twitter en PHP hemos visto generalidades sobre el API de Twitter y cómo hacer un primer script PHP para conectar por HTTP con las URL de consulta del servicio, con la ayuda de cURL. Hemos visto que para hacer un pequeño ejemplo necesitamos poco código PHP, pero de momento los resultados que obtenemos no los hemos procesado y así sirven para poco.

Podríamos evolucionar un poco el código anterior y hacer scripts más complejos, pero hay que trabajar en diversos frentes, cada uno con sus dificultades intrínsecas. Para darnos cuenta de esto, quiero hacer unas pocas reflexiones:

• De momento hemos podido ver en la página unos datos traídos del servicio de Twitter, pero nos ha faltado darles formato o procesarlos de distintas maneras para producir nuestras propias aplicaciones.
• Lo que recibimos del API de Twitter está en XML, por lo que también necesitaremos interpretar ese lenguaje desde PHP, para conseguir procesar las distintas partes de la respuesta.
• Hay muchas otras utilidades del API de Twitter, como revisar los estatus de los usuarios seguidos, o de los seguidores, o hacer que un usuario siga a otro, o enviar mensajes a Twitter a la cuenta de un usuario autenticado, etc.

Por estas razones y por otras, se puede uno imaginar que el trabajo con el API se puede ir complicando a medida que se complican nuestras necesidades y vamos procesando los resultados obtenidos. Así pues, por facilitarnos la vida, vamos a hablar de una de las librerías que existen en PHP para comunicar con el API de Twitter. Veremos cómo usando una de estas librerías el código PHP que tenemos que generar se hará bastante más corto y además la respuesta que podemos ofrecer al usuario también se podrá mejorar sustancialmente con mucha más facilidad.

En este artículo hablaremos de "Twitter class", una librería que nos servirá para hacer la mayoría de las operaciones con Twitter que podamos necesitar de una manera sencilla. Es una especie de envoltorio del API de Twitter que nos permite realizar acciones usando sencillos métodos. Al usar estas librerías no necesitaremos saber cURL, ni tampoco procesar nosotros mismos el XML de la respuesta del API, sino que tendremos nuestras propias funciones para hacer las conexiones, que nos devolverán arrays sencillos de procesar en cualquier script PHP.

La librería la podemos encontrar y descargar en: http://classes.verkoyen.eu/twitter/

Primer ejemplo de uso de la "Twitter Class"

Para empezar, vamos a ver un pequeño ejemplo de consumo de la información ofrecida por el API de Twitter, para realizar la misma tarea que realizamos en el anterior artículo, en el que vimos cómo trabajar con el API de Twitter utilizando directamente las funciones de cURL.

Veamos directamente el código completo de este ejemplo, que seguro podremos entenderlo mucho más fácilmente que el ejemplo del artículo anterior.

<?php
//incluyo la clase Twitter, la "librería envoltorio del API"
include "twitter.php";

//instancio un objeto de la clase Twitter
$miTwitter = new Twitter();

//pedir las 20 últimas participacipaciones públicas
$statusPublico = $miTwitter->getPublicTimeline();

//muestro los resultados en pantalla
echo "<pre>";
print_r($statusPublico);
echo "</pre>";
?>

El ejemplo está comentado y es lo suficientemente sencillo para suponer que cualquier persona podrá entender los distintos pasos que hemos realizado. Como se puede ver, con esta librería podemos acceder al API de Twitter con sólo tres líneas de código, más unas adicionales para mostrar la respuesta en la página. La diferencia comprado con usar cURL nosotros mismos es palpable, pero este es el ejemplo más sencillo, si complicásemos más nuestra tarea, aumentarían más los beneficios de usar la librería.

Pero quiero comentar un detalle adicional. Antes la respuesta que teníamos estaba en XML, sin embargo ahora, lo que nos devuelve el método getPublicTimeline() del objeto Twitter no es un texto en XML, sino que es un array multidimensional con los datos de los últimos post públicos. Sin duda, mucho más fácil de procesar que un texto XML.

En el siguiente artículo seguiremos investigando cosas de esta interesante librería y con su ayuda explicaremos varios otros tipos de operaciones que se pueden realizar con el API de Twitter y con un código minúsculo.