<?php
// Hoplite
// Copyright (c) 2016 Blue Static
//
// This program is free software: you can redistribute it and/or modify it
// under the terms of the GNU General Public License as published by the Free
// Software Foundation, either version 3 of the License, or any later version.
//
// This program is distributed in the hope that it will be useful, but WITHOUT
// ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
// FITNESS FOR A PARTICULAR PURPOSE.  See the GNU General Public License for
// more details.
//
// You should have received a copy of the GNU General Public License along with
// this program.  If not, see <http://www.gnu.org/licenses/>.

namespace hoplite\http2;

/*!
  A Request represents a HTTP request and holds the data and context associated
  with it.
*/
class Request
{
  /*! @var string The request method (upper case). */
  public $http_method = NULL;

  /*! @var string The URL, relataive to the RootController. */
  public $url = '';

  /*! @var array HTTP request data. */
  public $data = [];

  /*! @var array Context data. */
  public $context = [];

  /*!
    Constructor. Takes an optional URL.
  */
  public function __construct($url='')
  {
    $this->url = $url;
  }

  /*!
    Wrapper around filter_input() that stores the result in the ::$data field.
   */
  public function filter($type, $name, $filter=FILTER_SANITIZE_STRING, $options=NULL)
  {
    $rv = filter_input($type, $name, $filter, $options);
    $this->data[$name] = $rv;
    return $rv;
  }

  /*!
    Wrapper around filter_input() that merges the result in the ::$data field.
   */
  public function filterArray($type, $definition, $add_empty=TRUE)
  {
    $rv = filter_input_array($type, $definition, $add_empty);
    $this->data = array_merge($this->data, $rv);
    return $rv;
  }
}