Как в шаблонах Laravel использовать собственные генераторы представлений?

Question

[Станислав]

Ситуация: есть шаблон, в нем хочется написать что-то вроде:

<!-- $var является экземпляром класса MyClass -->
{{ $var }}

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

Вопрос: позволяет ли такое делать Laravel в своем шаблонизаторе Blade? Каким образом я могу перехватить генерацию шаблона и в зависимости от типа переменной вызвать свой код?

Comments

[Дмитрий]

Блэйд нативный, хоть чистый пых пихай, только смысл такого шаблона

[Сергей delphinpro]

Такое писать можно (тайпхинтинг для переменных)

<?php /** @var MyClass $var */ ?>
{{ $var->field }}

Подсказки в IDE будут работать.

Собственно в php тегах можно писать любой php код

[Станислав]

Дмитрий, смысл такой: где-то под капотом приложения зарегистрировать свой генератор для того или иного класса, который будет вызываться в случае необходимости, и после просто выводить его в двух фигурных скобках, зная что он будет обработан тем самым генератором. "Пихать" каждый раз что-то в шаблон не хочется.

[Дмитрий]

Станислав, ну так сделайте все дела до шаблона, а в шаблон результат киньте

[Станислав]

Сергей delphinpro, хорошо, допустим у вас в данном поле не примитив, а экземпляр какого-то класса. Как перехватить его обработку для вывода?

[Сергей delphinpro]

Станислав, Определить интерфейс для классов, которые могут рендерить себя.

interface Renderable {
  public function render(): \Illuminate\View\View
}

Реализовать интерфейс в необходимом классе

class Card implements Renderable {
  public function render(): \Illuminate\View\View {
    return view('templates.card', []);
  }
}
class Panel implements Renderable {
  public function render(): \Illuminate\View\View {
    return view('templates.panel', []);
  }
}

Передать объект класса в родительский шаблон и дернуть метод render

{{ $card->render() }}
{{ $panel->render() }}

Короче, вынести любую логику, кроме примитивных условий из шаблонов.

[Станислав]

Сергей delphinpro, вот цель избавиться от некоего вызова чего угодно, предоставив некоему подкапотному инструменту вызывать метод render, или искать генератор представления, или что угодно еще.

[Сергей delphinpro]

Станислав, тогда определять метод __invoke

{{ $card() }}
{{ $panel() }}

Ниже про __toString() написали. Совсем забыл про него...

[Сергей delphinpro]

Станислав, ну еще можете свою директиву определить, которая будет проверять переданную переменную и при необходимости дергать тот же метод render/ ну или там по вашей какой-то логики что-то делать

@output($var)

[Станислав]

Сергей delphinpro, __invoke(), так же как и __toString(), как я уже отвечал ранее, дают слишком сильное зацепление между модулем собственно самого класса и модулем генерации представлений, это неверно архитектурно.

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

[Сергей delphinpro]

Станислав, ну вроде уже все простые варианты перечислили.
Осталось только переопределить компилятор своим собственным, с блэкджеком и дамами =)

[Станислав]

Дмитрий,

ну так сделайте все дела до шаблона, а в шаблон результат киньте

Конечно же можно и так, но тогда зачем я сюда со своим вопросом вообще пришел? :-)

Сергей delphinpro,

Осталось только переопределить компилятор своим собственным, с блэкджеком и дамами =)

Нет, просто не буду тогда искать лишней магии :-)

Answer 1

[Антон Антон]

Если заранее "имя класса" известно - то это можно просто заменить компонентом https://laravel.com/docs/8.x/blade#components или (при отсутствии собственной логики) подшаблоном https://laravel.com/docs/8.x/blade#including-subviews
Если же заранее "имя класса" не известно, то тут динамические компоненты могут помочь https://laravel.com/docs/8.x/blade#dynamic-components

Comments

[Станислав]

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

[Антон Антон]

