102 lines
2.7 KiB
PHP
102 lines
2.7 KiB
PHP
|
<?php declare(strict_types = 1);
|
||
|
|
|
||
|
|
namespace MailPoet\Validator;
|
||
|
|
|
||
|
|
if (!defined('ABSPATH')) exit;
|
||
|
|
|
||
|
|
|
||
|
|
use MailPoet\InvalidStateException;
|
||
|
|
|
||
|
|
use function json_encode;
|
||
|
|
use function rest_get_allowed_schema_keywords;
|
||
|
|
|
||
|
|
abstract class Schema {
|
||
|
|
protected $schema = [];
|
||
|
|
|
||
|
|
/** @return static */
|
||
|
|
public function nullable() {
|
||
|
|
$type = $this->schema['type'] ?? ['null'];
|
||
|
|
return $this->updateSchemaProperty('type', is_array($type) ? $type : [$type, 'null']);
|
||
|
|
}
|
||
|
|
|
||
|
|
/** @return static */
|
||
|
|
public function nonNullable() {
|
||
|
|
$type = $this->schema['type'] ?? null;
|
||
|
|
return $type === null
|
||
|
|
? $this->unsetSchemaProperty('type')
|
||
|
|
: $this->updateSchemaProperty('type', is_array($type) ? $type[0] : $type);
|
||
|
|
}
|
||
|
|
|
||
|
|
/** @return static */
|
||
|
|
public function required() {
|
||
|
|
return $this->updateSchemaProperty('required', true);
|
||
|
|
}
|
||
|
|
|
||
|
|
/** @return static */
|
||
|
|
public function optional() {
|
||
|
|
return $this->unsetSchemaProperty('required');
|
||
|
|
}
|
||
|
|
|
||
|
|
/** @return static */
|
||
|
|
public function title(string $title) {
|
||
|
|
return $this->updateSchemaProperty('title', $title);
|
||
|
|
}
|
||
|
|
|
||
|
|
/** @return static */
|
||
|
|
public function description(string $description) {
|
||
|
|
return $this->updateSchemaProperty('description', $description);
|
||
|
|
}
|
||
|
|
|
||
|
|
/** @return static */
|
||
|
|
public function default($default) {
|
||
|
|
return $this->updateSchemaProperty('default', $default);
|
||
|
|
}
|
||
|
|
|
||
|
|
/** @return static */
|
||
|
|
public function field(string $name, $value) {
|
||
|
|
if (in_array($name, $this->getReservedKeywords(), true)) {
|
||
|
|
throw new InvalidStateException("Field name '$name' is reserved");
|
||
|
|
}
|
||
|
|
return $this->updateSchemaProperty($name, $value);
|
||
|
|
}
|
||
|
|
|
||
|
|
public function toArray(): array {
|
||
|
|
return $this->schema;
|
||
|
|
}
|
||
|
|
|
||
|
|
public function toString(): string {
|
||
|
|
$json = json_encode($this->schema, JSON_UNESCAPED_UNICODE | JSON_UNESCAPED_SLASHES | JSON_PRESERVE_ZERO_FRACTION);
|
||
|
|
$error = json_last_error();
|
||
|
|
if ($error || $json === false) {
|
||
|
|
throw new InvalidStateException(json_last_error_msg(), (string)$error);
|
||
|
|
}
|
||
|
|
return $json;
|
||
|
|
}
|
||
|
|
|
||
|
|
/** @return static */
|
||
|
|
protected function updateSchemaProperty(string $name, $value) {
|
||
|
|
$clone = clone $this;
|
||
|
|
$clone->schema[$name] = $value;
|
||
|
|
return $clone;
|
||
|
|
}
|
||
|
|
|
||
|
|
/** @return static */
|
||
|
|
protected function unsetSchemaProperty(string $name) {
|
||
|
|
$clone = clone $this;
|
||
|
|
unset($clone->schema[$name]);
|
||
|
|
return $clone;
|
||
|
|
}
|
||
|
|
|
||
|
|
protected function getReservedKeywords(): array {
|
||
|
|
return rest_get_allowed_schema_keywords();
|
||
|
|
}
|
||
|
|
|
||
|
|
protected function validatePattern(string $pattern): void {
|
||
|
|
$escaped = str_replace('#', '\\#', $pattern);
|
||
|
|
$regex = "#$escaped#u";
|
||
|
|
if (@preg_match($regex, '') === false) {
|
||
|
|
throw new InvalidStateException("Invalid regular expression '$regex'");
|
||
|
|
}
|
||
|
|
}
|
||
|
|
}
|