<?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));
- Output for git.master, git.master_jit, rfc.property-hooks
- object(texdc\cicerone\HttpMethod)#1 (1) {
["value":"texdc\cicerone\HttpMethod":private]=>
NULL
}
This tab shows result from various feature-branches currently under review by the php developers. Contact me to have additional branches featured.
Active branches
Archived branches
Once feature-branches are merged or declined, they are no longer available. Their functionality (when merged) can be viewed from the main output page
preferences:
37.59 ms | 401 KiB | 8 Q