• [转]拙议REST及其在PHP中的现状


    本文并不想从头介绍REST,只是想举例说明在HTTP中使用REST需要注意的问题:

    先来看看人们对REST的困惑

    REST长啥样?

    最一般的REST例子,类似下面的样子:

    POST   /articles     创建
    DELETE /articles/123 删除
    PUT    /articles/123 更新或创建
    GET    /articles/123 查看

    顺便说说几个知识点:

    GET操作是安全的。所谓安全是指不管进行多少次操作,资源的状态都不会改变。比如我用GET浏览文章,不管浏览多少次,那篇文章还在那,没有变化。当 然,你可能说每浏览一次文章,文章的浏览数就加一,这不也改变了资源的状态么?这并不矛盾,因为这个改变不是GET操作引起的,而是用户自己设定的服务端 逻辑造成的。

    PUT,DELETE操作是幂等的。所谓幂等是指不管进行多少次操作,结果都一样。比如我用PUT修改一篇文章,然后在做同样的操作,每次操作后的结果并没有不同,DELETE也是一样。顺便说一句,因为GET操作是安全的,所以它自然也是幂等的。

    POST操作既不是安全的,也不是幂等的,比如常见的POST重复加载问题:当我们多次发出同样的POST请求后,其结果是创建出了若干的资源。

    安全和幂等的意义在于:当操作没有达到预期的目标时,我们可以不停的重试,而不会对资源产生副作用。从这个意义上说,POST操作往往是有害的,但很多时候我们还是不得不使用它。

    还有一点需要注意的就是,创建操作可以使用POST,也可以使用PUT,区别在于POST是作用在一个集合资源之上的(/articles),而PUT操 作是作用在一个具体资源之上的(/articles/123),再通俗点说,如果URL可以在客户端确定,那么就使用PUT,如果是在服务端确定,那么就 使用POST,比如说很多资源使用数据库自增主键作为标识信息,而创建的资源的标识信息到底是什么只能由服务端提供,这个时候就必须使用POST。

    浏览器不支持PUT/DELETE方法怎么办?

    大部分浏览器只支持GET/POST方法,这使得我们无法完美的实现REST。对于这样的情况,大致有几种解决方法,一种是在表单里加入一个 _method之类名字的隐藏字段,用于表示真正的方法,另一种是使用X-HTTP-METHOD-OVERRIDE头信息来重载POST。

    HTTP方法够用么?

    从上面的例子,我们可以看到,通过使用已有的HTTP方法:POST,DELETE,PUT,GET就可以完成资源的增删改查,但在实际情况中,我们需要 做的操作往往并不仅仅局限在简单的增删改查操作中,比如说我们要把一篇文章“置顶”,但是HTTP方法里没有一个和“置顶”操作相对应的方法,这时候该怎 么办呢?REST对类似问题的解决方案是:创建一个新的资源!在上面的例子里,我们可以这样:

    PUT /top_articles/123

    通过创建出一个新的资源(top_articles),我们就可以使用简单的HTTP方法通吃一切操作了。

    如何设计资源的URL?

    最常见的资源命名方式是/controllers/id,不过这不是必须的,REST并没有强制规定URL必须符合哪种形式,你大可以按照自己的设想去自由的设计,实际编程时大致有两种方法:

    一种是基于路径变量的命名,如:/china/beijing/laowang

    基于路径变量的命名方式一般用来描述具有层次化的结构的资源。

    另一种是基于查询变量的命名,如:/person?name=laowang

    基于查询变量的命名方式一般用来描述某种算法的计算结果。

    到底是使用基于路径的命名方式,还是基于查询的命名方式,取决于你看问题的角度和个人的喜好。

    REST反对使用Session么?

    REST拒绝Session!这是因为REST强调无状态性。这里的状态指的的应用状态,也可以称之为会话状态。一旦在服务端保持了这样的状态,那么架构的可扩展性将大打折扣。在REST看来,任何类似的状态本身都应该是一个独立的资源。

    但也有人认为,现在可以很方便的把session存储在memcached之类的分布式缓存中,所以不是问题。

    Cookie对REST有害么?

    一分为二的看,如果Cookie里保存的是应用状态的话,就没有问题。因为应用状态本来就属于客户端。但如果使用Cookie保存类似PHPSESSIONID之类的东西就不对了,因为这样的数据并不属于客户端状态,它只不过是使用Session的借口而已。

    再来看看REST在PHP中的现状

    PHP里的REST实现案例不多,有点影响都就是CakePHP和Zend,下面分别看看他们的实现:

    CakePHP:

    设定路由:

    Router::parseExtensions('xml');
    Router::mapResources('articles');

    编写控制器:

    class ArticlesController extends AppController {

    var $components = array('RequestHandler');

    function view($id = null) {
    $article = $this->Article->findById($id);
    $this->set(compact('article'));
    }

    // ...
    }

    视图:

    <articles>
    <?php echo $xml->serialize($article); ?>
    </articles>

    差不多就这样了,相应的,还可以实现其他的功能,于是,如下REST操作便成为可能:

    POST   /articles
    DELETE /articles/123.xml
    PUT    /articles/123.xml
    GET    /articles/123.xml

    总体看,CakePHP的REST实现基本上是按Rails风格来实现的,大体还过得去。

    参考链接:

    http://book.cakephp.org/view/476/rest
    http://c7y.phparch.com/c/entry/1/art,cakephp-rest

    ZendFramework:

    ZendFramework通过Zend_Rest组件来实现Rest功能:

    服务端:

    require_once 'Zend/Rest/Server.php';

    function sayHello($who, $when)
    {
    return "Hello $who, Good $when";
    }

    $server = new Zend_Rest_Server();
    $server->addFunction('sayHello');
    $server->handle();

    客户端:

    require_once 'Zend/Rest/Client.php';

    $client = new Zend_Rest_Client('http://path/to/server/script');
    $client->sayHello('Davey', 'Day');

    echo $client->get();

    这时候,我们看一下Web服务器的日志,会发现生成了一条如下的记录:

    GET /path/to/servier/script?method=sayHello&arg0=Davey&arg1=Day&rest=1 HTTP/1.1

    我们发现,实际操作方法是由URL中的method=sayHello指定的,而HTTP固有方法(GET/POST等)则成为了摆设,这是典型的RPC 风格,如果大家对比Zend_Rest和Zend_XmlRpc文档的话,会明显发现它们根本就是一个东西,所以说,Zend_Rest是一个REST伪 实现。

    参考链接:

    http://framework.zend.com/manual/en/zend.rest.html
    http://framework.zend.com/manual/en/zend.xmlrpc.html

    =============================

    此外,还有几篇不错的文章:

    http://www.berenddeboer.net/rest/
    http://www.ibm.com/developerworks/webservices/library/ws-restful/
    http://www.infoq.com/cn/articles/rest-architecure
    http://www.infoq.com/cn/articles/rest-introduction
    http://www.infoq.com/cn/articles/rest-anti-patterns
    http://www.infoq.com/cn/articles/webber-rest-workflow
    http://www.infoq.com/cn/articles/tilkov-rest-doubts
    http://www.infoq.com/cn/articles/designing-restful-http-apps-roth
    http://www.infoq.com/cn/articles/roa-rest-of-rest
    本文来源:http://www.cnblogs.com/x3d/,转载请注明。
  • 相关阅读:
    内置系统账户:Local system/Network service/Local Service 区别
    python-基于文件导入的特性的单例模式
    php原因 nginx报错[error] 10773#0: *272212065 recv() failed (104: Connection reset by peer) while reading response header from upstream
    实用Django ORM实用操作方法
    session是什么和cookie的区别?
    Python可迭代对象,迭代器,生成器
    浅析python中的GIL锁和协程
    git 常用
    testlink安装
    redmine搭建
  • 原文地址:https://www.cnblogs.com/x3d/p/2566315.html
Copyright © 2020-2023  润新知