Die APIs der Url Shortener funktionieren alle nach dem gleichen Prinzip: Man übergibt die Url als Parameter zu einer Website und man bekommt die Kurz-Url zurück. Beispiel:

http://is.gd/api.php?longurl=http://stevieswebsite.de

Wenn man diese Seite besucht bekommt man den folgenden Link:

http://is.gd/5O2ZU

Also muss man nur die Url zusammensetzen und den Inhalt auslesen. Ich habe mir bereits einige Url Shortener rausgesucht und je eine Funktion gebastelt, mit welcher man die Kurz-Url zurückbekommt.

Dafür muss in der php.ini die Einstellung allow_url_fopen auf On geschaltet werden (wenn sie es noch nicht ist).

Hier sind die Funktionen der einzelnen Anbieter (Ich habe extra jeweils eine Funktion gemacht, da man i.d.R. sowieso nur einen Anbieter braucht):

Bit.ly

<?php
  function shortBitLy($url){
    $res = "";
    $handle = @fopen("http://bit.ly/api?url=".urlencode($url), "rb");
    if($handle){
      while (!feof($handle)) {
        $res .= fgets($handle,2000);
      }
      fclose($handle);
    }
    else{
      throw new Exception("Link kann nicht gekürzt werden!");
    }
    return $res;
  }
?>

Is.Gd

<?php
  functionshortIsGd($url){
    $res = "";
    $handle = @fopen("http://is.gd/api.php?longurl=".urlencode($url), "rb");
    if($handle){
      while (!feof($handle)) {
        $res .= fgets($handle,2000);
      }
      fclose($handle);
    }
    else{
      throw new Exception("Link kann nicht gekürzt werden!");
    }
    return $res;
  }
?>

TinyUrl

<?php 
  functionshortTinyUrl($url){
    $res = "";
    $handle = @fopen("http://tinyurl.com/api-create.php?url=".urlencode($url), "rb");
    if($handle){
      while (!feof($handle)) {
        $res .= fgets($handle,2000);
      }
      fclose($handle);
    }
    else{
      throw new Exception("Link kann nicht gekürzt werden!");
    }
    return $res;
  }
?>

Krz.ch

<?php
  function shortKrzCh($url){
    $res = "";
    $handle = @fopen("http://krz.ch/?module=ShortURL&file=Add&mode=API&url=".urlencode($url), "rb");
    if($handle){
      while (!feof($handle)) {
        $res .= fgets($handle,2000);
      }
      fclose($handle);
    }
    else{
      throw new Exception("Link kann nicht gekürzt werden!");
    }
    return $res;
  }
?>

Redir.ec

<?php
  function shortRedirEc($url){
    $res = "";
    $handle = @fopen("http://redir.ec/_api/rest/redirec/create?url=".urlencode($url), "rb");
    if($handle){
      while (!feof($handle)) {
        $res .= fgets($handle,2000);
      }
      fclose($handle);
    }
    else{
      throw new Exception("Link kann nicht gekürzt werden!");
    }
    return $res;
  }
?>

U.nu

<?php
  function shortUNu($url){
    $res = "";
    $handle = @fopen("http://u.nu/unu-api-simple?url=".urlencode($url), "rb");
    if($handle){
      while (!feof($handle)) {
        $res .= fgets($handle,2000);
      }
      fclose($handle);
    }
    else{
      throw new Exception("Link kann nicht gekürzt werden!");
    }
    return $res;
  }
?>

Die PHP-Grundlagen Tutorials auf SteviesWebsite sind ja bereits ein bisschen veraltet, weswegen ich jetzt ab und an ein paar neue Tutorials über die Grundlagen in PHP berichte und diese in Tutorial-Sammlung einbaue. Heute fängt es mit den Grundlagen der Objektorientierung an.

In der Programmierung macht es oft Sinn Sachen als Objekte zu verstehen. Macht man z.B. eine Community, so könnte User ein eigenes Objekt sein. Alle Funktionen die es zu dem User gibt werden dann in einer Klasse gespeichert. Das hat den Vorteil, dass man bei Änderungen nicht nach den Funktionen suchen muss. Man kann direkt das Objekt ändern.