Станислав, где в вопросе про 5.3 (который по современным темпам разработки - уже достаточно древний и это является существенным нюансом)?
Ну а если совсем как в вопросе хочется, то есть магический метод https://www.php.net/manual/ru/language.oop5.magic.... правда чем это лучше, чем знать имя компонента - не понятно. Ну и вопрос передачи данных из шаблона в "класс-генератор" остается открытым. придется тогда дергать конкретную функцию и передавать в неё параметры, что также убивает всю прелесть (относительно subview, в которые переменные передадутся автоматом). Логику, если она есть (хоть это и говнокод), можно прям в subview реализовать https://laravel.com/docs/5.3/blade#php

[Сергей delphinpro]

Антон Антон, Есть одна админка для ларки (orchid), она вся построена на __toString. В результате небольшая опечатка в таком "stringable" классе превращается в угадайку "где же я ошибся", потому как трейсер вываливает указания на скомпилированный блэйдшаблон, а не на сам класс..

[Антон Антон]

Сергей delphinpro, всё так, но автору нужно больше магии.

[Станислав]

Антон Антон, Сергей delphinpro, все верно, есть __toString(), о котором я тоже знаю, но нужен другой способ, как минимум из-за причины, озвученной выше, как максимум из-за сильного сцепления в случае использования такого подхода.

Ребят, меня не нужно учить основам программирования. Мне нужно дать рабочий способ регистрации своего генератора представления для тех или иных вещей.

[Антон Антон]

Станислав, тут надо выдохнуть и вернуться к изучению архитектуры. Более подробно рассказать, чего же хочется добиться - у laravel есть куча всего. Наверное надо начать с сервис провайдеров, байндинга и прочего. Потому что прибивание имени класса как в шаблоне - это тоже самое "сильное зацепление".

[Станислав]

Антон Антон,

Потому что прибивание имени класса как в шаблоне - это тоже самое "сильное зацепление"

Скорее всего вы имеете ввиду комментарий phpDoc в моем вопросе, но он дан просто для понимания того, что переменная является экземпляром некоего класса. Изменил вопрос, надеюсь так будет понятнее. Если нет, то раскройте смысл сказанного более подробно, пожалуйста.

[Антон Антон]

Станислав, ну вот прямо в таком виде как в вопросе и будет работать __toString() и будет он вызываться именно для того класса. Внутри можно вызвать свой render своих шаблонов, можно просто возвращать строку. В чем вопрос и откуда тут "регистрация" - я не понял. Если имеется ввиду автоопределение классов, то выше я написал про биндинг и сервис провайдеры. Если автоопределения классов нет и экземпляр создается где-то в коде напрямую - то всё будет и так работать.

[Станислав]

Антон Антон, в итоге нашлось более менее подходящее решение для более поздних в..., но использовать его я не смогу.

[Антон Антон]

Станислав, так там прямым текстом написано - если не можете использовать __toString, так как класс в сторонней библиотеке (и от него не отнаследоваться по какой-то причине)

[Станислав]

Антон Антон, там прямым текстом написано следующее:

However, sometimes you may not have control over the __toString method of a given class, such as when the class that you are interacting with belongs to a third-party library.

То есть не "если не можете", а "например, если не можете". Так вот я например просто не хочу сильного сцепления между классами и их трансляторами.

[Антон Антон]

Станислав,

sometimes you may not have control over the __toString method of a given class

"у вас может не быть контроля над методом __toString"
+ тут не будет "сильного зацепления между классами", так как нет нескольких классов, нечему зацепляться.

[Станислав]

Антон Антон, как-то странно вы переводите, слово "sometimes" для вас ничего не значит? Это во-первых. Во-вторых, если вы внимательнее прочитаете, вопрос то я хотел бы использовать трансляторы для классов, так как они зачастую однотипны. А так да, если в методе __toString() написать что-то без использования чего-либо в принципе, то сильного зацепления ни с чем не будет :-)

[Антон Антон]

Станислав, там написано: "вы можете использовать __toString, но иногда у вас может не быть возможности его переопределить." У вас явно не этот случай.