Введите минимум 3 символа для поиска

·11 мин чтения

Из Elementor в Laravel Blade: как перевести сайт на конструкторе скриптом

Cover of the Elementor to Laravel Blade article: a printed web page layout on a desk beside a wooden type case of metal letters, with two letters lifted out

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

Это техническая сторона проекта, который мы для клиентов описали в кейсе IFHRS. У Международной федерации обществ по исследованию волос (IFHRS) был сайт на WordPress 7.1, собранный в Elementor Pro, ACF Pro и Unlimited Elements. Федерации нужен был сайт на шести языках своих обществ и место под личный кабинет в будущем. Мы перевели его на Laravel 13.42 и PHP 8.3, нашего собственного PHP получилось около 2200 строк.

Весь код ниже взят из этого проекта. Для статьи ничего не писалось отдельно.

ЗАДАЧА

Что должно остаться прежним

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

  • Тот же дизайн до пикселя, включая разметку и CSS самого Elementor.
  • Те же 39 адресов, со слешем в конце, потому что так их проиндексировал Google.
  • Тот же виртуальный хостинг: один корень сайта, Apache, ни второго сервера, ни конвейера выкладки.
  • Возврат за минуты, без восстановления из бэкапа.

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

СПЕЦИФИКАЦИЯ

Опубликованный HTML как спецификация

Мы начали с единственной версии дизайна, которая гарантированно верна: с того, что WordPress реально отдаёт анонимному посетителю. Мы сохранили HTML каждой страницы в том виде, в каком его отдаёт сайт, и считали эти файлы спецификацией.

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

Сайт на конструкторе не перерисовывают. Переносят то, что он уже публикует.

Менять нужно было место, где живут слова. В WordPress они лежат внутри JSON-дерева Elementor в базе, вперемешку с настройками вёрстки. В Laravel они должны были стать строками, которые переводчик правит, не касаясь разметки.

КОНВЕРТЕР

Текст наружу, токены внутрь

Конвертер написан на Python и Beautiful Soup. Он проходит по каждой сохранённой странице и заменяет видимый текст вызовами хелпера Blade tx(). Самое интересное решение здесь в том, что считать одной строкой.

Переводчик должен видеть целое предложение со ссылкой и выделением, а не три обрывка. Поэтому скрипт работает единицами: элемент, внутри которого только строчные теги и текст, становится одной строкой вместе с этими тегами.

INLINE = {"a", "span", "strong", "b", "em", "i", "br", "sup", "sub", "small", "u", "mark", "abbr", "time", "code", "wbr"}

def is_unit(self, el):
    has_text = False
    for d in el.descendants:
        if isinstance(d, Comment):
            continue
        if isinstance(d, NavigableString):
            if d.strip():
                has_text = True
        elif isinstance(d, Tag) and d.name not in INLINE:
            return False
    return has_text

Сам обход короткий. Голые текстовые узлы становятся токеном, единицы очищаются и получают один токен, всё остальное обходится глубже. Скрипты, стили, SVG, iframe и поля форм пропускаются.

def walk(self, el):
    for c in list(el.children):
        if isinstance(c, NavigableString):
            t = c.strip(WS)
            if t and not LITERAL.match(t):
                c.replace_with(NavigableString("{!! tx('%s') !!}" % self.key(t)))
            continue
        if self.is_unit(c):            # only inline tags and text inside
            inner = "".join(str(x) for x in c.contents).strip(WS)
            c.clear()
            c.append(NavigableString("{!! tx('%s') !!}" % self.key(inner)))
        else:
            self.walk(c)

Ещё три правила держат результат чистым:

  • Текст в атрибутах, который читают люди (alt, title, aria-label, placeholder), получает экранированную форму {{ tx('...') }}.
  • Ключи короткие и свои у каждой страницы (p.1, p.2 и дальше). Функция ключа сначала ищет значение, поэтому повторённое на странице предложение получает тот же ключ и переводится один раз.
  • Строки, где нечего переводить (числа, даты цифрами, разделители), совпадают с шаблоном LITERAL и остаются в разметке.

