.
*/
declare(strict_types=1);
use Fig\Http\Message\StatusCodeInterface;
use Fisharebest\Webtrees\Registry;
use Fisharebest\Webtrees\Session as WebtreesSession;
use Fisharebest\Webtrees\Validator;
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;
/**
* Get the IoC container, or fetch something from it.
*
* @param string|null $abstract
*
* @return mixed
*/
function app(string $abstract = null)
{
if ($abstract === null) {
return Webtrees::container();
}
return Webtrees::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 (str_ends_with($path, '/')) {
$version = '';
} elseif (Webtrees::STABILITY === '') {
$version = '?v=' . Webtrees::VERSION;
} else {
$version = '?v=' . filemtime(Webtrees::ROOT_DIR . 'public/' . $path);
}
$request = app(ServerRequestInterface::class);
assert($request instanceof ServerRequestInterface);
$base_url = Validator::attributes($request)->string('base_url');
return $base_url . '/public/' . $path . $version;
}
/**
* Generate a CSRF token form field.
*
* @return string
*/
function csrf_field(): string
{
return '';
}
/**
* Get the CSRF token value.
*
* @return string
*/
function csrf_token(): string
{
return WebtreesSession::getCsrfToken();
}
/**
* @param string $url
* @param int $code
*
* @return ResponseInterface
*/
function redirect(string $url, int $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 array|object|string $content
* @param int $code
* @param array $headers
*
* @return ResponseInterface
*/
function response(array|object|string $content = '', int $code = StatusCodeInterface::STATUS_OK, array $headers = []): ResponseInterface
{
return Registry::responseFactory()->response($content, $code, $headers);
}
/**
* Generate a URL for a named route.
*
* @param string $route_name
* @param array|null> $parameters
*
* @return string
*/
function route(string $route_name, array $parameters = []): string
{
return Registry::routeFactory()->route($route_name, $parameters);
}
/**
* Create and render a view in a single operation.
*
* @param string $name
* @param array $data
*
* @return string
*/
function view(string $name, array $data = []): string
{
return WebtreesView::make($name, $data);
}