version_strategy

  • Description : Permet de définir une classe PHP personnalisée qui détermine la version d'un asset. Cela offre une flexibilité totale pour la gestion des versions, par exemple en basant la version sur la date de modification du fichier ou sur un autre mécanisme. La classe doit implémenter l'interface Symfony\Component\Asset\VersionStrategy\VersionStrategyInterface.

  • Type : string (nom de la classe) ou null

  • Valeur par défaut : null

  • Exemple :

    YAML
    framework:
        assets:
            version_strategy: App\Asset\TimestampVersionStrategy
    

    Vous devrez ensuite créer la classe App\Asset\TimestampVersionStrategy qui implémente la logique de versionnage souhaitée.




1. Création d'une classe personnalisée pour version_strategy

Vous devez créer une classe qui implémente l'interface Symfony\Component\Asset\VersionStrategy\VersionStrategyInterface.

Exemple de classe personnalisée :

namespace App\Asset; use Symfony\Component\Asset\VersionStrategy\VersionStrategyInterface; class CustomVersionStrategy implements VersionStrategyInterface { private string $version; public function __construct(string $version) { $this->version = $version; } public function getVersion(string $path): string { // Ajoute la version sous forme de paramètre de requête return $this->version; } public function applyVersion(string $path): string { // Ajoute un suffixe de version à l'URL de l'asset return sprintf('%s?v=%s', $path, $this->version); } }
  • getVersion($path): Retourne la version à appliquer.

  • applyVersion($path): Modifie l'URL de l'asset en ajoutant un paramètre ?v=version.


2. Enregistrement du service dans Symfony

Ajoutez cette classe comme un service dans services.yaml :

services: App\Asset\CustomVersionStrategy: arguments: $version: '1.0.0' # Version que vous souhaitez appliquer

3. Configuration du framework.yaml pour utiliser la version_strategy

Ajoutez la configuration pour utiliser votre stratégie personnalisée :

framework: assets: packages: custom_assets: base_path: '/assets' version_strategy: '@App\Asset\CustomVersionStrategy'
  • packages.custom_assets: Définit un package d'assets nommé custom_assets.

  • base_path: '/assets': Indique que les fichiers sont sous /assets.

  • version_strategy: '@App\Asset\CustomVersionStrategy': Utilise notre classe pour gérer la version des assets.


4. Utilisation dans les templates Twig

Dans un template Twig, vous pouvez utiliser :

<link rel="stylesheet" href="{{ asset('css/style.css', 'custom_assets') }}">

Cela générera une URL comme :

/assets/css/style.css?v=1.0.0

Grâce à la CustomVersionStrategy, la version 1.0.0 est ajoutée à l'URL.


Conclusion

  • Créer une classe qui implémente VersionStrategyInterface.

  • L'enregistrer en tant que service dans services.yaml.

  • L'utiliser dans framework.yaml sous version_strategy.

  • L'exploiter dans les templates Twig avec asset().

Cela permet un contrôle total sur la gestion des versions d’assets dans Symfony. 🚀


Powered by Froala Editor