В итоге получился один шаблон Blade на страницу и один JSON-файл строк на страницу и язык: около 1130 строк на язык в 40 файлах.

ССЫЛКИ

Два вида внутренних ссылок

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

if k:
    return ("[[url:%s]]" % k if in_text else "{{ lurl('%s') }}" % k) + frag
return path + frag

В шаблоне href становится вызовом Blade {{ lurl('mission') }}. Внутри переводимой строки он становится токеном [[url:mission]], который подставляется под текущий язык при выводе. Переводчик никогда не правит адрес, а перенос страницы никогда не требует трогать шесть переводов. Ссылки на загрузки и файлы темы остаются обычными путями, ссылки на другие сайты не меняются.

Хелпер адресов сохраняет привычку WordPress ставить слеш в конце каждой страницы:

public static function url(string $page, ?string $locale = null): string
{
    $locale ??= app(self::class)->locale;
    $path = $page === 'home' ? '' : $page;
    $prefix = $locale === config('ifhrs.default_locale') ? '' : $locale;
    $u = '/'.trim($prefix.'/'.$path, '/');
    return $u === '/' ? $u : $u.'/';     // /mission/, /uk/mission/, /uk/
}

Всё, на что раньше отвечал WordPress, получает 301: адреса .html старой статической версии, wp-sitemap.xml с дочерними картами, ленты, архивы рубрик и меток, а также /?s= для поиска. Новая карта сайта перечисляет 234 адреса, 39 страниц на шести языках, со ссылками hreflang между ними.

ЛОВУШКИ BLADE

Что Blade пытается скомпилировать

