ZF Zend Framework

Zend_Service_Akismet bietet einen Client für die Akismet API. Der Akismet Service wird verwendet um herauszufinden ob hereinkommende Daten potentieller Spam sind; Er bietet auch Methoden für das Übertragen von Daten als bekannter Spam oder als falsch Positiv (ham). Original dazu gedacht um für Wordpress zu kategorisieren und Spam zu identifizieren, kann es für alle Arten von Daten verwendet werden.

Akismet benötigt einen API Schlüssel um verwendet zu werden. Kan kann einen bekommen indem man sich für einen WordPress.com Zugang einschreibt. Man muß keinen Blog aktivieren; nur das Erstellen des Accounts reicht um den API Schlüssel zu erhalten.

Zusätzlich erfordert Akismet das alle Anfragen eine URL zu der Ressource enthalten für die die Daten gefiltert werden und, weil Akismeth's Ursprung Wordpress ist, wird diese Ressource die Blog URL genannt. Dieser Wert sollte als zweites Argument an den Konstruktor übergeben werden; aber er kann zu jeder Zeit resetiert werden in dem der setBlogUrl() Accessor verwendet wird, oder überschrieben durch die Spezifizierung eines 'blog' Schlüssels in den verschiedenen Methodenaufrufen.

Zend_Service_Akismet::verifyKey($key) wird verwendet um zu prüfen ob ein Akismet API Schlüssel gültig ist. In den meisten Fällen, besteht keine Notwendigkeit ihn zu prüfen, aber wenn eine Qualitätssicherung durchgeführt werden soll, oder eruiert werden soll ob ein neuerer erhaltener Schlüssel aktiv ist, kann das mit dieser Methode gemacht werden.

// Instanzieren mit dem API Schlüssel und einer URL zur Anwendung oder
// Ressource die verwendet wird
$akismet = new Zend_Service_Akismet($apiKey,
                                    'http://framework.zend.com/wiki/');
if ($akismet->verifyKey($apiKey) {
    echo "Schlüssel ist gültig.\n";
} else {
    echo "Schlüssel ist ungültig\n";
}

Wenn verifyKey() ohne Argumente aufgerufen wird, verwendet es den API Schlüssel der im Konstruktor angegeben wurde.

verifyKey() implementiert Akismet's verify-key REST Methode.

Zend_Service_Akismet::isSpam($data) wird verwendet um zu prüfen ob die übergebenen Daten von Akismet als Spam erkannt werden. Es wird ein assoziatives Array als Basisargument akzeptiert. Das Array erfordert das die folgenden Schlüssel gesetzt werden:

Die folgenden Schlüssel werden im speziellen auch von der API erkannt:

Es können auch beliebige andere Umgebungsvariablen übermittelt werden von denen angenommen wird, das Sie bei er Ermittlung helfen ob Daten Spam sind. Akismet empfiehlt den Inhalt des kompletten $_SERVER Arrays.

Die isSpam() gibt true oder false zurück, und wirft eine Ausnahme wenn der API Schlüssel nicht gültig ist.

$data = array(
    'user_ip'              => '111.222.111.222',
    'user_agent'           => 'Mozilla/5.0 (Windows; U; Windows NT ' .
                              '5.2; en-GB; rv:1.8.1) Gecko/20061010 ' .
                              'Firefox/2.0',
    'comment_type'         => 'contact',
    'comment_author'       => 'John Doe',
    'comment_author_email' => 'nospam@myhaus.net',
    'comment_content'      => "Ich bin kein Spammer, ehrlich!"
);
if ($akismet->isSpam($data)) {
    echo "Sorry, aber wir denken das Du ein Spammer bist.";
} else {
    echo "Willkommen auf unserer Seite!";
}

isSpam() implementiert die comment-check Methode der Akismet API.

Gelegentlich werden Spam Daten durch den Filter kommen. Wenn in der Begutachtung der hereinkommenden Daten Spam erkannt wird, und man das Gefühl hat das er gefunden werden sollte, kann er an Akismet übertragen werden um deren Filter zu verbessern.

Zend_Service_Akismet::submitSpam() nimmt das selbe Datenarray entgegen wie es der isSpam() übergeben wird, aber es wird kein Wert zurückgegeben. Eine Ausnahme wird geworfen wenn der API Schlüsel ungültig ist.

$data = array(
    'user_ip'              => '111.222.111.222',
    'user_agent'           => 'Mozilla/5.0 (Windows; U; Windows NT 5.2;' .
                              'en-GB; rv:1.8.1) Gecko/20061010 Firefox/2.0',
    'comment_type'         => 'contact',
    'comment_author'       => 'John Doe',
    'comment_author_email' => 'nospam@myhaus.net',
    'comment_content'      => "Ich bin kein Spammer, ehrlich!"
);
$akismet->submitSpam($data));

submitSpam() implementiert die submit-spam Methode der Akismet API.

Gelegentlich werden Daten fehlerhafterweise von Akismet als Spam erkannt. Für diesen Fall, sollte ein Log aller Daten behalten werden, indem alle Daten die von Akismet als Spam erkannt, geloggt werden und dieses von Zeit zu Zeit durchgesehen. Wenn solche Fülle gefunden werden, können die Daten an Akismet als "Ham", oder falsche Positive übermittelt werden (Ham ist gut, Spam ist schlecht)

Zend_Service_Akismet::submitHam() nimmt das selbe Datenarray entgegen wie isSpam() oder submitSpam(), und wie bei submitSpam() wird kein Wert zurückgegeben. Eine Ausnahme wird geworfen wenn der verwendete API Schlüssel ungültig ist.

$data = array(
    'user_ip'              => '111.222.111.222',
    'user_agent'           => 'Mozilla/5.0 (Windows; U; Windows NT 5.2;' .
                              'en-GB; rv:1.8.1) Gecko/20061010 Firefox/2.0',
    'comment_type'         => 'contact',
    'comment_author'       => 'John Doe',
    'comment_author_email' => 'nospam@myhaus.net',
    'comment_content'      => "I'm not a spammer, honest!"
);
$akismet->submitHam($data));

submitHam() implementiert die submit-ham Methode der Akismet API.

Wärend die Akismet API nur vier Methoden spezifiziert, hat Zend_Service_Akismet verschiedene zusätzliche Helfer die für die Modifikation von internen Eigenschaften verwendet werden können.