Was sind Klassen?

Für alle OOP(Objektorientierung) Neulinge werde ich noch mal kurz erklären was Klassen und Objekte eigentlich sind. Klassen sind so zusagen die Baupläne für die Objekte. Die Klassen müssen wir entwickeln. Außerhalb des Codes der Klasse, werden wir auf Objekte zurückgreifen. Das sind eben nicht nur die Baupläne, sondern zum Beispiel schon das reelle Haus.

Neue Klasse erstellen

Am besten nennst Du die PHP-Datei der Klasse so, wie du auch die Klasse selbst nennst. So weist du immer, wo Du sie finden kannst. Ich hab da mal ne Beispiel-Klasse vorbereitet, die ich nachher erläutern werde:

<?PHP
  class Auto{
    private $bezin;

    public function tanken($bezin){
      $this->benzin += $bezin;
    }

    public function fahren(){
      $this->benzin -= 1;
      echo "Brumm Brumm";
    }

    public function istBenzinVorhanden(){
      return $this->benzin > 0;
    }
  }
?>

Der Name der Klasse ist Auto. Sie hat eine lokale Variable namens $benzin. Diese ist jedoch nur innerhalb der Klasse erreichbar, da sie als private deklaiert wurde.

Dann haben wir noch 3 Funktionen, die alle von außen erreichbar sind. Auf die Variable Benzin greifen wir dort über $this zu. $this steht für das aktuelle Objekt.

Objekte erstellen

Super, jetzt haben wir eine Klasse. Nun müssen wir nur noch das Objekt daraus erstellen und es verwenden. Wenn wir schon so ein schönes Auto haben, müssen wir es natürlich auch fahren lassen. Also tanken wir erst und fahren dann so lange, bis der Tank leer ist:

<?PHP
  include("Auto.php");
  $porsche = new Auto();
  $porsche.tanken(50);
  while($porsche. istBenzinVorhanden()){
    $porsche->fahren();
  }
?>

Ganz oben mussten wir als erstes unsere Klasse importieren. Dann erstellen wir und mit new und dem Klassennamen Auto einen Porsche (Wenn ihr wollt, könnt ihr auch ein anderes nehmen^^). Den müssen wir Tanken. Also rufen wir die $porsche.tanken auf. Schon steht der Benzinstand auf 50. In der While-Schleife prüfen wir dann, ob noch Benzin vorhanden ist und wenn ja fahren wir weiter.

Gravatar monsterid

Gravatar ist ein Dienst, der für ganz viele Mail-Adressen Bilder gespeichert hat, welche man dann auslesen kann. So ist das zum Beispiel auch in WordPress Blogs. Dort wird oft (wie auch bei mir) bei den Usern ein Bild angezeigt. Dieses Bild ist auf Gravatar.com gespeichert und in allen Blogs gleich.

Gravatar kann man aber auch an anderen Stellen verwenden, um so zum Beispiel in Communities das Profil-Bild automatisch zu setzten.

Das ist auch nicht wirklich schwer. Man muss nur die Bild-Adresse herauskriegen und das geht so:

1. Aus der Mail-Adresse einen MD5 Hash erstellen (aus info an stevieswebsite.de wird 20f8e8b51e470855d7bbbe21aa84eec3).
2. Den Hash so in die Adrese einfügen: http://www.gravatar.com/avatar/{md5hash}.jpg

Nun kann man auch noch die Größe definieren. Dabei übergibt man einfach den Parameter s (Anzahl an Pixeln):

http://www.gravatar.com/avatar/20f8e8b51e470855d7bbbe21aa84eec3.jpg?s=100

Wenn nun eine Mail-Adresse doch noch nicht vorhanden ist, kann man mit dem Parameter d noch Defaultbilder angeben. Dort gibt es folgendes zur Auswahl:

