Путь к DRY валидации в Laravel

В статье рассказывается о том, как один человек решил сократить дублирование кода при написании правил валидации с помощью принципа DRY (Don't Repeat Yourself). Он искал удобное решение, которое удовлетворяло бы нескольким основным требованиям:

1. Имело бы удобный интерфейс.
2. Позволяло бы при необходимости редактировать или переписывать правила валидации для полей.
3. Давало бы возможность добавлять дополнительные поля «на месте».
4. Использовало бы только строковые значения в качестве имен полей, при этом имена не могли бы содержать точки, так как они нужны для разделения уровней вложенности.
5. Некоторые поля группировались по сущностям базы данных, а некоторые существовали отдельно.

Для реализации этого решения использовался существующий механизм хелперов в Laravel. Было решено создать функцию get_validation_rules, которая бы принимала два параметра: массив с именами полей и ассоциативный массив с дополнительными правилами для этих полей.

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

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

🧑‍💻 Статьи для IT: как объяснять и распространять значимые идеи

Напоминаем, что у нас есть бесплатный курс для всех, кто хочет научиться интересно писать — о программировании и в целом.

Что: семь модулей, посвященных написанию, редактированию, иллюстрированию и распространению публикаций.

Для кого: для авторов, копирайтеров и просто программистов, которые хотят научиться интересно рассказывать о своих проектах.

👉Материалы регулярно дополняются, обновляются и корректируются. А еще мы отвечаем на все учебные вопросы в комментариях курса.

Существует такой Bash-скрипт phloc, который упрощает запуск локального PHP-сервера для тестирования и разработки. Он позволяет указать номер порта и корневую директорию. Если параметры не заданы, по умолчанию используется порт 8080 и текущая директория. Скрипт проверяет, занят ли порт, и при необходимости увеличивает его номер. Это экономит время и автоматически управляет конфликтами портов. Инструкции по использованию включают сохранение, предоставление прав на выполнение и запуск скрипта.

Что выведет код?

Как рефакторить метод с необязательными параметрами

Здесь обсуждается проблема, связанную с методами, имеющими необязательные параметры, которые могут вызывать неожиданные побочные эффекты. В качестве примера приводится класс PageRepository с методами find и findOrFail, у которых параметр $prerender имеет разные значения по умолчанию. Это может привести к ненамеренной предварительной отрисовке страницы, что является дорогостоящей операцией.

Пример проблемы:
Класс PageRepository содержит два метода:

find($pageId, $prerender = false), который по умолчанию не выполняет предварительную отрисовку.
findOrFail($pageId, $prerender = true), который по умолчанию выполняет предварительную отрисовку.

Возможные решения:

🟢Установить одинаковые значения по умолчанию для параметра $prerender.

🟢Явно указывать значение параметра.

🟢Разделить метод с флагом параметра на два отдельных метода. Это потребует от разработчика явного выбора функциональности, предотвращая ненамеренные побочные эффекты.

Расскажите про сериализатор Symfony

В Symfony, сериализатор — это сервис, который преобразует данные между различными форматами, такими как JSON, XML, YAML или CSV, и PHP-объектами. Компонент сериализации в Symfony — это мощный инструмент, используемый для преобразования объектов в сериализуемый формат и обратно. Он особенно полезен для API, где обмен данными часто требует преобразования в структурированные текстовые форматы и обратно.

Нормализаторы и кодировщики

Нормализаторы: Отвечают за преобразование объектов в массивы и обратно:

✔️ObjectNormalizer: Преобразует объекты в массивы и обратно.
✔️ArrayDenormalizer: Обрабатывает массивы объектов.
✔️DateTimeNormalizer: Обрабатывает объекты DateTime.

Кодировщики: Отвечают за преобразование массивов в определенные форматы и обратно:

✔️JsonEncoder: Обрабатывает кодирование/декодирование JSON.
✔️XmlEncoder: Обрабатывает кодирование/декодирование XML.
✔️YamlEncoder: Обрабатывает кодирование/декодирование YAML.
✔️CsvEncoder: Обрабатывает кодирование/декодирование CSV.

Foxy

это плагин Composer для автоматизации проверки, установки, обновления и удаления зависимостей PHP-библиотек (javaScript, таблиц стилей и т.д.), определенных в файле NPM package.json проекта и PHP-библиотек во время выполнения Composer. Он восстанавливает состояние проекта в случае, если Bun или NPM или Yarn или PNpM завершается с ошибкой.

Иногда нам нужно сгенерировать случайное число, например, для отправки пользователю через SMS💬 для авторизации с помощью SMS. Для этого мы можем использовать функцию rand(000000, 999999), которая пришлет пользователю шестизначный код для верификации. Также с помощью функции в Laravel мы можем усложнить задачу и отправить случайные символы с помощью Str::random(). Эта функция по умолчанию отправляет 16 символов, но мы также можем сократить их до 8 с помощью Str::random(8).

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

Избегание импортов и алиасов в PHP

В PHP важно правильно управлять зависимостями и пространствами имен, чтобы поддерживать чистый и читаемый код. Использование операторов use и псевдонимов может привести к засорению кода и его неоднозначности. Вот несколько стратегий для избегания чрезмерного использования импортов и псевдонимов:

🟢Автозагрузка с PSR-4: Настройка автозагрузки по стандарту PSR-4 позволяет автоматически загружать классы на основе их пространства имен и структуры директорий, уменьшая необходимость ручного импорта.

🟢Полные имена классов (FQCN): Используйте полные имена классов напрямую в коде, чтобы избежать импорта и сделать использование классов явным.

🟢Внедрение зависимостей: Передавайте зависимости через конструкторы классов, что улучшает тестируемость и снижает необходимость импорта.

🟢Паттерн локатор сервисов: Используйте локатор сервисов для управления зависимостями, чтобы централизовать создание и хранение сервисов.

🟢Группировка операторов use: Сгруппируйте несколько классов из одного пространства имен в одном операторе use для уменьшения засорения.

🟢Избегайте псевдонимов, если это не необходимо: Используйте описательные имена классов и избегайте их сокращения, если это не улучшает читаемость кода.

#дайджест новостей по PHP за неделю:

🔎Новая страница исключений по умолчанию с поддержкой темного режима в Laravel 11.9 — На этой неделе команда Laravel выпустила версию 11.9, в которой появилась новая страница исключений по умолчанию, способ предотвратить выполнение деструктивных команд, метод очереди withoutDelay() и многое другое.

🔎Выпущена версия Symfony 7.1.1 — Только что состоялся релиз Symfony 7.1.1. Вот список наиболее важных изменений по сравнению с 7.1.0.

🔎Неделя Symfony #909 (27 мая — 2 июня 2024 года)

Как использовать редактор Quill с Laravel 10 и Livewire v3

Это подробное руководство по интеграции редактора Quill с Laravel 10 и Livewire v3 для создания блог-постов, включая загрузку изображений. Предполагается, что читатель имеет опыт использования этих инструментов.

🤖🎙️ S.T.A.R.K. — первый фреймворк для создания голосового ассистента

В новой статье рассказываем о фреймворке S.T.A.R.K. (Speech and Text Algorithmic Recognition Kit), который поможет создать голосового ассистента. У него есть несколько преимуществ:

▪️S.T.A.R.K. работает полностью на устройстве, гарантируя сохранность ваших данных.
▪️С фреймворком можно легко определять контекст и параметры для последующих запросов, а также одновременно выполнять несколько команд.
▪️S.T.A.R.K позволяет использовать ведущие языковые модели.

🔗 Читать статью
🔗 Зеркало

Использование Temporal для эффективного управления жизненным циклом документов

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

Здесь рассматривается, как можно использовать Temporal Workflows для разработки структуры для эффективного управления жизненным циклом документов. Мы сосредоточимся на использовании Temporal для обработки событий workflow, связанных с изменениями документов, не перегружая систему ненужными процессами и ручными шагами.

Assess

Библиотека для уведомлений о файловой системе Unix для PHP. Можно следить за изменениями в файловой системе без каких-либо зависимостей от JS