Rivalry2

HTML Diff

0 added 0 removed

Original 2026-01-01

Modified 2026-03-10

1 Омакросах в Laravelсказано явно недостаточно, и мы постараемся исправить эту досадную оплошность. Если говорить о макросах вкратце, то речь идёт о способе расширения метода класса, однако не через наследование, а через замыкание. При этом макросы можно применять в любом классе фреймворка Laravel, который использует трейт Macroable.

2 Использование макросов позволит вам улучшить свою работу, снизить дублирование кода, сделать код более читабельным, да и просто решить ряд проблем, которые иногда возникают при тестировании.

3 <h2>Как сделать и куда положить макросы в Laravel?</h2>

4 Итак, есть несколько мест, куда можно положить макросы: 1.Использование простого PHP-файла и его загрузка черезComposer. Нужно создать новый файлmacros.phpв папкеapp. После этого следует отредактироватьautoloadвcomposer.json, добавив в свойствоfilesотносительный путь к файлуapp/macros.php. Далее останется запуститьcomposer dump-autoloader, чтобы файл загружался и выполнялся, настраивая макросы для всего нашего приложения.

5 "autoload": { "psr-4": { "App\\": "app/" }, "classmap": [ "database/seeds", "database/factories" ], "files": [ "app/macros.php" ] }2.Второе место - это методbootв сервис-провайдере. По правде говоря, это не самый оптимальный способ, т. к. при росте приложения придётся добавлять всё больше макросов. Но тем не менее.

6 <h2>Коллекции</h2>

7 Большинство людей познакомились с макросами именно с помощью коллекций вLaravel, поэтому не будем об этом много рассказывать. Приведём лишь простой, но хороший пример небольшого макроса - этопреобразование ключей для массива. Если вы захотите написать преобразование как функцию, это будет довольно утомительно.Лучше использовать макрос. Сначала его необходимо создать, чтобы всё отмаппить и управлять рекурсивно:

8 <?php \Illuminate\Support\Collection::macro( 'mapKeysWith', function ($callable) { /* @var $this \Illuminate\Support\Collection */ return $this->mapWithKeys(function ($item, $key) use ($callable) { if (is_array($item)) { $item = collect($item) ->mapKeysWith($callable) ->toArray(); } return [$callable($key) => $item]; }); } );А потом создать ещё один, чтобы красиво всё обернуть:

9 <?php \Illuminate\Support\Collection::macro( 'mapKeysToCamelCase', function () { /* @var $this \Illuminate\Support\Collection */ return $this->mapKeysWith('camel_case'); } );Вуаля, теперь можно использовать наш макрос, к примеру, так:

10 <?php collect(['test_key' => ['second_layer' => true]])->mapKeysToCamelCase(); // Создает массив ['TestKey' => ['SecondLayer' => true]]<h2>Запросы Eloquent</h2>

11 Здесь применение макросов имеет действительно важное значение. К примеру, вы хотите напрямую использовать БД. Скорее всего, вы будете делать это, используя "сырые" запросы (raw queries):

12 <?php $query->whereRaw( "ST_Distance_Sphere(`table`.`column`, POINT(?, ?)) < ?", [$long, $lat, $distance], $boolean );Если в вашем приложении вы будете делать это слишком часто, код станет повторяемым, не говоря уже о попытках соединить несколько where в одном выражении. Да, можно обойти это с помощью скоупов (scopes), но их тогда придётся добавлять в каждую модель. Проще всего - создать макрос. В нашем примере мы создаём макрос для фильтрации результатов в MySQL, применяя встроенные геопространственные функции сервера:

13 <?php \Illuminate\Database\Query\Builder::macro( 'whereSpatialDistance', function ($column, $operator, $point, $distance, $boolean = 'and') { $this->whereRaw( "ST_Distance_Sphere(`{$this->from}`.`$column`, POINT(?, ?)) $operator ?", [$point[0], $point[1], $distance], $boolean ); });А чтобы мы могли использовать условиеorWhere, добавим ещё один макрос:

14 <?php \Illuminate\Database\Query\Builder::macro( 'orWhereSpatialDistance', function ($column, $operator, $point, $distance) { $this->whereSpatialDistance($column, $operator, $point, $distance, 'or'); } );Теперь, если нужно отфильтровать запрос, можно вызвать макрос напрямую точно так же, как и любой другой оператор where.

15 <?php $query->whereSpatialDistance('coordinates', [1, 1], 10) ->orWhereSpatialDistance('coordinates', [0, 0], 1);Написано по материалам статьи "<a>Laravel Tip: 5 examples of why you should be using Macros</a>".