Lightning для AI-агентов

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

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

Инструменты Lightning
index.php?li_op=tools
Общий каталог инструментов для диагностики сервера, базы данных, файлов и Lightning. Также открывается кнопкой Инструменты в панели Lightning.

Панель и настройки Lightning
index.php?lightning
Открывает виджет OpenCart Lightning. Показывает размеры кеша, статистику использования, текущие запросы и фоновую активность. Кнопка Настройки... открывает параметры оптимизации. Панель также позволяет включать и отключать Lightning и очищать кеш кнопкой Очистить кеш для проверки изменений в настройках.

Извещения и проверка состояния
Доступны через Извещения или Новые извещения в панели Lightning. Сообщают об обнаруженных проблемах интеграции, настройки и хостинга, включая ускорение PHP, HTTPS, CRON и задержки при обращении к базе данных.

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

Лог производительности
Нажмите Лог производительности на странице магазина или откройте URL из заголовка ответа X-Lightning-Log, обычно ?log_ID. Открывает отчёт Метрики генерации страницы с профилем уже завершённого запроса, в том числе AJAX: временем выполнения, SQL-запросами и зафиксированными вызовами приложения. Исходное действие при этом не повторяется.

Детальное профилирование
Добавьте ?li_sql или &li_sql к URL исследуемой страницы либо используйте Детальное профилирование или Перетестировать в отчёте. Создаёт подробный профиль нового выполнения с разбивкой времени на PHP, SQL, Lightning, изменение размеров изображений, WebP и ожидание. Помогает находить ресурсоёмкие вызовы, повторяющиеся запросы и соответствующие места в исходном коде.

Изучение запроса SQL
Нажмите Изучить рядом с запросом в профиле; адрес имеет вид index.php?li_op=inspect&data=.... Выполняет SELECT-запрос и измеряет его длительность, показывает план выполнения, таблицы и индексы. Позволяет проверять принудительное использование или игнорирование индексов. Агенты могут добавлять индексы прямо здесь кнопкой «Добавить индекс», управлять существующими индексами, менять движки таблиц и повторно выполнять запросы кнопкой Выполнить снова для оценки результата.

Оценка оптимизации SQL
Нажмите Оценить в профиле, содержащем оптимизированные запросы. Сравнивает производительность исходных SQL-запросов и запросов, оптимизированных Lightning, показывая ускорения и замедления. Выполняет исходные запросы и сравнивает их время с записанным временем оптимизированных запросов. Если записанный результат был получен из кеша, оптимизированный запрос также выполняется заново.

Таблицы SQL
index.php?li_op=search&search=tables
Показывает размеры таблиц, движки, правила сравнения строк, столбцы, записи и индексы. Позволяет редактировать индексы, менять движки и выполнять операции обслуживания таблиц.

Проверка вариантов оптимизации SQL
index.php?li_op=optimization
Проверяет особенности каталога, влияющие на оптимизацию запросов: порядок сортировки товаров, отсутствующие описания, привязку к магазинам, отключённые товары и будущие даты поступления. Предоставляет соответствующие действия для массового изменения данных.

Просмотр исходного кода
index.php?li_source=catalog/model/catalog/product.php:123
Показывает фактический файл на сервере, выделяет указанную строку и отображает время изменения файла. Помогает искать причины ошибок и сравнивать исходные файлы с копиями, созданными системой модификаций. Префикс storage/... соответствует настроенному каталогу хранения.

Поиск в файлах
index.php?li_op=search&search=TEXT
Ищет буквальное вхождение текста без учёта регистра в файлах PHP, TPL и Twig. Добавьте &js=1, чтобы включить JavaScript и CSS. Помогает находить маршруты, функции, фрагменты SQL, сообщения об ошибках и ключи сессии. Текст поиска нужно передавать в URL-кодировке.

Модификации
index.php?li_op=search&search=ocmod
Показывает модификации OCMOD/vQmod, их состояние и содержимое патчей. Помогает определить, какие расширения изменяют контроллер, модель, библиотеку или шаблон.

Изменённые файлы
index.php?li_op=search&search=changed
Показывает недавно изменённые файлы. Помогает находить ручные правки, обновлённые и сгенерированные файлы, которые могут быть связаны с появлением проблемы.

Просмотр логов
index.php?li_op=lg
Показывает журналы ошибок и отладки для чтения и наблюдения в реальном времени. Помогает исследовать сбои PHP, ошибки расширений и повторяющиеся проблемы фоновых задач. Для выбранного журнала доступен фильтр по буквальному вхождению текста &filter=TEXT.

Сессия и параметры запроса
index.php?li_op=s
Показывает снимок состояния сессии, полученный Lightning на раннем этапе обработки запроса, а при наличии административного доступа — также переменные сервера и запроса. Помогает исследовать поведение, связанное с языком, валютой, группой покупателей, корзиной и сессией.

Информация о сервере
index.php?li_op=server
Показывает информацию о PHP, загруженных расширениях и состоянии OPcache. Помогает выявлять отсутствие необходимых возможностей, ошибки настройки и устаревший байткод в кеше. Кнопка Сбросить OPcache позволяет очистить кеш байткода.

Просмотр процессов
index.php?li_op=ps
Показывает текущую загрузку процессора отдельными процессами. Помогает находить ресурсоёмкие процессы PHP, базы данных и фоновые задачи.

Процессы БД
index.php?li_op=ps&sql=1
Показывает активные запросы к базе данных, их длительность и состояние выполнения. Помогает исследовать медленные запросы, одновременную нагрузку и ожидание освобождения блокировок.

Анализ места на диске
index.php?li_op=free
Помогает находить крупные каталоги, оценивать объём кеша и причины нехватки места на диске. Включает действия для очистки.

Анализ inodes
index.php?li_op=free&inodes=1
Находит каталоги с большим количеством файлов. Полезен, когда лимит количества файлов на хостинге исчерпан, хотя свободного места на диске ещё достаточно.

Активность CRON
index.php?li_op=show_cron
В реальном времени показывает фоновую работу Lightning, генерацию кеша и ход выполнения задач. Помогает исследовать зависшую или незавершённую обработку.

Почта
index.php?li_op=mailbox
Показывает письма в очереди, отправленные письма и письма с ошибками отправки, их содержимое и ошибки доставки. Поддерживает поиск по получателю или теме, повторную отправку, редактирование, отправку и удаление писем.

Управление доступом к сайту
index.php?li_op=access&op=control
Также открывается кнопкой Доступ в панели Lightning. Показывает правила доступа и информацию о заблокированных запросах. Помогает исследовать неожиданную блокировку и изменять правила разрешения и блокировки доступа.

Разобрать с ChatGPT
Кнопка ChatGPT на поддерживаемых страницах диагностики экспортирует текущий отчёт или исходный код вместе с информацией о магазине и версиях для анализа с помощью ИИ.