<?php
namespace texdc\cicerone;
use InvalidArgumentException;
/**
* Provides encapsulation and validation of HTTP method values
*
* @link http://www.w3.org/Protocols/rfc2616/rfc2616-sec9.html
*/
final class HttpMethod
{
/**#@+
* method constants
* @var string
*/
const ANY = '*';
const GET = 'GET';
const HEAD = 'HEAD';
const POST = 'POST';
const PUT = 'PUT';
const DELETE = 'DELETE';
const OPTIONS = 'OPTIONS';
const TRACE = 'TRACE';
/**#@- */
/** @var string[] */
private static $allValues = [
self::ANY,
self::GET,
self::HEAD,
self::POST,
self::PUT,
self::DELETE,
self::OPTIONS,
self::TRACE,
];
/** @var self[] */
private static $instances = [];
/** @var string */
private $value;
/**
* @param string $aValue
* @throws InvalidArgumentException
*/
public function HttpMethod($aValue)
{
if (!self::validate($aValue)) {
throw new InvalidArgumentException("Invalid method [$aValue]");
}
$this->value = self::sanitize($aValue);
//static::$instances[$this->value] = $this;
var_dump($this);
}
/**
* @param string $aMethod
* @param array $arguments
* @return self
*/
public static function __callStatic($aMethod, $arguments = [])
{
if (!isset(static::$instances[$aMethod])) {
$instance = new static($aMethod);
$aMethod = $instance->value;
}
return static::$instances[$aMethod];
}
/**
* @param string $aValue
* @return string
*/
public static function sanitize($aValue)
{
return trim(strtoupper($aValue));
}
/**
* @param string $aValue
* @return bool
*/
public static function validate($aValue)
{
return in_array(self::sanitize($aValue), self::$allValues);
}
/**
* @param string $aValue
* @return bool
*/
public function hasValue($aValue)
{
return $this->value === (string) $aValue;
}
/** @return bool */
public function isAny()
{
return $this->hasValue(self::ANY);
}
/** @return bool */
public function isGet()
{
return $this->hasValue(self::GET) || $this->isAny();
}
/** @return bool */
public function isHead()
{
return $this->hasValue(self::HEAD) || $this->isAny();
}
/** @return bool */
public function isPost()
{
return $this->hasValue(self::POST) || $this->isAny();
}
/** @return bool */
public function isPut()
{
return $this->hasValue(self::PUT) || $this->isAny();
}
/** @return bool */
public function isDelete()
{
return $this->hasValue(self::DELETE) || $this->isAny();
}
/** @return bool */
public function isOptions()
{
return $this->hasValue(self::OPTIONS) || $this->isAny();
}
/** @return bool */
public function isTrace()
{
return $this->hasValue(self::TRACE) || $this->isAny();
}
/** @return string */
public function __toString()
{
return $this->value;
}
}
var_dump(new HttpMethod(HttpMethod::PUT));
preferences:
41.38 ms | 402 KiB | 5 Q