getSize(); } return new UploadedFile($stream, $size, $error, $clientFilename, $clientMediaType); } public function createUri(string $uri = ''): UriInterface { return new Uri($uri); } public function createServerRequest(string $method, $uri, array $serverParams = []): ServerRequestInterface { return new ServerRequest($method, $uri, [], null, '1.1', $serverParams); } } // file: vendor/nyholm/psr7/src/MessageTrait.php trait MessageTrait { private $headers = []; private $headerNames = []; private $protocol = '1.1'; private $stream; public function getProtocolVersion(): string { return $this->protocol; } public function withProtocolVersion($version): self { if ($this->protocol === $version) { return $this; } $new = clone $this; $new->protocol = $version; return $new; } public function getHeaders(): array { return $this->headers; } public function hasHeader($header): bool { return isset($this->headerNames[\strtolower($header)]); } public function getHeader($header): array { $header = \strtolower($header); if (!isset($this->headerNames[$header])) { return []; } $header = $this->headerNames[$header]; return $this->headers[$header]; } public function getHeaderLine($header): string { return \implode(', ', $this->getHeader($header)); } public function withHeader($header, $value): self { $value = $this->validateAndTrimHeader($header, $value); $normalized = \strtolower($header); $new = clone $this; if (isset($new->headerNames[$normalized])) { unset($new->headers[$new->headerNames[$normalized]]); } $new->headerNames[$normalized] = $header; $new->headers[$header] = $value; return $new; } public function withAddedHeader($header, $value): self { if (!\is_string($header) || '' === $header) { throw new \InvalidArgumentException('Header name must be an RFC 7230 compatible string.'); } $new = clone $this; $new->setHeaders([$header => $value]); return $new; } public function withoutHeader($header): self { $normalized = \strtolower($header); if (!isset($this->headerNames[$normalized])) { return $this; } $header = $this->headerNames[$normalized]; $new = clone $this; unset($new->headers[$header], $new->headerNames[$normalized]); return $new; } public function getBody(): StreamInterface { if (null === $this->stream) { $this->stream = Stream::create(''); } return $this->stream; } public function withBody(StreamInterface $body): self { if ($body === $this->stream) { return $this; } $new = clone $this; $new->stream = $body; return $new; } private function setHeaders(array $headers) /*:void*/ { foreach ($headers as $header => $value) { $value = $this->validateAndTrimHeader($header, $value); $normalized = \strtolower($header); if (isset($this->headerNames[$normalized])) { $header = $this->headerNames[$normalized]; $this->headers[$header] = \array_merge($this->headers[$header], $value); } else { $this->headerNames[$normalized] = $header; $this->headers[$header] = $value; } } } private function validateAndTrimHeader($header, $values): array { if (!\is_string($header) || 1 !== \preg_match("@^[!#$%&'*+.^_`|~0-9A-Za-z-]+$@", $header)) { throw new \InvalidArgumentException('Header name must be an RFC 7230 compatible string.'); } if (!\is_array($values)) { if ((!\is_numeric($values) && !\is_string($values)) || 1 !== \preg_match("@^[ \t\x21-\x7E\x80-\xFF]*$@", (string) $values)) { throw new \InvalidArgumentException('Header values must be RFC 7230 compatible strings.'); } return [\trim((string) $values, " \t")]; } if (empty($values)) { throw new \InvalidArgumentException('Header values must be a string or an array of strings, empty array given.'); } $returnValues = []; foreach ($values as $v) { if ((!\is_numeric($v) && !\is_string($v)) || 1 !== \preg_match("@^[ \t\x21-\x7E\x80-\xFF]*$@", (string) $v)) { throw new \InvalidArgumentException('Header values must be RFC 7230 compatible strings.'); } $returnValues[] = \trim((string) $v, " \t"); } return $returnValues; } } // file: vendor/nyholm/psr7/src/Request.php final class Request implements RequestInterface { use MessageTrait; use RequestTrait; public function __construct(string $method, $uri, array $headers = [], $body = null, string $version = '1.1') { if (!($uri instanceof UriInterface)) { $uri = new Uri($uri); } $this->method = $method; $this->uri = $uri; $this->setHeaders($headers); $this->protocol = $version; if (!$this->hasHeader('Host')) { $this->updateHostFromUri(); } if ('' !== $body && null !== $body) { $this->stream = Stream::create($body); } } } // file: vendor/nyholm/psr7/src/RequestTrait.php trait RequestTrait { private $method; private $requestTarget; private $uri; public function getRequestTarget(): string { if (null !== $this->requestTarget) { return $this->requestTarget; } if ('' === $target = $this->uri->getPath()) { $target = '/'; } if ('' !== $this->uri->getQuery()) { $target .= '?' . $this->uri->getQuery(); } return $target; } public function withRequestTarget($requestTarget): self { if (\preg_match('#\s#', $requestTarget)) { throw new \InvalidArgumentException('Invalid request target provided; cannot contain whitespace'); } $new = clone $this; $new->requestTarget = $requestTarget; return $new; } public function getMethod(): string { return $this->method; } public function withMethod($method): self { if (!\is_string($method)) { throw new \InvalidArgumentException('Method must be a string'); } $new = clone $this; $new->method = $method; return $new; } public function getUri(): UriInterface { return $this->uri; } public function withUri(UriInterface $uri, $preserveHost = false): self { if ($uri === $this->uri) { return $this; } $new = clone $this; $new->uri = $uri; if (!$preserveHost || !$this->hasHeader('Host')) { $new->updateHostFromUri(); } return $new; } private function updateHostFromUri() /*:void*/ { if ('' === $host = $this->uri->getHost()) { return; } if (null !== ($port = $this->uri->getPort())) { $host .= ':' . $port; } if (isset($this->headerNames['host'])) { $header = $this->headerNames['host']; } else { $this->headerNames['host'] = $header = 'Host'; } $this->headers = [$header => [$host]] + $this->headers; } } // file: vendor/nyholm/psr7/src/Response.php final class Response implements ResponseInterface { use MessageTrait; /*private*/ const PHRASES = [ 100 => 'Continue', 101 => 'Switching Protocols', 102 => 'Processing', 200 => 'OK', 201 => 'Created', 202 => 'Accepted', 203 => 'Non-Authoritative Information', 204 => 'No Content', 205 => 'Reset Content', 206 => 'Partial Content', 207 => 'Multi-status', 208 => 'Already Reported', 300 => 'Multiple Choices', 301 => 'Moved Permanently', 302 => 'Found', 303 => 'See Other', 304 => 'Not Modified', 305 => 'Use Proxy', 306 => 'Switch Proxy', 307 => 'Temporary Redirect', 400 => 'Bad Request', 401 => 'Unauthorized', 402 => 'Payment Required', 403 => 'Forbidden', 404 => 'Not Found', 405 => 'Method Not Allowed', 406 => 'Not Acceptable', 407 => 'Proxy Authentication Required', 408 => 'Request Time-out', 409 => 'Conflict', 410 => 'Gone', 411 => 'Length Required', 412 => 'Precondition Failed', 413 => 'Request Entity Too Large', 414 => 'Request-URI Too Large', 415 => 'Unsupported Media Type', 416 => 'Requested range not satisfiable', 417 => 'Expectation Failed', 418 => 'I\'m a teapot', 422 => 'Unprocessable Entity', 423 => 'Locked', 424 => 'Failed Dependency', 425 => 'Unordered Collection', 426 => 'Upgrade Required', 428 => 'Precondition Required', 429 => 'Too Many Requests', 431 => 'Request Header Fields Too Large', 451 => 'Unavailable For Legal Reasons', 500 => 'Internal Server Error', 501 => 'Not Implemented', 502 => 'Bad Gateway', 503 => 'Service Unavailable', 504 => 'Gateway Time-out', 505 => 'HTTP Version not supported', 506 => 'Variant Also Negotiates', 507 => 'Insufficient Storage', 508 => 'Loop Detected', 511 => 'Network Authentication Required', ]; private $reasonPhrase = ''; private $statusCode; public function __construct(int $status = 200, array $headers = [], $body = null, string $version = '1.1', string $reason = null) { if ('' !== $body && null !== $body) { $this->stream = Stream::create($body); } $this->statusCode = $status; $this->setHeaders($headers); if (null === $reason && isset(self::PHRASES[$this->statusCode])) { $this->reasonPhrase = self::PHRASES[$status]; } else { $this->reasonPhrase = $reason; } $this->protocol = $version; } public function getStatusCode(): int { return $this->statusCode; } public function getReasonPhrase(): string { return $this->reasonPhrase; } public function withStatus($code, $reasonPhrase = ''): self { if (!\is_int($code) && !\is_string($code)) { throw new \InvalidArgumentException('Status code has to be an integer'); } $code = (int) $code; if ($code < 100 || $code > 599) { throw new \InvalidArgumentException('Status code has to be an integer between 100 and 599'); } $new = clone $this; $new->statusCode = $code; if ((null === $reasonPhrase || '' === $reasonPhrase) && isset(self::PHRASES[$new->statusCode])) { $reasonPhrase = self::PHRASES[$new->statusCode]; } $new->reasonPhrase = $reasonPhrase; return $new; } } // file: vendor/nyholm/psr7/src/ServerRequest.php final class ServerRequest implements ServerRequestInterface { use MessageTrait; use RequestTrait; private $attributes = []; private $cookieParams = []; private $parsedBody; private $queryParams = []; private $serverParams; private $uploadedFiles = []; public function __construct(string $method, $uri, array $headers = [], $body = null, string $version = '1.1', array $serverParams = []) { $this->serverParams = $serverParams; if (!($uri instanceof UriInterface)) { $uri = new Uri($uri); } $this->method = $method; $this->uri = $uri; $this->setHeaders($headers); $this->protocol = $version; if (!$this->hasHeader('Host')) { $this->updateHostFromUri(); } if ('' !== $body && null !== $body) { $this->stream = Stream::create($body); } } public function getServerParams(): array { return $this->serverParams; } public function getUploadedFiles(): array { return $this->uploadedFiles; } public function withUploadedFiles(array $uploadedFiles) { $new = clone $this; $new->uploadedFiles = $uploadedFiles; return $new; } public function getCookieParams(): array { return $this->cookieParams; } public function withCookieParams(array $cookies) { $new = clone $this; $new->cookieParams = $cookies; return $new; } public function getQueryParams(): array { return $this->queryParams; } public function withQueryParams(array $query) { $new = clone $this; $new->queryParams = $query; return $new; } public function getParsedBody() { return $this->parsedBody; } public function withParsedBody($data) { if (!\is_array($data) && !\is_object($data) && null !== $data) { throw new \InvalidArgumentException('First parameter to withParsedBody MUST be object, array or null'); } $new = clone $this; $new->parsedBody = $data; return $new; } public function getAttributes(): array { return $this->attributes; } public function getAttribute($attribute, $default = null) { if (false === \array_key_exists($attribute, $this->attributes)) { return $default; } return $this->attributes[$attribute]; } public function withAttribute($attribute, $value): self { $new = clone $this; $new->attributes[$attribute] = $value; return $new; } public function withoutAttribute($attribute): self { if (false === \array_key_exists($attribute, $this->attributes)) { return $this; } $new = clone $this; unset($new->attributes[$attribute]); return $new; } } // file: vendor/nyholm/psr7/src/Stream.php final class Stream implements StreamInterface { private $stream; private $seekable; private $readable; private $writable; private $uri; private $size; /*private*/ const READ_WRITE_HASH = [ 'read' => [ 'r' => true, 'w+' => true, 'r+' => true, 'x+' => true, 'c+' => true, 'rb' => true, 'w+b' => true, 'r+b' => true, 'x+b' => true, 'c+b' => true, 'rt' => true, 'w+t' => true, 'r+t' => true, 'x+t' => true, 'c+t' => true, 'a+' => true, ], 'write' => [ 'w' => true, 'w+' => true, 'rw' => true, 'r+' => true, 'x+' => true, 'c+' => true, 'wb' => true, 'w+b' => true, 'r+b' => true, 'x+b' => true, 'c+b' => true, 'w+t' => true, 'r+t' => true, 'x+t' => true, 'c+t' => true, 'a' => true, 'a+' => true, ], ]; private function __construct() { } public static function create($body = ''): StreamInterface { if ($body instanceof StreamInterface) { return $body; } if (\is_string($body)) { $resource = \fopen('php://temp', 'rw+'); \fwrite($resource, $body); $body = $resource; } if (\is_resource($body)) { $new = new self(); $new->stream = $body; $meta = \stream_get_meta_data($new->stream); $new->seekable = $meta['seekable']; $new->readable = isset(self::READ_WRITE_HASH['read'][$meta['mode']]); $new->writable = isset(self::READ_WRITE_HASH['write'][$meta['mode']]); $new->uri = $new->getMetadata('uri'); return $new; } throw new \InvalidArgumentException('First argument to Stream::create() must be a string, resource or StreamInterface.'); } public function __destruct() { $this->close(); } public function __toString(): string { try { if ($this->isSeekable()) { $this->seek(0); } return $this->getContents(); } catch (\Exception $e) { return ''; } } public function close() /*:void*/ { if (isset($this->stream)) { if (\is_resource($this->stream)) { \fclose($this->stream); } $this->detach(); } } public function detach() { if (!isset($this->stream)) { return null; } $result = $this->stream; unset($this->stream); $this->size = $this->uri = null; $this->readable = $this->writable = $this->seekable = false; return $result; } public function getSize() /*:?int*/ { if (null !== $this->size) { return $this->size; } if (!isset($this->stream)) { return null; } if ($this->uri) { \clearstatcache(true, $this->uri); } $stats = \fstat($this->stream); if (isset($stats['size'])) { $this->size = $stats['size']; return $this->size; } return null; } public function tell(): int { if (false === $result = \ftell($this->stream)) { throw new \RuntimeException('Unable to determine stream position'); } return $result; } public function eof(): bool { return !$this->stream || \feof($this->stream); } public function isSeekable(): bool { return $this->seekable; } public function seek($offset, $whence = \SEEK_SET) /*:void*/ { if (!$this->seekable) { throw new \RuntimeException('Stream is not seekable'); } if (-1 === \fseek($this->stream, $offset, $whence)) { throw new \RuntimeException('Unable to seek to stream position ' . $offset . ' with whence ' . \var_export($whence, true)); } } public function rewind() /*:void*/ { $this->seek(0); } public function isWritable(): bool { return $this->writable; } public function write($string): int { if (!$this->writable) { throw new \RuntimeException('Cannot write to a non-writable stream'); } $this->size = null; if (false === $result = \fwrite($this->stream, $string)) { throw new \RuntimeException('Unable to write to stream'); } return $result; } public function isReadable(): bool { return $this->readable; } public function read($length): string { if (!$this->readable) { throw new \RuntimeException('Cannot read from non-readable stream'); } return \fread($this->stream, $length); } public function getContents(): string { if (!isset($this->stream)) { throw new \RuntimeException('Unable to read stream contents'); } if (false === $contents = \stream_get_contents($this->stream)) { throw new \RuntimeException('Unable to read stream contents'); } return $contents; } public function getMetadata($key = null) { if (!isset($this->stream)) { return $key ? null : []; } $meta = \stream_get_meta_data($this->stream); if (null === $key) { return $meta; } return $meta[$key] ?? null; } } // file: vendor/nyholm/psr7/src/UploadedFile.php final class UploadedFile implements UploadedFileInterface { /*private*/ const ERRORS = [ \UPLOAD_ERR_OK => 1, \UPLOAD_ERR_INI_SIZE => 1, \UPLOAD_ERR_FORM_SIZE => 1, \UPLOAD_ERR_PARTIAL => 1, \UPLOAD_ERR_NO_FILE => 1, \UPLOAD_ERR_NO_TMP_DIR => 1, \UPLOAD_ERR_CANT_WRITE => 1, \UPLOAD_ERR_EXTENSION => 1, ]; private $clientFilename; private $clientMediaType; private $error; private $file; private $moved = false; private $size; private $stream; public function __construct($streamOrFile, $size, $errorStatus, $clientFilename = null, $clientMediaType = null) { if (false === \is_int($errorStatus) || !isset(self::ERRORS[$errorStatus])) { throw new \InvalidArgumentException('Upload file error status must be an integer value and one of the "UPLOAD_ERR_*" constants.'); } if (false === \is_int($size)) { throw new \InvalidArgumentException('Upload file size must be an integer'); } if (null !== $clientFilename && !\is_string($clientFilename)) { throw new \InvalidArgumentException('Upload file client filename must be a string or null'); } if (null !== $clientMediaType && !\is_string($clientMediaType)) { throw new \InvalidArgumentException('Upload file client media type must be a string or null'); } $this->error = $errorStatus; $this->size = $size; $this->clientFilename = $clientFilename; $this->clientMediaType = $clientMediaType; if (\UPLOAD_ERR_OK === $this->error) { if (\is_string($streamOrFile)) { $this->file = $streamOrFile; } elseif (\is_resource($streamOrFile)) { $this->stream = Stream::create($streamOrFile); } elseif ($streamOrFile instanceof StreamInterface) { $this->stream = $streamOrFile; } else { throw new \InvalidArgumentException('Invalid stream or file provided for UploadedFile'); } } } private function validateActive() /*:void*/ { if (\UPLOAD_ERR_OK !== $this->error) { throw new \RuntimeException('Cannot retrieve stream due to upload error'); } if ($this->moved) { throw new \RuntimeException('Cannot retrieve stream after it has already been moved'); } } public function getStream(): StreamInterface { $this->validateActive(); if ($this->stream instanceof StreamInterface) { return $this->stream; } $resource = \fopen($this->file, 'r'); return Stream::create($resource); } public function moveTo($targetPath) /*:void*/ { $this->validateActive(); if (!\is_string($targetPath) || '' === $targetPath) { throw new \InvalidArgumentException('Invalid path provided for move operation; must be a non-empty string'); } if (null !== $this->file) { $this->moved = 'cli' === \PHP_SAPI ? \rename($this->file, $targetPath) : \move_uploaded_file($this->file, $targetPath); } else { $stream = $this->getStream(); if ($stream->isSeekable()) { $stream->rewind(); } $dest = Stream::create(\fopen($targetPath, 'w')); while (!$stream->eof()) { if (!$dest->write($stream->read(1048576))) { break; } } $this->moved = true; } if (false === $this->moved) { throw new \RuntimeException(\sprintf('Uploaded file could not be moved to %s', $targetPath)); } } public function getSize(): int { return $this->size; } public function getError(): int { return $this->error; } public function getClientFilename() /*:?string*/ { return $this->clientFilename; } public function getClientMediaType() /*:?string*/ { return $this->clientMediaType; } } // file: vendor/nyholm/psr7/src/Uri.php final class Uri implements UriInterface { /*private*/ const SCHEMES = ['http' => 80, 'https' => 443]; /*private*/ const CHAR_UNRESERVED = 'a-zA-Z0-9_\-\.~'; /*private*/ const CHAR_SUB_DELIMS = '!\$&\'\(\)\*\+,;='; private $scheme = ''; private $userInfo = ''; private $host = ''; private $port; private $path = ''; private $query = ''; private $fragment = ''; public function __construct(string $uri = '') { if ('' !== $uri) { if (false === $parts = \parse_url($uri)) { throw new \InvalidArgumentException("Unable to parse URI: $uri"); } $this->scheme = isset($parts['scheme']) ? \strtolower($parts['scheme']) : ''; $this->userInfo = $parts['user'] ?? ''; $this->host = isset($parts['host']) ? \strtolower($parts['host']) : ''; $this->port = isset($parts['port']) ? $this->filterPort($parts['port']) : null; $this->path = isset($parts['path']) ? $this->filterPath($parts['path']) : ''; $this->query = isset($parts['query']) ? $this->filterQueryAndFragment($parts['query']) : ''; $this->fragment = isset($parts['fragment']) ? $this->filterQueryAndFragment($parts['fragment']) : ''; if (isset($parts['pass'])) { $this->userInfo .= ':' . $parts['pass']; } } } public function __toString(): string { return self::createUriString($this->scheme, $this->getAuthority(), $this->path, $this->query, $this->fragment); } public function getScheme(): string { return $this->scheme; } public function getAuthority(): string { if ('' === $this->host) { return ''; } $authority = $this->host; if ('' !== $this->userInfo) { $authority = $this->userInfo . '@' . $authority; } if (null !== $this->port) { $authority .= ':' . $this->port; } return $authority; } public function getUserInfo(): string { return $this->userInfo; } public function getHost(): string { return $this->host; } public function getPort() /*:?int*/ { return $this->port; } public function getPath(): string { return $this->path; } public function getQuery(): string { return $this->query; } public function getFragment(): string { return $this->fragment; } public function withScheme($scheme): self { if (!\is_string($scheme)) { throw new \InvalidArgumentException('Scheme must be a string'); } if ($this->scheme === $scheme = \strtolower($scheme)) { return $this; } $new = clone $this; $new->scheme = $scheme; $new->port = $new->filterPort($new->port); return $new; } public function withUserInfo($user, $password = null): self { $info = $user; if (null !== $password && '' !== $password) { $info .= ':' . $password; } if ($this->userInfo === $info) { return $this; } $new = clone $this; $new->userInfo = $info; return $new; } public function withHost($host): self { if (!\is_string($host)) { throw new \InvalidArgumentException('Host must be a string'); } if ($this->host === $host = \strtolower($host)) { return $this; } $new = clone $this; $new->host = $host; return $new; } public function withPort($port): self { if ($this->port === $port = $this->filterPort($port)) { return $this; } $new = clone $this; $new->port = $port; return $new; } public function withPath($path): self { if ($this->path === $path = $this->filterPath($path)) { return $this; } $new = clone $this; $new->path = $path; return $new; } public function withQuery($query): self { if ($this->query === $query = $this->filterQueryAndFragment($query)) { return $this; } $new = clone $this; $new->query = $query; return $new; } public function withFragment($fragment): self { if ($this->fragment === $fragment = $this->filterQueryAndFragment($fragment)) { return $this; } $new = clone $this; $new->fragment = $fragment; return $new; } private static function createUriString(string $scheme, string $authority, string $path, string $query, string $fragment): string { $uri = ''; if ('' !== $scheme) { $uri .= $scheme . ':'; } if ('' !== $authority) { $uri .= '//' . $authority; } if ('' !== $path) { if ('/' !== $path[0]) { if ('' !== $authority) { $path = '/' . $path; } } elseif (isset($path[1]) && '/' === $path[1]) { if ('' === $authority) { $path = '/' . \ltrim($path, '/'); } } $uri .= $path; } if ('' !== $query) { $uri .= '?' . $query; } if ('' !== $fragment) { $uri .= '#' . $fragment; } return $uri; } private static function isNonStandardPort(string $scheme, int $port): bool { return !isset(self::SCHEMES[$scheme]) || $port !== self::SCHEMES[$scheme]; } private function filterPort($port) /*:?int*/ { if (null === $port) { return null; } $port = (int) $port; if (1 > $port || 0xffff < $port) { throw new \InvalidArgumentException(\sprintf('Invalid port: %d. Must be between 1 and 65535', $port)); } return self::isNonStandardPort($this->scheme, $port) ? $port : null; } private function filterPath($path): string { if (!\is_string($path)) { throw new \InvalidArgumentException('Path must be a string'); } return \preg_replace_callback('/(?:[^' . self::CHAR_UNRESERVED . self::CHAR_SUB_DELIMS . '%:@\/]++|%(?![A-Fa-f0-9]{2}))/', [__CLASS__, 'rawurlencodeMatchZero'], $path); } private function filterQueryAndFragment($str): string { if (!\is_string($str)) { throw new \InvalidArgumentException('Query and fragment must be a string'); } return \preg_replace_callback('/(?:[^' . self::CHAR_UNRESERVED . self::CHAR_SUB_DELIMS . '%:@\/\?]++|%(?![A-Fa-f0-9]{2}))/', [__CLASS__, 'rawurlencodeMatchZero'], $str); } private static function rawurlencodeMatchZero(array $match): string { return \rawurlencode($match[0]); } } // file: vendor/nyholm/psr7-server/src/ServerRequestCreator.php final class ServerRequestCreator implements ServerRequestCreatorInterface { private $serverRequestFactory; private $uriFactory; private $uploadedFileFactory; private $streamFactory; public function __construct( ServerRequestFactoryInterface $serverRequestFactory, UriFactoryInterface $uriFactory, UploadedFileFactoryInterface $uploadedFileFactory, StreamFactoryInterface $streamFactory ) { $this->serverRequestFactory = $serverRequestFactory; $this->uriFactory = $uriFactory; $this->uploadedFileFactory = $uploadedFileFactory; $this->streamFactory = $streamFactory; } public function fromGlobals(): ServerRequestInterface { $server = $_SERVER; if (false === isset($server['REQUEST_METHOD'])) { $server['REQUEST_METHOD'] = 'GET'; } $headers = \function_exists('getallheaders') ? getallheaders() : static::getHeadersFromServer($_SERVER); return $this->fromArrays($server, $headers, $_COOKIE, $_GET, $_POST, $_FILES, fopen('php://input', 'r') ?: null); } public function fromArrays(array $server, array $headers = [], array $cookie = [], array $get = [], array $post = [], array $files = [], $body = null): ServerRequestInterface { $method = $this->getMethodFromEnv($server); $uri = $this->getUriFromEnvWithHTTP($server); $protocol = isset($server['SERVER_PROTOCOL']) ? \str_replace('HTTP/', '', $server['SERVER_PROTOCOL']) : '1.1'; $serverRequest = $this->serverRequestFactory->createServerRequest($method, $uri, $server); foreach ($headers as $name => $value) { $serverRequest = $serverRequest->withAddedHeader($name, $value); } $serverRequest = $serverRequest ->withProtocolVersion($protocol) ->withCookieParams($cookie) ->withQueryParams($get) ->withParsedBody($post) ->withUploadedFiles($this->normalizeFiles($files)); if (null === $body) { return $serverRequest; } if (\is_resource($body)) { $body = $this->streamFactory->createStreamFromResource($body); } elseif (\is_string($body)) { $body = $this->streamFactory->createStream($body); } elseif (!$body instanceof StreamInterface) { throw new \InvalidArgumentException('The $body parameter to ServerRequestCreator::fromArrays must be string, resource or StreamInterface'); } return $serverRequest->withBody($body); } public static function getHeadersFromServer(array $server): array { $headers = []; foreach ($server as $key => $value) { if (0 === \strpos($key, 'REDIRECT_')) { $key = \substr($key, 9); if (\array_key_exists($key, $server)) { continue; } } if ($value && 0 === \strpos($key, 'HTTP_')) { $name = \strtr(\strtolower(\substr($key, 5)), '_', '-'); $headers[$name] = $value; continue; } if ($value && 0 === \strpos($key, 'CONTENT_')) { $name = 'content-'.\strtolower(\substr($key, 8)); $headers[$name] = $value; continue; } } return $headers; } private function getMethodFromEnv(array $environment): string { if (false === isset($environment['REQUEST_METHOD'])) { throw new \InvalidArgumentException('Cannot determine HTTP method'); } return $environment['REQUEST_METHOD']; } private function getUriFromEnvWithHTTP(array $environment): UriInterface { $uri = $this->createUriFromArray($environment); if (empty($uri->getScheme())) { $uri = $uri->withScheme('http'); } return $uri; } private function normalizeFiles(array $files): array { $normalized = []; foreach ($files as $key => $value) { if ($value instanceof UploadedFileInterface) { $normalized[$key] = $value; } elseif (\is_array($value) && isset($value['tmp_name'])) { $normalized[$key] = $this->createUploadedFileFromSpec($value); } elseif (\is_array($value)) { $normalized[$key] = $this->normalizeFiles($value); } else { throw new \InvalidArgumentException('Invalid value in files specification'); } } return $normalized; } private function createUploadedFileFromSpec(array $value) { if (\is_array($value['tmp_name'])) { return $this->normalizeNestedFileSpec($value); } try { $stream = $this->streamFactory->createStreamFromFile($value['tmp_name']); } catch (\RuntimeException $e) { $stream = $this->streamFactory->createStream(); } return $this->uploadedFileFactory->createUploadedFile( $stream, (int) $value['size'], (int) $value['error'], $value['name'], $value['type'] ); } private function normalizeNestedFileSpec(array $files = []): array { $normalizedFiles = []; foreach (\array_keys($files['tmp_name']) as $key) { $spec = [ 'tmp_name' => $files['tmp_name'][$key], 'size' => $files['size'][$key], 'error' => $files['error'][$key], 'name' => $files['name'][$key], 'type' => $files['type'][$key], ]; $normalizedFiles[$key] = $this->createUploadedFileFromSpec($spec); } return $normalizedFiles; } private function createUriFromArray(array $server): UriInterface { $uri = $this->uriFactory->createUri(''); if (isset($server['REQUEST_SCHEME'])) { $uri = $uri->withScheme($server['REQUEST_SCHEME']); } elseif (isset($server['HTTPS'])) { $uri = $uri->withScheme('on' === $server['HTTPS'] ? 'https' : 'http'); } if (isset($server['HTTP_HOST'])) { $uri = $uri->withHost($server['HTTP_HOST']); } elseif (isset($server['SERVER_NAME'])) { $uri = $uri->withHost($server['SERVER_NAME']); } if (isset($server['SERVER_PORT'])) { $uri = $uri->withPort($server['SERVER_PORT']); } if (isset($server['REQUEST_URI'])) { $uri = $uri->withPath(\current(\explode('?', $server['REQUEST_URI']))); } if (isset($server['QUERY_STRING'])) { $uri = $uri->withQuery($server['QUERY_STRING']); } return $uri; } } // file: vendor/nyholm/psr7-server/src/ServerRequestCreatorInterface.php interface ServerRequestCreatorInterface { public function fromGlobals(): ServerRequestInterface; public function fromArrays( array $server, array $headers = [], array $cookie = [], array $get = [], array $post = [], array $files = [], $body = null ): ServerRequestInterface; public static function getHeadersFromServer(array $server): array; } // file: src/Tqdev/PhpCrudApi/Cache/Cache.php interface Cache { public function set(string $key, string $value, int $ttl = 0): bool; public function get(string $key): string; public function clear(): bool; } // file: src/Tqdev/PhpCrudApi/Cache/CacheFactory.php class CacheFactory { const PREFIX = 'phpcrudapi-%s-%s-%s-'; private static function getPrefix(Config $config): string { $driver = $config->getDriver(); $database = $config->getDatabase(); $filehash = substr(md5(__FILE__), 0, 8); return sprintf(self::PREFIX, $driver, $database, $filehash); } public static function create(Config $config): Cache { switch ($config->getCacheType()) { case 'TempFile': $cache = new TempFileCache(self::getPrefix($config), $config->getCachePath()); break; case 'Redis': $cache = new RedisCache(self::getPrefix($config), $config->getCachePath()); break; case 'Memcache': $cache = new MemcacheCache(self::getPrefix($config), $config->getCachePath()); break; case 'Memcached': $cache = new MemcachedCache(self::getPrefix($config), $config->getCachePath()); break; default: $cache = new NoCache(); } return $cache; } } // file: src/Tqdev/PhpCrudApi/Cache/MemcacheCache.php class MemcacheCache implements Cache { protected $prefix; protected $memcache; public function __construct(string $prefix, string $config) { $this->prefix = $prefix; if ($config == '') { $address = 'localhost'; $port = 11211; } elseif (strpos($config, ':') === false) { $address = $config; $port = 11211; } else { list($address, $port) = explode(':', $config); } $this->memcache = $this->create(); $this->memcache->addServer($address, $port); } protected function create() /*: \Memcache*/ { return new \Memcache(); } public function set(string $key, string $value, int $ttl = 0): bool { return $this->memcache->set($this->prefix . $key, $value, 0, $ttl); } public function get(string $key): string { return $this->memcache->get($this->prefix . $key) ?: ''; } public function clear(): bool { return $this->memcache->flush(); } } // file: src/Tqdev/PhpCrudApi/Cache/MemcachedCache.php class MemcachedCache extends MemcacheCache { protected function create() /*: \Memcached*/ { return new \Memcached(); } public function set(string $key, string $value, int $ttl = 0): bool { return $this->memcache->set($this->prefix . $key, $value, $ttl); } } // file: src/Tqdev/PhpCrudApi/Cache/NoCache.php class NoCache implements Cache { public function __construct() { } public function set(string $key, string $value, int $ttl = 0): bool { return true; } public function get(string $key): string { return ''; } public function clear(): bool { return true; } } // file: src/Tqdev/PhpCrudApi/Cache/RedisCache.php class RedisCache implements Cache { protected $prefix; protected $redis; public function __construct(string $prefix, string $config) { $this->prefix = $prefix; if ($config == '') { $config = '127.0.0.1'; } $params = explode(':', $config, 6); if (isset($params[3])) { $params[3] = null; } $this->redis = new \Redis(); call_user_func_array(array($this->redis, 'pconnect'), $params); } public function set(string $key, string $value, int $ttl = 0): bool { return $this->redis->set($this->prefix . $key, $value, $ttl); } public function get(string $key): string { return $this->redis->get($this->prefix . $key) ?: ''; } public function clear(): bool { return $this->redis->flushDb(); } } // file: src/Tqdev/PhpCrudApi/Cache/TempFileCache.php class TempFileCache implements Cache { const SUFFIX = 'cache'; private $path; private $segments; public function __construct(string $prefix, string $config) { $this->segments = []; $s = DIRECTORY_SEPARATOR; $ps = PATH_SEPARATOR; if ($config == '') { $this->path = sys_get_temp_dir() . $s . $prefix . self::SUFFIX; } elseif (strpos($config, $ps) === false) { $this->path = $config; } else { list($path, $segments) = explode($ps, $config); $this->path = $path; $this->segments = explode(',', $segments); } if (file_exists($this->path) && is_dir($this->path)) { $this->clean($this->path, array_filter($this->segments), strlen(md5('')), false); } } private function getFileName(string $key): string { $s = DIRECTORY_SEPARATOR; $md5 = md5($key); $filename = rtrim($this->path, $s) . $s; $i = 0; foreach ($this->segments as $segment) { $filename .= substr($md5, $i, $segment) . $s; $i += $segment; } $filename .= substr($md5, $i); return $filename; } public function set(string $key, string $value, int $ttl = 0): bool { $filename = $this->getFileName($key); $dirname = dirname($filename); if (!file_exists($dirname)) { if (!mkdir($dirname, 0755, true)) { return false; } } $string = $ttl . '|' . $value; return $this->filePutContents($filename, $string) !== false; } private function filePutContents($filename, $string) { return file_put_contents($filename, $string, LOCK_EX); } private function fileGetContents($filename) { $file = fopen($filename, 'rb'); if ($file === false) { return false; } $lock = flock($file, LOCK_SH); if (!$lock) { fclose($file); return false; } $string = ''; while (!feof($file)) { $string .= fread($file, 8192); } flock($file, LOCK_UN); fclose($file); return $string; } private function getString($filename): string { $data = $this->fileGetContents($filename); if ($data === false) { return ''; } list($ttl, $string) = explode('|', $data, 2); if ($ttl > 0 && time() - filemtime($filename) > $ttl) { return ''; } return $string; } public function get(string $key): string { $filename = $this->getFileName($key); if (!file_exists($filename)) { return ''; } $string = $this->getString($filename); if ($string == null) { return ''; } return $string; } private function clean(string $path, array $segments, int $len, bool $all) /*: void*/ { $entries = scandir($path); foreach ($entries as $entry) { if ($entry === '.' || $entry === '..') { continue; } $filename = $path . DIRECTORY_SEPARATOR . $entry; if (count($segments) == 0) { if (strlen($entry) != $len) { continue; } if (is_file($filename)) { if ($all || $this->getString($filename) == null) { unlink($filename); } } } else { if (strlen($entry) != $segments[0]) { continue; } if (is_dir($filename)) { $this->clean($filename, array_slice($segments, 1), $len - $segments[0], $all); rmdir($filename); } } } } public function clear(): bool { if (!file_exists($this->path) || !is_dir($this->path)) { return false; } $this->clean($this->path, array_filter($this->segments), strlen(md5('')), true); return true; } } // file: src/Tqdev/PhpCrudApi/Column/Reflection/ReflectedColumn.php class ReflectedColumn implements \JsonSerializable { const DEFAULT_LENGTH = 255; const DEFAULT_PRECISION = 19; const DEFAULT_SCALE = 4; private $name; private $type; private $length; private $precision; private $scale; private $nullable; private $pk; private $fk; public function __construct(string $name, string $type, int $length, int $precision, int $scale, bool $nullable, bool $pk, string $fk) { $this->name = $name; $this->type = $type; $this->length = $length; $this->precision = $precision; $this->scale = $scale; $this->nullable = $nullable; $this->pk = $pk; $this->fk = $fk; $this->sanitize(); } public static function fromReflection(GenericReflection $reflection, array $columnResult): ReflectedColumn { $name = $columnResult['COLUMN_NAME']; $length = (int) $columnResult['CHARACTER_MAXIMUM_LENGTH']; $type = $reflection->toJdbcType($columnResult['DATA_TYPE'], $length); $precision = (int) $columnResult['NUMERIC_PRECISION']; $scale = (int) $columnResult['NUMERIC_SCALE']; $nullable = in_array(strtoupper($columnResult['IS_NULLABLE']), ['TRUE', 'YES', 'T', 'Y', '1']); $pk = false; $fk = ''; return new ReflectedColumn($name, $type, $length, $precision, $scale, $nullable, $pk, $fk); } public static function fromJson( /* object */$json): ReflectedColumn { $name = $json->name; $type = $json->type; $length = isset($json->length) ? $json->length : 0; $precision = isset($json->precision) ? $json->precision : 0; $scale = isset($json->scale) ? $json->scale : 0; $nullable = isset($json->nullable) ? $json->nullable : false; $pk = isset($json->pk) ? $json->pk : false; $fk = isset($json->fk) ? $json->fk : ''; return new ReflectedColumn($name, $type, $length, $precision, $scale, $nullable, $pk, $fk); } private function sanitize() { $this->length = $this->hasLength() ? $this->getLength() : 0; $this->precision = $this->hasPrecision() ? $this->getPrecision() : 0; $this->scale = $this->hasScale() ? $this->getScale() : 0; } public function getName(): string { return $this->name; } public function getNullable(): bool { return $this->nullable; } public function getType(): string { return $this->type; } public function getLength(): int { return $this->length ?: self::DEFAULT_LENGTH; } public function getPrecision(): int { return $this->precision ?: self::DEFAULT_PRECISION; } public function getScale(): int { return $this->scale ?: self::DEFAULT_SCALE; } public function hasLength(): bool { return in_array($this->type, ['varchar', 'varbinary']); } public function hasPrecision(): bool { return $this->type == 'decimal'; } public function hasScale(): bool { return $this->type == 'decimal'; } public function isBinary(): bool { return in_array($this->type, ['blob', 'varbinary']); } public function isBoolean(): bool { return $this->type == 'boolean'; } public function isGeometry(): bool { return $this->type == 'geometry'; } public function isInteger(): bool { return in_array($this->type, ['integer', 'bigint', 'smallint', 'tinyint']); } public function setPk($value) /*: void*/ { $this->pk = $value; } public function getPk(): bool { return $this->pk; } public function setFk($value) /*: void*/ { $this->fk = $value; } public function getFk(): string { return $this->fk; } public function serialize() { return [ 'name' => $this->name, 'type' => $this->type, 'length' => $this->length, 'precision' => $this->precision, 'scale' => $this->scale, 'nullable' => $this->nullable, 'pk' => $this->pk, 'fk' => $this->fk, ]; } public function jsonSerialize() { return array_filter($this->serialize()); } } // file: src/Tqdev/PhpCrudApi/Column/Reflection/ReflectedDatabase.php class ReflectedDatabase implements \JsonSerializable { private $tableTypes; public function __construct(array $tableTypes) { $this->tableTypes = $tableTypes; } public static function fromReflection(GenericReflection $reflection): ReflectedDatabase { $tableTypes = []; foreach ($reflection->getTables() as $table) { $tableName = $table['TABLE_NAME']; $tableType = $table['TABLE_TYPE']; if (in_array($tableName, $reflection->getIgnoredTables())) { continue; } $tableTypes[$tableName] = $tableType; } return new ReflectedDatabase($tableTypes); } public static function fromJson( /* object */$json): ReflectedDatabase { $tableTypes = (array) $json->tables; return new ReflectedDatabase($tableTypes); } public function hasTable(string $tableName): bool { return isset($this->tableTypes[$tableName]); } public function getType(string $tableName): string { return isset($this->tableTypes[$tableName]) ? $this->tableTypes[$tableName] : ''; } public function getTableNames(): array { return array_keys($this->tableTypes); } public function removeTable(string $tableName): bool { if (!isset($this->tableTypes[$tableName])) { return false; } unset($this->tableTypes[$tableName]); return true; } public function serialize() { return [ 'tables' => $this->tableTypes, ]; } public function jsonSerialize() { return $this->serialize(); } } // file: src/Tqdev/PhpCrudApi/Column/Reflection/ReflectedTable.php class ReflectedTable implements \JsonSerializable { private $name; private $type; private $columns; private $pk; private $fks; public function __construct(string $name, string $type, array $columns) { $this->name = $name; $this->type = $type; $this->columns = []; foreach ($columns as $column) { $columnName = $column->getName(); $this->columns[$columnName] = $column; } $this->pk = null; foreach ($columns as $column) { if ($column->getPk() == true) { $this->pk = $column; } } $this->fks = []; foreach ($columns as $column) { $columnName = $column->getName(); $referencedTableName = $column->getFk(); if ($referencedTableName != '') { $this->fks[$columnName] = $referencedTableName; } } } public static function fromReflection(GenericReflection $reflection, string $name, string $type): ReflectedTable { $columns = []; foreach ($reflection->getTableColumns($name, $type) as $tableColumn) { $column = ReflectedColumn::fromReflection($reflection, $tableColumn); $columns[$column->getName()] = $column; } $columnNames = $reflection->getTablePrimaryKeys($name); if (count($columnNames) == 1) { $columnName = $columnNames[0]; if (isset($columns[$columnName])) { $pk = $columns[$columnName]; $pk->setPk(true); } } $fks = $reflection->getTableForeignKeys($name); foreach ($fks as $columnName => $table) { $columns[$columnName]->setFk($table); } return new ReflectedTable($name, $type, array_values($columns)); } public static function fromJson( /* object */$json): ReflectedTable { $name = $json->name; $type = $json->type; $columns = []; if (isset($json->columns) && is_array($json->columns)) { foreach ($json->columns as $column) { $columns[] = ReflectedColumn::fromJson($column); } } return new ReflectedTable($name, $type, $columns); } public function hasColumn(string $columnName): bool { return isset($this->columns[$columnName]); } public function hasPk(): bool { return $this->pk != null; } public function getPk() /*: ?ReflectedColumn */ { return $this->pk; } public function getName(): string { return $this->name; } public function getType(): string { return $this->type; } public function getColumnNames(): array { return array_keys($this->columns); } public function getColumn($columnName): ReflectedColumn { return $this->columns[$columnName]; } public function getFksTo(string $tableName): array { $columns = array(); foreach ($this->fks as $columnName => $referencedTableName) { if ($tableName == $referencedTableName) { $columns[] = $this->columns[$columnName]; } } return $columns; } public function removeColumn(string $columnName): bool { if (!isset($this->columns[$columnName])) { return false; } unset($this->columns[$columnName]); return true; } public function serialize() { return [ 'name' => $this->name, 'type' => $this->type, 'columns' => array_values($this->columns), ]; } public function jsonSerialize() { return $this->serialize(); } } // file: src/Tqdev/PhpCrudApi/Column/DefinitionService.php class DefinitionService { private $db; private $reflection; public function __construct(GenericDB $db, ReflectionService $reflection) { $this->db = $db; $this->reflection = $reflection; } public function updateTable(string $tableName, /* object */ $changes): bool { $table = $this->reflection->getTable($tableName); $newTable = ReflectedTable::fromJson((object) array_merge((array) $table->jsonSerialize(), (array) $changes)); if ($table->getName() != $newTable->getName()) { if (!$this->db->definition()->renameTable($table->getName(), $newTable->getName())) { return false; } } return true; } public function updateColumn(string $tableName, string $columnName, /* object */ $changes): bool { $table = $this->reflection->getTable($tableName); $column = $table->getColumn($columnName); $newColumn = ReflectedColumn::fromJson((object) array_merge((array) $column->jsonSerialize(), (array) $changes)); if ($newColumn->getPk() != $column->getPk() && $table->hasPk()) { $oldColumn = $table->getPk(); if ($oldColumn->getName() != $columnName) { $oldColumn->setPk(false); if (!$this->db->definition()->removeColumnPrimaryKey($table->getName(), $oldColumn->getName(), $oldColumn)) { return false; } } } $newColumn = ReflectedColumn::fromJson((object) array_merge((array) $column->jsonSerialize(), ['pk' => false, 'fk' => false])); if ($newColumn->getPk() != $column->getPk() && !$newColumn->getPk()) { if (!$this->db->definition()->removeColumnPrimaryKey($table->getName(), $column->getName(), $newColumn)) { return false; } } if ($newColumn->getFk() != $column->getFk() && !$newColumn->getFk()) { if (!$this->db->definition()->removeColumnForeignKey($table->getName(), $column->getName(), $newColumn)) { return false; } } $newColumn = ReflectedColumn::fromJson((object) array_merge((array) $column->jsonSerialize(), (array) $changes)); $newColumn->setPk(false); $newColumn->setFk(''); if ($newColumn->getName() != $column->getName()) { if (!$this->db->definition()->renameColumn($table->getName(), $column->getName(), $newColumn)) { return false; } } if ($newColumn->getType() != $column->getType() || $newColumn->getLength() != $column->getLength() || $newColumn->getPrecision() != $column->getPrecision() || $newColumn->getScale() != $column->getScale() ) { if (!$this->db->definition()->retypeColumn($table->getName(), $newColumn->getName(), $newColumn)) { return false; } } if ($newColumn->getNullable() != $column->getNullable()) { if (!$this->db->definition()->setColumnNullable($table->getName(), $newColumn->getName(), $newColumn)) { return false; } } $newColumn = ReflectedColumn::fromJson((object) array_merge((array) $column->jsonSerialize(), (array) $changes)); if ($newColumn->getFk()) { if (!$this->db->definition()->addColumnForeignKey($table->getName(), $newColumn->getName(), $newColumn)) { return false; } } if ($newColumn->getPk()) { if (!$this->db->definition()->addColumnPrimaryKey($table->getName(), $newColumn->getName(), $newColumn)) { return false; } } return true; } public function addTable( /* object */$definition) { $newTable = ReflectedTable::fromJson($definition); if (!$this->db->definition()->addTable($newTable)) { return false; } return true; } public function addColumn(string $tableName, /* object */ $definition) { $newColumn = ReflectedColumn::fromJson($definition); if (!$this->db->definition()->addColumn($tableName, $newColumn)) { return false; } if ($newColumn->getFk()) { if (!$this->db->definition()->addColumnForeignKey($tableName, $newColumn->getName(), $newColumn)) { return false; } } if ($newColumn->getPk()) { if (!$this->db->definition()->addColumnPrimaryKey($tableName, $newColumn->getName(), $newColumn)) { return false; } } return true; } public function removeTable(string $tableName) { if (!$this->db->definition()->removeTable($tableName)) { return false; } return true; } public function removeColumn(string $tableName, string $columnName) { $table = $this->reflection->getTable($tableName); $newColumn = $table->getColumn($columnName); if ($newColumn->getPk()) { $newColumn->setPk(false); if (!$this->db->definition()->removeColumnPrimaryKey($table->getName(), $newColumn->getName(), $newColumn)) { return false; } } if ($newColumn->getFk()) { $newColumn->setFk(""); if (!$this->db->definition()->removeColumnForeignKey($tableName, $columnName, $newColumn)) { return false; } } if (!$this->db->definition()->removeColumn($tableName, $columnName)) { return false; } return true; } } // file: src/Tqdev/PhpCrudApi/Column/ReflectionService.php class ReflectionService { private $db; private $cache; private $ttl; private $database; private $tables; public function __construct(GenericDB $db, Cache $cache, int $ttl) { $this->db = $db; $this->cache = $cache; $this->ttl = $ttl; $this->database = $this->loadDatabase(true); $this->tables = []; } private function loadDatabase(bool $useCache): ReflectedDatabase { $data = $useCache ? $this->cache->get('ReflectedDatabase') : ''; if ($data != '') { $database = ReflectedDatabase::fromJson(json_decode(gzuncompress($data))); } else { $database = ReflectedDatabase::fromReflection($this->db->reflection()); $data = gzcompress(json_encode($database, JSON_UNESCAPED_UNICODE)); $this->cache->set('ReflectedDatabase', $data, $this->ttl); } return $database; } private function loadTable(string $tableName, bool $useCache): ReflectedTable { $data = $useCache ? $this->cache->get("ReflectedTable($tableName)") : ''; if ($data != '') { $table = ReflectedTable::fromJson(json_decode(gzuncompress($data))); } else { $tableType = $this->database->getType($tableName); $table = ReflectedTable::fromReflection($this->db->reflection(), $tableName, $tableType); $data = gzcompress(json_encode($table, JSON_UNESCAPED_UNICODE)); $this->cache->set("ReflectedTable($tableName)", $data, $this->ttl); } return $table; } public function refreshTables() { $this->database = $this->loadDatabase(false); } public function refreshTable(string $tableName) { $this->tables[$tableName] = $this->loadTable($tableName, false); } public function hasTable(string $tableName): bool { return $this->database->hasTable($tableName); } public function getType(string $tableName): string { return $this->database->getType($tableName); } public function getTable(string $tableName): ReflectedTable { if (!isset($this->tables[$tableName])) { $this->tables[$tableName] = $this->loadTable($tableName, true); } return $this->tables[$tableName]; } public function getTableNames(): array { return $this->database->getTableNames(); } public function getDatabaseName(): string { return $this->database->getName(); } public function removeTable(string $tableName): bool { unset($this->tables[$tableName]); return $this->database->removeTable($tableName); } } // file: src/Tqdev/PhpCrudApi/Controller/CacheController.php class CacheController { private $cache; private $responder; public function __construct(Router $router, Responder $responder, Cache $cache) { $router->register('GET', '/cache/clear', array($this, 'clear')); $this->cache = $cache; $this->responder = $responder; } public function clear(ServerRequestInterface $request): ResponseInterface { return $this->responder->success($this->cache->clear()); } } // file: src/Tqdev/PhpCrudApi/Controller/ColumnController.php class ColumnController { private $responder; private $reflection; private $definition; public function __construct(Router $router, Responder $responder, ReflectionService $reflection, DefinitionService $definition) { $router->register('GET', '/columns', array($this, 'getDatabase')); $router->register('GET', '/columns/*', array($this, 'getTable')); $router->register('GET', '/columns/*/*', array($this, 'getColumn')); $router->register('PUT', '/columns/*', array($this, 'updateTable')); $router->register('PUT', '/columns/*/*', array($this, 'updateColumn')); $router->register('POST', '/columns', array($this, 'addTable')); $router->register('POST', '/columns/*', array($this, 'addColumn')); $router->register('DELETE', '/columns/*', array($this, 'removeTable')); $router->register('DELETE', '/columns/*/*', array($this, 'removeColumn')); $this->responder = $responder; $this->reflection = $reflection; $this->definition = $definition; } public function getDatabase(ServerRequestInterface $request): ResponseInterface { $tables = []; foreach ($this->reflection->getTableNames() as $table) { $tables[] = $this->reflection->getTable($table); } $database = ['tables' => $tables]; return $this->responder->success($database); } public function getTable(ServerRequestInterface $request): ResponseInterface { $tableName = RequestUtils::getPathSegment($request, 2); if (!$this->reflection->hasTable($tableName)) { return $this->responder->error(ErrorCode::TABLE_NOT_FOUND, $tableName); } $table = $this->reflection->getTable($tableName); return $this->responder->success($table); } public function getColumn(ServerRequestInterface $request): ResponseInterface { $tableName = RequestUtils::getPathSegment($request, 2); $columnName = RequestUtils::getPathSegment($request, 3); if (!$this->reflection->hasTable($tableName)) { return $this->responder->error(ErrorCode::TABLE_NOT_FOUND, $tableName); } $table = $this->reflection->getTable($tableName); if (!$table->hasColumn($columnName)) { return $this->responder->error(ErrorCode::COLUMN_NOT_FOUND, $columnName); } $column = $table->getColumn($columnName); return $this->responder->success($column); } public function updateTable(ServerRequestInterface $request): ResponseInterface { $tableName = RequestUtils::getPathSegment($request, 2); if (!$this->reflection->hasTable($tableName)) { return $this->responder->error(ErrorCode::TABLE_NOT_FOUND, $tableName); } $success = $this->definition->updateTable($tableName, $request->getParsedBody()); if ($success) { $this->reflection->refreshTables(); } return $this->responder->success($success); } public function updateColumn(ServerRequestInterface $request): ResponseInterface { $tableName = RequestUtils::getPathSegment($request, 2); $columnName = RequestUtils::getPathSegment($request, 3); if (!$this->reflection->hasTable($tableName)) { return $this->responder->error(ErrorCode::TABLE_NOT_FOUND, $tableName); } $table = $this->reflection->getTable($tableName); if (!$table->hasColumn($columnName)) { return $this->responder->error(ErrorCode::COLUMN_NOT_FOUND, $columnName); } $success = $this->definition->updateColumn($tableName, $columnName, $request->getParsedBody()); if ($success) { $this->reflection->refreshTable($tableName); } return $this->responder->success($success); } public function addTable(ServerRequestInterface $request): ResponseInterface { $tableName = $request->getParsedBody()->name; if ($this->reflection->hasTable($tableName)) { return $this->responder->error(ErrorCode::TABLE_ALREADY_EXISTS, $tableName); } $success = $this->definition->addTable($request->getParsedBody()); if ($success) { $this->reflection->refreshTables(); } return $this->responder->success($success); } public function addColumn(ServerRequestInterface $request): ResponseInterface { $tableName = RequestUtils::getPathSegment($request, 2); if (!$this->reflection->hasTable($tableName)) { return $this->responder->error(ErrorCode::TABLE_NOT_FOUND, $tableName); } $columnName = $request->getParsedBody()->name; $table = $this->reflection->getTable($tableName); if ($table->hasColumn($columnName)) { return $this->responder->error(ErrorCode::COLUMN_ALREADY_EXISTS, $columnName); } $success = $this->definition->addColumn($tableName, $request->getParsedBody()); if ($success) { $this->reflection->refreshTable($tableName); } return $this->responder->success($success); } public function removeTable(ServerRequestInterface $request): ResponseInterface { $tableName = RequestUtils::getPathSegment($request, 2); if (!$this->reflection->hasTable($tableName)) { return $this->responder->error(ErrorCode::TABLE_NOT_FOUND, $tableName); } $success = $this->definition->removeTable($tableName); if ($success) { $this->reflection->refreshTables(); } return $this->responder->success($success); } public function removeColumn(ServerRequestInterface $request): ResponseInterface { $tableName = RequestUtils::getPathSegment($request, 2); $columnName = RequestUtils::getPathSegment($request, 3); if (!$this->reflection->hasTable($tableName)) { return $this->responder->error(ErrorCode::TABLE_NOT_FOUND, $tableName); } $table = $this->reflection->getTable($tableName); if (!$table->hasColumn($columnName)) { return $this->responder->error(ErrorCode::COLUMN_NOT_FOUND, $columnName); } $success = $this->definition->removeColumn($tableName, $columnName); if ($success) { $this->reflection->refreshTable($tableName); } return $this->responder->success($success); } } // file: src/Tqdev/PhpCrudApi/Controller/GeoJsonController.php class GeoJsonController { private $service; private $responder; private $geoJsonConverter; public function __construct(Router $router, Responder $responder, GeoJsonService $service) { $router->register('GET', '/geojson/*', array($this, '_list')); $router->register('GET', '/geojson/*/*', array($this, 'read')); $this->service = $service; $this->responder = $responder; } public function _list(ServerRequestInterface $request): ResponseInterface { $table = RequestUtils::getPathSegment($request, 2); $params = RequestUtils::getParams($request); if (!$this->service->hasTable($table)) { return $this->responder->error(ErrorCode::TABLE_NOT_FOUND, $table); } return $this->responder->success($this->service->_list($table, $params)); } public function read(ServerRequestInterface $request): ResponseInterface { $table = RequestUtils::getPathSegment($request, 2); if (!$this->service->hasTable($table)) { return $this->responder->error(ErrorCode::TABLE_NOT_FOUND, $table); } if ($this->service->getType($table) != 'table') { return $this->responder->error(ErrorCode::OPERATION_NOT_SUPPORTED, __FUNCTION__); } $id = RequestUtils::getPathSegment($request, 3); $params = RequestUtils::getParams($request); if (strpos($id, ',') !== false) { $ids = explode(',', $id); $result = []; for ($i = 0; $i < count($ids); $i++) { array_push($result, $this->service->read($table, $ids[$i], $params)); } return $this->responder->success($result); } else { $response = $this->service->read($table, $id, $params); if ($response === null) { return $this->responder->error(ErrorCode::RECORD_NOT_FOUND, $id); } return $this->responder->success($response); } } } // file: src/Tqdev/PhpCrudApi/Controller/OpenApiController.php class OpenApiController { private $openApi; private $responder; public function __construct(Router $router, Responder $responder, OpenApiService $openApi) { $router->register('GET', '/openapi', array($this, 'openapi')); $this->openApi = $openApi; $this->responder = $responder; } public function openapi(ServerRequestInterface $request): ResponseInterface { return $this->responder->success($this->openApi->get()); } } // file: src/Tqdev/PhpCrudApi/Controller/RecordController.php class RecordController { private $service; private $responder; public function __construct(Router $router, Responder $responder, RecordService $service) { $router->register('GET', '/records/*', array($this, '_list')); $router->register('POST', '/records/*', array($this, 'create')); $router->register('GET', '/records/*/*', array($this, 'read')); $router->register('PUT', '/records/*/*', array($this, 'update')); $router->register('DELETE', '/records/*/*', array($this, 'delete')); $router->register('PATCH', '/records/*/*', array($this, 'increment')); $this->service = $service; $this->responder = $responder; } public function _list(ServerRequestInterface $request): ResponseInterface { $table = RequestUtils::getPathSegment($request, 2); $params = RequestUtils::getParams($request); if (!$this->service->hasTable($table)) { return $this->responder->error(ErrorCode::TABLE_NOT_FOUND, $table); } return $this->responder->success($this->service->_list($table, $params)); } public function read(ServerRequestInterface $request): ResponseInterface { $table = RequestUtils::getPathSegment($request, 2); if (!$this->service->hasTable($table)) { return $this->responder->error(ErrorCode::TABLE_NOT_FOUND, $table); } if ($this->service->getType($table) != 'table') { return $this->responder->error(ErrorCode::OPERATION_NOT_SUPPORTED, __FUNCTION__); } $id = RequestUtils::getPathSegment($request, 3); $params = RequestUtils::getParams($request); if (strpos($id, ',') !== false) { $ids = explode(',', $id); $result = []; for ($i = 0; $i < count($ids); $i++) { array_push($result, $this->service->read($table, $ids[$i], $params)); } return $this->responder->success($result); } else { $response = $this->service->read($table, $id, $params); if ($response === null) { return $this->responder->error(ErrorCode::RECORD_NOT_FOUND, $id); } return $this->responder->success($response); } } public function create(ServerRequestInterface $request): ResponseInterface { $table = RequestUtils::getPathSegment($request, 2); if (!$this->service->hasTable($table)) { return $this->responder->error(ErrorCode::TABLE_NOT_FOUND, $table); } if ($this->service->getType($table) != 'table') { return $this->responder->error(ErrorCode::OPERATION_NOT_SUPPORTED, __FUNCTION__); } $record = $request->getParsedBody(); if ($record === null) { return $this->responder->error(ErrorCode::HTTP_MESSAGE_NOT_READABLE, ''); } $params = RequestUtils::getParams($request); if (is_array($record)) { $result = array(); foreach ($record as $r) { $result[] = $this->service->create($table, $r, $params); } return $this->responder->success($result); } else { return $this->responder->success($this->service->create($table, $record, $params)); } } public function update(ServerRequestInterface $request): ResponseInterface { $table = RequestUtils::getPathSegment($request, 2); if (!$this->service->hasTable($table)) { return $this->responder->error(ErrorCode::TABLE_NOT_FOUND, $table); } if ($this->service->getType($table) != 'table') { return $this->responder->error(ErrorCode::OPERATION_NOT_SUPPORTED, __FUNCTION__); } $id = RequestUtils::getPathSegment($request, 3); $params = RequestUtils::getParams($request); $record = $request->getParsedBody(); if ($record === null) { return $this->responder->error(ErrorCode::HTTP_MESSAGE_NOT_READABLE, ''); } $ids = explode(',', $id); if (is_array($record)) { if (count($ids) != count($record)) { return $this->responder->error(ErrorCode::ARGUMENT_COUNT_MISMATCH, $id); } $result = array(); for ($i = 0; $i < count($ids); $i++) { $result[] = $this->service->update($table, $ids[$i], $record[$i], $params); } return $this->responder->success($result); } else { if (count($ids) != 1) { return $this->responder->error(ErrorCode::ARGUMENT_COUNT_MISMATCH, $id); } return $this->responder->success($this->service->update($table, $id, $record, $params)); } } public function delete(ServerRequestInterface $request): ResponseInterface { $table = RequestUtils::getPathSegment($request, 2); if (!$this->service->hasTable($table)) { return $this->responder->error(ErrorCode::TABLE_NOT_FOUND, $table); } if ($this->service->getType($table) != 'table') { return $this->responder->error(ErrorCode::OPERATION_NOT_SUPPORTED, __FUNCTION__); } $id = RequestUtils::getPathSegment($request, 3); $params = RequestUtils::getParams($request); $ids = explode(',', $id); if (count($ids) > 1) { $result = array(); for ($i = 0; $i < count($ids); $i++) { $result[] = $this->service->delete($table, $ids[$i], $params); } return $this->responder->success($result); } else { return $this->responder->success($this->service->delete($table, $id, $params)); } } public function increment(ServerRequestInterface $request): ResponseInterface { $table = RequestUtils::getPathSegment($request, 2); if (!$this->service->hasTable($table)) { return $this->responder->error(ErrorCode::TABLE_NOT_FOUND, $table); } if ($this->service->getType($table) != 'table') { return $this->responder->error(ErrorCode::OPERATION_NOT_SUPPORTED, __FUNCTION__); } $id = RequestUtils::getPathSegment($request, 3); $record = $request->getParsedBody(); if ($record === null) { return $this->responder->error(ErrorCode::HTTP_MESSAGE_NOT_READABLE, ''); } $params = RequestUtils::getParams($request); $ids = explode(',', $id); if (is_array($record)) { if (count($ids) != count($record)) { return $this->responder->error(ErrorCode::ARGUMENT_COUNT_MISMATCH, $id); } $result = array(); for ($i = 0; $i < count($ids); $i++) { $result[] = $this->service->increment($table, $ids[$i], $record[$i], $params); } return $this->responder->success($result); } else { if (count($ids) != 1) { return $this->responder->error(ErrorCode::ARGUMENT_COUNT_MISMATCH, $id); } return $this->responder->success($this->service->increment($table, $id, $record, $params)); } } } // file: src/Tqdev/PhpCrudApi/Controller/Responder.php class Responder { public function error(int $error, string $argument, $details = null): ResponseInterface { $errorCode = new ErrorCode($error); $status = $errorCode->getStatus(); $document = new ErrorDocument($errorCode, $argument, $details); return ResponseFactory::fromObject($status, $document); } public function success($result): ResponseInterface { return ResponseFactory::fromObject(ResponseFactory::OK, $result); } } // file: src/Tqdev/PhpCrudApi/Database/ColumnConverter.php class ColumnConverter { private $driver; public function __construct(string $driver) { $this->driver = $driver; } public function convertColumnValue(ReflectedColumn $column): string { if ($column->isBinary()) { switch ($this->driver) { case 'mysql': return "FROM_BASE64(?)"; case 'pgsql': return "decode(?, 'base64')"; case 'sqlsrv': return "CONVERT(XML, ?).value('.','varbinary(max)')"; } } if ($column->isGeometry()) { switch ($this->driver) { case 'mysql': case 'pgsql': return "ST_GeomFromText(?)"; case 'sqlsrv': return "geometry::STGeomFromText(?,0)"; } } return '?'; } public function convertColumnName(ReflectedColumn $column, $value): string { if ($column->isBinary()) { switch ($this->driver) { case 'mysql': return "TO_BASE64($value) as $value"; case 'pgsql': return "encode($value::bytea, 'base64') as $value"; case 'sqlsrv': return "CASE WHEN $value IS NULL THEN NULL ELSE (SELECT CAST($value as varbinary(max)) FOR XML PATH(''), BINARY BASE64) END as $value"; } } if ($column->isGeometry()) { switch ($this->driver) { case 'mysql': case 'pgsql': return "ST_AsText($value) as $value"; case 'sqlsrv': return "REPLACE($value.STAsText(),' (','(') as $value"; } } return $value; } } // file: src/Tqdev/PhpCrudApi/Database/ColumnsBuilder.php class ColumnsBuilder { private $driver; private $converter; public function __construct(string $driver) { $this->driver = $driver; $this->converter = new ColumnConverter($driver); } public function getOffsetLimit(int $offset, int $limit): string { if ($limit < 0 || $offset < 0) { return ''; } switch ($this->driver) { case 'mysql':return " LIMIT $offset, $limit"; case 'pgsql':return " LIMIT $limit OFFSET $offset"; case 'sqlsrv':return " OFFSET $offset ROWS FETCH NEXT $limit ROWS ONLY"; } } private function quoteColumnName(ReflectedColumn $column): string { return '"' . $column->getName() . '"'; } public function getOrderBy(ReflectedTable $table, array $columnOrdering): string { if (count($columnOrdering) == 0) { return ''; } $results = array(); foreach ($columnOrdering as $i => list($columnName, $ordering)) { $column = $table->getColumn($columnName); $quotedColumnName = $this->quoteColumnName($column); $results[] = $quotedColumnName . ' ' . $ordering; } return ' ORDER BY ' . implode(',', $results); } public function getSelect(ReflectedTable $table, array $columnNames): string { $results = array(); foreach ($columnNames as $columnName) { $column = $table->getColumn($columnName); $quotedColumnName = $this->quoteColumnName($column); $quotedColumnName = $this->converter->convertColumnName($column, $quotedColumnName); $results[] = $quotedColumnName; } return implode(',', $results); } public function getInsert(ReflectedTable $table, array $columnValues): string { $columns = array(); $values = array(); foreach ($columnValues as $columnName => $columnValue) { $column = $table->getColumn($columnName); $quotedColumnName = $this->quoteColumnName($column); $columns[] = $quotedColumnName; $columnValue = $this->converter->convertColumnValue($column); $values[] = $columnValue; } $columnsSql = '(' . implode(',', $columns) . ')'; $valuesSql = '(' . implode(',', $values) . ')'; $outputColumn = $this->quoteColumnName($table->getPk()); switch ($this->driver) { case 'mysql':return "$columnsSql VALUES $valuesSql"; case 'pgsql':return "$columnsSql VALUES $valuesSql RETURNING $outputColumn"; case 'sqlsrv':return "$columnsSql OUTPUT INSERTED.$outputColumn VALUES $valuesSql"; } } public function getUpdate(ReflectedTable $table, array $columnValues): string { $results = array(); foreach ($columnValues as $columnName => $columnValue) { $column = $table->getColumn($columnName); $quotedColumnName = $this->quoteColumnName($column); $columnValue = $this->converter->convertColumnValue($column); $results[] = $quotedColumnName . '=' . $columnValue; } return implode(',', $results); } public function getIncrement(ReflectedTable $table, array $columnValues): string { $results = array(); foreach ($columnValues as $columnName => $columnValue) { if (!is_numeric($columnValue)) { continue; } $column = $table->getColumn($columnName); $quotedColumnName = $this->quoteColumnName($column); $columnValue = $this->converter->convertColumnValue($column); $results[] = $quotedColumnName . '=' . $quotedColumnName . '+' . $columnValue; } return implode(',', $results); } } // file: src/Tqdev/PhpCrudApi/Database/ConditionsBuilder.php class ConditionsBuilder { private $driver; public function __construct(string $driver) { $this->driver = $driver; } private function getConditionSql(Condition $condition, array &$arguments): string { if ($condition instanceof AndCondition) { return $this->getAndConditionSql($condition, $arguments); } if ($condition instanceof OrCondition) { return $this->getOrConditionSql($condition, $arguments); } if ($condition instanceof NotCondition) { return $this->getNotConditionSql($condition, $arguments); } if ($condition instanceof SpatialCondition) { return $this->getSpatialConditionSql($condition, $arguments); } if ($condition instanceof ColumnCondition) { return $this->getColumnConditionSql($condition, $arguments); } throw new \Exception('Unknown Condition: ' . get_class($condition)); } private function getAndConditionSql(AndCondition $and, array &$arguments): string { $parts = []; foreach ($and->getConditions() as $condition) { $parts[] = $this->getConditionSql($condition, $arguments); } return '(' . implode(' AND ', $parts) . ')'; } private function getOrConditionSql(OrCondition $or, array &$arguments): string { $parts = []; foreach ($or->getConditions() as $condition) { $parts[] = $this->getConditionSql($condition, $arguments); } return '(' . implode(' OR ', $parts) . ')'; } private function getNotConditionSql(NotCondition $not, array &$arguments): string { $condition = $not->getCondition(); return '(NOT ' . $this->getConditionSql($condition, $arguments) . ')'; } private function quoteColumnName(ReflectedColumn $column): string { return '"' . $column->getName() . '"'; } private function escapeLikeValue(string $value): string { return addcslashes($value, '%_'); } private function getColumnConditionSql(ColumnCondition $condition, array &$arguments): string { $column = $this->quoteColumnName($condition->getColumn()); $operator = $condition->getOperator(); $value = $condition->getValue(); switch ($operator) { case 'cs': $sql = "$column LIKE ?"; $arguments[] = '%' . $this->escapeLikeValue($value) . '%'; break; case 'sw': $sql = "$column LIKE ?"; $arguments[] = $this->escapeLikeValue($value) . '%'; break; case 'ew': $sql = "$column LIKE ?"; $arguments[] = '%' . $this->escapeLikeValue($value); break; case 'eq': $sql = "$column = ?"; $arguments[] = $value; break; case 'lt': $sql = "$column < ?"; $arguments[] = $value; break; case 'le': $sql = "$column <= ?"; $arguments[] = $value; break; case 'ge': $sql = "$column >= ?"; $arguments[] = $value; break; case 'gt': $sql = "$column > ?"; $arguments[] = $value; break; case 'bt': $parts = explode(',', $value, 2); $count = count($parts); if ($count == 2) { $sql = "($column >= ? AND $column <= ?)"; $arguments[] = $parts[0]; $arguments[] = $parts[1]; } else { $sql = "FALSE"; } break; case 'in': $parts = explode(',', $value); $count = count($parts); if ($count > 0) { $qmarks = implode(',', str_split(str_repeat('?', $count))); $sql = "$column IN ($qmarks)"; for ($i = 0; $i < $count; $i++) { $arguments[] = $parts[$i]; } } else { $sql = "FALSE"; } break; case 'is': $sql = "$column IS NULL"; break; } return $sql; } private function getSpatialFunctionName(string $operator): string { switch ($operator) { case 'co':return 'ST_Contains'; case 'cr':return 'ST_Crosses'; case 'di':return 'ST_Disjoint'; case 'eq':return 'ST_Equals'; case 'in':return 'ST_Intersects'; case 'ov':return 'ST_Overlaps'; case 'to':return 'ST_Touches'; case 'wi':return 'ST_Within'; case 'ic':return 'ST_IsClosed'; case 'is':return 'ST_IsSimple'; case 'iv':return 'ST_IsValid'; } } private function hasSpatialArgument(string $operator): bool { return in_array($operator, ['ic', 'is', 'iv']) ? false : true; } private function getSpatialFunctionCall(string $functionName, string $column, bool $hasArgument): string { switch ($this->driver) { case 'mysql': case 'pgsql': $argument = $hasArgument ? 'ST_GeomFromText(?)' : ''; return "$functionName($column, $argument)=TRUE"; case 'sqlsrv': $functionName = str_replace('ST_', 'ST', $functionName); $argument = $hasArgument ? 'geometry::STGeomFromText(?,0)' : ''; return "$column.$functionName($argument)=1"; } } private function getSpatialConditionSql(ColumnCondition $condition, array &$arguments): string { $column = $this->quoteColumnName($condition->getColumn()); $operator = $condition->getOperator(); $value = $condition->getValue(); $functionName = $this->getSpatialFunctionName($operator); $hasArgument = $this->hasSpatialArgument($operator); $sql = $this->getSpatialFunctionCall($functionName, $column, $hasArgument); if ($hasArgument) { $arguments[] = $value; } return $sql; } public function getWhereClause(Condition $condition, array &$arguments): string { if ($condition instanceof NoCondition) { return ''; } return ' WHERE ' . $this->getConditionSql($condition, $arguments); } } // file: src/Tqdev/PhpCrudApi/Database/DataConverter.php class DataConverter { private $driver; public function __construct(string $driver) { $this->driver = $driver; } private function convertRecordValue($conversion, $value) { switch ($conversion) { case 'boolean': return $value ? true : false; case 'integer': return (int) $value; } return $value; } private function getRecordValueConversion(ReflectedColumn $column): string { if (in_array($this->driver, ['mysql', 'sqlsrv']) && $column->isBoolean()) { return 'boolean'; } if ($this->driver == 'sqlsrv' && $column->getType() == 'bigint') { return 'integer'; } return 'none'; } public function convertRecords(ReflectedTable $table, array $columnNames, array &$records) /*: void*/ { foreach ($columnNames as $columnName) { $column = $table->getColumn($columnName); $conversion = $this->getRecordValueConversion($column); if ($conversion != 'none') { foreach ($records as $i => $record) { $value = $records[$i][$columnName]; if ($value === null) { continue; } $records[$i][$columnName] = $this->convertRecordValue($conversion, $value); } } } } private function convertInputValue($conversion, $value) { switch ($conversion) { case 'base64url_to_base64': return str_pad(strtr($value, '-_', '+/'), ceil(strlen($value) / 4) * 4, '=', STR_PAD_RIGHT); } return $value; } private function getInputValueConversion(ReflectedColumn $column): string { if ($column->isBinary()) { return 'base64url_to_base64'; } return 'none'; } public function convertColumnValues(ReflectedTable $table, array &$columnValues) /*: void*/ { $columnNames = array_keys($columnValues); foreach ($columnNames as $columnName) { $column = $table->getColumn($columnName); $conversion = $this->getInputValueConversion($column); if ($conversion != 'none') { $value = $columnValues[$columnName]; if ($value !== null) { $columnValues[$columnName] = $this->convertInputValue($conversion, $value); } } } } } // file: src/Tqdev/PhpCrudApi/Database/GenericDB.php class GenericDB { private $driver; private $database; private $pdo; private $reflection; private $definition; private $conditions; private $columns; private $converter; private function getDsn(string $address, int $port, string $database): string { switch ($this->driver) { case 'mysql':return "$this->driver:host=$address;port=$port;dbname=$database;charset=utf8mb4"; case 'pgsql':return "$this->driver:host=$address port=$port dbname=$database options='--client_encoding=UTF8'"; case 'sqlsrv':return "$this->driver:Server=$address,$port;Database=$database"; } } private function getCommands(): array { switch ($this->driver) { case 'mysql':return [ 'SET SESSION sql_warnings=1;', 'SET NAMES utf8mb4;', 'SET SESSION sql_mode = "ANSI,TRADITIONAL";', ]; case 'pgsql':return [ "SET NAMES 'UTF8';", ]; case 'sqlsrv':return [ ]; } } private function getOptions(): array { $options = array( \PDO::ATTR_ERRMODE => \PDO::ERRMODE_EXCEPTION, \PDO::ATTR_DEFAULT_FETCH_MODE => \PDO::FETCH_ASSOC, ); switch ($this->driver) { case 'mysql':return $options + [ \PDO::ATTR_EMULATE_PREPARES => false, \PDO::MYSQL_ATTR_FOUND_ROWS => true, \PDO::ATTR_PERSISTENT => true, ]; case 'pgsql':return $options + [ \PDO::ATTR_EMULATE_PREPARES => false, \PDO::ATTR_PERSISTENT => true, ]; case 'sqlsrv':return $options + [ \PDO::SQLSRV_ATTR_DIRECT_QUERY => false, \PDO::SQLSRV_ATTR_FETCHES_NUMERIC_TYPE => true, ]; } } public function __construct(string $driver, string $address, int $port, string $database, string $username, string $password) { $this->driver = $driver; $this->database = $database; $dsn = $this->getDsn($address, $port, $database); $options = $this->getOptions(); $this->pdo = new \PDO($dsn, $username, $password, $options); $commands = $this->getCommands(); foreach ($commands as $command) { $this->pdo->query($command); } $this->reflection = new GenericReflection($this->pdo, $driver, $database); $this->definition = new GenericDefinition($this->pdo, $driver, $database); $this->conditions = new ConditionsBuilder($driver); $this->columns = new ColumnsBuilder($driver); $this->converter = new DataConverter($driver); } public function pdo(): \PDO { return $this->pdo; } public function reflection(): GenericReflection { return $this->reflection; } public function definition(): GenericDefinition { return $this->definition; } private function addMiddlewareConditions(string $tableName, Condition $condition): Condition { $condition1 = VariableStore::get("authorization.conditions.$tableName"); if ($condition1) { $condition = $condition->_and($condition1); } $condition2 = VariableStore::get("multiTenancy.conditions.$tableName"); if ($condition2) { $condition = $condition->_and($condition2); } return $condition; } public function createSingle(ReflectedTable $table, array $columnValues) /*: ?String*/ { $this->converter->convertColumnValues($table, $columnValues); $insertColumns = $this->columns->getInsert($table, $columnValues); $tableName = $table->getName(); $pkName = $table->getPk()->getName(); $parameters = array_values($columnValues); $sql = 'INSERT INTO "' . $tableName . '" ' . $insertColumns; $stmt = $this->query($sql, $parameters); if (isset($columnValues[$pkName])) { return $columnValues[$pkName]; } switch ($this->driver) { case 'mysql': $stmt = $this->query('SELECT LAST_INSERT_ID()', []); break; } $pkValue = $stmt->fetchColumn(0); if ($this->driver == 'sqlsrv' && $table->getPk()->getType() == 'bigint') { return (int) $pkValue; } return $pkValue; } public function selectSingle(ReflectedTable $table, array $columnNames, string $id) /*: ?array*/ { $selectColumns = $this->columns->getSelect($table, $columnNames); $tableName = $table->getName(); $condition = new ColumnCondition($table->getPk(), 'eq', $id); $condition = $this->addMiddlewareConditions($tableName, $condition); $parameters = array(); $whereClause = $this->conditions->getWhereClause($condition, $parameters); $sql = 'SELECT ' . $selectColumns . ' FROM "' . $tableName . '" ' . $whereClause; $stmt = $this->query($sql, $parameters); $record = $stmt->fetch() ?: null; if ($record === null) { return null; } $records = array($record); $this->converter->convertRecords($table, $columnNames, $records); return $records[0]; } public function selectMultiple(ReflectedTable $table, array $columnNames, array $ids): array { if (count($ids) == 0) { return []; } $selectColumns = $this->columns->getSelect($table, $columnNames); $tableName = $table->getName(); $condition = new ColumnCondition($table->getPk(), 'in', implode(',', $ids)); $condition = $this->addMiddlewareConditions($tableName, $condition); $parameters = array(); $whereClause = $this->conditions->getWhereClause($condition, $parameters); $sql = 'SELECT ' . $selectColumns . ' FROM "' . $tableName . '" ' . $whereClause; $stmt = $this->query($sql, $parameters); $records = $stmt->fetchAll(); $this->converter->convertRecords($table, $columnNames, $records); return $records; } public function selectCount(ReflectedTable $table, Condition $condition): int { $tableName = $table->getName(); $condition = $this->addMiddlewareConditions($tableName, $condition); $parameters = array(); $whereClause = $this->conditions->getWhereClause($condition, $parameters); $sql = 'SELECT COUNT(*) FROM "' . $tableName . '"' . $whereClause; $stmt = $this->query($sql, $parameters); return $stmt->fetchColumn(0); } public function selectAll(ReflectedTable $table, array $columnNames, Condition $condition, array $columnOrdering, int $offset, int $limit): array { if ($limit == 0) { return array(); } $selectColumns = $this->columns->getSelect($table, $columnNames); $tableName = $table->getName(); $condition = $this->addMiddlewareConditions($tableName, $condition); $parameters = array(); $whereClause = $this->conditions->getWhereClause($condition, $parameters); $orderBy = $this->columns->getOrderBy($table, $columnOrdering); $offsetLimit = $this->columns->getOffsetLimit($offset, $limit); $sql = 'SELECT ' . $selectColumns . ' FROM "' . $tableName . '"' . $whereClause . $orderBy . $offsetLimit; $stmt = $this->query($sql, $parameters); $records = $stmt->fetchAll(); $this->converter->convertRecords($table, $columnNames, $records); return $records; } public function updateSingle(ReflectedTable $table, array $columnValues, string $id) { if (count($columnValues) == 0) { return 0; } $this->converter->convertColumnValues($table, $columnValues); $updateColumns = $this->columns->getUpdate($table, $columnValues); $tableName = $table->getName(); $condition = new ColumnCondition($table->getPk(), 'eq', $id); $condition = $this->addMiddlewareConditions($tableName, $condition); $parameters = array_values($columnValues); $whereClause = $this->conditions->getWhereClause($condition, $parameters); $sql = 'UPDATE "' . $tableName . '" SET ' . $updateColumns . $whereClause; $stmt = $this->query($sql, $parameters); return $stmt->rowCount(); } public function deleteSingle(ReflectedTable $table, string $id) { $tableName = $table->getName(); $condition = new ColumnCondition($table->getPk(), 'eq', $id); $condition = $this->addMiddlewareConditions($tableName, $condition); $parameters = array(); $whereClause = $this->conditions->getWhereClause($condition, $parameters); $sql = 'DELETE FROM "' . $tableName . '" ' . $whereClause; $stmt = $this->query($sql, $parameters); return $stmt->rowCount(); } public function incrementSingle(ReflectedTable $table, array $columnValues, string $id) { if (count($columnValues) == 0) { return 0; } $this->converter->convertColumnValues($table, $columnValues); $updateColumns = $this->columns->getIncrement($table, $columnValues); $tableName = $table->getName(); $condition = new ColumnCondition($table->getPk(), 'eq', $id); $condition = $this->addMiddlewareConditions($tableName, $condition); $parameters = array_values($columnValues); $whereClause = $this->conditions->getWhereClause($condition, $parameters); $sql = 'UPDATE "' . $tableName . '" SET ' . $updateColumns . $whereClause; $stmt = $this->query($sql, $parameters); return $stmt->rowCount(); } private function query(string $sql, array $parameters): \PDOStatement { $stmt = $this->pdo->prepare($sql); $stmt->execute($parameters); return $stmt; } } // file: src/Tqdev/PhpCrudApi/Database/GenericDefinition.php class GenericDefinition { private $pdo; private $driver; private $database; private $typeConverter; private $reflection; public function __construct(\PDO $pdo, string $driver, string $database) { $this->pdo = $pdo; $this->driver = $driver; $this->database = $database; $this->typeConverter = new TypeConverter($driver); $this->reflection = new GenericReflection($pdo, $driver, $database); } private function quote(string $identifier): string { return '"' . str_replace('"', '', $identifier) . '"'; } public function getColumnType(ReflectedColumn $column, bool $update): string { if ($this->driver == 'pgsql' && !$update && $column->getPk() && $this->canAutoIncrement($column)) { return 'serial'; } $type = $this->typeConverter->fromJdbc($column->getType()); if ($column->hasPrecision() && $column->hasScale()) { $size = '(' . $column->getPrecision() . ',' . $column->getScale() . ')'; } else if ($column->hasPrecision()) { $size = '(' . $column->getPrecision() . ')'; } else if ($column->hasLength()) { $size = '(' . $column->getLength() . ')'; } else { $size = ''; } $null = $this->getColumnNullType($column, $update); $auto = $this->getColumnAutoIncrement($column, $update); return $type . $size . $null . $auto; } private function getPrimaryKey(string $tableName): string { $pks = $this->reflection->getTablePrimaryKeys($tableName); if (count($pks) == 1) { return $pks[0]; } return ""; } private function canAutoIncrement(ReflectedColumn $column): bool { return in_array($column->getType(), ['integer', 'bigint']); } private function getColumnAutoIncrement(ReflectedColumn $column, bool $update): string { if (!$this->canAutoIncrement($column)) { return ''; } switch ($this->driver) { case 'mysql': return $column->getPk() ? ' AUTO_INCREMENT' : ''; case 'pgsql': case 'sqlsrv': return ''; } } private function getColumnNullType(ReflectedColumn $column, bool $update): string { if ($this->driver == 'pgsql' && $update) { return ''; } return $column->getNullable() ? ' NULL' : ' NOT NULL'; } private function getTableRenameSQL(string $tableName, string $newTableName): string { $p1 = $this->quote($tableName); $p2 = $this->quote($newTableName); switch ($this->driver) { case 'mysql': return "RENAME TABLE $p1 TO $p2"; case 'pgsql': return "ALTER TABLE $p1 RENAME TO $p2"; case 'sqlsrv': return "EXEC sp_rename $p1, $p2"; } } private function getColumnRenameSQL(string $tableName, string $columnName, ReflectedColumn $newColumn): string { $p1 = $this->quote($tableName); $p2 = $this->quote($columnName); $p3 = $this->quote($newColumn->getName()); switch ($this->driver) { case 'mysql': $p4 = $this->getColumnType($newColumn, true); return "ALTER TABLE $p1 CHANGE $p2 $p3 $p4"; case 'pgsql': return "ALTER TABLE $p1 RENAME COLUMN $p2 TO $p3"; case 'sqlsrv': $p4 = $this->quote($tableName . '.' . $columnName); return "EXEC sp_rename $p4, $p3, 'COLUMN'"; } } private function getColumnRetypeSQL(string $tableName, string $columnName, ReflectedColumn $newColumn): string { $p1 = $this->quote($tableName); $p2 = $this->quote($columnName); $p3 = $this->quote($newColumn->getName()); $p4 = $this->getColumnType($newColumn, true); switch ($this->driver) { case 'mysql': return "ALTER TABLE $p1 CHANGE $p2 $p3 $p4"; case 'pgsql': return "ALTER TABLE $p1 ALTER COLUMN $p3 TYPE $p4"; case 'sqlsrv': return "ALTER TABLE $p1 ALTER COLUMN $p3 $p4"; } } private function getSetColumnNullableSQL(string $tableName, string $columnName, ReflectedColumn $newColumn): string { $p1 = $this->quote($tableName); $p2 = $this->quote($columnName); $p3 = $this->quote($newColumn->getName()); $p4 = $this->getColumnType($newColumn, true); switch ($this->driver) { case 'mysql': return "ALTER TABLE $p1 CHANGE $p2 $p3 $p4"; case 'pgsql': $p5 = $newColumn->getNullable() ? 'DROP NOT NULL' : 'SET NOT NULL'; return "ALTER TABLE $p1 ALTER COLUMN $p2 $p5"; case 'sqlsrv': return "ALTER TABLE $p1 ALTER COLUMN $p2 $p4"; } } private function getSetColumnPkConstraintSQL(string $tableName, string $columnName, ReflectedColumn $newColumn): string { $p1 = $this->quote($tableName); $p2 = $this->quote($columnName); $p3 = $this->quote($tableName . '_pkey'); switch ($this->driver) { case 'mysql': $p4 = $newColumn->getPk() ? "ADD PRIMARY KEY ($p2)" : 'DROP PRIMARY KEY'; return "ALTER TABLE $p1 $p4"; case 'pgsql': case 'sqlsrv': $p4 = $newColumn->getPk() ? "ADD CONSTRAINT $p3 PRIMARY KEY ($p2)" : "DROP CONSTRAINT $p3"; return "ALTER TABLE $p1 $p4"; } } private function getSetColumnPkSequenceSQL(string $tableName, string $columnName, ReflectedColumn $newColumn): string { $p1 = $this->quote($tableName); $p2 = $this->quote($columnName); $p3 = $this->quote($tableName . '_' . $columnName . '_seq'); switch ($this->driver) { case 'mysql': return "select 1"; case 'pgsql': return $newColumn->getPk() ? "CREATE SEQUENCE $p3 OWNED BY $p1.$p2" : "DROP SEQUENCE $p3"; case 'sqlsrv': return $newColumn->getPk() ? "CREATE SEQUENCE $p3" : "DROP SEQUENCE $p3"; } } private function getSetColumnPkSequenceStartSQL(string $tableName, string $columnName, ReflectedColumn $newColumn): string { $p1 = $this->quote($tableName); $p2 = $this->quote($columnName); switch ($this->driver) { case 'mysql': return "select 1"; case 'pgsql': $p3 = $this->pdo->quote($tableName . '_' . $columnName . '_seq'); return "SELECT setval($p3, (SELECT max($p2)+1 FROM $p1));"; case 'sqlsrv': $p3 = $this->quote($tableName . '_' . $columnName . '_seq'); $p4 = $this->pdo->query("SELECT max($p2)+1 FROM $p1")->fetchColumn(); return "ALTER SEQUENCE $p3 RESTART WITH $p4"; } } private function getSetColumnPkDefaultSQL(string $tableName, string $columnName, ReflectedColumn $newColumn): string { $p1 = $this->quote($tableName); $p2 = $this->quote($columnName); switch ($this->driver) { case 'mysql': $p3 = $this->quote($newColumn->getName()); $p4 = $this->getColumnType($newColumn, true); return "ALTER TABLE $p1 CHANGE $p2 $p3 $p4"; case 'pgsql': if ($newColumn->getPk()) { $p3 = $this->pdo->quote($tableName . '_' . $columnName . '_seq'); $p4 = "SET DEFAULT nextval($p3)"; } else { $p4 = 'DROP DEFAULT'; } return "ALTER TABLE $p1 ALTER COLUMN $p2 $p4"; case 'sqlsrv': $p3 = $this->quote($tableName . '_' . $columnName . '_seq'); $p4 = $this->quote($tableName . '_' . $columnName . '_def'); if ($newColumn->getPk()) { return "ALTER TABLE $p1 ADD CONSTRAINT $p4 DEFAULT NEXT VALUE FOR $p3 FOR $p2"; } else { return "ALTER TABLE $p1 DROP CONSTRAINT $p4"; } } } private function getAddColumnFkConstraintSQL(string $tableName, string $columnName, ReflectedColumn $newColumn): string { $p1 = $this->quote($tableName); $p2 = $this->quote($columnName); $p3 = $this->quote($tableName . '_' . $columnName . '_fkey'); $p4 = $this->quote($newColumn->getFk()); $p5 = $this->quote($this->getPrimaryKey($newColumn->getFk())); return "ALTER TABLE $p1 ADD CONSTRAINT $p3 FOREIGN KEY ($p2) REFERENCES $p4 ($p5)"; } private function getRemoveColumnFkConstraintSQL(string $tableName, string $columnName, ReflectedColumn $newColumn): string { $p1 = $this->quote($tableName); $p2 = $this->quote($tableName . '_' . $columnName . '_fkey'); switch ($this->driver) { case 'mysql': return "ALTER TABLE $p1 DROP FOREIGN KEY $p2"; case 'pgsql': case 'sqlsrv': return "ALTER TABLE $p1 DROP CONSTRAINT $p2"; } } private function getAddTableSQL(ReflectedTable $newTable): string { $tableName = $newTable->getName(); $p1 = $this->quote($tableName); $fields = []; $constraints = []; foreach ($newTable->getColumnNames() as $columnName) { $pkColumn = $this->getPrimaryKey($tableName); $newColumn = $newTable->getColumn($columnName); $f1 = $this->quote($columnName); $f2 = $this->getColumnType($newColumn, false); $f3 = $this->quote($tableName . '_' . $columnName . '_fkey'); $f4 = $this->quote($newColumn->getFk()); $f5 = $this->quote($this->getPrimaryKey($newColumn->getFk())); $f6 = $this->quote($tableName . '_' . $pkColumn . '_pkey'); $fields[] = "$f1 $f2"; if ($newColumn->getPk()) { $constraints[] = "CONSTRAINT $f6 PRIMARY KEY ($f1)"; } if ($newColumn->getFk()) { $constraints[] = "CONSTRAINT $f3 FOREIGN KEY ($f1) REFERENCES $f4 ($f5)"; } } $p2 = implode(',', array_merge($fields, $constraints)); return "CREATE TABLE $p1 ($p2);"; } private function getAddColumnSQL(string $tableName, ReflectedColumn $newColumn): string { $p1 = $this->quote($tableName); $p2 = $this->quote($newColumn->getName()); $p3 = $this->getColumnType($newColumn, false); switch ($this->driver) { case 'mysql': case 'pgsql': return "ALTER TABLE $p1 ADD COLUMN $p2 $p3"; case 'sqlsrv': return "ALTER TABLE $p1 ADD $p2 $p3"; } } private function getRemoveTableSQL(string $tableName): string { $p1 = $this->quote($tableName); switch ($this->driver) { case 'mysql': case 'pgsql': return "DROP TABLE $p1 CASCADE;"; case 'sqlsrv': return "DROP TABLE $p1;"; } } private function getRemoveColumnSQL(string $tableName, string $columnName): string { $p1 = $this->quote($tableName); $p2 = $this->quote($columnName); switch ($this->driver) { case 'mysql': case 'pgsql': return "ALTER TABLE $p1 DROP COLUMN $p2 CASCADE;"; case 'sqlsrv': return "ALTER TABLE $p1 DROP COLUMN $p2;"; } } public function renameTable(string $tableName, string $newTableName) { $sql = $this->getTableRenameSQL($tableName, $newTableName); return $this->query($sql); } public function renameColumn(string $tableName, string $columnName, ReflectedColumn $newColumn) { $sql = $this->getColumnRenameSQL($tableName, $columnName, $newColumn); return $this->query($sql); } public function retypeColumn(string $tableName, string $columnName, ReflectedColumn $newColumn) { $sql = $this->getColumnRetypeSQL($tableName, $columnName, $newColumn); return $this->query($sql); } public function setColumnNullable(string $tableName, string $columnName, ReflectedColumn $newColumn) { $sql = $this->getSetColumnNullableSQL($tableName, $columnName, $newColumn); return $this->query($sql); } public function addColumnPrimaryKey(string $tableName, string $columnName, ReflectedColumn $newColumn) { $sql = $this->getSetColumnPkConstraintSQL($tableName, $columnName, $newColumn); $this->query($sql); if ($this->canAutoIncrement($newColumn)) { $sql = $this->getSetColumnPkSequenceSQL($tableName, $columnName, $newColumn); $this->query($sql); $sql = $this->getSetColumnPkSequenceStartSQL($tableName, $columnName, $newColumn); $this->query($sql); $sql = $this->getSetColumnPkDefaultSQL($tableName, $columnName, $newColumn); $this->query($sql); } return true; } public function removeColumnPrimaryKey(string $tableName, string $columnName, ReflectedColumn $newColumn) { if ($this->canAutoIncrement($newColumn)) { $sql = $this->getSetColumnPkDefaultSQL($tableName, $columnName, $newColumn); $this->query($sql); $sql = $this->getSetColumnPkSequenceSQL($tableName, $columnName, $newColumn); $this->query($sql); } $sql = $this->getSetColumnPkConstraintSQL($tableName, $columnName, $newColumn); $this->query($sql); return true; } public function addColumnForeignKey(string $tableName, string $columnName, ReflectedColumn $newColumn) { $sql = $this->getAddColumnFkConstraintSQL($tableName, $columnName, $newColumn); return $this->query($sql); } public function removeColumnForeignKey(string $tableName, string $columnName, ReflectedColumn $newColumn) { $sql = $this->getRemoveColumnFkConstraintSQL($tableName, $columnName, $newColumn); return $this->query($sql); } public function addTable(ReflectedTable $newTable) { $sql = $this->getAddTableSQL($newTable); return $this->query($sql); } public function addColumn(string $tableName, ReflectedColumn $newColumn) { $sql = $this->getAddColumnSQL($tableName, $newColumn); return $this->query($sql); } public function removeTable(string $tableName) { $sql = $this->getRemoveTableSQL($tableName); return $this->query($sql); } public function removeColumn(string $tableName, string $columnName) { $sql = $this->getRemoveColumnSQL($tableName, $columnName); return $this->query($sql); } private function query(string $sql): bool { $stmt = $this->pdo->prepare($sql); return $stmt->execute(); } } // file: src/Tqdev/PhpCrudApi/Database/GenericReflection.php class GenericReflection { private $pdo; private $driver; private $database; private $typeConverter; public function __construct(\PDO $pdo, string $driver, string $database) { $this->pdo = $pdo; $this->driver = $driver; $this->database = $database; $this->typeConverter = new TypeConverter($driver); } public function getIgnoredTables(): array { switch ($this->driver) { case 'mysql':return []; case 'pgsql':return ['spatial_ref_sys', 'raster_columns', 'raster_overviews', 'geography_columns', 'geometry_columns']; case 'sqlsrv':return []; } } private function getTablesSQL(): string { switch ($this->driver) { case 'mysql':return 'SELECT "TABLE_NAME", "TABLE_TYPE" FROM "INFORMATION_SCHEMA"."TABLES" WHERE "TABLE_TYPE" IN (\'BASE TABLE\' , \'VIEW\') AND "TABLE_SCHEMA" = ? ORDER BY BINARY "TABLE_NAME"'; case 'pgsql':return 'SELECT c.relname as "TABLE_NAME", c.relkind as "TABLE_TYPE" FROM pg_catalog.pg_class c LEFT JOIN pg_catalog.pg_namespace n ON n.oid = c.relnamespace WHERE c.relkind IN (\'r\', \'v\') AND n.nspname <> \'pg_catalog\' AND n.nspname <> \'information_schema\' AND n.nspname !~ \'^pg_toast\' AND pg_catalog.pg_table_is_visible(c.oid) AND \'\' <> ? ORDER BY "TABLE_NAME";'; case 'sqlsrv':return 'SELECT o.name as "TABLE_NAME", o.xtype as "TABLE_TYPE" FROM sysobjects o WHERE o.xtype IN (\'U\', \'V\') ORDER BY "TABLE_NAME"'; } } private function getTableColumnsSQL(): string { switch ($this->driver) { case 'mysql':return 'SELECT "COLUMN_NAME", "IS_NULLABLE", "DATA_TYPE", "CHARACTER_MAXIMUM_LENGTH", "NUMERIC_PRECISION", "NUMERIC_SCALE" FROM "INFORMATION_SCHEMA"."COLUMNS" WHERE "TABLE_NAME" = ? AND "TABLE_SCHEMA" = ?'; case 'pgsql':return 'SELECT a.attname AS "COLUMN_NAME", case when a.attnotnull then \'NO\' else \'YES\' end as "IS_NULLABLE", pg_catalog.format_type(a.atttypid, -1) as "DATA_TYPE", case when a.atttypmod < 0 then NULL else a.atttypmod-4 end as "CHARACTER_MAXIMUM_LENGTH", case when a.atttypid != 1700 then NULL else ((a.atttypmod - 4) >> 16) & 65535 end as "NUMERIC_PRECISION", case when a.atttypid != 1700 then NULL else (a.atttypmod - 4) & 65535 end as "NUMERIC_SCALE" FROM pg_attribute a JOIN pg_class pgc ON pgc.oid = a.attrelid WHERE pgc.relname = ? AND \'\' <> ? AND a.attnum > 0 AND NOT a.attisdropped;'; case 'sqlsrv':return 'SELECT c.name AS "COLUMN_NAME", c.is_nullable AS "IS_NULLABLE", t.Name AS "DATA_TYPE", (c.max_length/2) AS "CHARACTER_MAXIMUM_LENGTH", c.precision AS "NUMERIC_PRECISION", c.scale AS "NUMERIC_SCALE" FROM sys.columns c INNER JOIN sys.types t ON c.user_type_id = t.user_type_id WHERE c.object_id = OBJECT_ID(?) AND \'\' <> ?'; } } private function getTablePrimaryKeysSQL(): string { switch ($this->driver) { case 'mysql':return 'SELECT "COLUMN_NAME" FROM "INFORMATION_SCHEMA"."KEY_COLUMN_USAGE" WHERE "CONSTRAINT_NAME" = \'PRIMARY\' AND "TABLE_NAME" = ? AND "TABLE_SCHEMA" = ?'; case 'pgsql':return 'SELECT a.attname AS "COLUMN_NAME" FROM pg_attribute a JOIN pg_constraint c ON (c.conrelid, c.conkey[1]) = (a.attrelid, a.attnum) JOIN pg_class pgc ON pgc.oid = a.attrelid WHERE pgc.relname = ? AND \'\' <> ? AND c.contype = \'p\''; case 'sqlsrv':return 'SELECT c.NAME as "COLUMN_NAME" FROM sys.key_constraints kc inner join sys.objects t on t.object_id = kc.parent_object_id INNER JOIN sys.index_columns ic ON kc.parent_object_id = ic.object_id and kc.unique_index_id = ic.index_id INNER JOIN sys.columns c ON ic.object_id = c.object_id AND ic.column_id = c.column_id WHERE kc.type = \'PK\' and t.object_id = OBJECT_ID(?) and \'\' <> ?'; } } private function getTableForeignKeysSQL(): string { switch ($this->driver) { case 'mysql':return 'SELECT "COLUMN_NAME", "REFERENCED_TABLE_NAME" FROM "INFORMATION_SCHEMA"."KEY_COLUMN_USAGE" WHERE "REFERENCED_TABLE_NAME" IS NOT NULL AND "TABLE_NAME" = ? AND "TABLE_SCHEMA" = ?'; case 'pgsql':return 'SELECT a.attname AS "COLUMN_NAME", c.confrelid::regclass::text AS "REFERENCED_TABLE_NAME" FROM pg_attribute a JOIN pg_constraint c ON (c.conrelid, c.conkey[1]) = (a.attrelid, a.attnum) JOIN pg_class pgc ON pgc.oid = a.attrelid WHERE pgc.relname = ? AND \'\' <> ? AND c.contype = \'f\''; case 'sqlsrv':return 'SELECT COL_NAME(fc.parent_object_id, fc.parent_column_id) AS "COLUMN_NAME", OBJECT_NAME (f.referenced_object_id) AS "REFERENCED_TABLE_NAME" FROM sys.foreign_keys AS f INNER JOIN sys.foreign_key_columns AS fc ON f.OBJECT_ID = fc.constraint_object_id WHERE f.parent_object_id = OBJECT_ID(?) and \'\' <> ?'; } } public function getDatabaseName(): string { return $this->database; } public function getTables(): array { $sql = $this->getTablesSQL(); $results = $this->query($sql, [$this->database]); foreach ($results as &$result) { switch ($this->driver) { case 'mysql': $map = ['BASE TABLE' => 'table', 'VIEW' => 'view']; $result['TABLE_TYPE'] = $map[$result['TABLE_TYPE']]; break; case 'pgsql': $map = ['r' => 'table', 'v' => 'view']; $result['TABLE_TYPE'] = $map[$result['TABLE_TYPE']]; break; case 'sqlsrv': $map = ['U' => 'table', 'V' => 'view']; $result['TABLE_TYPE'] = $map[trim($result['TABLE_TYPE'])]; break; } } return $results; } public function getTableColumns(string $tableName, string $type): array { $sql = $this->getTableColumnsSQL(); $results = $this->query($sql, [$tableName, $this->database]); if ($type == 'view') { foreach ($results as &$result) { $result['IS_NULLABLE'] = false; } } return $results; } public function getTablePrimaryKeys(string $tableName): array { $sql = $this->getTablePrimaryKeysSQL(); $results = $this->query($sql, [$tableName, $this->database]); $primaryKeys = []; foreach ($results as $result) { $primaryKeys[] = $result['COLUMN_NAME']; } return $primaryKeys; } public function getTableForeignKeys(string $tableName): array { $sql = $this->getTableForeignKeysSQL(); $results = $this->query($sql, [$tableName, $this->database]); $foreignKeys = []; foreach ($results as $result) { $foreignKeys[$result['COLUMN_NAME']] = $result['REFERENCED_TABLE_NAME']; } return $foreignKeys; } public function toJdbcType(string $type, int $size): string { return $this->typeConverter->toJdbc($type, $size); } private function query(string $sql, array $parameters): array { $stmt = $this->pdo->prepare($sql); $stmt->execute($parameters); return $stmt->fetchAll(); } } // file: src/Tqdev/PhpCrudApi/Database/TypeConverter.php class TypeConverter { private $driver; public function __construct(string $driver) { $this->driver = $driver; } private $fromJdbc = [ 'mysql' => [ 'clob' => 'longtext', 'boolean' => 'bit', 'blob' => 'longblob', 'timestamp' => 'datetime', ], 'pgsql' => [ 'clob' => 'text', 'blob' => 'bytea', ], 'sqlsrv' => [ 'boolean' => 'bit', 'varchar' => 'nvarchar', 'clob' => 'ntext', 'blob' => 'image', ], ]; private $toJdbc = [ 'simplified' => [ 'char' => 'varchar', 'longvarchar' => 'clob', 'nchar' => 'varchar', 'nvarchar' => 'varchar', 'longnvarchar' => 'clob', 'binary' => 'varbinary', 'longvarbinary' => 'blob', 'tinyint' => 'integer', 'smallint' => 'integer', 'real' => 'float', 'numeric' => 'decimal', 'time_with_timezone' => 'time', 'timestamp_with_timezone' => 'timestamp', ], 'mysql' => [ 'bit' => 'boolean', 'tinyblob' => 'blob', 'mediumblob' => 'blob', 'longblob' => 'blob', 'tinytext' => 'clob', 'mediumtext' => 'clob', 'longtext' => 'clob', 'text' => 'clob', 'mediumint' => 'integer', 'int' => 'integer', 'polygon' => 'geometry', 'point' => 'geometry', 'datetime' => 'timestamp', 'year' => 'integer', 'enum' => 'varchar', 'json' => 'clob', ], 'pgsql' => [ 'bigserial' => 'bigint', 'bit varying' => 'bit', 'box' => 'geometry', 'bytea' => 'blob', 'character varying' => 'varchar', 'character' => 'char', 'cidr' => 'varchar', 'circle' => 'geometry', 'double precision' => 'double', 'inet' => 'integer', 'json' => 'clob', 'jsonb' => 'clob', 'line' => 'geometry', 'lseg' => 'geometry', 'macaddr' => 'varchar', 'money' => 'decimal', 'path' => 'geometry', 'point' => 'geometry', 'polygon' => 'geometry', 'real' => 'float', 'serial' => 'integer', 'text' => 'clob', 'time without time zone' => 'time', 'time with time zone' => 'time_with_timezone', 'timestamp without time zone' => 'timestamp', 'timestamp with time zone' => 'timestamp_with_timezone', 'uuid' => 'char', 'xml' => 'clob', ], 'sqlsrv' => [ 'varbinary(0)' => 'blob', 'bit' => 'boolean', 'datetime' => 'timestamp', 'datetime2' => 'timestamp', 'float' => 'double', 'image' => 'blob', 'int' => 'integer', 'money' => 'decimal', 'ntext' => 'clob', 'smalldatetime' => 'timestamp', 'smallmoney' => 'decimal', 'text' => 'clob', 'timestamp' => 'binary', 'udt' => 'varbinary', 'uniqueidentifier' => 'char', 'xml' => 'clob', ], ]; private $valid = [ 'bigint' => true, 'binary' => true, 'bit' => true, 'blob' => true, 'boolean' => true, 'char' => true, 'clob' => true, 'date' => true, 'decimal' => true, 'distinct' => true, 'double' => true, 'float' => true, 'integer' => true, 'longnvarchar' => true, 'longvarbinary' => true, 'longvarchar' => true, 'nchar' => true, 'nclob' => true, 'numeric' => true, 'nvarchar' => true, 'real' => true, 'smallint' => true, 'time' => true, 'time_with_timezone' => true, 'timestamp' => true, 'timestamp_with_timezone' => true, 'tinyint' => true, 'varbinary' => true, 'varchar' => true, 'geometry' => true, ]; public function toJdbc(string $type, int $size): string { $jdbcType = strtolower($type); if (isset($this->toJdbc[$this->driver]["$jdbcType($size)"])) { $jdbcType = $this->toJdbc[$this->driver]["$jdbcType($size)"]; } if (isset($this->toJdbc[$this->driver][$jdbcType])) { $jdbcType = $this->toJdbc[$this->driver][$jdbcType]; } if (isset($this->toJdbc['simplified'][$jdbcType])) { $jdbcType = $this->toJdbc['simplified'][$jdbcType]; } if (!isset($this->valid[$jdbcType])) { throw new \Exception("Unsupported type '$jdbcType' for driver '$this->driver'"); } return $jdbcType; } public function fromJdbc(string $type): string { $jdbcType = strtolower($type); if (isset($this->fromJdbc[$this->driver][$jdbcType])) { $jdbcType = $this->fromJdbc[$this->driver][$jdbcType]; } return $jdbcType; } } // file: src/Tqdev/PhpCrudApi/GeoJson/Feature.php class Feature implements \JsonSerializable { private $properties; private $geometry; public function __construct(array $properties, /*?Geometry*/ $geometry) { $this->properties = $properties; $this->geometry = $geometry; } public function serialize() { return [ 'type' => 'Feature', 'properties' => $this->properties, 'geometry' => $this->geometry, ]; } public function jsonSerialize() { return $this->serialize(); } } // file: src/Tqdev/PhpCrudApi/GeoJson/FeatureCollection.php class FeatureCollection implements \JsonSerializable { private $features; private $results; public function __construct(array $features, int $results) { $this->features = $features; $this->results = $results; } public function serialize() { return [ 'type' => 'FeatureCollection', 'features' => $this->features, 'results' => $this->results, ]; } public function jsonSerialize() { return array_filter($this->serialize(), function ($v) { return $v !== 0; }); } } // file: src/Tqdev/PhpCrudApi/GeoJson/GeoJsonService.php class GeoJsonService { private $reflection; private $records; public function __construct(ReflectionService $reflection, RecordService $records) { $this->reflection = $reflection; $this->records = $records; } public function hasTable(string $table): bool { return $this->reflection->hasTable($table); } public function getType(string $table): string { return $this->reflection->getType($table); } private function getGeometryColumnName(string $tableName, array &$params): string { $geometryParam = isset($params['geometry']) ? $params['geometry'][0] : ''; $table = $this->reflection->getTable($tableName); $geometryColumnName = ''; foreach ($table->getColumnNames() as $columnName) { if ($geometryParam && $geometryParam != $columnName) { continue; } $column = $table->getColumn($columnName); if ($column->isGeometry()) { $geometryColumnName = $columnName; break; } } if ($geometryColumnName) { $params['mandatory'][] = $tableName . "." . $geometryColumnName; } return $geometryColumnName; } private function setBoudingBoxFilter(string $geometryColumnName, array &$params) { $boundingBox = isset($params['bbox']) ? $params['bbox'][0] : ''; if ($boundingBox) { $c = explode(',', $boundingBox); if (!isset($params['filter'])) { $params['filter'] = array(); } $params['filter'][] = "$geometryColumnName,sin,POLYGON(($c[0] $c[1],$c[2] $c[1],$c[2] $c[3],$c[0] $c[3],$c[0] $c[1]))"; } } private function convertRecordToFeature( /*object*/$record, string $geometryColumnName) { $geometry = null; if (isset($record[$geometryColumnName])) { $geometry = Geometry::fromWkt($record[$geometryColumnName]); } $properties = array_diff_key($record, [$geometryColumnName => true]); return new Feature($properties, $geometry); } public function _list(string $tableName, array $params): FeatureCollection { $geometryColumnName = $this->getGeometryColumnName($tableName, $params); $this->setBoudingBoxFilter($geometryColumnName, $params); $records = $this->records->_list($tableName, $params); $features = array(); foreach ($records->getRecords() as $record) { $features[] = $this->convertRecordToFeature($record, $geometryColumnName); } return new FeatureCollection($features, $records->getResults()); } public function read(string $tableName, string $id, array $params): Feature { $geometryColumnName = $this->getGeometryColumnName($tableName, $params); $this->setBoudingBoxFilter($geometryColumnName, $params); $record = $this->records->read($tableName, $id, $params); return $this->convertRecordToFeature($record, $geometryColumnName); } } // file: src/Tqdev/PhpCrudApi/GeoJson/Geometry.php class Geometry implements \JsonSerializable { private $type; private $geometry; public static $types = [ "Point", "MultiPoint", "LineString", "MultiLineString", "Polygon", "MultiPolygon", ]; public function __construct(string $type, array $coordinates) { $this->type = $type; $this->coordinates = $coordinates; } public static function fromWkt(string $wkt): Geometry { $bracket = strpos($wkt, '('); $type = strtoupper(trim(substr($wkt, 0, $bracket))); $supported = false; foreach (Geometry::$types as $typeName) { if (strtoupper($typeName) == $type) { $type = $typeName; $supported = true; } } if (!$supported) { throw new \Exception('Geometry type not supported: ' . $type); } $coordinates = substr($wkt, $bracket); if (substr($type, -5) != 'Point' || ($type == 'MultiPoint' && $coordinates[1] != '(')) { $coordinates = preg_replace('|([0-9\-\.]+ )+([0-9\-\.]+)|', '[\1\2]', $coordinates); } $coordinates = str_replace(['(', ')', ', ', ' '], ['[', ']', ',', ','], $coordinates); $json = $coordinates; $coordinates = json_decode($coordinates); if (!$coordinates) { throw new \Exception('Could not decode WKT: ' . $wkt); } return new Geometry($type, $coordinates); } public function serialize() { return [ 'type' => $this->type, 'coordinates' => $this->coordinates, ]; } public function jsonSerialize() { return $this->serialize(); } } // file: src/Tqdev/PhpCrudApi/Middleware/Base/Middleware.php abstract class Middleware implements MiddlewareInterface { protected $next; protected $responder; private $properties; public function __construct(Router $router, Responder $responder, array $properties) { $router->load($this); $this->responder = $responder; $this->properties = $properties; } protected function getArrayProperty(string $key, string $default): array { return array_filter(array_map('trim', explode(',', $this->getProperty($key, $default)))); } protected function getProperty(string $key, $default) { return isset($this->properties[$key]) ? $this->properties[$key] : $default; } } // file: src/Tqdev/PhpCrudApi/Middleware/Communication/VariableStore.php class VariableStore { static $values = array(); public static function get(string $key) { if (isset(self::$values[$key])) { return self::$values[$key]; } return null; } public static function set(string $key, /* object */ $value) { self::$values[$key] = $value; } } // file: src/Tqdev/PhpCrudApi/Middleware/Router/Router.php interface Router extends RequestHandlerInterface { public function register(string $method, string $path, array $handler); public function load(Middleware $middleware); public function route(ServerRequestInterface $request): ResponseInterface; } // file: src/Tqdev/PhpCrudApi/Middleware/Router/SimpleRouter.php class SimpleRouter implements Router { private $basePath; private $responder; private $cache; private $ttl; private $debug; private $registration; private $routes; private $routeHandlers; private $middlewares; public function __construct(string $basePath, Responder $responder, Cache $cache, int $ttl, bool $debug) { $this->basePath = $basePath; $this->responder = $responder; $this->cache = $cache; $this->ttl = $ttl; $this->debug = $debug; $this->registration = true; $this->routes = $this->loadPathTree(); $this->routeHandlers = []; $this->middlewares = array(); } private function loadPathTree(): PathTree { $data = $this->cache->get('PathTree'); if ($data != '') { $tree = PathTree::fromJson(json_decode(gzuncompress($data))); $this->registration = false; } else { $tree = new PathTree(); } return $tree; } public function register(string $method, string $path, array $handler) { $routeNumber = count($this->routeHandlers); $this->routeHandlers[$routeNumber] = $handler; if ($this->registration) { $parts = explode('/', trim($path, '/')); array_unshift($parts, $method); $this->routes->put($parts, $routeNumber); } } public function load(Middleware $middleware) /*: void*/ { array_push($this->middlewares, $middleware); } public function route(ServerRequestInterface $request): ResponseInterface { if ($this->registration) { $data = gzcompress(json_encode($this->routes, JSON_UNESCAPED_UNICODE)); $this->cache->set('PathTree', $data, $this->ttl); } return $this->handle($request); } private function getRouteNumbers(ServerRequestInterface $request): array { $method = strtoupper($request->getMethod()); $path = array(); $segment = $method; for ($i = 1; $segment; $i++) { array_push($path, $segment); $segment = RequestUtils::getPathSegment($request, $i); } return $this->routes->match($path); } private function removeBasePath(ServerRequestInterface $request): ServerRequestInterface { if ($this->basePath) { $path = $request->getUri()->getPath(); $basePath = rtrim($this->basePath, '/'); if (substr($path, 0, strlen($basePath)) == $basePath) { $path = substr($path, strlen($basePath)); $request = $request->withUri($request->getUri()->withPath($path)); } } elseif (isset($_SERVER['PATH_INFO'])) { $path = $_SERVER['PATH_INFO']; $request = $request->withUri($request->getUri()->withPath($path)); } return $request; } public function handle(ServerRequestInterface $request): ResponseInterface { $request = $this->removeBasePath($request); if (count($this->middlewares)) { $handler = array_pop($this->middlewares); return $handler->process($request, $this); } $routeNumbers = $this->getRouteNumbers($request); if (count($routeNumbers) == 0) { return $this->responder->error(ErrorCode::ROUTE_NOT_FOUND, $request->getUri()->getPath()); } try { $response = call_user_func($this->routeHandlers[$routeNumbers[0]], $request); } catch (\PDOException $e) { if (strpos(strtolower($e->getMessage()), 'duplicate') !== false) { $response = $this->responder->error(ErrorCode::DUPLICATE_KEY_EXCEPTION, ''); } elseif (strpos(strtolower($e->getMessage()), 'default value') !== false) { $response = $this->responder->error(ErrorCode::DATA_INTEGRITY_VIOLATION, ''); } elseif (strpos(strtolower($e->getMessage()), 'allow nulls') !== false) { $response = $this->responder->error(ErrorCode::DATA_INTEGRITY_VIOLATION, ''); } elseif (strpos(strtolower($e->getMessage()), 'constraint') !== false) { $response = $this->responder->error(ErrorCode::DATA_INTEGRITY_VIOLATION, ''); } else { $response = $this->responder->error(ErrorCode::ERROR_NOT_FOUND, ''); } if ($this->debug) { $response = ResponseUtils::addExceptionHeaders($response, $e); } } return $response; } } // file: src/Tqdev/PhpCrudApi/Middleware/AjaxOnlyMiddleware.php class AjaxOnlyMiddleware extends Middleware { public function process(ServerRequestInterface $request, RequestHandlerInterface $next): ResponseInterface { $method = $request->getMethod(); $excludeMethods = $this->getArrayProperty('excludeMethods', 'OPTIONS,GET'); if (!in_array($method, $excludeMethods)) { $headerName = $this->getProperty('headerName', 'X-Requested-With'); $headerValue = $this->getProperty('headerValue', 'XMLHttpRequest'); if ($headerValue != RequestUtils::getHeader($request, $headerName)) { return $this->responder->error(ErrorCode::ONLY_AJAX_REQUESTS_ALLOWED, $method); } } return $next->handle($request); } } // file: src/Tqdev/PhpCrudApi/Middleware/AuthorizationMiddleware.php class AuthorizationMiddleware extends Middleware { private $reflection; public function __construct(Router $router, Responder $responder, array $properties, ReflectionService $reflection) { parent::__construct($router, $responder, $properties); $this->reflection = $reflection; } private function handleColumns(string $operation, string $tableName) /*: void*/ { $columnHandler = $this->getProperty('columnHandler', ''); if ($columnHandler) { $table = $this->reflection->getTable($tableName); foreach ($table->getColumnNames() as $columnName) { $allowed = call_user_func($columnHandler, $operation, $tableName, $columnName); if (!$allowed) { $table->removeColumn($columnName); } } } } private function handleTable(string $operation, string $tableName) /*: void*/ { if (!$this->reflection->hasTable($tableName)) { return; } $tableHandler = $this->getProperty('tableHandler', ''); if ($tableHandler) { $allowed = call_user_func($tableHandler, $operation, $tableName); if (!$allowed) { $this->reflection->removeTable($tableName); } else { $this->handleColumns($operation, $tableName); } } } private function handleRecords(string $operation, string $tableName) /*: void*/ { if (!$this->reflection->hasTable($tableName)) { return; } $recordHandler = $this->getProperty('recordHandler', ''); if ($recordHandler) { $query = call_user_func($recordHandler, $operation, $tableName); $filters = new FilterInfo(); $table = $this->reflection->getTable($tableName); $query = str_replace('][]=', ']=', str_replace('=', '[]=', $query)); parse_str($query, $params); $condition = $filters->getCombinedConditions($table, $params); VariableStore::set("authorization.conditions.$tableName", $condition); } } public function process(ServerRequestInterface $request, RequestHandlerInterface $next): ResponseInterface { $path = RequestUtils::getPathSegment($request, 1); $operation = RequestUtils::getOperation($request); $tableNames = RequestUtils::getTableNames($request, $this->reflection); foreach ($tableNames as $tableName) { $this->handleTable($operation, $tableName); if ($path == 'records') { $this->handleRecords($operation, $tableName); } } if ($path == 'openapi') { VariableStore::set('authorization.tableHandler', $this->getProperty('tableHandler', '')); VariableStore::set('authorization.columnHandler', $this->getProperty('columnHandler', '')); } return $next->handle($request); } } // file: src/Tqdev/PhpCrudApi/Middleware/BasicAuthMiddleware.php class BasicAuthMiddleware extends Middleware { private function hasCorrectPassword(string $username, string $password, array &$passwords): bool { $hash = isset($passwords[$username]) ? $passwords[$username] : false; if ($hash && password_verify($password, $hash)) { if (password_needs_rehash($hash, PASSWORD_DEFAULT)) { $passwords[$username] = password_hash($password, PASSWORD_DEFAULT); } return true; } return false; } private function getValidUsername(string $username, string $password, string $passwordFile): string { $passwords = $this->readPasswords($passwordFile); $valid = $this->hasCorrectPassword($username, $password, $passwords); $this->writePasswords($passwordFile, $passwords); return $valid ? $username : ''; } private function readPasswords(string $passwordFile): array { $passwords = []; $passwordLines = file($passwordFile); foreach ($passwordLines as $passwordLine) { if (strpos($passwordLine, ':') !== false) { list($username, $hash) = explode(':', trim($passwordLine), 2); if (strlen($hash) > 0 && $hash[0] != '$') { $hash = password_hash($hash, PASSWORD_DEFAULT); } $passwords[$username] = $hash; } } return $passwords; } private function writePasswords(string $passwordFile, array $passwords): bool { $success = false; $passwordFileContents = ''; foreach ($passwords as $username => $hash) { $passwordFileContents .= "$username:$hash\n"; } if (file_get_contents($passwordFile) != $passwordFileContents) { $success = file_put_contents($passwordFile, $passwordFileContents) !== false; } return $success; } private function getAuthorizationCredentials(ServerRequestInterface $request): string { if (isset($_SERVER['PHP_AUTH_USER'])) { return $_SERVER['PHP_AUTH_USER'] . ':' . $_SERVER['PHP_AUTH_PW']; } $header = RequestUtils::getHeader($request, 'Authorization'); $parts = explode(' ', trim($header), 2); if (count($parts) != 2) { return ''; } if ($parts[0] != 'Basic') { return ''; } return base64_decode(strtr($parts[1], '-_', '+/')); } public function process(ServerRequestInterface $request, RequestHandlerInterface $next): ResponseInterface { if (session_status() == PHP_SESSION_NONE) { session_start(); } $credentials = $this->getAuthorizationCredentials($request); if ($credentials) { list($username, $password) = array('', ''); if (strpos($credentials, ':') !== false) { list($username, $password) = explode(':', $credentials, 2); } $passwordFile = $this->getProperty('passwordFile', '.htpasswd'); $validUser = $this->getValidUsername($username, $password, $passwordFile); $_SESSION['username'] = $validUser; if (!$validUser) { return $this->responder->error(ErrorCode::AUTHENTICATION_FAILED, $username); } if (!headers_sent()) { session_regenerate_id(); } } if (!isset($_SESSION['username']) || !$_SESSION['username']) { $authenticationMode = $this->getProperty('mode', 'required'); if ($authenticationMode == 'required') { $response = $this->responder->error(ErrorCode::AUTHENTICATION_REQUIRED, ''); $realm = $this->getProperty('realm', 'Username and password required'); $response = $response->withHeader('WWW-Authenticate', "Basic realm=\"$realm\""); return $response; } } return $next->handle($request); } } // file: src/Tqdev/PhpCrudApi/Middleware/CorsMiddleware.php class CorsMiddleware extends Middleware { private function isOriginAllowed(string $origin, string $allowedOrigins): bool { $found = false; foreach (explode(',', $allowedOrigins) as $allowedOrigin) { $hostname = preg_quote(strtolower(trim($allowedOrigin))); $regex = '/^' . str_replace('\*', '.*', $hostname) . '$/'; if (preg_match($regex, $origin)) { $found = true; break; } } return $found; } public function process(ServerRequestInterface $request, RequestHandlerInterface $next): ResponseInterface { $method = $request->getMethod(); $origin = count($request->getHeader('Origin')) ? $request->getHeader('Origin')[0] : ''; $allowedOrigins = $this->getProperty('allowedOrigins', '*'); if ($origin && !$this->isOriginAllowed($origin, $allowedOrigins)) { $response = $this->responder->error(ErrorCode::ORIGIN_FORBIDDEN, $origin); } elseif ($method == 'OPTIONS') { $response = ResponseFactory::fromStatus(ResponseFactory::OK); $allowHeaders = $this->getProperty('allowHeaders', 'Content-Type, X-XSRF-TOKEN, X-Authorization'); if ($allowHeaders) { $response = $response->withHeader('Access-Control-Allow-Headers', $allowHeaders); } $allowMethods = $this->getProperty('allowMethods', 'OPTIONS, GET, PUT, POST, DELETE, PATCH'); if ($allowMethods) { $response = $response->withHeader('Access-Control-Allow-Methods', $allowMethods); } $allowCredentials = $this->getProperty('allowCredentials', 'true'); if ($allowCredentials) { $response = $response->withHeader('Access-Control-Allow-Credentials', $allowCredentials); } $maxAge = $this->getProperty('maxAge', '1728000'); if ($maxAge) { $response = $response->withHeader('Access-Control-Max-Age', $maxAge); } $exposeHeaders = $this->getProperty('exposeHeaders', ''); if ($exposeHeaders) { $response = $response->withHeader('Access-Control-Expose-Headers', $exposeHeaders); } } else { $response = $next->handle($request); } if ($origin) { $allowCredentials = $this->getProperty('allowCredentials', 'true'); if ($allowCredentials) { $response = $response->withHeader('Access-Control-Allow-Credentials', $allowCredentials); } $response = $response->withHeader('Access-Control-Allow-Origin', $origin); } return $response; } } // file: src/Tqdev/PhpCrudApi/Middleware/CustomizationMiddleware.php class CustomizationMiddleware extends Middleware { private $reflection; public function __construct(Router $router, Responder $responder, array $properties, ReflectionService $reflection) { parent::__construct($router, $responder, $properties); $this->reflection = $reflection; } public function process(ServerRequestInterface $request, RequestHandlerInterface $next): ResponseInterface { $operation = RequestUtils::getOperation($request); $tableName = RequestUtils::getPathSegment($request, 2); $beforeHandler = $this->getProperty('beforeHandler', ''); $environment = (object) array(); if ($beforeHandler !== '') { $result = call_user_func($beforeHandler, $operation, $tableName, $request, $environment); $request = $result ?: $request; } $response = $next->handle($request); $afterHandler = $this->getProperty('afterHandler', ''); if ($afterHandler !== '') { $result = call_user_func($afterHandler, $operation, $tableName, $response, $environment); $response = $result ?: $response; } return $response; } } // file: src/Tqdev/PhpCrudApi/Middleware/FirewallMiddleware.php class FirewallMiddleware extends Middleware { private function ipMatch(string $ip, string $cidr): bool { if (strpos($cidr, '/') !== false) { list($subnet, $mask) = explode('/', trim($cidr)); if ((ip2long($ip) & ~((1 << (32 - $mask)) - 1)) == ip2long($subnet)) { return true; } } else { if (ip2long($ip) == ip2long($cidr)) { return true; } } return false; } private function isIpAllowed(string $ipAddress, string $allowedIpAddresses): bool { foreach (explode(',', $allowedIpAddresses) as $allowedIp) { if ($this->ipMatch($ipAddress, $allowedIp)) { return true; } } return false; } public function process(ServerRequestInterface $request, RequestHandlerInterface $next): ResponseInterface { $reverseProxy = $this->getProperty('reverseProxy', ''); if ($reverseProxy) { $ipAddress = array_pop(explode(',', $request->getHeader('X-Forwarded-For'))); } elseif (isset($_SERVER['REMOTE_ADDR'])) { $ipAddress = $_SERVER['REMOTE_ADDR']; } else { $ipAddress = '127.0.0.1'; } $allowedIpAddresses = $this->getProperty('allowedIpAddresses', ''); if (!$this->isIpAllowed($ipAddress, $allowedIpAddresses)) { $response = $this->responder->error(ErrorCode::TEMPORARY_OR_PERMANENTLY_BLOCKED, ''); } else { $response = $next->handle($request); } return $response; } } // file: src/Tqdev/PhpCrudApi/Middleware/IpAddressMiddleware.php class IpAddressMiddleware extends Middleware { private $reflection; public function __construct(Router $router, Responder $responder, array $properties, ReflectionService $reflection) { parent::__construct($router, $responder, $properties); $this->reflection = $reflection; } private function callHandler($record, string $operation, ReflectedTable $table) /*: object */ { $context = (array) $record; $columnNames = $this->getProperty('columns', ''); if ($columnNames) { foreach (explode(',', $columnNames) as $columnName) { if ($table->hasColumn($columnName)) { if ($operation == 'create') { $context[$columnName] = $_SERVER['REMOTE_ADDR']; } else { unset($context[$columnName]); } } } } return (object) $context; } public function process(ServerRequestInterface $request, RequestHandlerInterface $next): ResponseInterface { $operation = RequestUtils::getOperation($request); if (in_array($operation, ['create', 'update', 'increment'])) { $tableNames = $this->getProperty('tables', ''); $tableName = RequestUtils::getPathSegment($request, 2); if (!$tableNames || in_array($tableName, explode(',', $tableNames))) { if ($this->reflection->hasTable($tableName)) { $record = $request->getParsedBody(); if ($record !== null) { $table = $this->reflection->getTable($tableName); if (is_array($record)) { foreach ($record as &$r) { $r = $this->callHandler($r, $operation, $table); } } else { $record = $this->callHandler($record, $operation, $table); } $request = $request->withParsedBody($record); } } } } return $next->handle($request); } } // file: src/Tqdev/PhpCrudApi/Middleware/JoinLimitsMiddleware.php class JoinLimitsMiddleware extends Middleware { private $reflection; public function __construct(Router $router, Responder $responder, array $properties, ReflectionService $reflection) { parent::__construct($router, $responder, $properties); $this->reflection = $reflection; } public function process(ServerRequestInterface $request, RequestHandlerInterface $next): ResponseInterface { $operation = RequestUtils::getOperation($request); $params = RequestUtils::getParams($request); if (in_array($operation, ['read', 'list']) && isset($params['join'])) { $maxDepth = (int) $this->getProperty('depth', '3'); $maxTables = (int) $this->getProperty('tables', '10'); $maxRecords = (int) $this->getProperty('records', '1000'); $tableCount = 0; $joinPaths = array(); for ($i = 0; $i < count($params['join']); $i++) { $joinPath = array(); $tables = explode(',', $params['join'][$i]); for ($depth = 0; $depth < min($maxDepth, count($tables)); $depth++) { array_push($joinPath, $tables[$depth]); $tableCount += 1; if ($tableCount == $maxTables) { break; } } array_push($joinPaths, implode(',', $joinPath)); if ($tableCount == $maxTables) { break; } } $params['join'] = $joinPaths; $request = RequestUtils::setParams($request, $params); VariableStore::set("joinLimits.maxRecords", $maxRecords); } return $next->handle($request); } } // file: src/Tqdev/PhpCrudApi/Middleware/JwtAuthMiddleware.php class JwtAuthMiddleware extends Middleware { private function getVerifiedClaims(string $token, int $time, int $leeway, int $ttl, string $secret, array $requirements): array { $algorithms = array( 'HS256' => 'sha256', 'HS384' => 'sha384', 'HS512' => 'sha512', 'RS256' => 'sha256', 'RS384' => 'sha384', 'RS512' => 'sha512', ); $token = explode('.', $token); if (count($token) < 3) { return array(); } $header = json_decode(base64_decode(strtr($token[0], '-_', '+/')), true); if (!$secret) { return array(); } if ($header['typ'] != 'JWT') { return array(); } $algorithm = $header['alg']; if (!isset($algorithms[$algorithm])) { return array(); } if (!empty($requirements['alg']) && !in_array($algorithm, $requirements['alg'])) { return array(); } $hmac = $algorithms[$algorithm]; $signature = base64_decode(strtr($token[2], '-_', '+/')); $data = "$token[0].$token[1]"; switch ($algorithm[0]) { case 'H': $hash = hash_hmac($hmac, $data, $secret, true); if (function_exists('hash_equals')) { $equals = hash_equals($signature, $hash); } else { $equals = $signature == $hash; } if (!$equals) { return array(); } break; case 'R': $equals = openssl_verify($data, $signature, $secret, $hmac) == 1; if (!$equals) { return array(); } break; } $claims = json_decode(base64_decode(strtr($token[1], '-_', '+/')), true); if (!$claims) { return array(); } foreach ($requirements as $field => $values) { if (!empty($values)) { if ($field != 'alg') { if (!isset($claims[$field]) || !in_array($claims[$field], $values)) { return array(); } } } } if (isset($claims['nbf']) && $time + $leeway < $claims['nbf']) { return array(); } if (isset($claims['iat']) && $time + $leeway < $claims['iat']) { return array(); } if (isset($claims['exp']) && $time - $leeway > $claims['exp']) { return array(); } if (isset($claims['iat']) && !isset($claims['exp'])) { if ($time - $leeway > $claims['iat'] + $ttl) { return array(); } } return $claims; } private function getClaims(string $token): array { $time = (int) $this->getProperty('time', time()); $leeway = (int) $this->getProperty('leeway', '5'); $ttl = (int) $this->getProperty('ttl', '30'); $secret = $this->getProperty('secret', ''); $requirements = array( 'alg' => $this->getArrayProperty('algorithms', ''), 'aud' => $this->getArrayProperty('audiences', ''), 'iss' => $this->getArrayProperty('issuers', ''), ); if (!$secret) { return array(); } return $this->getVerifiedClaims($token, $time, $leeway, $ttl, $secret, $requirements); } private function getAuthorizationToken(ServerRequestInterface $request): string { $headerName = $this->getProperty('header', 'X-Authorization'); $headerValue = RequestUtils::getHeader($request, $headerName); $parts = explode(' ', trim($headerValue), 2); if (count($parts) != 2) { return ''; } if ($parts[0] != 'Bearer') { return ''; } return $parts[1]; } public function process(ServerRequestInterface $request, RequestHandlerInterface $next): ResponseInterface { if (session_status() == PHP_SESSION_NONE) { session_start(); } $token = $this->getAuthorizationToken($request); if ($token) { $claims = $this->getClaims($token); $_SESSION['claims'] = $claims; if (empty($claims)) { return $this->responder->error(ErrorCode::AUTHENTICATION_FAILED, 'JWT'); } if (!headers_sent()) { session_regenerate_id(); } } if (empty($_SESSION['claims'])) { $authenticationMode = $this->getProperty('mode', 'required'); if ($authenticationMode == 'required') { return $this->responder->error(ErrorCode::AUTHENTICATION_REQUIRED, ''); } } return $next->handle($request); } } // file: src/Tqdev/PhpCrudApi/Middleware/MultiTenancyMiddleware.php class MultiTenancyMiddleware extends Middleware { private $reflection; public function __construct(Router $router, Responder $responder, array $properties, ReflectionService $reflection) { parent::__construct($router, $responder, $properties); $this->reflection = $reflection; } private function getCondition(string $tableName, array $pairs): Condition { $condition = new NoCondition(); $table = $this->reflection->getTable($tableName); foreach ($pairs as $k => $v) { $condition = $condition->_and(new ColumnCondition($table->getColumn($k), 'eq', $v)); } return $condition; } private function getPairs($handler, string $operation, string $tableName): array { $result = array(); $pairs = call_user_func($handler, $operation, $tableName); $table = $this->reflection->getTable($tableName); foreach ($pairs as $k => $v) { if ($table->hasColumn($k)) { $result[$k] = $v; } } return $result; } private function handleRecord(ServerRequestInterface $request, string $operation, array $pairs): ServerRequestInterface { $record = $request->getParsedBody(); if ($record === null) { return $request; } $multi = is_array($record); $records = $multi ? $record : [$record]; foreach ($records as &$record) { foreach ($pairs as $column => $value) { if ($operation == 'create') { $record->$column = $value; } else { if (isset($record->$column)) { unset($record->$column); } } } } return $request->withParsedBody($multi ? $records : $records[0]); } public function process(ServerRequestInterface $request, RequestHandlerInterface $next): ResponseInterface { $handler = $this->getProperty('handler', ''); if ($handler !== '') { $path = RequestUtils::getPathSegment($request, 1); if ($path == 'records') { $operation = RequestUtils::getOperation($request); $tableNames = RequestUtils::getTableNames($request, $this->reflection); foreach ($tableNames as $i => $tableName) { if (!$this->reflection->hasTable($tableName)) { continue; } $pairs = $this->getPairs($handler, $operation, $tableName); if ($i == 0) { if (in_array($operation, ['create', 'update', 'increment'])) { $request = $this->handleRecord($request, $operation, $pairs); } } $condition = $this->getCondition($tableName, $pairs); VariableStore::set("multiTenancy.conditions.$tableName", $condition); } } } return $next->handle($request); } } // file: src/Tqdev/PhpCrudApi/Middleware/PageLimitsMiddleware.php class PageLimitsMiddleware extends Middleware { private $reflection; public function __construct(Router $router, Responder $responder, array $properties, ReflectionService $reflection) { parent::__construct($router, $responder, $properties); $this->reflection = $reflection; } public function process(ServerRequestInterface $request, RequestHandlerInterface $next): ResponseInterface { $operation = RequestUtils::getOperation($request); if ($operation == 'list') { $params = RequestUtils::getParams($request); $maxPage = (int) $this->getProperty('pages', '100'); if (isset($params['page']) && $params['page'] && $maxPage > 0) { if (strpos($params['page'][0], ',') === false) { $page = $params['page'][0]; } else { list($page, $size) = explode(',', $params['page'][0], 2); } if ($page > $maxPage) { return $this->responder->error(ErrorCode::PAGINATION_FORBIDDEN, ''); } } $maxSize = (int) $this->getProperty('records', '1000'); if (!isset($params['size']) || !$params['size'] && $maxSize > 0) { $params['size'] = array($maxSize); } else { $params['size'] = array(min($params['size'][0], $maxSize)); } $request = RequestUtils::setParams($request, $params); } return $next->handle($request); } } // file: src/Tqdev/PhpCrudApi/Middleware/SanitationMiddleware.php class SanitationMiddleware extends Middleware { private $reflection; public function __construct(Router $router, Responder $responder, array $properties, ReflectionService $reflection) { parent::__construct($router, $responder, $properties); $this->reflection = $reflection; } private function callHandler($handler, $record, string $operation, ReflectedTable $table) /*: object */ { $context = (array) $record; $tableName = $table->getName(); foreach ($context as $columnName => &$value) { if ($table->hasColumn($columnName)) { $column = $table->getColumn($columnName); $value = call_user_func($handler, $operation, $tableName, $column->serialize(), $value); } } return (object) $context; } public function process(ServerRequestInterface $request, RequestHandlerInterface $next): ResponseInterface { $operation = RequestUtils::getOperation($request); if (in_array($operation, ['create', 'update', 'increment'])) { $tableName = RequestUtils::getPathSegment($request, 2); if ($this->reflection->hasTable($tableName)) { $record = $request->getParsedBody(); if ($record !== null) { $handler = $this->getProperty('handler', ''); if ($handler !== '') { $table = $this->reflection->getTable($tableName); if (is_array($record)) { foreach ($record as &$r) { $r = $this->callHandler($handler, $r, $operation, $table); } } else { $record = $this->callHandler($handler, $record, $operation, $table); } $request = $request->withParsedBody($record); } } } } return $next->handle($request); } } // file: src/Tqdev/PhpCrudApi/Middleware/ValidationMiddleware.php class ValidationMiddleware extends Middleware { private $reflection; public function __construct(Router $router, Responder $responder, array $properties, ReflectionService $reflection) { parent::__construct($router, $responder, $properties); $this->reflection = $reflection; } private function callHandler($handler, $record, string $operation, ReflectedTable $table) /*: ResponseInterface?*/ { $context = (array) $record; $details = array(); $tableName = $table->getName(); foreach ($context as $columnName => $value) { if ($table->hasColumn($columnName)) { $column = $table->getColumn($columnName); $valid = call_user_func($handler, $operation, $tableName, $column->serialize(), $value, $context); if ($valid !== true && $valid !== '') { $details[$columnName] = $valid; } } } if (count($details) > 0) { return $this->responder->error(ErrorCode::INPUT_VALIDATION_FAILED, $tableName, $details); } return null; } public function process(ServerRequestInterface $request, RequestHandlerInterface $next): ResponseInterface { $operation = RequestUtils::getOperation($request); if (in_array($operation, ['create', 'update', 'increment'])) { $tableName = RequestUtils::getPathSegment($request, 2); if ($this->reflection->hasTable($tableName)) { $record = $request->getParsedBody(); if ($record !== null) { $handler = $this->getProperty('handler', ''); if ($handler !== '') { $table = $this->reflection->getTable($tableName); if (is_array($record)) { foreach ($record as $r) { $response = $this->callHandler($handler, $r, $operation, $table); if ($response !== null) { return $response; } } } else { $response = $this->callHandler($handler, $record, $operation, $table); if ($response !== null) { return $response; } } } } } } return $next->handle($request); } } // file: src/Tqdev/PhpCrudApi/Middleware/XsrfMiddleware.php class XsrfMiddleware extends Middleware { private function getToken(): string { $cookieName = $this->getProperty('cookieName', 'XSRF-TOKEN'); if (isset($_COOKIE[$cookieName])) { $token = $_COOKIE[$cookieName]; } else { $secure = isset($_SERVER['HTTPS']) && $_SERVER['HTTPS'] == 'on'; $token = bin2hex(random_bytes(8)); if (!headers_sent()) { setcookie($cookieName, $token, 0, '', '', $secure); } } return $token; } public function process(ServerRequestInterface $request, RequestHandlerInterface $next): ResponseInterface { $token = $this->getToken(); $method = $request->getMethod(); $excludeMethods = $this->getArrayProperty('excludeMethods', 'OPTIONS,GET'); if (!in_array($method, $excludeMethods)) { $headerName = $this->getProperty('headerName', 'X-XSRF-TOKEN'); if ($token != $request->getHeader($headerName)) { return $this->responder->error(ErrorCode::BAD_OR_MISSING_XSRF_TOKEN, ''); } } return $next->handle($request); } } // file: src/Tqdev/PhpCrudApi/OpenApi/OpenApiBuilder.php class OpenApiBuilder { private $openapi; private $reflection; private $operations = [ 'list' => 'get', 'create' => 'post', 'read' => 'get', 'update' => 'put', 'delete' => 'delete', 'increment' => 'patch', ]; private $types = [ 'integer' => ['type' => 'integer', 'format' => 'int32'], 'bigint' => ['type' => 'integer', 'format' => 'int64'], 'varchar' => ['type' => 'string'], 'clob' => ['type' => 'string'], 'varbinary' => ['type' => 'string', 'format' => 'byte'], 'blob' => ['type' => 'string', 'format' => 'byte'], 'decimal' => ['type' => 'string'], 'float' => ['type' => 'number', 'format' => 'float'], 'double' => ['type' => 'number', 'format' => 'double'], 'date' => ['type' => 'string', 'format' => 'date'], 'time' => ['type' => 'string', 'format' => 'date-time'], 'timestamp' => ['type' => 'string', 'format' => 'date-time'], 'geometry' => ['type' => 'string'], 'boolean' => ['type' => 'boolean'], ]; public function __construct(ReflectionService $reflection, $base) { $this->reflection = $reflection; $this->openapi = new OpenApiDefinition($base); } private function getServerUrl(): string { $protocol = @$_SERVER['HTTP_X_FORWARDED_PROTO'] ?: @$_SERVER['REQUEST_SCHEME'] ?: ((isset($_SERVER["HTTPS"]) && $_SERVER["HTTPS"] == "on") ? "https" : "http"); $port = @intval($_SERVER['HTTP_X_FORWARDED_PORT']) ?: @intval($_SERVER["SERVER_PORT"]) ?: (($protocol === 'https') ? 443 : 80); $host = @explode(":", $_SERVER['HTTP_HOST'])[0] ?: @$_SERVER['SERVER_NAME'] ?: @$_SERVER['SERVER_ADDR']; $port = ($protocol === 'https' && $port === 443) || ($protocol === 'http' && $port === 80) ? '' : ':' . $port; $path = @trim(substr($_SERVER['REQUEST_URI'], 0, strpos($_SERVER['REQUEST_URI'], '/openapi')), '/'); return sprintf('%s://%s%s/%s', $protocol, $host, $port, $path); } private function getAllTableReferences(): array { $tableReferences = array(); foreach ($this->reflection->getTableNames() as $tableName) { $table = $this->reflection->getTable($tableName); foreach ($table->getColumnNames() as $columnName) { $column = $table->getColumn($columnName); $referencedTableName = $column->getFk(); if ($referencedTableName) { if (!isset($tableReferences[$referencedTableName])) { $tableReferences[$referencedTableName] = array(); } $tableReferences[$referencedTableName][] = "$tableName.$columnName"; } } } return $tableReferences; } public function build(): OpenApiDefinition { $this->openapi->set("openapi", "3.0.0"); if (!$this->openapi->has("servers") && isset($_SERVER['REQUEST_URI'])) { $this->openapi->set("servers|0|url", $this->getServerUrl()); } $tableNames = $this->reflection->getTableNames(); foreach ($tableNames as $tableName) { $this->setPath($tableName); } $this->openapi->set("components|responses|pk_integer|description", "inserted primary key value (integer)"); $this->openapi->set("components|responses|pk_integer|content|application/json|schema|type", "integer"); $this->openapi->set("components|responses|pk_integer|content|application/json|schema|format", "int64"); $this->openapi->set("components|responses|pk_string|description", "inserted primary key value (string)"); $this->openapi->set("components|responses|pk_string|content|application/json|schema|type", "string"); $this->openapi->set("components|responses|pk_string|content|application/json|schema|format", "uuid"); $this->openapi->set("components|responses|rows_affected|description", "number of rows affected (integer)"); $this->openapi->set("components|responses|rows_affected|content|application/json|schema|type", "integer"); $this->openapi->set("components|responses|rows_affected|content|application/json|schema|format", "int64"); $tableReferences = $this->getAllTableReferences(); foreach ($tableNames as $tableName) { $references = isset($tableReferences[$tableName]) ? $tableReferences[$tableName] : array(); $this->setComponentSchema($tableName, $references); $this->setComponentResponse($tableName); $this->setComponentRequestBody($tableName); } $this->setComponentParameters(); foreach ($tableNames as $index => $tableName) { $this->setTag($index, $tableName); } return $this->openapi; } private function isOperationOnTableAllowed(string $operation, string $tableName): bool { $tableHandler = VariableStore::get('authorization.tableHandler'); if (!$tableHandler) { return true; } return (bool) call_user_func($tableHandler, $operation, $tableName); } private function isOperationOnColumnAllowed(string $operation, string $tableName, string $columnName): bool { $columnHandler = VariableStore::get('authorization.columnHandler'); if (!$columnHandler) { return true; } return (bool) call_user_func($columnHandler, $operation, $tableName, $columnName); } private function setPath(string $tableName) /*: void*/ { $table = $this->reflection->getTable($tableName); $type = $table->getType(); $pk = $table->getPk(); $pkName = $pk ? $pk->getName() : ''; foreach ($this->operations as $operation => $method) { if (!$pkName && $operation != 'list') { continue; } if ($type != 'table' && $operation != 'list') { continue; } if (!$this->isOperationOnTableAllowed($operation, $tableName)) { continue; } $parameters = []; if (in_array($operation, ['list', 'create'])) { $path = sprintf('/records/%s', $tableName); if ($operation == 'list') { $parameters = ['filter', 'include', 'exclude', 'order', 'size', 'page', 'join']; } } else { $path = sprintf('/records/%s/{%s}', $tableName, $pkName); if ($operation == 'read') { $parameters = ['pk', 'include', 'exclude', 'join']; } else { $parameters = ['pk']; } } foreach ($parameters as $p => $parameter) { $this->openapi->set("paths|$path|$method|parameters|$p|\$ref", "#/components/parameters/$parameter"); } if (in_array($operation, ['create', 'update', 'increment'])) { $this->openapi->set("paths|$path|$method|requestBody|\$ref", "#/components/requestBodies/$operation-" . urlencode($tableName)); } $this->openapi->set("paths|$path|$method|tags|0", "$tableName"); $this->openapi->set("paths|$path|$method|description", "$operation $tableName"); switch ($operation) { case 'list': $this->openapi->set("paths|$path|$method|responses|200|\$ref", "#/components/responses/$operation-" . urlencode($tableName)); break; case 'create': if ($pk->getType() == 'integer') { $this->openapi->set("paths|$path|$method|responses|200|\$ref", "#/components/responses/pk_integer"); } else { $this->openapi->set("paths|$path|$method|responses|200|\$ref", "#/components/responses/pk_string"); } break; case 'read': $this->openapi->set("paths|$path|$method|responses|200|\$ref", "#/components/responses/$operation-" . urlencode($tableName)); break; case 'update': case 'delete': case 'increment': $this->openapi->set("paths|$path|$method|responses|200|\$ref", "#/components/responses/rows_affected"); break; } } } private function setComponentSchema(string $tableName, array $references) /*: void*/ { $table = $this->reflection->getTable($tableName); $type = $table->getType(); $pk = $table->getPk(); $pkName = $pk ? $pk->getName() : ''; foreach ($this->operations as $operation => $method) { if (!$pkName && $operation != 'list') { continue; } if ($type != 'table' && $operation != 'list') { continue; } if ($operation == 'delete') { continue; } if (!$this->isOperationOnTableAllowed($operation, $tableName)) { continue; } if ($operation == 'list') { $this->openapi->set("components|schemas|$operation-$tableName|type", "object"); $this->openapi->set("components|schemas|$operation-$tableName|properties|results|type", "integer"); $this->openapi->set("components|schemas|$operation-$tableName|properties|results|format", "int64"); $this->openapi->set("components|schemas|$operation-$tableName|properties|records|type", "array"); $prefix = "components|schemas|$operation-$tableName|properties|records|items"; } else { $prefix = "components|schemas|$operation-$tableName"; } $this->openapi->set("$prefix|type", "object"); foreach ($table->getColumnNames() as $columnName) { if (!$this->isOperationOnColumnAllowed($operation, $tableName, $columnName)) { continue; } $column = $table->getColumn($columnName); $properties = $this->types[$column->getType()]; foreach ($properties as $key => $value) { $this->openapi->set("$prefix|properties|$columnName|$key", $value); } if ($column->getPk()) { $this->openapi->set("$prefix|properties|$columnName|x-primary-key", true); $this->openapi->set("$prefix|properties|$columnName|x-referenced", $references); } $fk = $column->getFk(); if ($fk) { $this->openapi->set("$prefix|properties|$columnName|x-references", $fk); } } } } private function setComponentResponse(string $tableName) /*: void*/ { $table = $this->reflection->getTable($tableName); $type = $table->getType(); $pk = $table->getPk(); $pkName = $pk ? $pk->getName() : ''; foreach (['list', 'read'] as $operation) { if (!$pkName && $operation != 'list') { continue; } if ($type != 'table' && $operation != 'list') { continue; } if (!$this->isOperationOnTableAllowed($operation, $tableName)) { continue; } if ($operation == 'list') { $this->openapi->set("components|responses|$operation-$tableName|description", "list of $tableName records"); } else { $this->openapi->set("components|responses|$operation-$tableName|description", "single $tableName record"); } $this->openapi->set("components|responses|$operation-$tableName|content|application/json|schema|\$ref", "#/components/schemas/$operation-" . urlencode($tableName)); } } private function setComponentRequestBody(string $tableName) /*: void*/ { $table = $this->reflection->getTable($tableName); $type = $table->getType(); $pk = $table->getPk(); $pkName = $pk ? $pk->getName() : ''; if ($pkName && $type == 'table') { foreach (['create', 'update', 'increment'] as $operation) { if (!$this->isOperationOnTableAllowed($operation, $tableName)) { continue; } $this->openapi->set("components|requestBodies|$operation-$tableName|description", "single $tableName record"); $this->openapi->set("components|requestBodies|$operation-$tableName|content|application/json|schema|\$ref", "#/components/schemas/$operation-" . urlencode($tableName)); } } } private function setComponentParameters() /*: void*/ { $this->openapi->set("components|parameters|pk|name", "id"); $this->openapi->set("components|parameters|pk|in", "path"); $this->openapi->set("components|parameters|pk|schema|type", "string"); $this->openapi->set("components|parameters|pk|description", "primary key value"); $this->openapi->set("components|parameters|pk|required", true); $this->openapi->set("components|parameters|filter|name", "filter"); $this->openapi->set("components|parameters|filter|in", "query"); $this->openapi->set("components|parameters|filter|schema|type", "array"); $this->openapi->set("components|parameters|filter|schema|items|type", "string"); $this->openapi->set("components|parameters|filter|description", "Filters to be applied. Each filter consists of a column, an operator and a value (comma separated). Example: id,eq,1"); $this->openapi->set("components|parameters|filter|required", false); $this->openapi->set("components|parameters|include|name", "include"); $this->openapi->set("components|parameters|include|in", "query"); $this->openapi->set("components|parameters|include|schema|type", "string"); $this->openapi->set("components|parameters|include|description", "Columns you want to include in the output (comma separated). Example: posts.*,categories.name"); $this->openapi->set("components|parameters|include|required", false); $this->openapi->set("components|parameters|exclude|name", "exclude"); $this->openapi->set("components|parameters|exclude|in", "query"); $this->openapi->set("components|parameters|exclude|schema|type", "string"); $this->openapi->set("components|parameters|exclude|description", "Columns you want to exclude from the output (comma separated). Example: posts.content"); $this->openapi->set("components|parameters|exclude|required", false); $this->openapi->set("components|parameters|order|name", "order"); $this->openapi->set("components|parameters|order|in", "query"); $this->openapi->set("components|parameters|order|schema|type", "array"); $this->openapi->set("components|parameters|order|schema|items|type", "string"); $this->openapi->set("components|parameters|order|description", "Column you want to sort on and the sort direction (comma separated). Example: id,desc"); $this->openapi->set("components|parameters|order|required", false); $this->openapi->set("components|parameters|size|name", "size"); $this->openapi->set("components|parameters|size|in", "query"); $this->openapi->set("components|parameters|size|schema|type", "string"); $this->openapi->set("components|parameters|size|description", "Maximum number of results (for top lists). Example: 10"); $this->openapi->set("components|parameters|size|required", false); $this->openapi->set("components|parameters|page|name", "page"); $this->openapi->set("components|parameters|page|in", "query"); $this->openapi->set("components|parameters|page|schema|type", "string"); $this->openapi->set("components|parameters|page|description", "Page number and page size (comma separated). Example: 1,10"); $this->openapi->set("components|parameters|page|required", false); $this->openapi->set("components|parameters|join|name", "join"); $this->openapi->set("components|parameters|join|in", "query"); $this->openapi->set("components|parameters|join|schema|type", "array"); $this->openapi->set("components|parameters|join|schema|items|type", "string"); $this->openapi->set("components|parameters|join|description", "Paths (comma separated) to related entities that you want to include. Example: comments,users"); $this->openapi->set("components|parameters|join|required", false); } private function setTag(int $index, string $tableName) /*: void*/ { $this->openapi->set("tags|$index|name", "$tableName"); $this->openapi->set("tags|$index|description", "$tableName operations"); } } // file: src/Tqdev/PhpCrudApi/OpenApi/OpenApiDefinition.php class OpenApiDefinition implements \JsonSerializable { private $root; public function __construct($base) { $this->root = $base; } public function set(string $path, $value) /*: void*/ { $parts = explode('|', trim($path, '|')); $current = &$this->root; while (count($parts) > 0) { $part = array_shift($parts); if (!isset($current[$part])) { $current[$part] = []; } $current = &$current[$part]; } $current = $value; } public function has(string $path): bool { $parts = explode('|', trim($path, '|')); $current = &$this->root; while (count($parts) > 0) { $part = array_shift($parts); if (!isset($current[$part])) { return false; } $current = &$current[$part]; } return true; } public function jsonSerialize() { return $this->root; } } // file: src/Tqdev/PhpCrudApi/OpenApi/OpenApiService.php class OpenApiService { private $builder; public function __construct(ReflectionService $reflection, array $base) { $this->builder = new OpenApiBuilder($reflection, $base); } public function get(): OpenApiDefinition { return $this->builder->build(); } } // file: src/Tqdev/PhpCrudApi/Record/Condition/AndCondition.php class AndCondition extends Condition { private $conditions; public function __construct(Condition $condition1, Condition $condition2) { $this->conditions = [$condition1, $condition2]; } public function _and(Condition $condition): Condition { if ($condition instanceof NoCondition) { return $this; } $this->conditions[] = $condition; return $this; } public function getConditions(): array { return $this->conditions; } public static function fromArray(array $conditions): Condition { $condition = new NoCondition(); foreach ($conditions as $c) { $condition = $condition->_and($c); } return $condition; } } // file: src/Tqdev/PhpCrudApi/Record/Condition/ColumnCondition.php class ColumnCondition extends Condition { private $column; private $operator; private $value; public function __construct(ReflectedColumn $column, string $operator, string $value) { $this->column = $column; $this->operator = $operator; $this->value = $value; } public function getColumn(): ReflectedColumn { return $this->column; } public function getOperator(): string { return $this->operator; } public function getValue(): string { return $this->value; } } // file: src/Tqdev/PhpCrudApi/Record/Condition/Condition.php abstract class Condition { public function _and(Condition $condition): Condition { if ($condition instanceof NoCondition) { return $this; } return new AndCondition($this, $condition); } public function _or(Condition $condition): Condition { if ($condition instanceof NoCondition) { return $this; } return new OrCondition($this, $condition); } public function _not(): Condition { return new NotCondition($this); } public static function fromString(ReflectedTable $table, string $value): Condition { $condition = new NoCondition(); $parts = explode(',', $value, 3); if (count($parts) < 2) { return $condition; } if (count($parts) < 3) { $parts[2] = ''; } $field = $table->getColumn($parts[0]); $command = $parts[1]; $negate = false; $spatial = false; if (strlen($command) > 2) { if (substr($command, 0, 1) == 'n') { $negate = true; $command = substr($command, 1); } if (substr($command, 0, 1) == 's') { $spatial = true; $command = substr($command, 1); } } if ($spatial) { if (in_array($command, ['co', 'cr', 'di', 'eq', 'in', 'ov', 'to', 'wi', 'ic', 'is', 'iv'])) { $condition = new SpatialCondition($field, $command, $parts[2]); } } else { if (in_array($command, ['cs', 'sw', 'ew', 'eq', 'lt', 'le', 'ge', 'gt', 'bt', 'in', 'is'])) { $condition = new ColumnCondition($field, $command, $parts[2]); } } if ($negate) { $condition = $condition->_not(); } return $condition; } } // file: src/Tqdev/PhpCrudApi/Record/Condition/NoCondition.php class NoCondition extends Condition { public function _and(Condition $condition): Condition { return $condition; } public function _or(Condition $condition): Condition { return $condition; } public function _not(): Condition { return $this; } } // file: src/Tqdev/PhpCrudApi/Record/Condition/NotCondition.php class NotCondition extends Condition { private $condition; public function __construct(Condition $condition) { $this->condition = $condition; } public function getCondition(): Condition { return $this->condition; } } // file: src/Tqdev/PhpCrudApi/Record/Condition/OrCondition.php class OrCondition extends Condition { private $conditions; public function __construct(Condition $condition1, Condition $condition2) { $this->conditions = [$condition1, $condition2]; } public function _or(Condition $condition): Condition { if ($condition instanceof NoCondition) { return $this; } $this->conditions[] = $condition; return $this; } public function getConditions(): array { return $this->conditions; } public static function fromArray(array $conditions): Condition { $condition = new NoCondition(); foreach ($conditions as $c) { $condition = $condition->_or($c); } return $condition; } } // file: src/Tqdev/PhpCrudApi/Record/Condition/SpatialCondition.php class SpatialCondition extends ColumnCondition { } // file: src/Tqdev/PhpCrudApi/Record/Document/ErrorDocument.php class ErrorDocument implements \JsonSerializable { public $code; public $message; public $details; public function __construct(ErrorCode $errorCode, string $argument, $details) { $this->code = $errorCode->getCode(); $this->message = $errorCode->getMessage($argument); $this->details = $details; } public function getCode(): int { return $this->code; } public function getMessage(): string { return $this->message; } public function serialize() { return [ 'code' => $this->code, 'message' => $this->message, 'details' => $this->details, ]; } public function jsonSerialize() { return array_filter($this->serialize()); } } // file: src/Tqdev/PhpCrudApi/Record/Document/ListDocument.php class ListDocument implements \JsonSerializable { private $records; private $results; public function __construct(array $records, int $results) { $this->records = $records; $this->results = $results; } public function getRecords(): array { return $this->records; } public function getResults(): int { return $this->results; } public function serialize() { return [ 'records' => $this->records, 'results' => $this->results, ]; } public function jsonSerialize() { return array_filter($this->serialize(), function ($v) { return $v !== 0; }); } } // file: src/Tqdev/PhpCrudApi/Record/ColumnIncluder.php class ColumnIncluder { private function isMandatory(string $tableName, string $columnName, array $params): bool { return isset($params['mandatory']) && in_array($tableName . "." . $columnName, $params['mandatory']); } private function select(string $tableName, bool $primaryTable, array $params, string $paramName, array $columnNames, bool $include): array{ if (!isset($params[$paramName])) { return $columnNames; } $columns = array(); foreach (explode(',', $params[$paramName][0]) as $columnName) { $columns[$columnName] = true; } $result = array(); foreach ($columnNames as $columnName) { $match = isset($columns['*.*']); if (!$match) { $match = isset($columns[$tableName . '.*']) || isset($columns[$tableName . '.' . $columnName]); } if ($primaryTable && !$match) { $match = isset($columns['*']) || isset($columns[$columnName]); } if ($match) { if ($include || $this->isMandatory($tableName, $columnName, $params)) { $result[] = $columnName; } } else { if (!$include || $this->isMandatory($tableName, $columnName, $params)) { $result[] = $columnName; } } } return $result; } public function getNames(ReflectedTable $table, bool $primaryTable, array $params): array { $tableName = $table->getName(); $results = $table->getColumnNames(); $results = $this->select($tableName, $primaryTable, $params, 'include', $results, true); $results = $this->select($tableName, $primaryTable, $params, 'exclude', $results, false); return $results; } public function getValues(ReflectedTable $table, bool $primaryTable, /* object */ $record, array $params): array { $results = array(); $columnNames = $this->getNames($table, $primaryTable, $params); foreach ($columnNames as $columnName) { if (property_exists($record, $columnName)) { $results[$columnName] = $record->$columnName; } } return $results; } } // file: src/Tqdev/PhpCrudApi/Record/ErrorCode.php class ErrorCode { private $code; private $message; private $status; const ERROR_NOT_FOUND = 9999; const ROUTE_NOT_FOUND = 1000; const TABLE_NOT_FOUND = 1001; const ARGUMENT_COUNT_MISMATCH = 1002; const RECORD_NOT_FOUND = 1003; const ORIGIN_FORBIDDEN = 1004; const COLUMN_NOT_FOUND = 1005; const TABLE_ALREADY_EXISTS = 1006; const COLUMN_ALREADY_EXISTS = 1007; const HTTP_MESSAGE_NOT_READABLE = 1008; const DUPLICATE_KEY_EXCEPTION = 1009; const DATA_INTEGRITY_VIOLATION = 1010; const AUTHENTICATION_REQUIRED = 1011; const AUTHENTICATION_FAILED = 1012; const INPUT_VALIDATION_FAILED = 1013; const OPERATION_FORBIDDEN = 1014; const OPERATION_NOT_SUPPORTED = 1015; const TEMPORARY_OR_PERMANENTLY_BLOCKED = 1016; const BAD_OR_MISSING_XSRF_TOKEN = 1017; const ONLY_AJAX_REQUESTS_ALLOWED = 1018; const PAGINATION_FORBIDDEN = 1019; private $values = [ 9999 => ["%s", ResponseFactory::INTERNAL_SERVER_ERROR], 1000 => ["Route '%s' not found", ResponseFactory::NOT_FOUND], 1001 => ["Table '%s' not found", ResponseFactory::NOT_FOUND], 1002 => ["Argument count mismatch in '%s'", ResponseFactory::UNPROCESSABLE_ENTITY], 1003 => ["Record '%s' not found", ResponseFactory::NOT_FOUND], 1004 => ["Origin '%s' is forbidden", ResponseFactory::FORBIDDEN], 1005 => ["Column '%s' not found", ResponseFactory::NOT_FOUND], 1006 => ["Table '%s' already exists", ResponseFactory::CONFLICT], 1007 => ["Column '%s' already exists", ResponseFactory::CONFLICT], 1008 => ["Cannot read HTTP message", ResponseFactory::UNPROCESSABLE_ENTITY], 1009 => ["Duplicate key exception", ResponseFactory::CONFLICT], 1010 => ["Data integrity violation", ResponseFactory::CONFLICT], 1011 => ["Authentication required", ResponseFactory::UNAUTHORIZED], 1012 => ["Authentication failed for '%s'", ResponseFactory::FORBIDDEN], 1013 => ["Input validation failed for '%s'", ResponseFactory::UNPROCESSABLE_ENTITY], 1014 => ["Operation forbidden", ResponseFactory::FORBIDDEN], 1015 => ["Operation '%s' not supported", ResponseFactory::METHOD_NOT_ALLOWED], 1016 => ["Temporary or permanently blocked", ResponseFactory::FORBIDDEN], 1017 => ["Bad or missing XSRF token", ResponseFactory::FORBIDDEN], 1018 => ["Only AJAX requests allowed for '%s'", ResponseFactory::FORBIDDEN], 1019 => ["Pagination forbidden", ResponseFactory::FORBIDDEN], ]; public function __construct(int $code) { if (!isset($this->values[$code])) { $code = 9999; } $this->code = $code; $this->message = $this->values[$code][0]; $this->status = $this->values[$code][1]; } public function getCode(): int { return $this->code; } public function getMessage(string $argument): string { return sprintf($this->message, $argument); } public function getStatus(): int { return $this->status; } } // file: src/Tqdev/PhpCrudApi/Record/FilterInfo.php class FilterInfo { private function addConditionFromFilterPath(PathTree $conditions, array $path, ReflectedTable $table, array $params) { $key = 'filter' . implode('', $path); if (isset($params[$key])) { foreach ($params[$key] as $filter) { $condition = Condition::fromString($table, $filter); if (($condition instanceof NoCondition) == false) { $conditions->put($path, $condition); } } } } private function getConditionsAsPathTree(ReflectedTable $table, array $params): PathTree { $conditions = new PathTree(); $this->addConditionFromFilterPath($conditions, [], $table, $params); for ($n = ord('0'); $n <= ord('9'); $n++) { $this->addConditionFromFilterPath($conditions, [chr($n)], $table, $params); for ($l = ord('a'); $l <= ord('f'); $l++) { $this->addConditionFromFilterPath($conditions, [chr($n), chr($l)], $table, $params); } } return $conditions; } private function combinePathTreeOfConditions(PathTree $tree): Condition { $andConditions = $tree->getValues(); $and = AndCondition::fromArray($andConditions); $orConditions = []; foreach ($tree->getKeys() as $p) { $orConditions[] = $this->combinePathTreeOfConditions($tree->get($p)); } $or = OrCondition::fromArray($orConditions); return $and->_and($or); } public function getCombinedConditions(ReflectedTable $table, array $params): Condition { return $this->combinePathTreeOfConditions($this->getConditionsAsPathTree($table, $params)); } } // file: src/Tqdev/PhpCrudApi/Record/HabtmValues.php class HabtmValues { public $pkValues; public $fkValues; public function __construct(array $pkValues, array $fkValues) { $this->pkValues = $pkValues; $this->fkValues = $fkValues; } } // file: src/Tqdev/PhpCrudApi/Record/OrderingInfo.php class OrderingInfo { public function getColumnOrdering(ReflectedTable $table, array $params): array { $fields = array(); if (isset($params['order'])) { foreach ($params['order'] as $order) { $parts = explode(',', $order, 3); $columnName = $parts[0]; if (!$table->hasColumn($columnName)) { continue; } $ascending = 'ASC'; if (count($parts) > 1) { if (substr(strtoupper($parts[1]), 0, 4) == "DESC") { $ascending = 'DESC'; } } $fields[] = [$columnName, $ascending]; } } if (count($fields) == 0) { return $this->getDefaultColumnOrdering($table); } return $fields; } public function getDefaultColumnOrdering(ReflectedTable $table): array { $fields = array(); $pk = $table->getPk(); if ($pk) { $fields[] = [$pk->getName(), 'ASC']; } else { foreach ($table->getColumnNames() as $columnName) { $fields[] = [$columnName, 'ASC']; } } return $fields; } } // file: src/Tqdev/PhpCrudApi/Record/PaginationInfo.php class PaginationInfo { public $DEFAULT_PAGE_SIZE = 20; public function hasPage(array $params): bool { return isset($params['page']); } public function getPageOffset(array $params): int { $offset = 0; $pageSize = $this->getPageSize($params); if (isset($params['page'])) { foreach ($params['page'] as $page) { $parts = explode(',', $page, 2); $page = intval($parts[0]) - 1; $offset = $page * $pageSize; } } return $offset; } private function getPageSize(array $params): int { $pageSize = $this->DEFAULT_PAGE_SIZE; if (isset($params['page'])) { foreach ($params['page'] as $page) { $parts = explode(',', $page, 2); if (count($parts) > 1) { $pageSize = intval($parts[1]); } } } return $pageSize; } public function getResultSize(array $params): int { $numberOfRows = -1; if (isset($params['size'])) { foreach ($params['size'] as $size) { $numberOfRows = intval($size); } } return $numberOfRows; } public function getPageLimit(array $params): int { $pageLimit = -1; if ($this->hasPage($params)) { $pageLimit = $this->getPageSize($params); } $resultSize = $this->getResultSize($params); if ($resultSize >= 0) { if ($pageLimit >= 0) { $pageLimit = min($pageLimit, $resultSize); } else { $pageLimit = $resultSize; } } return $pageLimit; } } // file: src/Tqdev/PhpCrudApi/Record/PathTree.php class PathTree implements \JsonSerializable { const WILDCARD = '*'; private $tree; public function __construct( /* object */&$tree = null) { if (!$tree) { $tree = $this->newTree(); } $this->tree = &$tree; } public function newTree() { return (object) ['values' => [], 'branches' => (object) []]; } public function getKeys(): array { $branches = (array) $this->tree->branches; return array_keys($branches); } public function getValues(): array { return $this->tree->values; } public function get(string $key): PathTree { if (!isset($this->tree->branches->$key)) { return null; } return new PathTree($this->tree->branches->$key); } public function put(array $path, $value) { $tree = &$this->tree; foreach ($path as $key) { if (!isset($tree->branches->$key)) { $tree->branches->$key = $this->newTree(); } $tree = &$tree->branches->$key; } $tree->values[] = $value; } public function match(array $path): array { $star = self::WILDCARD; $tree = &$this->tree; foreach ($path as $key) { if (isset($tree->branches->$key)) { $tree = &$tree->branches->$key; } else if (isset($tree->branches->$star)) { $tree = &$tree->branches->$star; } else { return []; } } return $tree->values; } public static function fromJson( /* object */$tree): PathTree { return new PathTree($tree); } public function jsonSerialize() { return $this->tree; } } // file: src/Tqdev/PhpCrudApi/Record/RecordService.php class RecordService { private $db; private $reflection; private $columns; private $joiner; private $filters; private $ordering; private $pagination; public function __construct(GenericDB $db, ReflectionService $reflection) { $this->db = $db; $this->reflection = $reflection; $this->columns = new ColumnIncluder(); $this->joiner = new RelationJoiner($reflection, $this->columns); $this->filters = new FilterInfo(); $this->ordering = new OrderingInfo(); $this->pagination = new PaginationInfo(); } private function sanitizeRecord(string $tableName, /* object */ $record, string $id) { $keyset = array_keys((array) $record); foreach ($keyset as $key) { if (!$this->reflection->getTable($tableName)->hasColumn($key)) { unset($record->$key); } } if ($id != '') { $pk = $this->reflection->getTable($tableName)->getPk(); foreach ($this->reflection->getTable($tableName)->getColumnNames() as $key) { $field = $this->reflection->getTable($tableName)->getColumn($key); if ($field->getName() == $pk->getName()) { unset($record->$key); } } } } public function hasTable(string $table): bool { return $this->reflection->hasTable($table); } public function getType(string $table): string { return $this->reflection->getType($table); } public function create(string $tableName, /* object */ $record, array $params) /*: ?int*/ { $this->sanitizeRecord($tableName, $record, ''); $table = $this->reflection->getTable($tableName); $columnValues = $this->columns->getValues($table, true, $record, $params); return $this->db->createSingle($table, $columnValues); } public function read(string $tableName, string $id, array $params) /*: ?object*/ { $table = $this->reflection->getTable($tableName); $this->joiner->addMandatoryColumns($table, $params); $columnNames = $this->columns->getNames($table, true, $params); $record = $this->db->selectSingle($table, $columnNames, $id); if ($record == null) { return null; } $records = array($record); $this->joiner->addJoins($table, $records, $params, $this->db); return $records[0]; } public function update(string $tableName, string $id, /* object */ $record, array $params) /*: ?int*/ { $this->sanitizeRecord($tableName, $record, $id); $table = $this->reflection->getTable($tableName); $columnValues = $this->columns->getValues($table, true, $record, $params); return $this->db->updateSingle($table, $columnValues, $id); } public function delete(string $tableName, string $id, array $params) /*: ?int*/ { $table = $this->reflection->getTable($tableName); return $this->db->deleteSingle($table, $id); } public function increment(string $tableName, string $id, /* object */ $record, array $params) /*: ?int*/ { $this->sanitizeRecord($tableName, $record, $id); $table = $this->reflection->getTable($tableName); $columnValues = $this->columns->getValues($table, true, $record, $params); return $this->db->incrementSingle($table, $columnValues, $id); } public function _list(string $tableName, array $params): ListDocument { $table = $this->reflection->getTable($tableName); $this->joiner->addMandatoryColumns($table, $params); $columnNames = $this->columns->getNames($table, true, $params); $condition = $this->filters->getCombinedConditions($table, $params); $columnOrdering = $this->ordering->getColumnOrdering($table, $params); if (!$this->pagination->hasPage($params)) { $offset = 0; $limit = $this->pagination->getPageLimit($params); $count = 0; } else { $offset = $this->pagination->getPageOffset($params); $limit = $this->pagination->getPageLimit($params); $count = $this->db->selectCount($table, $condition); } $records = $this->db->selectAll($table, $columnNames, $condition, $columnOrdering, $offset, $limit); $this->joiner->addJoins($table, $records, $params, $this->db); return new ListDocument($records, $count); } } // file: src/Tqdev/PhpCrudApi/Record/RelationJoiner.php class RelationJoiner { private $reflection; private $columns; public function __construct(ReflectionService $reflection, ColumnIncluder $columns) { $this->reflection = $reflection; $this->ordering = new OrderingInfo(); $this->columns = $columns; } public function addMandatoryColumns(ReflectedTable $table, array &$params) /*: void*/ { if (!isset($params['join']) || !isset($params['include'])) { return; } $params['mandatory'] = array(); foreach ($params['join'] as $tableNames) { $t1 = $table; foreach (explode(',', $tableNames) as $tableName) { if (!$this->reflection->hasTable($tableName)) { continue; } $t2 = $this->reflection->getTable($tableName); $fks1 = $t1->getFksTo($t2->getName()); $t3 = $this->hasAndBelongsToMany($t1, $t2); if ($t3 != null || count($fks1) > 0) { $params['mandatory'][] = $t2->getName() . '.' . $t2->getPk()->getName(); } foreach ($fks1 as $fk) { $params['mandatory'][] = $t1->getName() . '.' . $fk->getName(); } $fks2 = $t2->getFksTo($t1->getName()); if ($t3 != null || count($fks2) > 0) { $params['mandatory'][] = $t1->getName() . '.' . $t1->getPk()->getName(); } foreach ($fks2 as $fk) { $params['mandatory'][] = $t2->getName() . '.' . $fk->getName(); } $t1 = $t2; } } } private function getJoinsAsPathTree(array $params): PathTree { $joins = new PathTree(); if (isset($params['join'])) { foreach ($params['join'] as $tableNames) { $path = array(); foreach (explode(',', $tableNames) as $tableName) { $t = $this->reflection->getTable($tableName); if ($t != null) { $path[] = $t->getName(); } } $joins->put($path, true); } } return $joins; } public function addJoins(ReflectedTable $table, array &$records, array $params, GenericDB $db) /*: void*/ { $joins = $this->getJoinsAsPathTree($params); $this->addJoinsForTables($table, $joins, $records, $params, $db); } private function hasAndBelongsToMany(ReflectedTable $t1, ReflectedTable $t2) /*: ?ReflectedTable*/ { foreach ($this->reflection->getTableNames() as $tableName) { $t3 = $this->reflection->getTable($tableName); if (count($t3->getFksTo($t1->getName())) > 0 && count($t3->getFksTo($t2->getName())) > 0) { return $t3; } } return null; } private function addJoinsForTables(ReflectedTable $t1, PathTree $joins, array &$records, array $params, GenericDB $db) { foreach ($joins->getKeys() as $t2Name) { $t2 = $this->reflection->getTable($t2Name); $belongsTo = count($t1->getFksTo($t2->getName())) > 0; $hasMany = count($t2->getFksTo($t1->getName())) > 0; if (!$belongsTo && !$hasMany) { $t3 = $this->hasAndBelongsToMany($t1, $t2); } else { $t3 = null; } $hasAndBelongsToMany = ($t3 != null); $newRecords = array(); $fkValues = null; $pkValues = null; $habtmValues = null; if ($belongsTo) { $fkValues = $this->getFkEmptyValues($t1, $t2, $records); $this->addFkRecords($t2, $fkValues, $params, $db, $newRecords); } if ($hasMany) { $pkValues = $this->getPkEmptyValues($t1, $records); $this->addPkRecords($t1, $t2, $pkValues, $params, $db, $newRecords); } if ($hasAndBelongsToMany) { $habtmValues = $this->getHabtmEmptyValues($t1, $t2, $t3, $db, $records); $this->addFkRecords($t2, $habtmValues->fkValues, $params, $db, $newRecords); } $this->addJoinsForTables($t2, $joins->get($t2Name), $newRecords, $params, $db); if ($fkValues != null) { $this->fillFkValues($t2, $newRecords, $fkValues); $this->setFkValues($t1, $t2, $records, $fkValues); } if ($pkValues != null) { $this->fillPkValues($t1, $t2, $newRecords, $pkValues); $this->setPkValues($t1, $t2, $records, $pkValues); } if ($habtmValues != null) { $this->fillFkValues($t2, $newRecords, $habtmValues->fkValues); $this->setHabtmValues($t1, $t2, $records, $habtmValues); } } } private function getFkEmptyValues(ReflectedTable $t1, ReflectedTable $t2, array $records): array { $fkValues = array(); $fks = $t1->getFksTo($t2->getName()); foreach ($fks as $fk) { $fkName = $fk->getName(); foreach ($records as $record) { if (isset($record[$fkName])) { $fkValue = $record[$fkName]; $fkValues[$fkValue] = null; } } } return $fkValues; } private function addFkRecords(ReflectedTable $t2, array $fkValues, array $params, GenericDB $db, array &$records) /*: void*/ { $columnNames = $this->columns->getNames($t2, false, $params); $fkIds = array_keys($fkValues); foreach ($db->selectMultiple($t2, $columnNames, $fkIds) as $record) { $records[] = $record; } } private function fillFkValues(ReflectedTable $t2, array $fkRecords, array &$fkValues) /*: void*/ { $pkName = $t2->getPk()->getName(); foreach ($fkRecords as $fkRecord) { $pkValue = $fkRecord[$pkName]; $fkValues[$pkValue] = $fkRecord; } } private function setFkValues(ReflectedTable $t1, ReflectedTable $t2, array &$records, array $fkValues) /*: void*/ { $fks = $t1->getFksTo($t2->getName()); foreach ($fks as $fk) { $fkName = $fk->getName(); foreach ($records as $i => $record) { if (isset($record[$fkName])) { $key = $record[$fkName]; $records[$i][$fkName] = $fkValues[$key]; } } } } private function getPkEmptyValues(ReflectedTable $t1, array $records): array { $pkValues = array(); $pkName = $t1->getPk()->getName(); foreach ($records as $record) { $key = $record[$pkName]; $pkValues[$key] = array(); } return $pkValues; } private function addPkRecords(ReflectedTable $t1, ReflectedTable $t2, array $pkValues, array $params, GenericDB $db, array &$records) /*: void*/ { $fks = $t2->getFksTo($t1->getName()); $columnNames = $this->columns->getNames($t2, false, $params); $pkValueKeys = implode(',', array_keys($pkValues)); $conditions = array(); foreach ($fks as $fk) { $conditions[] = new ColumnCondition($fk, 'in', $pkValueKeys); } $condition = OrCondition::fromArray($conditions); $columnOrdering = array(); $limit = VariableStore::get("joinLimits.maxRecords") ?: -1; if ($limit != -1) { $columnOrdering = $this->ordering->getDefaultColumnOrdering($t2); } foreach ($db->selectAll($t2, $columnNames, $condition, $columnOrdering, 0, $limit) as $record) { $records[] = $record; } } private function fillPkValues(ReflectedTable $t1, ReflectedTable $t2, array $pkRecords, array &$pkValues) /*: void*/ { $fks = $t2->getFksTo($t1->getName()); foreach ($fks as $fk) { $fkName = $fk->getName(); foreach ($pkRecords as $pkRecord) { $key = $pkRecord[$fkName]; if (isset($pkValues[$key])) { $pkValues[$key][] = $pkRecord; } } } } private function setPkValues(ReflectedTable $t1, ReflectedTable $t2, array &$records, array $pkValues) /*: void*/ { $pkName = $t1->getPk()->getName(); $t2Name = $t2->getName(); foreach ($records as $i => $record) { $key = $record[$pkName]; $records[$i][$t2Name] = $pkValues[$key]; } } private function getHabtmEmptyValues(ReflectedTable $t1, ReflectedTable $t2, ReflectedTable $t3, GenericDB $db, array $records): HabtmValues { $pkValues = $this->getPkEmptyValues($t1, $records); $fkValues = array(); $fk1 = $t3->getFksTo($t1->getName())[0]; $fk2 = $t3->getFksTo($t2->getName())[0]; $fk1Name = $fk1->getName(); $fk2Name = $fk2->getName(); $columnNames = array($fk1Name, $fk2Name); $pkIds = implode(',', array_keys($pkValues)); $condition = new ColumnCondition($t3->getColumn($fk1Name), 'in', $pkIds); $columnOrdering = array(); $limit = VariableStore::get("joinLimits.maxRecords") ?: -1; if ($limit != -1) { $columnOrdering = $this->ordering->getDefaultColumnOrdering($t3); } $records = $db->selectAll($t3, $columnNames, $condition, $columnOrdering, 0, $limit); foreach ($records as $record) { $val1 = $record[$fk1Name]; $val2 = $record[$fk2Name]; $pkValues[$val1][] = $val2; $fkValues[$val2] = null; } return new HabtmValues($pkValues, $fkValues); } private function setHabtmValues(ReflectedTable $t1, ReflectedTable $t2, array &$records, HabtmValues $habtmValues) /*: void*/ { $pkName = $t1->getPk()->getName(); $t2Name = $t2->getName(); foreach ($records as $i => $record) { $key = $record[$pkName]; $val = array(); $fks = $habtmValues->pkValues[$key]; foreach ($fks as $fk) { $val[] = $habtmValues->fkValues[$fk]; } $records[$i][$t2Name] = $val; } } } // file: src/Tqdev/PhpCrudApi/Api.php class Api implements RequestHandlerInterface { private $router; private $responder; private $debug; public function __construct(Config $config) { $db = new GenericDB( $config->getDriver(), $config->getAddress(), $config->getPort(), $config->getDatabase(), $config->getUsername(), $config->getPassword() ); $cache = CacheFactory::create($config); $reflection = new ReflectionService($db, $cache, $config->getCacheTime()); $responder = new Responder(); $router = new SimpleRouter($config->getBasePath(), $responder, $cache, $config->getCacheTime(), $config->getDebug()); foreach ($config->getMiddlewares() as $middleware => $properties) { switch ($middleware) { case 'cors': new CorsMiddleware($router, $responder, $properties); break; case 'firewall': new FirewallMiddleware($router, $responder, $properties); break; case 'basicAuth': new BasicAuthMiddleware($router, $responder, $properties); break; case 'jwtAuth': new JwtAuthMiddleware($router, $responder, $properties); break; case 'validation': new ValidationMiddleware($router, $responder, $properties, $reflection); break; case 'ipAddress': new IpAddressMiddleware($router, $responder, $properties, $reflection); break; case 'sanitation': new SanitationMiddleware($router, $responder, $properties, $reflection); break; case 'multiTenancy': new MultiTenancyMiddleware($router, $responder, $properties, $reflection); break; case 'authorization': new AuthorizationMiddleware($router, $responder, $properties, $reflection); break; case 'xsrf': new XsrfMiddleware($router, $responder, $properties); break; case 'pageLimits': new PageLimitsMiddleware($router, $responder, $properties, $reflection); break; case 'joinLimits': new JoinLimitsMiddleware($router, $responder, $properties, $reflection); break; case 'customization': new CustomizationMiddleware($router, $responder, $properties, $reflection); break; } } foreach ($config->getControllers() as $controller) { switch ($controller) { case 'records': $records = new RecordService($db, $reflection); new RecordController($router, $responder, $records); break; case 'columns': $definition = new DefinitionService($db, $reflection); new ColumnController($router, $responder, $reflection, $definition); break; case 'cache': new CacheController($router, $responder, $cache); break; case 'openapi': $openApi = new OpenApiService($reflection, $config->getOpenApiBase()); new OpenApiController($router, $responder, $openApi); break; case 'geojson': $records = new RecordService($db, $reflection); $geoJson = new GeoJsonService($reflection, $records); new GeoJsonController($router, $responder, $geoJson); break; } } $this->router = $router; $this->responder = $responder; $this->debug = $config->getDebug(); } public function handle(ServerRequestInterface $request): ResponseInterface { $response = null; try { $response = $this->router->route($request); } catch (\Throwable $e) { $response = $this->responder->error(ErrorCode::ERROR_NOT_FOUND, $e->getMessage()); if ($this->debug) { $response = ResponseUtils::addExceptionHeaders($response, $e); } } return $response; } } // file: src/Tqdev/PhpCrudApi/Config.php class Config { private $values = [ 'driver' => null, 'address' => 'localhost', 'port' => null, 'username' => null, 'password' => null, 'database' => null, 'middlewares' => 'cors', 'controllers' => 'records,openapi', 'cacheType' => 'TempFile', 'cachePath' => '', 'cacheTime' => 10, 'debug' => false, 'basePath' => '', 'openApiBase' => '{"info":{"title":"PHP-CRUD-API","version":"1.0.0"}}', ]; private function getDefaultDriver(array $values): string { if (isset($values['driver'])) { return $values['driver']; } return 'mysql'; } private function getDefaultPort(string $driver): int { switch ($driver) { case 'mysql':return 3306; case 'pgsql':return 5432; case 'sqlsrv':return 1433; } } private function getDefaultAddress(string $driver): string { switch ($driver) { case 'mysql':return 'localhost'; case 'pgsql':return 'localhost'; case 'sqlsrv':return 'localhost'; } } private function getDriverDefaults(string $driver): array { return [ 'driver' => $driver, 'address' => $this->getDefaultAddress($driver), 'port' => $this->getDefaultPort($driver), ]; } public function __construct(array $values) { $driver = $this->getDefaultDriver($values); $defaults = $this->getDriverDefaults($driver); $newValues = array_merge($this->values, $defaults, $values); $newValues = $this->parseMiddlewares($newValues); $diff = array_diff_key($newValues, $this->values); if (!empty($diff)) { $key = array_keys($diff)[0]; throw new \Exception("Config has invalid value '$key'"); } $this->values = $newValues; } private function parseMiddlewares(array $values): array { $newValues = array(); $properties = array(); $middlewares = array_map('trim', explode(',', $values['middlewares'])); foreach ($middlewares as $middleware) { $properties[$middleware] = []; } foreach ($values as $key => $value) { if (strpos($key, '.') === false) { $newValues[$key] = $value; } else { list($middleware, $key2) = explode('.', $key, 2); if (isset($properties[$middleware])) { $properties[$middleware][$key2] = $value; } else { throw new \Exception("Config has invalid value '$key'"); } } } $newValues['middlewares'] = array_reverse($properties, true); return $newValues; } public function getDriver(): string { return $this->values['driver']; } public function getAddress(): string { return $this->values['address']; } public function getPort(): int { return $this->values['port']; } public function getUsername(): string { return $this->values['username']; } public function getPassword(): string { return $this->values['password']; } public function getDatabase(): string { return $this->values['database']; } public function getMiddlewares(): array { return $this->values['middlewares']; } public function getControllers(): array { return array_map('trim', explode(',', $this->values['controllers'])); } public function getCacheType(): string { return $this->values['cacheType']; } public function getCachePath(): string { return $this->values['cachePath']; } public function getCacheTime(): int { return $this->values['cacheTime']; } public function getDebug(): bool { return $this->values['debug']; } public function getBasePath(): string { return $this->values['basePath']; } public function getOpenApiBase(): array { return json_decode($this->values['openApiBase'], true); } } // file: src/Tqdev/PhpCrudApi/RequestFactory.php class RequestFactory { private static function parseBody(string $body) /*: ?object*/ { $first = substr($body, 0, 1); if ($first == '[' || $first == '{') { $object = json_decode($body); $causeCode = json_last_error(); if ($causeCode !== JSON_ERROR_NONE) { $object = null; } } else { parse_str($body, $input); foreach ($input as $key => $value) { if (substr($key, -9) == '__is_null') { $input[substr($key, 0, -9)] = null; unset($input[$key]); } } $object = (object) $input; } return $object; } public static function fromGlobals(): ServerRequestInterface { $psr17Factory = new Psr17Factory(); $creator = new ServerRequestCreator($psr17Factory, $psr17Factory, $psr17Factory, $psr17Factory); $serverRequest = $creator->fromGlobals(); $body = file_get_contents('php://input'); if ($body) { $serverRequest = $serverRequest->withParsedBody(self::parseBody($body)); } return $serverRequest; } public static function fromString(string $request): ServerRequestInterface { $parts = explode("\n\n", trim($request), 2); $lines = explode("\n", $parts[0]); $first = explode(' ', trim(array_shift($lines)), 2); $method = $first[0]; $body = isset($parts[1]) ? $parts[1] : ''; $url = isset($first[1]) ? $first[1] : ''; $psr17Factory = new Psr17Factory(); $serverRequest = $psr17Factory->createServerRequest($method, $url); foreach ($lines as $line) { list($key, $value) = explode(':', $line, 2); $serverRequest = $serverRequest->withAddedHeader($key, $value); } if ($body) { $stream = $psr17Factory->createStream($body); $stream->rewind(); $serverRequest = $serverRequest->withBody($stream); $serverRequest = $serverRequest->withParsedBody(self::parseBody($body)); } return $serverRequest; } } // file: src/Tqdev/PhpCrudApi/RequestUtils.php class RequestUtils { public static function setParams(ServerRequestInterface $request, array $params): ServerRequestInterface { $query = preg_replace('|%5B[0-9]+%5D=|', '=', http_build_query($params)); return $request->withUri($request->getUri()->withQuery($query)); } public static function getHeader(ServerRequestInterface $request, string $header): string { $headers = $request->getHeader($header); return isset($headers[0]) ? $headers[0] : ''; } public static function getParams(ServerRequestInterface $request): array { $params = array(); $query = $request->getUri()->getQuery(); $query = str_replace('][]=', ']=', str_replace('=', '[]=', $query)); parse_str($query, $params); return $params; } public static function getPathSegment(ServerRequestInterface $request, int $part): string { $path = $request->getUri()->getPath(); $pathSegments = explode('/', rtrim($path, '/')); if ($part < 0 || $part >= count($pathSegments)) { return ''; } return urldecode($pathSegments[$part]); } public static function getOperation(ServerRequestInterface $request): string { $method = $request->getMethod(); $path = RequestUtils::getPathSegment($request, 1); $hasPk = RequestUtils::getPathSegment($request, 3) != ''; switch ($path) { case 'openapi': return 'document'; case 'columns': return $method == 'get' ? 'reflect' : 'remodel'; case 'records': switch ($method) { case 'POST': return 'create'; case 'GET': return $hasPk ? 'read' : 'list'; case 'PUT': return 'update'; case 'DELETE': return 'delete'; case 'PATCH': return 'increment'; } } return 'unknown'; } private static function getJoinTables(string $tableName, array $parameters): array { $uniqueTableNames = array(); $uniqueTableNames[$tableName] = true; if (isset($parameters['join'])) { foreach ($parameters['join'] as $parameter) { $tableNames = explode(',', trim($parameter)); foreach ($tableNames as $tableName) { $uniqueTableNames[$tableName] = true; } } } return array_keys($uniqueTableNames); } public static function getTableNames(ServerRequestInterface $request, ReflectionService $reflection): array { $path = RequestUtils::getPathSegment($request, 1); $tableName = RequestUtils::getPathSegment($request, 2); $allTableNames = $reflection->getTableNames(); switch ($path) { case 'openapi': return $allTableNames; case 'columns': return $tableName ? [$tableName] : $allTableNames; case 'records': return self::getJoinTables($tableName, RequestUtils::getParams($request)); } return $allTableNames; } } // file: src/Tqdev/PhpCrudApi/ResponseFactory.php class ResponseFactory { const OK = 200; const UNAUTHORIZED = 401; const FORBIDDEN = 403; const NOT_FOUND = 404; const METHOD_NOT_ALLOWED = 405; const CONFLICT = 409; const UNPROCESSABLE_ENTITY = 422; const INTERNAL_SERVER_ERROR = 500; public static function fromObject(int $status, $body): ResponseInterface { $psr17Factory = new Psr17Factory(); $response = $psr17Factory->createResponse($status); $content = json_encode($body, JSON_UNESCAPED_UNICODE); $stream = $psr17Factory->createStream($content); $stream->rewind(); $response = $response->withBody($stream); $response = $response->withHeader('Content-Type', 'application/json'); $response = $response->withHeader('Content-Length', strlen($content)); return $response; } public static function fromStatus(int $status): ResponseInterface { $psr17Factory = new Psr17Factory(); return $psr17Factory->createResponse($status); } } // file: src/Tqdev/PhpCrudApi/ResponseUtils.php class ResponseUtils { public static function output(ResponseInterface $response) { $status = $response->getStatusCode(); $headers = $response->getHeaders(); $body = $response->getBody()->getContents(); http_response_code($status); foreach ($headers as $key => $values) { foreach ($values as $value) { header("$key: $value"); } } echo $body; } public static function addExceptionHeaders(ResponseInterface $response, \Throwable $e): ResponseInterface { $response = $response->withHeader('X-Exception-Name', get_class($e)); $response = $response->withHeader('X-Exception-Message', preg_replace('|\n|', ' ', trim($e->getMessage()))); $response = $response->withHeader('X-Exception-File', $e->getFile() . ':' . $e->getLine()); return $response; } public static function toString(ResponseInterface $response): string { $status = $response->getStatusCode(); $headers = $response->getHeaders(); $body = $response->getBody()->getContents(); $str = "$status\n"; foreach ($headers as $key => $values) { foreach ($values as $value) { $str .= "$key: $value\n"; } } if ($body !== '') { $str .= "\n"; $str .= "$body\n"; } return $str; } } // file: src/index.php $config = new Config([ 'username' => 'php-crud-api', 'password' => 'php-crud-api', 'database' => 'php-crud-api', ]); $request = RequestFactory::fromGlobals(); $api = new Api($config); $response = $api->handle($request); ResponseUtils::output($response);