• Url des Defaultbildes
• identcon (Ich nenn es mal Mosaik-Grafiken)
• monsterid  - Bilder von Monstern (die gibt es in diesem Blog)
• wavatar – Komische andere Figuren
• 404 – Kein Bild wird geladen

In der Überschrift steht schon PHP, also müssen wir es auch verwenden Denn das ganze kann man natürlich schön in einer PHP-Funktion packen. Das sieht dann so aus:

<?PHP
  function getGravatarUrl($mail,$size,$default){
    return  "http://www.gravatar.com/avatar/".md5($mail).".jpg?s=".$size."&d=".urlencode($default);
  }
?>

Und das ist der Aufruf:

<?PHP
  echo "<img src=\"".getGravatarUrl("info@stevieswebsite.de",100,"monsterid")."\" />";
?>

Wenn ihr wollt, kann ich bald mal ein paar neue Beiträge über OOP in PHP schreiben. Wie ihr im Quiz sehen werdet, gibt es dort sehr viele interessante Sachen. Sagt einfach, wo ihr Probleme habt

Viel Erfolg!

YouTube API

Die YouTube API baut hauptsächlich auf Feeds aus. Wir werden uns heute darum kümmern, ein Video mithilfe von PHP über die API zu finden.

Damit wir diese auch später verwenden können bauen wir eine schöne Funktion damit. Darin können wir natürlich den Suchbegriff eingeben. Weitere Parameter sind die Sortierung, der Start-Index und die Anzahl der Elemente.

Bedingung dafür, dass das ganze Funktioniert ist, dass man vom Webspace externe Dateien laden kann. Dieses ist aus Sicherheitsgründen bei manchen Webspace-Anbietern (standardmäßig) ausgeschaltet. Ich hab das ganze auf meinem Testsystem gemacht (deswegen kann ich euch auch keine Testseite zur Verfügung stellen).

Über simplexml_load_file laden wir uns das Feed (was wie wir wissen aus XML besteht) . Danach suchen wir uns da die videos raus und geben sie zurück. Das sieht dann so aus:

<?php
  function getYouTubeVideos($search,$orderby,$start,$count){
    $search = urlencode($search);
    $orderby = urlencode($orderby);
    $xml = simplexml_load_file('http://gdata.youtube.com/feeds/api/videos?q='.$search.'&orderby='.$orderby.'&start-index='.$start.'&max-results='.$count.'&v=2');
    foreach($xml->entry as $video){
      $res[] = $video;
    }
    return $res;
  }
?>

Die einzelnen Videos bauen noch auf XML auf, so dass man dort die passenden Einträge auslesen muss. Am besten sieht man den Aufbau, wenn man folgende Schleife macht:

<?php
foreach(getYouTubeVideos("Video","published",1,10) as $video){
  print_r($video);
}
?>

Die wichtigsten Einträge sind wohl der Titel und der Link zu YouTube. Ich habe außerdem noch den Autor, das Veröfftlichs- und Änderungsdatum ausgelesen. Das sieht dann so aus:

<?PHP
  foreach(getYouTubeVideos("Video","published",1,10) as $video){
    ?>
    <h2>
      <a href="<?PHP echo $video->link['href']; ?>">
        <?PHP echo $video->title; ?>
      </a>
    </h2>
    <p>Ver&ouml;ffentlicht: 
      <?PHP echo $video->published; ?>
    </p>
    <p>Ge&auml;ndert: 
      <?PHP echo $video->updated; ?>
    </p>
    <p>Autor: 
      <?PHP echo $video->author->name; ?>
    </p>
    <?PHP
  }
?>

Verwandte Themen in anderen Blogs

• Import von YouTube Favoriten per PHP API (phpjunkie.de)
• YouTube API, Teil 1: Einführung in die YouTube API für Flash (video-flash.de)
• YouTube Api mit PHP (seo24.at)
• Youtube API (ecw.de)
• Youtube API Python Beispiel (codecocktail.wordpress.com)

