Nuevo en Symfony 3.4: Deprecando opciones de configuración

El proyecto Symfony sigue la estrategia de versionado semántico y define una política de retrocompatibilidad que facilitan las actualizaciones de tus proyectos. Una de las claves de esta estrategia son los mensajes de tipo "deprecation", que te avisan cuando una funcionalidad se va a cambiar o va a desaparecer en la próxima versión de Symfony.

Avisar con tiempo sobre los futuros cambios no solo es importante para el código. Si utilizas la configuración semántica en tus aplicaciones, también es importante que avises cuando una opción de configuración va a cambiar o desaparecer. Por eso en Symfony 3.4 hemos añadido una funcionalidad que permite declarar como obsoleta una opción de configuración fácilmente:

// ...
->scalarNode('opcion_1')
    // esto hace que se muestre el siguiente mensaje genérico:
    // The child node "opcion_1" at path "acme_root" is deprecated.
    ->setDeprecated()
->end()
->scalarNode('opcion_2')
    // también puedes definir un mensaje propio (puedes incluir las variables %node% y %path%):
    ->setDeprecated('La opción "%node%" está obsoleta. Usa "nueva_opcion_2" en su lugar.')
->end()

Esta funcionalidad ha sido contribuida por Sanpi en el pull request #22382.

Fuente: New in Symfony 3.4: Deprecate configuration options

Comentarios

Publicada el

20 de septiembre de 2017

Etiquetas

Proyectos Symfony destacados

La forma más sencilla de generar el backend de tus aplicaciones Symfony. Ver más

Síguenos en @symfony_es para acceder a las últimas noticias.