zfr/zfr-rest

Zend Framework 2 REST 模块。

v0.5.0 2016-03-11 13:27 UTC

This package is auto-updated.

Last update: 2024-09-07 02:32:46 UTC


README

Build Status Scrutinizer Quality Score Latest Stable Version Total Downloads Dependency Status

安装

通过输入以下命令安装模块(或将它添加到你的 composer.json 文件中)

php composer.phar require zfr/zfr-rest:0.5.*

然后,将 "ZfrRest" 添加到你的 application.config.php 文件中的模块列表,并将文件 zfr_rest.global.php.dist 复制粘贴到你的 autoload 文件夹(不要忘记删除末尾的 .dist 扩展名!)。

ZfrRest 0.4+ 与 ZfrRest 0.3 的比较

从版本 0.4 开始,ZfrRest 已经完全重写。之前,ZfrRest 会为你自动完成很多事情,从渲染到自动路由和创建路由。虽然这对非常简单的用例来说很好,但实际上很难扩展,引入了很多性能问题,并且非常不灵活。

现在,ZfrRest 更像是一个 "小型 REST 工具"。它提供了一个简单的方式来处理 HTTP 异常,一个轻量级的控制器,可以处理操作和 HTTP 动词,以及一个适用于资源渲染的视图层(可以选择使用版本控制来根据版本渲染资源)。你可以将 ZfrRest 视为一个模块,如果你想要创建一个 REST API,而不是像 Apigility 或之前 ZfrRest 版本那样的完整模块。

此外,对 Doctrine 的依赖已完全删除,任何人都可以使用。

ZfrRest 与 Apigility 的比较

Apigility 是一个 Zend Framework 2 API 构建器,也旨在简化 REST API 的创建。

从 ZfrRest 0.4+ 开始,这两个库之间实际上没有任何共同点。Apigility 是一个功能齐全的模块,可以做很多事情,从头信息协商,自动渲染,链接生成,代码生成器...另一方面,ZfrRest 是裸机,将大部分责任和权力留给了你。

文档

官方文档可在 /docs 文件夹中找到。