Стабильный API Symfony2¶

Стабильный API Symfony2 это подмножество всех опубликованных методов Symfony2 (как компонентов, так и пакетов из состава ядра), которые объединены по следующим признакам:

Пространство имён и имя класса не будет изменяться;
Наименование метода не будет изменяться;
Сигнатура метода (аргументы и тип возвращаемого значения) не будет изменяться;
Семантика того, что метод делает не будет изменяться;

Хотя, реализация метода может меняться со временем. Единственный случай, оправдывающий изменение стабильного API - исправление дыр в безопасности.

Стабильный API основывается на списке whitelist, тагированном @api. По этой причине всё, что не имеет этого тага - не является частью стабильного API.

Tip

Любой сторонний пакет может также публиковать свой собственный стабильный API.

Начиная с Symfony 2.0, следующие компоненты имеют публичный API:

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