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/ */

    

yassrzg / dsfr-card-image-bundle example snippets


// config/bundles.php
return [
    // …
    Yassrzg\DsfrCardImageBundle\DsfrCardImageBundle::class => ['all' => true],
];

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