🧩 Чистое проектирование контроллеров в Symfony с помощью разрешителей аргументов

Статья рассказывает о механизме разрешения аргументов (argument resolving) в Symfony — процессе, который позволяет автоматически преобразовывать параметры запроса в объекты.

Ранее, до Symfony 6.2, для этого использовался SensioFrameworkExtraBundle с аннотацией @ParamConverter, но теперь эту функцию выполняет встроенный EntityValueResolver. Это позволяет Symfony автоматически превращать идентификатор из URL (например, /messages/{id}) в объект соответствующей сущности (например, Message).

Symfony содержит несколько встроенных резолверов, которые помогают обрабатывать разные типы данных — от объектов запросов (RequestValueResolver) и пользовательских сессий (SessionValueResolver) до работы с датами (DateTimeValueResolver) и UID (UidValueResolver).

Создание кастомного аргумент-резолвера

Иногда стандартных резолверов недостаточно, например, если нужно загружать разные типы сущностей из одного маршрута. В статье рассматривается реальный пример с платформы Respawwwn, где есть разные игровые сессии (Daily, Survival, Collection, Party), но требуется один эндпоинт /api/game-sessions/{id}/complete, который может обработать любую из них.

Чтобы реализовать это, автор создаёт кастомный резолвер (GameSessionValueResolver), который:

✔️ Проверяет, является ли параметр id сущностью типа GameSessionInterface.
✔️ Ищет соответствующую игровую сессию в нескольких репозиториях.
✔️ Возвращает найденный объект, который затем передаётся в контроллер.
✔️ В контроллере этот резолвер подключается с помощью атрибута #[ValueResolver('game_session')], что делает код чище и удобнее.

Преимущества использования аргумент-резолверов

🔸 Чистый код — контроллеры не загромождены логикой преобразования параметров.
🔸 Гибкость — можно легко менять способ обработки параметров, не изменяя контроллеры.
🔸 Повторное использование — один резолвер можно применять в разных местах.
🔸 Тестируемость — можно отдельно протестировать резолвер без необходимости выполнять HTTP-запросы.

👉 Medium

Prism

Унифицированный интерфейс для работы с LLM в Laravel. Поддерживает API Anthropic, DeepSeek, Gemini, Groq, Mistral, Ollama, OpenAI и xAI.

🔗 Github

#инструменты

Установка Laravel 12 с помощью Docker за 8 минут — полное руководство по установке и настройке

Спидран по установке Laravel в докер, после чего сразу можно начать разработку или тестирование кода

👉 Видео

Библиотека пхпшника #буст

📊 Тестовые задания — любовь или боль?

По данным исследования, 81% IT-специалистов в России просто игнорируют вакансии с тестовыми заданиями. Программисты оказались самыми «неприступными» — только 19% согласны их выполнять.

😆 Только тестировщики, которые сами по долгу службы гоняют тесты, готовы пройти их ради работы (63%). Профессиональная эмпатия?

Как вы относитесь к тестовым заданиям при трудоустройстве? Делитесь мнением в комментах! 👇

🔥 — готов(-а) выполнить, если вакансия интересная
👍 — только если тестовое оплачивается
🌚 — игнорю такие вакансии сразу
🤔 — я уже делал(-а) тестовое, а его использовали в проде бесплатно

Библиотека пхпшника #междусобойчик

💻 Подборка новостей по PHP за неделю:​

🔎 Релиз CakePHP 4.5.10
Команда CakePHP объявила о выходе версии 4.5.10. Это технический релиз, исправляющий несколько проблем, о которых сообщило сообщество. ​
GitHub

🔎 Расширение JetBrains Xdebug Helper для браузера
JetBrains представила официальное расширение Xdebug Helper для Chrome, обеспечивающее беспроблемную отладку PHP-кода. ​

