API estable de Symfony2

La API estable de Symfony2 es un subconjunto de todos los métodos públicos de Symfony2 (componentes y paquetes básicos) que comparten las siguientes propiedades:

• El espacio de nombres y nombre de la clase no van a cambiar;
• El nombre del método no va a cambiar;
• La firma del método (el tipo de los argumentos y del valor de retorno) no va a cambiar;
• La semántica de lo que hace el método no va a cambiar.

Sin embargo, la imprementación en sí misma puede cambiar. El único caso válido para un cambio en la API estable es con el fin de corregir algún problema de seguridad.

La API estable se basa en una lista blanca, marcada con @api. Por lo tanto, todo lo no etiquetado explícitamente no es parte de la API estable.

Truco

Cualquier paquete de terceros también deberá publicar su propia API estable.

A partir de Symfony 2.0, los siguientes componentes tienen una API etiquetada pública:

• BrowserKit
• ClassLoader
• Console
• CssSelector
• DependencyInjection
• DomCrawler
• EventDispatcher
• Finder
• HttpFoundation
• HttpKernel
• Locale
• Process
• Routing
• Templating
• Translation
• Validator
• Yaml