xorgxx / neox-media-bundle

dev-main 2026-09-01 13:34 UTC

Requires

• php: >=8.2
• doctrine/doctrine-bundle: ^2.12 || ^3.0
• doctrine/orm: ^3.0
• liip/imagine-bundle: ^2.16
• symfony/form: ^7.0 || ^8.0
• symfony/framework-bundle: ^7.0 || ^8.0
• symfony/messenger: ^7.0 || ^8.0
• symfony/security-bundle: ^7.0 || ^8.0
• symfony/twig-bundle: ^7.0 || ^8.0
• symfony/validator: ^7.0 || ^8.0
• symfony/yaml: ^7.0 || ^8.0
• vich/uploader-bundle: ^2.9

Requires (Dev)

• friendsofphp/php-cs-fixer: ^3.64
• phpstan/phpstan: ^2.0
• phpstan/phpstan-doctrine: ^2.0
• phpstan/phpstan-symfony: ^2.0
• phpunit/phpunit: ^10.0 || ^11.0
• symfony/browser-kit: ^7.0 || ^8.0
• symfony/phpunit-bridge: ^7.0 || ^8.0

Suggests

• php-ffmpeg/php-ffmpeg: Optional video/audio processing.
• symfony/asset-mapper: Recommended to expose the bundled Stimulus controllers and CSS.
• symfony/mercure-bundle: Optional live processing updates.

Conflicts

• symfony/framework-bundle: <7.0

MIT

Published on Packagist.org on 2026-09-01 13:39 UTC

README

📚 Documentation complète — Français | English

Compatibilité

Runtime	Version
PHP	>= 8.2
Symfony 7	PHP >= 8.2 selon la version Symfony utilisée
Symfony 8	PHP >= 8.4 obligatoire
Doctrine ORM	^3.0
VichUploaderBundle	^2.9
LiipImagineBundle	^2.16

Le même package couvre Symfony 7 et Symfony 8. Composer résout automatiquement la branche Symfony compatible avec la version de PHP du projet.

Pour tester Symfony 8 :

composer require symfony/framework-bundle:^8.0

Symfony 8 nécessite PHP 8.4 ou supérieur.

Base réutilisable pour Symfony 7 et Symfony 8.

Objectif

L'application métier ne stocke ni chemin, ni filename, ni URL technique. Elle référence uniquement Neox\MediaBundle\Entity\Media.

Sources supportées par le modèle :

• FILE
• URL
• EMBED
• REMOTE

Le bundle centralise :

• VichUploader pour les fichiers uploadés
• LiipImagine pour les variantes d'images
• MediaPickerType pour sélectionner un média
• attribut #[MediaField] pour décrire l'usage métier
• Twig neox_media_url() / neox_media_render()
• Messenger pour le post-traitement

Exemple dans l'application

#[ORM\ManyToOne(targetEntity: Media::class)]
#[ORM\JoinColumn(onDelete: 'SET NULL')]
#[MediaField(role: 'cover', accept: ['image/*'])]
private ?Media $cover = null;

Le bundle ne connaît pas Product, Article, User, etc.

Configuration

Importer les routes :

neox_media:
    resource: '@NeoxMediaBundle/config/routes.yaml'

Configurer Vich et LiipImagine à partir des exemples dans config/packages/.

Notes

Le squelette est volontairement extensible. Le stockage FILE est prêt pour Vich. REMOTE est prévu pour un futur adapter S3/R2/MinIO. EMBED/URL sont modélisés sans imposer de provider.

Media Manager visuel

Le bundle fournit maintenant une couche de médiathèque réutilisable :

• grille responsive ;
• recherche ;
• filtres par type ;
• upload multiple ;
• drag & drop ;
• sélection simple/multiple en modale ;
• inspecteur de média ;
• édition titre / alt / description ;
• suppression ;
• collections ;
• API JSON ;
• bridge optionnel vers les systèmes CRUD.

Route principale :

/admin/media

Dans une entité métier :

#[ORM\ManyToOne(targetEntity: Media::class)]
#[MediaField(role: 'cover', accept: ['image/*'])]
private ?Media $cover = null;

Dans un FormType :

$builder->add('cover', MediaPickerType::class, [
    'accept' => ['image/*'],
]);

Intégration NeoxCrudBundle

NeoxMediaBundle ne dépend pas directement de NeoxCrudBundle.

Le service :

Neox\MediaBundle\Bridge\Crud\MediaCrudFieldGuesser

lit automatiquement les propriétés marquées #[MediaField] et retourne le MediaPickerType et ses options. NeoxCrudBundle peut donc consommer ce bridge lorsqu'il est installé.

Assets Stimulus

Le bundle fournit :

neox_media_library_controller.js
neox_media_upload_controller.js
neox_media_picker_controller.js

et une feuille de style :

public/media-manager.css

Dans une vraie publication Composer, exposer/copier ces assets via AssetMapper, Importmap ou assets:install selon la stratégie du projet hôte.