mirror of
https://github.com/retailcrm/NelmioApiDocBundle.git
synced 2025-02-02 23:59:26 +03:00
4148dfda25
* fixed : add doc blocks to silence Symfony deprecations Symfony 5.4 returning deprecations about ``` User Deprecated: Method "Twig\Extension\ExtensionInterface::getFunctions()" might add "array" as a native return type declaration in the future. Do the same in implementation "Nelmio\ApiDocBundle\Render\Html\GetNelmioAsset" now to avoid errors or add an explicit @return annotation to suppress this message. ``` * fixed : native hint
97 lines
2.8 KiB
PHP
97 lines
2.8 KiB
PHP
<?php
|
|
|
|
/*
|
|
* This file is part of the NelmioApiDocBundle package.
|
|
*
|
|
* (c) Nelmio
|
|
*
|
|
* For the full copyright and license information, please view the LICENSE
|
|
* file that was distributed with this source code.
|
|
*/
|
|
|
|
namespace Nelmio\ApiDocBundle\Render\Html;
|
|
|
|
use Symfony\Bridge\Twig\Extension\AssetExtension;
|
|
use Twig\Extension\AbstractExtension;
|
|
use Twig\TwigFunction;
|
|
|
|
/**
|
|
* @internal
|
|
*/
|
|
class GetNelmioAsset extends AbstractExtension
|
|
{
|
|
private $assetExtension;
|
|
private $resourcesDir;
|
|
private $cdnUrl;
|
|
|
|
public function __construct(AssetExtension $assetExtension)
|
|
{
|
|
$this->assetExtension = $assetExtension;
|
|
$this->cdnUrl = 'https://cdn.jsdelivr.net/gh/nelmio/NelmioApiDocBundle/Resources/public';
|
|
$this->resourcesDir = __DIR__.'/../../Resources/public';
|
|
}
|
|
|
|
public function getFunctions(): array
|
|
{
|
|
return [
|
|
new TwigFunction('nelmioAsset', $this, ['is_safe' => ['html']]),
|
|
];
|
|
}
|
|
|
|
public function __invoke($defaultAssetsMode, $asset)
|
|
{
|
|
[$extension, $mode] = $this->getExtension($defaultAssetsMode, $asset);
|
|
[$resource, $isInline] = $this->getResource($asset, $mode);
|
|
if ('js' == $extension) {
|
|
return $this->renderJavascript($resource, $isInline);
|
|
} elseif ('css' == $extension) {
|
|
return $this->renderCss($resource, $isInline);
|
|
} else {
|
|
return $resource;
|
|
}
|
|
}
|
|
|
|
private function getExtension($assetsMode, $asset)
|
|
{
|
|
$extension = mb_substr($asset, -3, 3, 'utf-8');
|
|
if ('.js' === $extension) {
|
|
return ['js', $assetsMode];
|
|
} elseif ('png' === $extension) {
|
|
return ['png', AssetsMode::OFFLINE == $assetsMode ? AssetsMode::CDN : $assetsMode];
|
|
} else {
|
|
return ['css', $assetsMode];
|
|
}
|
|
}
|
|
|
|
private function getResource($asset, $mode)
|
|
{
|
|
if (filter_var($asset, FILTER_VALIDATE_URL)) {
|
|
return [$asset, false];
|
|
} elseif (AssetsMode::OFFLINE === $mode) {
|
|
return [file_get_contents($this->resourcesDir.'/'.$asset), true];
|
|
} elseif (AssetsMode::CDN === $mode) {
|
|
return [$this->cdnUrl.'/'.$asset, false];
|
|
} else {
|
|
return [$this->assetExtension->getAssetUrl(sprintf('bundles/nelmioapidoc/%s', $asset)), false];
|
|
}
|
|
}
|
|
|
|
private function renderJavascript(string $script, bool $isInline)
|
|
{
|
|
if ($isInline) {
|
|
return sprintf('<script>%s</script>', $script);
|
|
} else {
|
|
return sprintf('<script src="%s"></script>', $script);
|
|
}
|
|
}
|
|
|
|
private function renderCss(string $stylesheet, bool $isInline)
|
|
{
|
|
if ($isInline) {
|
|
return sprintf('<style>%s</style>', $stylesheet);
|
|
} else {
|
|
return sprintf('<link rel="stylesheet" href="%s">', $stylesheet);
|
|
}
|
|
}
|
|
}
|