.
*/
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;
/**
* 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 = Registry::container()->get(ServerRequestInterface::class);
$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
{
$response_factory = Registry::container()->get(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);
}