. */ declare(strict_types=1); use Aura\Router\RouterContainer; 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\ServerRequestInterface; 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 (substr($path, -1) === '/') { $version = ''; } elseif (Webtrees::STABILITY === '') { $version = '?v=' . Webtrees::VERSION; } else { $version = '?v=' . filemtime(Webtrees::ROOT_DIR . 'public/' . $path); } $base_url = app(ServerRequestInterface::class)->getAttribute('base_url'); return $base_url . '/public/' . $path . $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 ($content === '' && $code === StatusCodeInterface::STATUS_OK) { $code = StatusCodeInterface::STATUS_NO_CONTENT; } 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_name * @param mixed[] $parameters * * @return string */ function route(string $route_name, array $parameters = []): string { $request = app(ServerRequestInterface::class); $router_container = app(RouterContainer::class); $route = $router_container->getMap()->getRoute($route_name); // Scheme/user/pass/host needed for absolute URLs. static $prefix = null; if ($prefix === null) { $base_url = $request->getAttribute('base_url'); $base_parts = parse_url($base_url); $prefix = $base_parts['scheme'] . '://'; if (array_key_exists('user', $base_parts)) { $prefix .= rawurlencode($base_parts['user']); if (array_key_exists('pass', $base_parts)) { $prefix .= ':' . rawurlencode($base_parts['pass']); } $prefix .= '@'; } $prefix .= $base_parts['host']; } // Generate the URL. $url = $router_container->getGenerator()->generate($route_name, $parameters); // Aura ignores parameters that are not tokens. We need to add them as query parameters. $parameters = array_filter($parameters, static function (string $key) use ($route): bool { return strpos($route->path, '{' . $key . '}') === false && strpos($route->path, '{/' . $key . '}') === false; }, ARRAY_FILTER_USE_KEY); // Turn the pretty URL into an ugly one. if ($request->getAttribute('rewrite_urls') !== '1') { $path = parse_url($url, PHP_URL_PATH); $parameters = ['route' => $path] + $parameters; $base_url = $request->getAttribute('base_url'); $base_path = parse_url($base_url, PHP_URL_PATH) ?? ''; $url = $base_path . '/index.php'; } return Html::url($url, $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); }