README

这是一个简单的 PHP5 类，它使您能够在 PHP5 应用程序中使用 Akismet 反垃圾邮件服务。

下载

查看 git 仓库

git clone git@github.com:achingbrain/php5-akismet.git

安装

一旦您已克隆了仓库（见上面的“下载”），将 src/main/php/net/achingbrain/Akismet.class.php 文件复制到您的脚本可访问的位置。使用 include 或其变体将其导入到脚本中。

或者，如果您正在运行 PHP 5.3 以上的版本，可以获取 phar 文件，并使用以下代码

<?php
	include 'phar:///path/to/php5-akismet-0.5.phar/net/achingbrain/Akismet.class.php';
?>

文档

查看 PHPDocs。

用法

在您可以使用 Akismet 之前，您需要一个 WordPress API 密钥（它们是免费的，获取一个大约需要五分钟）。一旦您有了，请查看下面的代码

$WordPressAPIKey = 'aoeu1aoue';
$MyBlogURL = 'http://www.example.com/blog/';

$akismet = new Akismet($MyBlogURL ,$WordPressAPIKey);
$akismet->setCommentAuthor($name);
$akismet->setCommentAuthorEmail($email);
$akismet->setCommentAuthorURL($url);
$akismet->setCommentContent($comment);
$akismet->setPermalink('http://www.example.com/blog/alex/someurl/');

if($akismet->isCommentSpam())
  // store the comment but mark it as spam (in case of a mis-diagnosis)
else
  // store the comment normally

就是这样。如果过滤器错误地标记了消息，您可以在以后创建一个新的对象，并从您的数据库中填充它，必要时覆盖字段，然后使用以下两个方法来训练它

$akismet->submitSpam();

和

$akismet->submitHam();

提交误诊的垃圾邮件和正常邮件，这可以提高每个人的系统。请参阅包含的文档，以了解所有可用方法的完整说明。

变更日志

版本 0.5

已部署到 GitHub 而不是 achingbrain.net，以在未来更好地协作
将项目转换为使用 Maven 进行单元测试和文档生成
单元测试 & 文档
允许在提交垃圾邮件/正常邮件时覆盖用户代理（感谢 Steven）

版本 0.4

性能 – 将 HTTP 版本从 1.1 更改为 1.0（感谢 Jan De Poorter）。
性能 – 不会在每次实例化时发出单独的 HTTP 请求来检查 API 密钥的有效性。
添加了一个新的公共方法 'isKeyValid'，以手动检查传递给构造函数的 API 密钥的有效性。
现在，如果 API 密钥无效，则 'isCommentSpam' 方法（而不是构造函数）将抛出异常。
稍微整理了内部结构。

版本 0.3

内部测试版本

版本 0.2

初始发布

版本 0.1