Экспериментальные функции

Все функции Symfony выигрывают от нашего Обещания обратной совместимости, что даёт разработчикам уверенность обновляться до новых версий чаще и безопасно.

Но иногда, новая функция неоднозначна. Или нелегко найти хороший API. В таких случаях, мы предпочитаем собрать отзывы реальных примеров использования, адаптировать API, или в принципе удалить её. Это невозможно сделать при подходе отсутствия ошибок ОС.

Чтобы избежать привязанности к обещанию обратной совместимости, такие функции могут быть помечены, как экспериментальные и их классы и методы должны быть отмечены тегом @experimental.

Функция может быть отмечена как экспериментальная только в одной маленькой версии, и не может быть представлена в LTS версии. Базовая команда может решить продлить экспериментальный период ещё на одну версию отдельно в каждом случае.

Чтобы облегчить процесс обновления проектов, использующих экспериментальные функции, журнал изменений проекта должен объяснять изменения, не имеющие обратной совместимости и как обновить код.

Эта документация является переводом официальной документации Symfony и предоставляется по свободной лицензии CC BY-SA 3.0.