Nutzen von externen Klassen

Möchte man nun mit Twitter arbeiten, so ist es nicht zwingend notwendig, die einzelnen API-Anfragen selbst zu schreiben. Es gibt auch schon diverse Klassen, die diese Funktionalität anbieten. David Billingham stellt in seinem Blog unter blog.slawcup.com eine einfache Klasse vor, die die meisten API-Funktionen unterstützt. Die Klasse verwendet auch die cURL-Bibliotheken, gibt aber die Rückgaben als XML zurück. Wird von der PHP-Installation SimpleXML unterstützt, so wird das Ergebnis zusätzlich als SimpleXMLElement-Objekt zurückgegeben. Listing 4 zeigt die Verwendung der Klasse, um Meldungen zu lesen und zu schreiben.

Listing 4: Twitter-Klasse von David Billingham im Einsatz

1. require_once ("twitter.class.phps");
3. $Twitter = new twitter();
4. $Twitter->username = "phpmag";
5. $Twitter->password = "phpmag";
7. // Status setzen
8. $Twitter->update("Twitter Meldung mit der Twitter Klasse von David Billingham");
10. // Letzte Meldung ausgeben
11. $xml = $Twitter->friendsTimeline();
12. echo $xml->status[0]->text;

Im PEAR (PHP Extension and Application Repository) gibt es auch ein Paket, das die Verwendung des Twitter-APIs ermöglicht. Das Paket Services_Twitter wurde von Joe Stump und David Jean Lois entwickelt und befindet sich noch im Beta-Status. Das Paket ist noch nicht in PEAR dokumentiert, aber auf den externen Projektseiten auf Google Code finden sich ein paar Beispiele. Die Anwendung ist dabei ähnlich der bereits beschriebenen Klasse, weswegen ich hier nicht näher darauf eingehen will.

Twittern mit Zend

Wer eine Anwendung mit dem Zend Framework entwickelt, kann auch auf Zend-Funktionen zurückgreifen, um mit Twitter zu kommunizieren. Im Zend Framework gibt es dabei die Klassen aus Zend_Rest, allerdings unterstützt diese Klasse noch keine Authentifizierung. Da die REST-Architektur aber auf HTTP-Anfragen beruht, kann man auch die Klassen aus Zend_Http_Client verwenden. Listing 5 zeigt, wie man mit der Klasse Zend_Http_Client eine Anfrage an das Twitter-API stellt.

Listing 5: Anfrage an das Twitter-API mit Zend_Http_Client

1. // Zend Klassen laden
2. require_once('Zend/Http/Client.php');
4. // Aktion und Rückgabeformat
5. $strAufrufURL = 'http://twitter.com/statuses/friends_timeline.json';
7. // Clienten initieren
8. $http_client = new Zend_Http_Client($strAufrufURL);
10. // Username und Passwort setzen
11. $http_client->setAuth("phpmag", "phpmag");
13. // Anfrage absenden und Rückgabe verarbeiten
14. $http_response = $http_client->request();
15. $oRueckgabe = json_decode($http_response->getBody());
17. // Ausgabe der ersten Meldung
18. echo $oRueckgabe[0]->text;

Der Vorteil der Zend-Klassen liegt darin, dass man die Parameter einfach über Methodenaufrufe definieren kann. Dafür gibt es die Methoden setParameterPost und setParameterGet der Klasse Zend_Http_Client. Listing 6 zeigt die Verwendung der setParameterPost-Methode, um die Mitteilung eines Benutzers zu setzen. Wichtig ist bei Anfragen, die Parameter über POST benötigen, dass man die Anfragemethode bei dem request-Aufruf mit angibt.

Listing 6: Einsatz der setParameterPost-Methode

1. // Zend Klassen laden
2. require_once('Zend/Http/Client.php');
4. // Aktion und Rückgabeformat
5. $http_client = new Zend_Http_Client('http://twitter.com/statuses/update.json');
7. // Username und Passwort setzen
8. $http_client->setAuth("phpmag", "phpmag");
10. // POST Parameter angeben
11. $http_client->setParameterPost("status", "Twitter Status neu gesetzt mit der Zend_Http_Client Klasse des Zend Frameworks");
13. // Anfrage abschicken
14. $http_response = $http_client->request("POST");

Im Zend Framework sind bereits spezielle Klassen für viele andere Web-2.0-Anwendungen wie Delicious oder Amazon integriert. Für das Twitter-API gibt es auch bereits eine Implementierung, die es aber noch nicht ins Framework geschafft hat. Wer die Klasse schon verwenden möchte, findet am Ende des Artikels den Link zu den Quellen im Zend-Framework-Wiki.

Fazit

In diesem Artikel haben Sie die grundlegende Funktionsweise des Twitter-APIs kennengelernt. Als ich angefangen habe, diesen Artikel zu schreiben, habe ich mich gefragt, welchen Sinn es eigentlich macht, von einer PHP-Applikation auf die Twitter-Funktionen zuzugreifen. Beim Schreiben des Artikels sind mir allerdings zahlreiche Anwendungsfälle in den Kopf gekommen, für die sich Twitter eignen würde. Es ist doch schick, wenn man zum Beispiel in einem Onlineshop die täglichen Statistiken als Tweet lesen kann, oder auch über Tweets benachrichtigt wird, wenn Programmfehler auftreten. In einigen Ländern wie den USA, Kanada und Indien ist der automatische SMS-Versand von Tweets noch möglich, so können sich die User in diesen Ländern über SMS informieren lassen, was ihre PHP-Anwendung gerade tut.

Daniel Schmitzer ist Programmierer bei der thüringischen Internetagentur maennchen1.de, und entwickelt dort neben Typo3-Applikationen auch Web-Anwendungen mit dem Zend Framework.

Links & Literatur

1. Twitter API Wiki
2. Blog von David Billingham
3. PEAR Paket Service_Twitter
4. Services_Twitter auf Google Code
5. Zend_Service_Twitter
6. Zend Framework API