Експериментальні функції

Всі функції Symfony отримують вигоду від нашої :doc:`Обіцянки зворотної сумісності </contributing/code/bc>', щоб дати розробникам впевненість у безпечному та частішому
оновленні до нових версій.

Але іноді нова функція є суперечливою або ви не можете знайти переконливий API. У таких випадках ми вважаємо за краще збирати відгуки від реальних користувачів, адаптувати API або взагалі видалити його. Це неможливо зробити, не порушуючи зворотну сумісність.

Щоб уникнути зобов'язань щодо зворотної сумісності, такі функції можуть бути позначені як експериментальні, а їхні класи та методи мають бути позначені тегом @experimental.

Функцію може бути позначено як експериментальну лише для однієї молодшої версії,
і може ніколи не бути внесено до LTS версії . Основна команда може вирішити продовжити експериментальний період для іншої молодшої версії у кожному конкретному випадку.

Для полегшення оновлення проектів, у яких використовуються експериментальні функції,
журнал змін повинен пояснювати несумісні зі старими версіями зміни та пояснювати,
як оновити код.