Als kleines Beispiel erstellen wir nun ein Script, in welchen eine Funktion ist, die uns einfach nur das übergebene Argument ausgibt. Wurde nichts (false) oder ein Leerstring übergeben, werfen wir eine Exception und geben sie aus:

<?php
  function echoString($input){
    if (!$input or $input == "") {
      throw new Exception('Es wurde kein Element übergeben!');
    }
    else{
      echo $input."<br />";
    }
  }

  try{
    echoString("Das wird noch ausgegeben");
    echoString("");
  }
  catch (Exception $ex){
    echo "<strong>Fehler</strong>: ",  $ex->getMessage()."<br />";
  }

  echo "Das wird wieder ausgegeben";
?>

Das ganze erzeugt folgende Ausgabe:

Das wird noch ausgegeben
Fehler: Es wurde kein Element übergeben!
Das wird wieder ausgegeben

Mit Throws new Exception wirft man eine Exception. Als Parameter wird die Fehlerbeschreibung übergeben. Wenn die Funktion in einem Try-Carch Block abgerufen wird, wird beim Fehler ins Catch gesprungen. Hier ist in $ex der Fehler gespeichert. Mit getMessage kann man die Meldung auslesen.

Meiner Meinung nach sind exceptions besser als die. Denn hier kann man bei einem Fehler direkt darauf reagieren. Man könnte so zum Beispiel die Fehlermeldung direkt per Mail an den Admin schicken. Beim die bricht das ganze sofort ab.

Dieses Tutorial ist nun mein Gastartikel auf Blogprojekt.de.

Ich werde demnächst evtl. auch noch ein weiteres Tutorial zur WordPress Plugin Entwicklung erstellen, worüber genau, muss ich mir allerdings noch ausdenken.

Zum Tutorial auf Blogprojekt.de

In der ersten Zeile ist meistens der Header. Jede Spalte ist getrennt von einem Semikolon.

In den weiteren Zeilen stehen dann wiederum die Daten, auch mit einem Semikolon getrennt.

Heute hab ich vor mit euch zu zeigen, wie man eine Klasse in PHP erstellt, um die Daten der Datei als Array auszulesen.

Dazu erstellen wir als erstes Mal die CSV-Datei. Ich habe dort mal drei Spalten und drei Zeilen angelegt. Die Datei wird passend zum Testen test.csv genannt:

ID;Alias;Titel
1;testseite;Titel
2;testseite;Titel 2
3;testseite;Titel 3

Nun kommen wir zum PHP Bereich. Dort haben wir 2 Dateien. Eine ist die Klasse selbst und in einer anderen geben wir die Daten zum Testen in einer HTML-Tabelle aus. Fangen wir mal mit der eigentlichen Klasse an. Die Datei davon heißt Csv2Array.php.

Sie hat die folgenden Eigenschaften:

• $file: Gibt den Pfad der CSV-Datei an. (public)
• $header: Gibt die Namen der Spalten wieder. (pubilc)
• $lines: Speichert die Zeilen der CSV-Datei (private)
• $position: Speichert die aktuelle Zeilenposition (private)

Außerdem gibt es noch die folgenden Methoden:

• __construct: Konstruktor für die Datei. Diese liest die Zeilen aus und bestimmt den Header und setzt die Position auf 1. (public)
• readHeader: Diese Zeil speichert den Header in die $header Variable. (private)
• getNextRow: Die Funktion liefert die nächste Zeile der CSV Datei zurück (public)
• readLines: Speichert die Zeilen in $lines. (private)

Fangen wir mal mit dem puren Grundgerüst an:

<?PHP
class Csv2Array{
  public $file;
  public $header;
  private $lines;
  private $position;

  function __construct($file){
  }

  private function readHeader(){
  }

  public function getNextRow(){
  }

  private function readLines(){
  }
}
?>

