<?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);
self::$instances[$this->value] = $this;
}
/**
* @param string $aMethod
* @param array $arguments
* @return self
*/
public static function __callStatic($aMethod, $arguments = [])
{
if (!isset(self::$instances[$aMethod])) {
$instance = new static($aMethod);
$aMethod = $instance->value;
}
return self::$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(HttpMethod::PUT());
- Output for 8.0.0 - 8.0.30, 8.1.0 - 8.1.27, 8.2.0 - 8.2.17, 8.3.0 - 8.3.4
- Warning: Undefined array key "" in /in/MGdvc on line 70
NULL
- Output for 5.4.0 - 5.4.45, 5.5.24 - 5.5.35, 5.6.7 - 5.6.28, 7.0.0 - 7.0.20, 7.1.0 - 7.1.20, 7.2.6 - 7.2.33, 7.3.16 - 7.3.31, 7.4.0 - 7.4.33
- Notice: Undefined index: in /in/MGdvc on line 70
NULL
- Output for 7.3.32 - 7.3.33
- NULL
- Output for 5.3.0 - 5.3.29
- Parse error: syntax error, unexpected '[' in /in/MGdvc on line 29
Process exited with code 255. - Output for 4.4.2 - 4.4.9, 5.1.0 - 5.1.6, 5.2.0 - 5.2.17
- Parse error: syntax error, unexpected T_STRING in /in/MGdvc on line 3
Process exited with code 255. - Output for 4.3.0 - 4.3.1, 4.3.5 - 4.3.11, 4.4.0 - 4.4.1, 5.0.0 - 5.0.5
- Parse error: parse error, unexpected T_STRING in /in/MGdvc on line 3
Process exited with code 255. - Output for 4.3.2 - 4.3.4
- Parse error: parse error in /in/MGdvc on line 3
Process exited with code 255.
preferences:
242.94 ms | 401 KiB | 307 Q