GITHUB：https://github.com/jacwright/RestServer
简介：
一个PHP REST服务器，用于提供非常轻量级的REST API。很容易上手。独立于其他库和框架。支持HTTP身份验证。
参考Zend Framework，该框架省略了Zend Framework MVC附带的大量类。还有一些有用的功能要添加（例如XML支持）。
RestServer到目前为止，该框架的解决方案是一个JSON REST服务器。添加对XML或其他格式的支持应该是微不足道的，但是必须假设您的对象在XML中的样子（XML-RPC样式，您自己的自定义XML格式等）。
首先，我们将查看您编写的用于处理请求的类，然后我们将查看如何在index.php文件中将它们绑定在一起。
使用教程：
从URL到类方法获取请求的映射都在类的doc-comments中。以下是处理某些用户操作的类的示例：
<?php use \Jacwright\RestServer\RestException; class TestController
{
/**
* Returns a JSON string object to the browser when hitting the root of the domain
*
* @url GET /
*/
public function test()
{
return "Hello World";
} /**
* Logs in a user with the given username and password POSTed. Though true
* REST doesn't believe in sessions, it is often desirable for an AJAX server.
*
* @url POST /login
*/
public function login()
{
$username = $_POST['username'];
$password = $_POST['password']; //@todo remove since it is not needed anywhere
return array("success" => "Logged in " . $username);
} /**
* Gets the user by id or current user
*
* @url GET /users/$id
* @url GET /users/current
*/
public function getUser($id = null)
{
// if ($id) {
// $user = User::load($id); // possible user loading method
// } else {
// $user = $_SESSION['user'];
// } return array("id" => $id, "name" => null); // serializes object into JSON
} /**
* Saves a user to the database
*
* @url POST /users
* @url PUT /users/$id
*/
public function saveUser($id = null, $data)
{
// ... validate $data properties such as $data->username, $data->firstName, etc.
// $data->id = $id;
// $user = User::saveUser($data); // saving the user to the database
$user = array("id" => $id, "name" => null);
return $user; // returning the updated or newly created user object
} /**
* Gets user list
*
* @url GET /users
*/
public function listUsers($query)
{
$users = array('Andra Combes', 'Valerie Shirkey', 'Manda Douse', 'Nobuko Fisch', 'Roger Hevey');
if (isset($query['search'])) {
$users = preg_grep("/{$query[search]}/i", $users);
}
return $users; // serializes object into JSON
} /**
* Get Charts
*
* @url GET /charts
* @url GET /charts/$id
* @url GET /charts/$id/$date
* @url GET /charts/$id/$date/$interval/
* @url GET /charts/$id/$date/$interval/$interval_months
*/
public function getCharts($id=null, $date=null, $interval = 30, $interval_months = 12)
{
echo "$id, $date, $interval, $interval_months";
} /**
* Throws an error
*
* @url GET /error
*/
public function throwError() {
throw new RestException(401, "Empty password not allowed");
}
}
让我们通过上面的TestController课程来讨论所展示的功能。首先我们来看看这个test方法。您会注意到docblock中有一种新的doc-comment标记。@url将URL映射到它下面的方法，格式如下：
@url <REQUEST_METHOD> <URL>
在这个特定的例子中，当某人在http://www.example.com/上进行GET时（假设example.com是我们的服务所在的位置），它将打印出来：
"Hello World"
这是JSON中字符串的有效表示。
继续下一个方法，login我们看到@url将任何POST映射到http://www.example.com/login到该login方法。从常规Web类型的POST获取数据与任何PHP应用程序相同，允许您将自己的验证或其他框架与此REST服务器结合使用。如果需要，也可以保留会话。虽然保持会话不是真正的REST风格，但我们通常只需要一个REST服务器来为我们的ajax应用程序提供数据，并且使用会话比使用RESTful更容易。
接下来我们有了我们的getUser方法（你会注意到我命名我的方法并不重要，因为我们的@url指令定义了哪些URL映射到方法）。你可以在这里看到几件事。首先，我们@url为此方法提供了多个映射。第二，/$id第一个URL映射有一个奇怪的地方。RestServer将任何:keyword占位符视为URL中的通配符，并将获取URL的该部分并将其传递给方法中具有相同名称的参数。在此示例中，当访问http://www.example.com/users/1234时，$id将等于1234.当访问http://www.example.com/users/current时，$id将等于null。您的参数的顺序无关紧要，只要它们与占位符（:id和$id，:username和$username）具有相同的名称即可。$id = null当您有多个不需要参数的URL映射时，您还需要确保将参数设置为optional（）。否则，您将抛出一个错误，告诉您没有传入必需的参数。
最后要注意的getUser是，此方法只返回一个User对象。这会被序列化为JSON（或可能是XML）并打印出来供应用程序使用。
接下来我们必须saveUser。你在这里看到我们再次有多个URL映射。这次他们还有不同的HTTP方法（POST和PUT）来创建和更新用户。这里的新东西是$data变量。这是一个特殊的关键字参数，它将包含POSTed或PUT到服务器的值。这与常规Web POST不同，它不需要只是名称 - 值对，但可以像JSON一样，发送复杂对象。例如，常规Web POST的主体，比如登录请求，可能如下所示：
username=bob&password=supersecretpassw0rd
但为我们的saveUser方法发布一个新的用户对象可能如下所示
{ “ username ”：“ bob ”，“ password ”：“ supersecretpassword ”，“ firstName ”：“ Bob ”，“ lastName ”：“ Smith ” }
因此，除了常规的Web样式POST之外，您还可以允许POSTING JSON。
最后我们得到listUsers方法。test方法简单。但$query参数是新的。此特殊参数可用于读取查询字符串。并将查询字符串参数保存为关联数组。例如，如果客户端使用url请求此API，/users?search=Manda则$query参数将保持[search => Manada]。
我称这些类来处理请求Controllers。并且它们可以通过URL映射，数据库配置等完全自包含，这样您就可以毫不费力地将它们放入其他RestServer服务中。
REST index.php
为了让整个服务器启动，你需要创建一个index.php文件，让你的URL重写直接请求（另一个你可以在其他地方学到的主题），然后创建RestServer并添加控制器类到它用于处理。RestServer将使用APC或文件缓存请求之间的URL映射以加速请求。如果使用自动加载和此缓存，则不必在每个请求上加载每个控制器文件，只需要请求所需的文件。缓存仅在生产模式下运行。这是一个示例index.php文件：
spl_autoload_register（）; //除非我们使用它们，否则不要加载我们的类 $ mode = ' debug ' ; // 'debug'或'production'
$ server = new RestServer（$ mode）;
// $ server-> refreshCache（）; //如果类在生产模式下更改，则暂时取消注释以清除缓存 $ server - > addClass（' TestController '）;
$ server - > addClass（' ProductsController '，' / products '）; //将此添加为此类中所有URL的基础 $ server - > handle（）;
而已。您可以根据需要添加任意数量的类。如果存在冲突，则稍后添加的类将覆盖先前添加的重复URL映射。addClass中的第二个参数可以是一个基本URL，它将作为给定类中URL映射的前缀，使您可以更加模块化。
您可以查看RestServer类，复制它并将其用于您自己的目的。它是在MIT许可下。要添加的功能包括XML支持和HTTP身份验证支持。如果您更好地完成此课程，请通过发表评论与大家分享您的更新。我将尝试使用新功能更新此类，因为它们是共享的。我希望你喜欢！
祝你好运，如果你最终使用它，请告诉我！
更新：我为可能需要它的人提供了一个示例.htaccess文件。它只会重写对不存在的文件的请求，因此您可以在webroot中拥有images，css或其他PHP文件，它们仍然有效。任何能给404的东西都会重定向到你的index.php文件。
DirectoryIndex index.php
<IfModule mod_rewrite.c>
RewriteEngine On
RewriteRule ^$ index.php [QSA,L]
RewriteCond %{REQUEST_FILENAME} !-f
RewriteCond %{REQUEST_FILENAME} !-d
RewriteRule ^(.*)$ index.php [QSA,L]
</IfModule>
认证
身份验证对每个应用程序都是唯 但是将身份验证机制绑定到RestServer很容易。只需添加一个名为所有请求的方法authorize，Controller就会先调用该方法。如果authorize()返回false，则服务器将发出401 Unauthorized响应。如果authorize()返回true，则请求继续调用正确的控制器操作。除非您添加@noAuth操作的文档（我通常将其置于@url映射之上），否则所有操作都将首先运行授权。
在您的身份验证方法中，您可以使用PHP的getallheaders功能或$_COOKIE根据您的用户授权方式。这是您从数据库加载用户对象的位置，并将其设置为$this->user = getUserFromDatabase()以便在以后调用时您的操作可以访问它。
RestServer是一种将应用程序映射到REST API的简单机制。其余细节由您决定。
跨域资源共享
出于安全原因，浏览器限制从脚本内发起的跨源HTTP或REST请求。因此，使用来自浏览器的REST API的Web应用程序只能向其自己的域发出API请求。RestServer通过在REST index.php文件中包含以下代码，可以将覆盖此限制配置为允许交叉请求请求。
/*
* 在$ server = new RestServer（$ mode）之后包含以下行;
* 或使用阵列中的多个起点的$服务器- > allowedOrigin = 阵列（ ' http://example.com '， ' https://example.com '）;
* 或通配符$ server - > allowedOrigin = ' * '
*/
$ server - > useCors = true ; $ server - > allowedOrigin = ' http://example.com ' ;
异常抛出错误处理
您可以通过在类中抛出一个例外来轻松地向API用户提供错误RestException。例
/ **
* 按id或当前用户获取用户
*
* @url GET / users / $ id
* @url GET / users / current
* /
public function getUser（ $ id = null） {
if（ $ id）{
$ user = User :: load（ $ id）; //可能的用户加载方法
if（！$ user）{
throw new RestException（404，' User not found '）;
}
} else {
$ user = $ _SESSION [ ' user ' ];
}
return $ user ; //将对象序列化为JSON
};
您可以控制REST服务处理错误的方式。您可以使用添加错误控制器$server->addErrorClass('ErrorController');。
此控制器可以定义命名的方法handle401或handle404添加您自己的自定义错误处理逻辑。