. */ declare(strict_types=1); use Fig\Http\Message\StatusCodeInterface; use Fisharebest\Webtrees\Application; use Fisharebest\Webtrees\Html; use Fisharebest\Webtrees\Session; use Fisharebest\Webtrees\View as WebtreesView; use Fisharebest\Webtrees\Webtrees; use Psr\Http\Message\ResponseFactoryInterface; use Psr\Http\Message\ResponseInterface; use Psr\Http\Message\StreamFactoryInterface; /** * Get the IoC container, or fetch something from it. * * @param string|null $abstract * * @return mixed */ function app(string $abstract = null) { if ($abstract === null) { return Application::getInstance(); } return Application::getInstance()->make($abstract); } /** * Generate a URL to an asset file in the public folder. * Add a version parameter for cache-busting. * * @param string $path * * @return string */ function asset(string $path): string { if (Webtrees::STABILITY === '') { $version = Webtrees::VERSION; } else { $version = filemtime(Webtrees::ROOT_DIR . 'public/' . $path); } return 'public/' . $path . '?v=' . $version; } /** * Generate a CSRF token form field. * * @return string */ function csrf_field() { return ''; } /** * Get the CSRF token value. * * @return string */ function csrf_token() { return Session::getCsrfToken(); } /** * @param string $url * @param int $code * * @return ResponseInterface */ function redirect(string $url, $code = StatusCodeInterface::STATUS_FOUND): ResponseInterface { /** @var ResponseFactoryInterface $response_factory */ $response_factory = app(ResponseFactoryInterface::class); return $response_factory ->createResponse($code) ->withHeader('Location', $url); } /** * Create a response. * * @param mixed $content * @param int $code * @param string[] $headers * * @return ResponseInterface */ function response($content = '', $code = StatusCodeInterface::STATUS_OK, $headers = []): ResponseInterface { if ($headers === []) { if (is_string($content)) { $headers = [ 'Content-Type' => 'text/html; charset=utf-8', 'Content-Length' => strlen($content), ]; } else { $content = json_encode($content, JSON_HEX_TAG | JSON_HEX_APOS | JSON_HEX_AMP | JSON_HEX_QUOT); $headers = [ 'Content-Type' => 'application/json', 'Content-Length' => strlen($content), ]; } } /** @var ResponseFactoryInterface $response_factory */ $response_factory = app(ResponseFactoryInterface::class); /** @var StreamFactoryInterface $stream_factory */ $stream_factory = app(StreamFactoryInterface::class); $stream = $stream_factory->createStream($content); $response = $response_factory ->createResponse($code) ->withBody($stream); foreach ($headers as $key => $value) { $response = $response->withHeader($key, $value); } return $response; } /** * Generate a URL for a named route. * * @param string $route * @param array $parameters * @param bool $absolute * * @return string */ function route(string $route, array $parameters = [], bool $absolute = true): string { $parameters = ['route' => $route] + $parameters; if ($absolute) { return Html::url(WT_BASE_URL . 'index.php', $parameters); } return Html::url('index.php', $parameters); } /** * Cerate and render a view in a single operation. * * @param string $name * @param mixed[] $data * * @return string */ function view(string $name, array $data = []) { return WebtreesView::make($name, $data); }