Twitter OAuth med PHP5

Hvorfor denne artikel?
Jeg har selv haft brug for at opdaterer mine gamle PHP Twitter-applikationer til det nye OAuth-system de sidste måneder, ydermere har brugeren Kenny i min brevkasse spurgt efter en løsning, og derfor valgte jeg at lave en god og nem dokumentation på hvordan du laver et PHP-script der kan poste til din Twitter tidslinje / status-beskeder.

Det gamle API er nu deaktiveret
Twitters HTTP Basic Autenticated API service er blevet deaktiveret fra den 31. august 2010. Dette medfører, at programmer som benytter denne API vil blive påkrævet fremover at anvende en token-baseret authentication metode, bedre kendt som OAuth.

Alle eksisterende apps skulle laves om
Men hvad betyder det egentlig? Enhver der har udviklet en applikation, som kommunikerer med Twitter via deres API, er nødt til at bruge noget tid på at opgradere applikationen. I denne artikel jeg vi fokusere på hvordan du med PHP kan udvikle en OAuth-baseret Twitter-klient som kan skrive statusbeskeder på din Twitter-timeline. Eksempelvis en applikation, der automatisk "tweeter", når der er et nyt tilbud tilgængeligt på dit website, når der scores i Champions League eller når du skriver et blog-indlæg på din hjemmeside mv.

Det nye system: OAuth
Ved første øjesyn kan implementeringen af OAuth synes ret skræmmende, og tilmed kan OAuth Token Exchange System være tæmmelig forvirrende at arbejde med, hvis dette ikke er noget du tidligere har prøvet. Heldigvis er der en gode mennesker, der har lavet grundarbejdet for os i form af en gennemført PHP-class så lad os se at komme i gang!

Registrering af din applikation

Din applikation skal registereres (Gratis)
Twitter kræver at alle applikationer der anvender OAuth skal registereres. Det er gratis og heldigvis ganske nemt. Efter din registrering vil du modtage en række nøgler fra Twitter, som du skal bruge for at tilslutte din applikation til deres OAuth API.

Til registrering af din applikation, skal du anvende nedenstående website, hvor du skal udfylde formularen. Dog er der et par punkter, som kan volde dig lidt problemer, og derfor gennemgår jeg dem herunder: 

http://dev.twitter.com/apps

Callback URL: (skal efterlades tomt) Dette felt bruges, hvis du laver en applikation, hvor brugeren skal godkende applikationen. Sagt på en anden måde, så skal dette felt ikke bruges i denne artikel, hvor vi fokuserer på at lave en lille PHP-app der vil opdaterer dit eget Twitter-feed.

Default Access type refererer til den adgang din applikation vil have til Twitter. Read only fjerner tilladelsen til at poste "tweets" mv. hvorimod Read & Write tillader fuld adgang, og i netop dette tilfælde hvor vi skal skrive Twitter status-beskeder på din timeline, skal vi have fuld adgang og du skal derfor vælge Read & Write

Application Type skal ændres til Client.

Så snart din applikation er blevet registreret vil du blive tildelt en OAuth Consumer Key og en Comsumer Secret. Dette danner basis for din OAuth tilslutning fra din PHP-klasse. Du skal gemme disse nøgler, da vi skal bruge dem i næste afsnit.

Resten af denne artiklen kræver et guldmedlemskab. Har du et guldmedlemskab kan du læse resten af artiklen under her :)