version_strategyDescription : 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 :
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.
version_strategyVous devez créer une classe qui implémente l'interface Symfony\Component\Asset\VersionStrategy\VersionStrategyInterface.
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.
Ajoutez cette classe comme un service dans services.yaml :
services: App\Asset\CustomVersionStrategy: arguments: $version: '1.0.0' # Version que vous souhaitez appliquer
framework.yaml pour utiliser la version_strategyAjoutez 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.
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.
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