L’API stabile di Symfony2¶

L’API stabile di Symfony2 è un sottoinsieme di tutti i metodi pubblici di Symfony2 (componenti e bundle del nucleo) che condividono le seguenti proprietà:

Lo spazio dei nomi e il nome della classe non cambieranno;
Il nome del metodo non cambierà;
La firma del metodo (i tipi dei parametri e del valore restituito) non cambierà;
La semantica di quello che fa il metodo non cambierà;

Tuttavia potrebbe cambiare l’implementazione. L’unico caso valido per una modifica dell’API stabile è la soluzone di una questione di sicurezza.

L’API stabile è basata su una lista, con il tag @api. Quindi, tutto ciò che non possiede esplicitamente il tag non fa parte dell’API stabile.

Tip

Si può approfondire l’API stabile in /contributing/code/bc.

Tip

Ogni bundle di terze parti dovrebbe a sua volta pubblicare la sua API stabile.

A partire da Symfony 2.0, i seguenti componenti hanno un tag API pubblico:

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