Restler 不需要必需的属性

Question

我有这个作为我的对象 class 和 API class。我可以在不发送 task_list_id 或 display_order 的情况下调用 post。只要我只是传递 title 它就在调用方法。

class BaseTaskObj
{   
  /// @var int    $task_list_id   The SQL ident of the Task List to use for the Task. {@min 1}{@required true}
  public $task_list_id;
}

class PostTaskObj extends BaseTaskObj
{
  /// @var int    $assigned_id    The SQL ident of the Person who this task is assigned to {@min 1}{@required false}
  public $assigned_id;
}

class MyTaskAPI {
  /**
   * Creates a new Task associated with an existing task list.
   *
   * @param PostTaskObj $info The details of the Task object to create. {@required title, display_order}
   *
   * @status 201
   *
   * @return int The SQL ident of the newly created Task
   */
   function post(PostTaskObj $info) {
   }  
}

Answer 1

task_list_id 和 assigned_id 目前没有有效的 phpdoc 注释。它们也没有任何赋值。这使它们成为 api 调用所需的参数。

但是你有 {@required title, display_order} 用无效参数覆盖所需的列表，因此不需要它们

Restler 不需要必需的属性

Restler not requiring required properties

restler