PHP SDK: с чего начать

SDK является набором готовых инструментов внутри сценария. Вместо прямого cURL, файлов и команд операционной системы используйте $ctx: система применит настройки сайта, права, ограничения частоты и учёт ресурсов.

Эта часть справочника описывает PHP-сценарии. Для другого языка переключите выбор рядом с версией документации. Примеры языков в разделе API предназначены для внешних программ.

Сценарий может объединять несколько сайтов и входящее письмо. Выбранный при создании сайт определяет место хранения результатов, а не перечень разрешённых адресов. Как объединить источники.

Как читать примеры

<?php
function run(\Sdk\Context $ctx): void
{
    // Здесь располагается ваш алгоритм и фрагменты из справочника.
    $ctx->log('Начинаем сбор');
}

Фрагменты на страницах методов вставляются внутрь run. Переменные $response, $dom, $card и $page описаны в начале соответствующей страницы. Это отдельные примеры, а не один общий сценарий, который следует запустить подряд.

В сигнатуре string означает строку, int целое число, float дробное, bool логическое значение, array массив. ?string допускает null; mixed допускает разные типы. После = показано значение по умолчанию. void не возвращает значение, never завершает выполнение. Объекты SDK получаются через $ctx; создавать их через new нельзя.

Выберите задачу

Что ещё разрешено

В алгоритмах доступны разрешённые стандартные функции PHP: например count, trim, json_encode, preg_match, операции с массивами. Полный актуальный набор выдаёт каталог SDK через API и показывает редактор. Не любая функция PHP разрешена: прямые файловые операции, сеть, shell, динамическое выполнение кода и создание объектов запрещены.

Служебные Transport и CssSelector реализуют внутреннюю работу SDK, не являются пользовательскими точками входа и не должны вызываться из алгоритма.

Рабочие примеры целиком

• Первый сбор HTML
• Обход страниц и категорий
• JSON-источник
• Действия браузера
• Параллельные запросы и прогресс
• Преобразование выгрузки

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

Работа с CAPTCHA: полные примеры

Каталог, пагинация, кнопка загрузки, прокрутка, вход, JavaScript-отрисовка и контрольные страницы разобраны в отдельном разделе. Каждый из 12 примеров содержит настройки, полный исходник и объяснение алгоритма.

Явные задания CAPTCHA

Актуальный каталог типов, схемы входных данных, оценка стоимости и получение результата доступны через ctx.captcha(). API работает в облаке и на агентах с оплатой из пространства. Справочник.