Более эффективное использование документации

Не допускайте возникновения туннельного зрения

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

Поэтому я продолжу тему об уникальности фабрик и извлеку из этой истории еще один совет.

На этот раз я хочу поговорить об эффективном использовании документации.

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

Если задать поиск по слову «unique» в документации Laravel, найдется ноль результатов, ведущих к разделу о фабриках. А если полностью прочитать раздел о фабриках, то единственное упоминание, которое удастся найти, это пример кода, использующий unique().

Но следует помнить, что, хотя Laravel предоставляет возможность создавать фабрики, для генерации данных используется библиотека Faker. Поэтому если не обратиться к документации Faker, то останется огромное слепое пятно.

Есть и другие примеры: PHPUnit, Mockery, Carbon и так далее.

Иногда границы размыты, как, например, в случае с PHPUnit, где Laravel предоставляет довольно много хелперов поверх предлагаемых PHPUnit, так что придётся проверить оба источника, чтобы понять, что относится к PHPUnit, а что — к Laravel.