Weiter geht’s mit der __construct Methode. Für alle die nicht wissen, was das ist: Diese Methode wird immer aufgerufen, wenn ein neues Objekt der Klasse erstellt wird. In der Methode wird das $file und die $position gespeichert und 2 Methoden aufgerufen:

  function __construct($file){
    $this->file = $file;
    $this->readLines();
    $this->readHeader();
    $this->position = 1;
  }

Weiter geht’s mit der internen Methode readLines. Sie liest ganz simpel die Zeilen mit der file Funktion aus:

  if($handle = fopen($this->file, "r")){
      $this->lines=file($this->file);
      return true;
    }
    else{
      return false;
    }

Nun kommen wir zum Header. Hier muss die erste Zeile mit einem Semikolon gesplittet werden:

  private function readHeader(){
    $this->header = split(';',$this->lines[0]);
  }

Die schwierigste Methode von alles gibt die nächste Zeile zurück. Sie liefert das Array zurück, wenn eine Zeile vorhanden ist und false wenn nicht. So können wir das ganze später in einer While-Schleife durchlaufen. Ist die Zeile vorhanden, wird wie beim Header wieder die Zeile gesplittet.

Nun müssen wir den Header durchlaufen und in die jeweilige Spalte den Wert eintragen. Danach müssen wir noch die Zeilenposition hochsetzen und das Array zurückgeben:

  public function getNextRow(){
    if($this->lines[$this->position]){
      $line = split(';',$this->lines[$this->position]);
      $columnposition = 0;
      foreach($this->header as $column){
        $res[$column] = $line[$columnposition];
        $columnposition++; 
      }
      $this->position++;
    }
    return $res;
  }

Die Klasse an sich ist soweit fertig. Nun muss ich euch noch davon überzeugen, dass sie auch funktioniert Dazu hab ich die Datei Csv2Array.test.php erstellt. Hier wird die test.csv von oben ausgelesen und in einer Tabelle ausgegeben. Auf das HTML Grundgerüst hab ich heut mal verzichtet^^:

<?PHP
  include('Csv2Array.php');
  $csv2array = new Csv2Array("test.csv");
?>
<table>
  <thead>
    <tr>
      <?PHP
        foreach($csv2array->header as $column){
          echo "<td>".$column."</td>";
        }
      ?>
    </tr>
  </thead>
  <tbody>
    <?PHP
      while($row = $csv2array->getNextRow()){
        echo "<tr>";
          foreach($row as $column){ 
            echo "<td>".$column."</td>";
          }
        echo "</tr>";
      }
    ?>
  </tbody>
</table>

Und das gibts dann zurück:

PHP Rechtschreibprüfung

Mit diesem PHP-Script könnt Ihr ganz einfach die Rechtschreibung eurer Texte in PHP prüfen lassen. Dort habe ich ein schönes Script gefunden, was allerdings nur in Englisch verfügbar war (Script + Sprachdatei). Nach ein bisschen Übersetzungarbeit und Recherche der Sprachdatei kann ich euch nun ein Rechtschreibprüfung Tool bieten, was auch deutsche Texte verbessert.

Fangen wir an mit den Sprachdateien. Diese braucht ihr, um die Wörter der jeweiligen Sprache zu kennen. Ich habe nach einigem suchen eine Seite gefunden, welche diese anbietet: http://www.javascriptspellcheck.com/downloads.asp.

In dem Script gibt es die Klasse dictionary_class, in welcher die Überprüfung stattfindet. Diese müsste man am besten nach seinen Wünschen anpassen, da sie die Vorschläge nur als Text zurückgibt. Besser wäre es, wenn man ein Array mit den Vorschlägen bekommt.

Außerdem gibt es noch zwei weitere Seiten, bei der einen gibt man den Text an, und die Andere ruft die Methoden der Übersetzungsklasse auf. Aber ich denke, man muss das ganze immer so anpassen, wie man es gerade braucht.

Hier geht’s zur Beispielseite:  http://temp.stevieswebsite.de/spellcheck.htm

Und hier ist der Download: http://stevieswebsite.de/temp/SpellCheck.zip

Wie ihr evtl. mitbekommen habt, läuft das Script sehr langsam. Wer auf seinem Server pspell hat, sollte besser das benutzen.

