PHP code example of yassrzg / dsfr-card-image-bundle
1. Go to this page and download the library: Download yassrzg/dsfr-card-image-bundle library. Choose the download type require.
2. Extract the ZIP file and open the index.php.
3. Add this code to the index.php.
<?php
require_once('vendor/autoload.php');
/* Start to develop here. Best regards https://php-download.com/ */
namespace App\Image;
use App\Entity\Picture;
use Symfony\Component\Routing\Generator\UrlGeneratorInterface;
use Yassrzg\DsfrCardImageBundle\Url\ImageUrlResolverInterface;
final readonly class PictureUrlResolver implements ImageUrlResolverInterface
{
public function __construct(private UrlGeneratorInterface $urlGenerator)
{
}
public function supports(mixed $image): bool
{
return $image instanceof Picture;
}
public function url(mixed $image, string $profile): string
{
return $this->urlGenerator->generate('picture_image', ['id' => $image->getId(), 'profile' => $profile]);
}
}
use Symfony\Component\HttpFoundation\Request;
use Symfony\Component\HttpFoundation\Response;
use Symfony\Component\Routing\Attribute\Route;
use Yassrzg\DsfrCardImageBundle\Http\ImageResponseFactory;
#[Route('/picture/{id}/{profile}', name: 'picture_image', methods: ['GET'])]
public function image(Request $request, Picture $picture, string $profile, ImageResponseFactory $responses): Response
{
$this->denyAccessUnlessGranted('VIEW', $picture);
// Chemin absolu de l'original, ou null s'il n'existe pas (image de remplacement).
return $responses->create($request, $this->storage->absolutePath($picture), $profile);
}
yaml
# config/packages/dsfr_card_image.yaml
dsfr_card_image:
# Dossier des images générées (hors de public/ : elles sont servies par une réponse HTTP).
cache_directory: '%kernel.project_dir%/var/card_images'
# Dossier des originaux servis par la route du bundle (chemins relatifs donnés à card_image_url()).
source_directory: '%kernel.project_dir%/public'
# Au-delà (largeur × hauteur), l'original est servi sans traitement (protection de la mémoire).
max_pixels: 40000000
# Format par défaut des profils : auto (WebP si le serveur le gère, sinon PNG ou JPEG), webp, jpeg, png.
format: auto
# Qualité par défaut des profils, de 1 à 100 (PNG : niveau de compression, sans perte).
quality: 82
http_cache:
# Durée de cache navigateur des images, en secondes (puis revalidation par Last-Modified).
max_age: 3600
# true : cache partagé (proxy, CDN) autorisé ; seulement si les images sont publiques.
public: false
# Profils : remplacent entièrement les profils par défaut dès qu'un profil est déclaré.
profiles:
card: { width: 800, height: 450, mode: cover }
card_contain: { width: 800, height: 450, mode: contain }
shell
php bin/console dsfr-card-image:purge # toutes les images générées
php bin/console dsfr-card-image:purge card # celles du profil « card »
shell
composer install
vendor/bin/phpunit # tests unitaires et fonctionnels
vendor/bin/phpstan analyse # analyse statique, niveau max
vendor/bin/php-cs-fixer fix --dry-run --diff
Loading please wait ...
Before you can download the PHP files, the dependencies should be resolved. This can take some minutes. Please be patient.