我怎样才能让 restler 接受一个方法的多个路由，但只记录其中一个？

Question

我正在修复 API，我想弃用一些旧路由。我基本上是在四处移动端点，但想鼓励新消费者使用新路线。但是，在此过渡期间，我需要在短时间内支持旧路由。下面是我想要的东西的一个例子。我希望新的 url 被记录下来，而旧的被标记为已弃用或完全从文档中删除。有没有一种简单的方法可以做到这一点，还是我在过渡过程中卡住了？

/**
 * Adds a new Item
 *
 * This creates a new item
 *
 * @url POST /:id/patch  {@deprecated}
 * @url PATCH /:id 
 */

Answer 1

将弃用的路由移动到一个新方法，该方法在内部调用旧方法以实现功能，如果需要，在 HTML 的帮助下通过描述将其标记为已弃用。这是一个例子

/**
 * Adds a new Item
 *
 * This creates a new item
 *
 * @url PATCH /{id}
 */
function patchItem($id)
{
    //actual process here
}


/**
 * Adds a new Item [DEPRECATED]
 *
 * This creates a new item
 *
 * @url POST /{id}/patch
 */
function deprecatedPatchItem($id)
{
    return $this->patchItem($id);
}

一旦您决定删除已弃用的方法，只需删除新方法

我怎样才能让 restler 接受一个方法的多个路由，但只记录其中一个？

How can I get restler to accept multiple routes to a method, but only document one of them?

php

restler