
Desarrollo web · Symfony 8.2 y AssetMapper
Symfony 8.2 moderniza AssetMapper: import maps más específicas, integridad SRI, actualizaciones controladas y nuevos ajustes de producción. Ejemplos en PHP y Twig, y método de prueba.
¿De verdad hay que instalar y mantener una cadena de compilación JavaScript para cada aplicación Symfony? AssetMapper ya permite servir CSS y módulos JavaScript modernos sin bundler. Con Symfony 8.2, resulta aún más interesante para sitios profesionales y software empresarial con varios puntos de entrada: import maps específicas, integridad de recursos, actualizaciones de paquetes mejor controladas y un despliegue más flexible.
Symfony detalló estas novedades el 10 de noviembre de 2026. Aún no se trata de la versión estable de Symfony 8.2: Symfony 8.2.0-BETA1 está disponible desde el 4 de noviembre y la versión final está prevista para noviembre de 2026. Por tanto, es el momento ideal para probar su impacto sin confundir una función beta con un cambio que ya esté desplegado en todos los sitios Symfony.
A continuación, presentamos las seis novedades oficiales, un ejemplo práctico que combina un sitio público y un área de administración, un método para medir el impacto en el navegador y los casos en los que Vite o Webpack Encore siguen siendo mejores opciones.
Symfony 8.2 introduce el filtrado importmap_entries: reachable, las huellas SRI y la opción minimum_release_age. También permite descargar un archivo de paquete sin transformar, evitar los metadatos compilados en modo debug y almacenar esos metadatos fuera del directorio público. Una import map más corta no significa automáticamente que se descargue menos JavaScript.
La publicación del 10 de noviembre de 2026 presenta las mejoras de AssetMapper. Estas ya figuran en el registro de cambios de Symfony 8.2.0-BETA1, publicada el 4 de noviembre. El calendario de Symfony prevé una versión estable en noviembre de 2026, aunque las páginas oficiales consultadas no confirman una fecha concreta.
Symfony 8.2 requiere PHP 8.4 o posterior. A fecha del 10 de noviembre, Symfony 8.1 sigue siendo la rama estable actual y Symfony 7.4 es una rama LTS con mantenimiento. Por tanto, un equipo que use Symfony 7.4 o PHP 8.2/8.3 no debería copiar esta configuración en su servidor actual dando por hecho que será compatible.
Esta guía describe opciones anunciadas y presentes en la beta de Symfony 8.2. La validación final del comportamiento, la compatibilidad y los costes operativos debe realizarse con las versiones que se desplieguen realmente.
AssetMapper asocia rutas lógicas con archivos CSS, JavaScript, imágenes y otros recursos, genera URL versionadas y utiliza los import maps nativos del navegador para resolver las importaciones de módulos. En una plantilla Twig, {{ importmap('app') }} genera los elementos necesarios para cargar el punto de entrada app.
No hay que confundir prescindir de un bundler en la cadena de entrega de módulos JavaScript estándar con prescindir por completo de herramientas. Un proyecto TypeScript puede seguir necesitando una etapa de transformación, y las aplicaciones complejas de React/Vue suelen utilizar herramientas frontend específicas. AssetMapper no concatena ni minifica automáticamente los archivos como lo haría una configuración de compilación tradicional.
Una aplicación orientada al servidor, con varias páginas, un área de cliente y un panel de administración, puede gestionar scripts específicos y dependencias controladas sin un bundler generalista.
En un frontend complejo que requiera transformaciones avanzadas, JSX o componentes .vue, puede resultar más sencillo operar con Vite, Encore o las herramientas del framework elegido.
| Novedad | Utilidad | Precaución |
|---|---|---|
importmap_entries: reachable |
Incluir solo las entradas alcanzables desde la página | Importaciones dinámicas con nombre calculado |
importmap_integrity_algorithms |
Añadir huellas de integridad a los recursos | No sustituye las auditorías ni la CSP |
minimum_release_age |
Retrasar ciertas actualizaciones de paquetes | No se aplica a importmap:require |
--no-esm |
Descargar el archivo proporcionado por el paquete | Hay que resolver las importaciones básicas y comprobar el formato del archivo |
| Sin metadatos compilados en debug | Volver a los archivos fuente sin tener que limpiar manualmente | Comportamiento ligado al modo debug |
metadata_dir |
Mover los metadatos de PHP fuera del directorio público | Adaptar el artefacto de despliegue |
Hasta ahora, la llamada Twig importmap() incluía todas las entradas de importmap.php, incluso cuando la página solo iniciaba un punto de entrada. Así, un formulario público podía incluir en su HTML definiciones de módulos reservados para el área de administración. Esto no implicaba necesariamente descargar los módulos, pero aumentaba el tamaño de la import map generada y exponía nombres de entradas innecesarios en esa página.
Con importmap_entries: reachable, Symfony conserva las entradas alcanzables desde los puntos de entrada pasados a importmap(). El cálculo incluye las importaciones estáticas y las importaciones dinámicas cuya ruta se conoce. En cambio, un import(nombreCalculado) no puede rastrearse estáticamente: hay que probar o adaptar este caso. El valor predeterminado sigue siendo all, precisamente para evitar interrupciones inesperadas.
La opción importmap_integrity_algorithms genera huellas criptográficas, por ejemplo, con sha384. Al activarla, importmap() añade una entrada de integridad a la import map y un atributo integrity a los enlaces modulepreload y las hojas de estilo correspondientes. Los algoritmos admitidos son sha256, sha384 y sha512.
Esta comprobación protege frente a la alteración de los archivos cargados, pero no demuestra que el paquete sea seguro: un archivo comprometido cuando se calcula su huella sigue estando comprometido. Tampoco sustituye a la Content Security Policy, la revisión de dependencias ni los controles de la aplicación.
La opción minimum_release_age se expresa en segundos. El valor 604800 impone un plazo de siete días para las versiones aplicables durante importmap:update. Symfony también ignora las versiones preliminares y algunas versiones posteriores a la etiqueta latest. El comando importmap:outdated muestra una columna Withheld para las versiones retenidas.
Esta precaución no es una solución universal contra los ataques a la cadena de suministro: sirve para evitar adoptar de inmediato todas las versiones publicadas. Y, sobre todo, importmap:require no está sujeto a este plazo. Las comprobaciones descargan ahora los metadatos completos de npm para conocer las fechas de publicación, lo que puede alargar esta etapa.
--no-esmDe forma predeterminada, AssetMapper utiliza la transformación ESM de jsDelivr para las dependencias recuperadas. Si esta transformación da problemas, la nueva opción --no-esm solicita el archivo publicado por el propio paquete. Hay que proporcionar la ruta exacta del archivo que se quiere importar.
Symfony gestiona entonces las importaciones relativas del tipo ./chunk.js, pero no resuelve automáticamente las importaciones básicas como import { h } from 'preact': los paquetes correspondientes deben añadirse explícitamente. Descargar un archivo sin transformar no garantiza que sea compatible con una importación ESM nativa; hay que comprobar el formato publicado por el autor.
En versiones anteriores, ejecutar asset-map:compile en el equipo podía dejar metadatos compilados que prevalecían sobre los archivos fuente durante el desarrollo. Entonces parecía que los cambios de JavaScript/CSS no se reflejaban hasta borrar public/assets/. En Symfony 8.2, con el modo debug activado, se ignoran esos metadatos en favor de los archivos fuente. Esto facilita alternar entre las pruebas de compilación y el desarrollo.
public/asset-map:compile genera, entre otros archivos, manifest.json, importmap.json y archivos entrypoint.*.json. PHP lee estos metadatos, pero su ubicación predeterminada, dentro de los assets públicos, los hace accesibles por HTTP. El nuevo parámetro metadata_dir permite colocarlos, por ejemplo, en var/assets.
Este cambio facilita la organización de los artefactos. Aun así, hay que comprobar que el proceso PHP pueda leer ese directorio y que el procedimiento de despliegue lo conserve o lo regenere. Esto no convierte los metadatos en una caja fuerte: no se deben almacenar allí datos confidenciales.
Imaginemos una aplicación Symfony con una parte pública ligera y un panel de administración con tablas y componentes interactivos. Queremos evitar que las definiciones JavaScript específicas del área de administración aparezcan en la import map de una página pública. Los siguientes fragmentos ilustran el principio; deben adaptarse a los nombres de assets y dependencias del proyecto.
Para un proyecto que aún no tenga AssetMapper, la instalación documentada es:
composer require symfony/asset-mapper symfony/asset symfony/twig-pack
php bin/console debug:asset-map
Con Symfony Flex se generan, entre otros archivos, assets/app.js e importmap.php, y se añade una llamada a importmap('app') en la plantilla. Para nuestro ejemplo, añadimos el archivo assets/admin.js y declaramos dos puntos de entrada:
<?php
// importmap.php
return [
'app' => [
'path' => './assets/app.js',
'entrypoint' => true,
],
'admin' => [
'path' => './assets/admin.js',
'entrypoint' => true,
],
];
En la aplicación real, conserva también las entradas de dependencias que ya existan en importmap.php: este fragmento solo muestra deliberadamente los puntos de entrada.
La plantilla base carga app. Para el área de administración, cargamos los dos puntos de entrada con una sola llamada a importmap():
{# templates/base.html.twig #}
{% block javascripts %}
{% block importmap %}
{{ importmap('app') }}
{% endblock %}
{% endblock %}
{# templates/admin/dashboard.html.twig #}
{% extends 'base.html.twig' %}
{% block importmap %}
{{ importmap(['app', 'admin']) }}
{% endblock %}
No llames a parent() en este bloque Twig: la import map debe generarse una sola vez por página. Las importaciones del punto de entrada admin no se ejecutarán en una página que solo cargue app.
En una rama de pruebas con Symfony 8.2, los ajustes pueden agruparse en config/packages/asset_mapper.yaml:
# config/packages/asset_mapper.yaml
framework:
asset_mapper:
importmap_entries: reachable
importmap_integrity_algorithms: ['sha384']
minimum_release_age: 604800
metadata_dir: '%kernel.project_dir%/var/assets'
Estas cuatro opciones tienen objetivos distintos: reachable modifica el contenido de la import map de la página; sha384 añade las huellas; minimum_release_age actúa durante las actualizaciones; metadata_dir determina dónde se almacenan los metadatos compilados. No son un único interruptor de «más rendimiento».
Se rastrean los módulos importados mediante una ruta literal:
// assets/app.js
document.querySelector('#open-help')?.addEventListener('click', async () => {
const module = await import('./help-panel.js');
module.openHelp();
});
En cambio, el siguiente caso se basa en una expresión calculada cuyos posibles valores Symfony no puede determinar durante el análisis:
// Revisar antes de elegir importmap_entries: reachable
const name = window.currentWidgetName;
const widget = await import(name);
Si la aplicación contiene importaciones calculadas o plugins cargados desde una configuración dinámica, prueba explícitamente todas las rutas pertinentes o conserva temporalmente el comportamiento all hasta adaptar el código.
La revisión de una dependencia puede empezar con estos comandos:
php bin/console importmap:outdated
php bin/console importmap:audit
# Actualizar solo después de validar
php bin/console importmap:update
A partir de Symfony 8.2, el comando importmap:outdated permite ver las versiones retenidas temporalmente por el plazo mínimo. Para un paquete cuya transformación ESM generada por jsDelivr falla, Symfony proporciona este ejemplo:
php bin/console importmap:require "fullcalendar/index.global.js=fullcalendar" --no-esm
Después, comprueba la compatibilidad real del archivo proporcionado, sobre todo si se trata de una compilación global y no de un módulo ES. Poder recuperar un archivo no garantiza que su API se pueda importar como una exportación JavaScript nativa.
El paso de compilación sigue generando los assets versionados destinados al servidor web:
APP_ENV=prod APP_DEBUG=0 php bin/console asset-map:compile
Si se trasladan los metadatos a var/assets, comprueba la ruta en el servidor final, los permisos de lectura de PHP y la presencia de los archivos en el artefacto de entrega. El comportamiento en desarrollo no sustituye la necesidad de compilar o exponer correctamente los recursos en producción.
La primera medición no debería ser una puntuación de Lighthouse, sino la diferencia entre las import maps con la opción predeterminada all y con reachable. Después se comparan los recursos precargados, el JavaScript realmente transferido y la experiencia del usuario.
type="importmap" y contar las entradas presentes.Podemos inspeccionar el mapa en la consola del navegador sin instalar ninguna biblioteca adicional:
const element = document.querySelector('script[type="importmap"]');
if (element) {
const map = JSON.parse(element.textContent);
console.table({
imports: Object.keys(map.imports ?? {}).length,
htmlCharacters: element.textContent.length
});
}
Este pequeño diagnóstico muestra el número de definiciones de módulos y el tamaño textual del mapa, no el peso total de los archivos descargados. Una import map puede contener 100 entradas aunque una página solo ejecute un módulo. Para afirmar que hay una mejora de red o en Core Web Vitals, hay que observar un cambio en las solicitudes o en el trabajo del navegador, no limitarse a contar las líneas de HTML que han desaparecido.
Reducir el código innecesario, mejorar la carga y simplificar las dependencias puede contribuir a una mejor experiencia de usuario. Pero ningún cambio de AssetMapper garantiza por sí solo una mejora en el posicionamiento SEO. La medición debe basarse en datos reales y en los recorridos que se utilizan de verdad.
Una actualización a Symfony 8.2 debe empezar por la base técnica: PHP 8.4 como mínimo, versiones de bundles, recetas de Flex, configuración de AssetMapper y pruebas automatizadas. Pasar de Symfony 8.1 a 8.2 no es lo mismo que migrar desde una rama LTS anterior, lo que puede requerir pasos intermedios.
Symfony proporciona el siguiente procedimiento para probar una versión preliminar en un proyecto cuyas restricciones de dependencias lo permitan:
# Solo en una rama de pruebas dedicada
composer config minimum-stability beta
composer config extra.symfony.require "8.2.*"
composer update
Precaución: estos comandos modifican la resolución de dependencias de Composer y no deben ejecutarse tal cual en producción. El anuncio de la beta indica que se presupone que las restricciones de Symfony de composer.json son compatibles; de lo contrario, habrá que adaptarlas. Comprueba también composer.lock, las pruebas y el plan de reversión.
reachable por separado. Validar cada punto de entrada y las importaciones dinámicas, incluidas las de los controladores Stimulus.integrity, asegurarse de que no haya errores de carga y comprobar las reglas CSP existentes.minimum_release_age, las vulnerabilidades conocidas y las excepciones urgentes.A menudo resulta más útil probar una opción cada vez que activar todos los ajustes a la vez: así se pueden identificar los efectos medibles y las posibles regresiones.
| Criterio | AssetMapper | Vite o Encore |
|---|---|---|
| Sitio Symfony/Twig con JavaScript moderado | Suele ser sencillo de mantener | Es posible, pero puede añadir una etapa de compilación |
| Import maps y módulos ES nativos | Están en el centro del enfoque | No necesariamente se utilizan en producción |
| TypeScript | Transformación mediante una herramienta o bundle específico | Integrado en la cadena frontend según la configuración |
| Vue SFC, JSX y transformaciones complejas | Menos directo | Suele ser más adecuado |
| Control preciso del bundling | Sin bundling nativo | Agrupación y optimización configurables |
| Mantenimiento a largo plazo | Según el proyecto, requiere menos infraestructura Node | Un ecosistema amplio, pero hay que mantener las dependencias de compilación |
Para una aplicación empresarial que se renderiza principalmente en el servidor, AssetMapper puede reducir el número de componentes que hay que gestionar. Para un panel de control construido como SPA o que requiera transformaciones frontend avanzadas, prescindir de un bundler no es un fin en sí mismo: Vite o Encore pueden hacer que el proyecto resulte más fácil de entender.
La elección de SDX: partir de los usos, el equipo y el coste de mantenimiento. Las novedades de Symfony 8.2 hacen que AssetMapper sea más flexible para las aplicaciones con varias páginas, pero no dejan obsoletas las demás herramientas frontend.
No. Ya existe y funciona en producción en versiones anteriores. La novedad del 10 de noviembre de 2026 es el anuncio detallado de seis mejoras previstas para Symfony 8.2.
No, a fecha del 10 de noviembre de 2026. Symfony 8.2.0-BETA1 se publicó el 4 de noviembre; la versión estable está prevista para noviembre y requiere PHP 8.4 como mínimo.
No necesariamente. Reduce las definiciones de módulos generadas para una página. Los módulos que se cargan realmente dependen de las importaciones ejecutadas y de las precargas. Hay que comprobar las solicitudes de red.
minimum_release_age bloquea todas las dependencias nuevas?No. Limita algunas actualizaciones realizadas mediante importmap:update. No se aplica a importmap:require y no sustituye a una auditoría de dependencias.
AssetMapper sirve módulos JavaScript. Para TypeScript hace falta una transformación. Symfony remite, entre otras opciones, a un bundle específico; por tanto, hay que evaluar las herramientas necesarias según el proyecto.
No. Permite comprobar la integridad de los recursos servidos al navegador, pero no que fueran seguros en el momento de su publicación. Mantén los controles de versiones, las auditorías, la CSP y las revisiones de código.
DESARROLLO WEB
Migración de PHP, actualización de CMS o evolución de framework: identifique los puntos de compatibilidad y valide los recorridos esenciales antes de la puesta en línea.
Introduce al menos 2 caracteres para iniciar la búsqueda.