🔎 Laravel 12.3: Новый тип приведения JSON Unicode
Команда Laravel выпустила версию 12.3.0, включающую новый тип приведения JSON Unicode, проверку статуса связанных хранилищ в команде about, поддержку нативных типов JSON и JSONB в схемах SQLite и другие улучшения. ​

🔎 Неделя Symfony #951 (17–23 марта 2025 года)
На этой неделе в предстоящей версии Symfony 7.3 обновлена конфигурация по умолчанию для исключения расширений контейнера, сущностей и сообщений Messenger при регистрации сервисов, а также внесены изменения, связанные с сбросом сервисов.

Библиотека пхпшника #свежак

Что выведет данный код?

🚀 Exceptional Validation — новый подход к валидации данных в Symfony

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

Преимущества такого подхода:

🔸 Упрощение валидации: Отказ от сложных механизмов, таких как группы валидации и кастомные expressions, делает процесс проверки данных более прозрачным и управляемым.​

🔸 Гибкость в различных контекстах: Возможность легко адаптировать логику валидации в зависимости от конкретного контекста без необходимости создания сложных конструкций.​

🔸 Совместимость: Библиотека интегрируется с Symfony Messenger и amphp, обеспечивая бесшовную работу в существующих проектах.​

🔸 Стандартные сообщения об ошибках: После обработки исключений библиотека возвращает список нарушений ограничений (constraint violations) в формате Symfony Validator.

🔗 Github

Библиотека пхпшника #инструменты

В 2017 году был запущен проект Bref с целью запуска PHP в бессерверной среде на AWS Lambda.

В 2020 году начались замеры количества запросов (или заданий, cron-задач, вызовов и т.д.), которые обрабатываются с его помощью каждый месяц. Это было сделано для того, чтобы показать AWS, что PHP заслуживает большего внимания и поддержки.

Ежемесячно данные добавлялись в электронную таблицу, и их количество постоянно растет. Как упомянуто в заголовке, на сегодняшний день с помощью PHP на Lambda обрабатывается более 40 миллиардов запросов в месяц.

Методика замеров описана в документации.

Кратко: каждые 100 вызовов среды выполнения отправляется несколько байтов данных через UDP. Эти данные полностью анонимны (вот содержимое пакета: Invocations_100:1|c\nLayer_fpm_100:1|c), а использование UDP гарантирует, что передача занимает всего несколько микросекунд (она неблокирующая). Эти байты доходят до небольшого сервера на EC2, который увеличивает счетчик в CloudWatch.

Наличие этой метрики оказалось крайне полезным во взаимодействии с AWS — теперь проект Bref воспринимается ими гораздо серьезнее. Примерно 1 из 1000 вызовов AWS Lambda — это PHP с Bref.

AWS даже внедрила свои внутренние метрики для отслеживания использования PHP (впрочем, и других языков тоже), и их данные совпадают с тем, что было получено в рамках проекта, что подтверждает правильность измерений.

Кроме того, удалось интегрировать счётчик метрик в режиме реального времени (почти реального времени, данные кэшируются на несколько минут) на главной странице проекта: bref.sh

⚙️ Улучшаем производительность кода с AI

Обнаружили в профилировщике тормозящий код? Попробуйте этот промпт, чтобы AI помог вам оптимизировать его:

📝 Промпт:

Analyze the following PHP code and suggest optimizations for better performance. Identify bottlenecks, improve memory usage, and recommend alternative approaches.

// Вставьте ваш код здесь

💡 Дополнительные возможности:

— Добавьте Refactor it using modern PHP features (e.g., OPcache, JIT, Fibers), если хотите использовать новейшие возможности PHP.
— Добавьте Optimize it for concurrency using Swoole or ReactPHP, если важна многопоточность и высокая нагрузка.
— Добавьте Suggest a profiling strategy using Xdebug or Blackfire, если нужна диагностика.

💬 Какие инструменты вы используете для профилирования кода?

Библиотека пхпшника #буст