Verwandte Themen

• Spell Checker with the Google Web API (webdesign.org,en)
• Aspell & pspell: Rechtschreibung mit PHP prüfen (codegefluester.de)
• Spell Check Rex – MySQL+PHP basierte Rechtschreibprüfung für Websites (tagdocs.de)

Optimierung durch Caching

PEAR Cache_Lite ist ein leicht zu benutzendes Cache-System. Unter einem Cache versteht man, die Zwischenspeicherung von Daten. Wenn man zum Beispiel seine Navigation dynamisch in der Datenbank aufbaut, müssen bei jedem Aufruf alle Links ausgelesen, sortiert und ausgegeben werden. Dort kann man Geschwindigkeit sparen, in den man sie z.B. einmal pro Tag ausliest und zwischenspeichert. Das hat den Vorteil, dass man nicht jeden einzelnen Eintrag auslesen muss, sondern einfach den Inhalt aus dem Cache. Das ist um einiges schneller.

Als Beispiel werde ich eine kleine HTML-Seite generieren. Wenn diese nicht im Cache vorhanden ist, wird sie in den Cache geladen. Danach wird sie ausegeben. In diesem Falle macht ein Cache zwar nicht wirklich Sinn, aber es soll ja auch nur veranschaulichen wie es geht. Um zu sehen, dass es wirklich zwischengespeichert wird, baue ich die Uhrzeit mit ein. Diese sollte dann, solange die Seite im Cache ist, immer gleich bleiben:

<?PHP
require_once('pear/PEAR/Cache/Lite.php');

$parameter = array('cacheDir' => 'cache/',
                   'lifeTime' => 10000, 
                   'pearErrorMode' =>CACHE_LITE_ERROR_DIE);
$Cache_Lite = new Cache_Lite($parameter);

if(!$seite = $Cache_Lite->get(1)){
  $seite = "<html>
              <body>
                <p>Uhrzeit: ".date("H:i:s")."</p>
              </body>
            </html>";
  $Cache_Lite->Save($seite,1);
}
echo $seite;

?>

Als Konstruktor bekommt Cache_Lite ein Array von Parametern(hier $parameter). Hier kann  mit cacheDir das Verzeichnis angegeben werden, in dem die gecachten Daten gespeichert werden sollen. LifeTime gibt die Anzahl in Sekunden an, wie lange die Seite gültig ist. Ist sie ungültig, wird sie neu hereingeladen. So kann man aktuelle Daten zeigen, aber trotzdem an Performance gewinnen, da diese eben nur einmal in X Sekunden ausgelesen werden. PearErrorMode gibt noch an, in welchen Modus Fehler behandelt werden sollen. In diesem Fall, wird wie bei den normalen PHP-Syntax-Fehlern die Fehlermeldung ausgegeben und die Ausführung der Skripts abgebrochen.

Mit der Methode get, kann man die Daten auslesen. Sind sie nicht vorhanden, gibt die Zuwesieund false aus. Als Parameter muss hier eine id angegebn werden, unter welcher die Daten gespeichert sind.

Mit dem Befehl save werden logischerweise die Daten gespeichert. Im ersten Parameter muss der Inhalt angegeben werden und im zweiten wie auch bei get die id.

Da wir hier den Inhalt in der Seite gespeichert haben, kann man diese nun einfach ausgeben. Wie Du sehen wirst, ist beim zweiten Aufruf die gleiche Uhrzeit wie beim ersten.

Die Abbildung oben stammt von  Mike Nottebrock auf Pixelio.de

Verwandte Themen

• Using PEAR Cache_Lite (sweeting.org, en)
• PEAR::Cache_lite – speed, simplicity, security (kalexandr.com, en)
• Speedup your website with Cache_Lite (kevin.vanzonneveld.net, en)
• Caching navigation with PEAR::Cache_Lite (nettiapina.fi, en)
• Quick and Dirty PHP Caching (snipe.net, en)