Именно здесь чаще всего спотыкаются те, кто пробует то же самое. Вывод Elementor полон текста, который Blade читает как свой синтаксис. Встроенные правила @media и @keyframes становятся директивами. JSON в атрибутах data-settings может содержать {{, а это для Blade вывод переменной. Шаблон, который вчера собирался, ломается, когда редактор добавляет анимацию.

Решение в том, чтобы до записи шаблона экранировать всё, кроме собственных токенов конвертера. Работу делают описанные в документации экраны Blade: @{{ выводит фигурные скобки как есть, а @@ выводит буквальный @ перед словом.

TOKEN = re.compile(r"(\{!! tx\('[^']+'\) !!\}|\{\{ tx\('[^']+'\) \}\}|\{\{ lurl\('[^']+'\) \}\})")

def blade_safe(html):
    out = []
    for part in TOKEN.split(html):
        if TOKEN.fullmatch(part or ""):
            out.append(part)          # our own tx() / lurl() calls
        else:
            part = part.replace("{{", "@{{").replace("{!!", "@{!!")
            part = re.sub(r"(?<![\w@])@(?=[a-zA-Z])", "@@", part)
            out.append(part)
    return "".join(out)

Проверка назад здесь важна. Без неё скрипт удвоил бы @ внутри адреса почты, который Blade и так не трогает, и на странице появилось бы name@@domain.

СТРОКИ

Слой строк вместо lang-файлов

__() и lang-файлы Laravel сделаны для строк интерфейса: подписей кнопок, сообщений валидации. Здесь строки размером с фрагмент страницы, с HTML внутри, и страница может быть переведена лишь частично. Поэтому шаблоны вызывают небольшой хелпер, за которым стоит один класс, читающий resources/content/<locale>/<page>.json.

На двух правилах держится весь слой. Пропущенная или пустая строка берётся из английской версии по одной строке, а не целой страницей, так что наполовину переведённая страница всё равно показывает каждое слово, и ничего не отдаёт 404 из-за недописанного языка. А токены [[url:...]] подставляются при выводе под текущий язык.

Раз строки содержат HTML, небрежный перевод может потерять закрывающий тег и сломать вёрстку вокруг. Поэтому каждая переведённая строка сравнивается с английской по форме, то есть по отсортированному списку её тегов и токенов ссылок:

public static function shape(string $html): array
{
    preg_match_all('/<\/?([a-z][a-z0-9]*)\b[^>]*>|\[\[[^\]]+\]\]/i', $html, $m, PREG_SET_ORDER);
    $out = [];
    foreach ($m as $x) {
        if (str_starts_with($x[0], '[[')) {
            $out[] = preg_replace('/\s+/', '', $x[0]);       // [[url:mission]]
        } else {
            $out[] = (str_starts_with($x[0], '</') ? '/' : '').strtolower($x[1]);
        }
    }
    sort($out);
    return $out;
}

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

СВЕРКА

Сравнение, а не скриншот

Перенос стоит ровно столько, сколько его доказательство, а «выглядит так же» доказательством не является. Перед каждым рефакторингом мы отрисовывали все 234 адреса и сохраняли HTML. После него скрипт заново забирал те же адреса и сравнивал их байт в байт, выводя первое место, где версии расходились.

def one(u):
    a = open(f'{D}/snap_before/{fname(u)}').read()
    b = get(u)                                  # the same URL from the new build
    if a == b:
        return u, 'same', ''
    i = 0
    n = min(len(a), len(b))
    while i < n and a[i] == b[i]: i += 1        # first differing character
    j = 0
    while j < n - i and a[-1-j] == b[-1-j]: j += 1
    return u, 'diff', f'A:{a[max(0,i-100):len(a)-j][:400]!r}\n B:{b[max(0,i-100):len(b)-j][:400]!r}'

Это грубо, и это именно то, что нужно при переезде. Смелые рефакторинги стали дешёвыми. Свести шестнадцать сделанных вручную шаблонов конгрессов в один оказалось можно проверить одной командой, как и перенос рассылок в записи. Последний полный прогон, после готовой админки, показал 228 из 234 страниц, совпадающих до байта; остальные шесть были одной намеренной правкой описаний картинок на странице одного конгресса на шести языках.

Та же идея ложится в тест Pest, если удобнее держать её в наборе тестов: один раз снять снимки ответов, а потом проверять, что $this->get($url)->getContent() совпадает с сохранённым файлом для каждого адреса из карты сайта. Этот метод мы уже применяли на более раннем переезде и описали его в статье о переносе статического сайта на Laravel байт в байт.

БЕЗ СЕССИЙ

Публичные маршруты вне web

Публичный сайт одинаков для всех посетителей, поэтому ему не нужны ни сессия, ни cookie, ни токен CSRF. Вместо того чтобы снимать middleware с маршрута за маршрутом, мы зарегистрировали публичные маршруты вообще вне группы web, в колбэке then метода withRouting():

return Application::configure(basePath: dirname(__DIR__))
    ->withRouting(
        web: __DIR__.'/../routes/web.php',          // admin only: session, CSRF
        commands: __DIR__.'/../routes/console.php',
        health: '/up',
        then: function () {
            // Public pages: no session, no cookies (cache-friendly, nothing written per visit).
            Route::middleware([])->group(base_path('routes/public.php'));
        },
    )

Админка живёт в routes/web.php с полным набором middleware, а её cookie сессии ограничена путём /admin. Публичный ответ не несёт заголовка Set-Cookie, поэтому любой CDN, поставленный перед сайтом позже, сможет кешировать его как есть.

Публичные страницы не трогают и базу. Тексты и записи лежат в JSON-файлах, а в базе только то, что нужно админке: пользователи и история правок. Там, где WordPress выполнял от 160 до 210 запросов на главную, Laravel не выполняет ни одного, и сервер отвечает от пяти до девяти раз быстрее. Полная таблица в кейсе.

ПЕРЕКЛЮЧЕНИЕ

Виртуальный хостинг без простоя

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

Прокладка перед фронт-контроллером. Приложение Laravel лежит рядом со старым корнем сайта, а файл из трёх строк в этом корне передаёт ему запросы:

<?php
// www/_lv.php: every request routed here runs the Laravel app
require __DIR__.'/../app/public/index.php';

Предпросмотр на настоящем домене. До переключения кто что видит, решала cookie. Секретный адрес ставил её. Браузеры с ней получали Laravel, все остальные, включая Googlebot, по-прежнему получали WordPress. Мы проверяли новый сайт на его настоящем домене, с настоящими файлами и адресами, столько, сколько было нужно.

RewriteRule ^_lv\.php$ - [L]
RewriteRule ^lv-preview-<secret>(-off)?$ /_lv.php [L]
RewriteCond %{HTTP_COOKIE} (^|;\s*)ifhrs_lv=1(;|$)
RewriteCond %{REQUEST_URI} !^/(wp-admin|wp-includes|wp-content|wp-json|wp-login\.php)
RewriteRule ^ /_lv.php [L]

Само переключение заменило этот блок правилом, которое отправляет на прокладку каждый нестатический запрос. WordPress переехал на поддомен old. с теми же файлами и базой, закрытый заголовком X-Robots-Tag: noindex и без аналитики. Вернуться назад значит снова поменять блок: минуты, а не восстановление.

Фиксация платформы в Composer. Хостинг запускает PHP 8.3 для сайта и 8.4 в командной строке. Без фиксации composer update в консоли подбирает пакеты, которым нужен 8.4, и сайт падает на следующем запросе из браузера. Одна настройка в composer.json заставляет Composer подбирать пакеты под ту версию, которая отдаёт страницы:

"config": {
    "platform": { "php": "8.3.36" }
}

На виртуальном хостинге Composer часто запускает не тот PHP, что отдаёт страницы.

ВЫВОДЫ

Что мы бы повторили

Порядок оказался важнее любого отдельного инструмента. Заморозить опубликованное, сделать сравнение автоматическим и только потом улучшать. Каждый шаг был достаточно мал, чтобы его проверить, и сравнение ловило каждую ошибку раньше посетителя.

Пока не изменился вес страниц в браузере. Страницы всё ещё грузят CSS и JavaScript Elementor, потому что этот этап обещал те же пиксели. Заменить их собственными файлами со сверкой по скриншотам, а не по байтам, предстоит на следующем этапе. После этого формы обратной связи переедут в Laravel, и старую копию можно будет выключить.

Если ваш сайт тоже держится на конструкторе и устаревшем стеке, наши команды разработки на Laravel и модернизации сайтов делают такой переезд без редизайна.

FAQ

Частые вопросы

Можно ли автоматически перевести страницы Elementor в Blade?

Да, если переводить опубликованный HTML, а не JSON Elementor. Скрипт может вынести видимый текст в языковые файлы и сохранить разметку, если он экранирует синтаксис Blade, спрятанный в CSS и настройках Elementor.

Нужен ли CSS Elementor после перевода?

Сначала да: разметка сохраняет классы Elementor, и его стили держат внешний вид. Замена их собственным CSS идёт отдельным этапом со сверкой по скриншотам, потому что она как раз должна менять байты.

Почему не lang-файлы Laravel для текстов страниц?

Lang-файлы подходят для коротких строк интерфейса. Тексты страниц это фрагменты HTML со ссылками и оформлением, переведённые частично и редактируемые людьми, поэтому им больше подходит JSON-файл на страницу с английской подстановкой для каждой строки.

Как доказать, что после переезда ничего не изменилось?

Сохранить HTML каждого адреса до изменений, забрать те же адреса после и сравнить байт в байт. Тест Pest с сохранёнными снимками делает то же самое внутри набора тестов.

Источники

Сайт застрял в конструкторе? Давайте посмотрим, что нужно, чтобы перевести его на Laravel.

Записаться на стратегическую сессию

Сайты на Laravel