Тема
Российская специфика
Пакеты и сервисы для проектов под РФ-рынок. Здесь чаще, чем в остальном каталоге, встречаются полуживые обёртки — правило: официальный PHP SDK сервиса + тонкая своя интеграция надёжнее, чем толстая community-обёртка «laravel-*», брошенная автором.
Платежи
| Сервис | Пакет | Заметка |
|---|---|---|
| ЮKassa | yoomoney/yookassa-sdk-php (официальный) | Карты, СБП, сплит; Laravel-обёртки сообщества — проверять свежесть, чаще проще свой Service поверх SDK |
| ЮKassa «Безопасная сделка» | тот же SDK / отдельный API | Ключ к эскроу на биржах → marketplace.md |
| Т-Касса (Тинькофф) | официальный API + community SDK | Хорошая документация, вменяемые вебхуки |
| Robokassa | лёгкие обёртки / свой клиент | Протокол простой — своя интеграция за полдня |
| CloudPayments | cloudpayments PHP SDK | Виджет + рекуррентные платежи |
| СБП напрямую | через банк-эквайер | Обычно берётся через ЮKassa/Т-Кассу |
Паттерн: интерфейс PaymentGateway в домене + реализации по шлюзам; вебхуки — только через подпись, идемпотентно (таблица payment_events с уникальным ключом события).
Чеки (54-ФЗ)
ЮKassa/Т-Касса умеют фискализацию сами (передача чека в платеже). Отдельные ОФД-интеграции (АТОЛ Онлайн, OrangeData) — официальные SDK + свой сервис. Закладывать поле «предмет расчёта» в модели позиций заранее.
Адреса, справочники
| Сервис | Пакет | Заметка |
|---|---|---|
| DaData | официальный PHP-клиент (hflabs/dadata на Packagist) | Подсказки адресов/ФИО/организаций, стандартизация; бесплатный лимит в сутки |
| ФИАС/КЛАДР напрямую | — | Не связываться — DaData дешевле по трудозатратам |
| Проверка контрагентов по ИНН | DaData Suggestions API | Автозаполнение реквизитов в формах |
Доставка
| Сервис | Пакет | Заметка |
|---|---|---|
| СДЭК | community SDK (напр. sanmai/cdek-sdk) или свой клиент к API v2 | Проверять поддержку API v2 |
| Boxberry, 5Post, ПВЗ-агрегаторы | свои клиенты | API простые REST |
| Почта России | отправка через otpravka-api | Community-обёртки нестабильны — тонкий свой клиент |
| Яндекс Доставка | REST API | Свой клиент |
SMS и мессенджеры
| Канал | Пакет | Заметка |
|---|---|---|
| Telegram-уведомления | laravel-notification-channels/telegram | В канал/чат команды — заявки, алерты; самый дешёвый канал |
| Telegram-боты | defstudio/telegraph (Laravel-native) или nutgram/nutgram | Telegraph проще для ботов «внутри» Laravel-приложения |
| Telegram Login | socialiteproviders/telegram | Вход на сайт через Telegram |
| SMS (sms.ru, smsc.ru, Devino) | свой Notification-канал (~50 строк) | Обёртки часто мертвы; канал пишется быстро |
| VK/Yandex OAuth | socialiteproviders/vkontakte, socialiteproviders/yandex | Соцвход для РФ |
Локализация
| Задача | Решение |
|---|---|
| Русские переводы валидации/писем/UI Laravel | laravel-lang/common — ставить в каждый проект первым делом |
| Склонение городов/слов по падежам | Своё (как HasDeclensions в проектах студии) или API morpher.ru (платный) |
| Склонение ФИО | petrovich-php |
| Числа прописью, склонение по числу («3 товара») | trans_choice() + русские правила плюрализации (laravel-lang включает) |
| Даты на русском | translatedFormat() (по спекам студии) + Carbon::setLocale('ru') |
| Транслитерация слагов | Str::slug() умеет кириллицу из коробки |
Интеграция с 1С
| Задача | Решение | Заметка |
|---|---|---|
| Обмен каталогом/заказами (CommerceML 2) | zenwalker/php-commerceml (парсер) или свой парсер XML | Зрелого «laravel-1c» нет; протокол обмена (запросы checkauth/init/file/import) реализуется своим контроллером за 1–2 дня |
| Выгрузка в МойСклад | официальный REST API | Часто проще, чем прямой 1С-обмен |
Поиск и карты
| Задача | Решение |
|---|---|
| Карты на сайте | Яндекс.Карты JS API (бесплатный лимит) или Leaflet + OSM (полностью бесплатно) |
| Геокодинг | DaData (адрес→координаты) или Яндекс Геокодер |
| 2GIS данные | официальный API (лимиты) |
Маркетплейсы-фиды
| Фид | Решение |
|---|---|
| YML (Яндекс.Маркет) | Зрелого пакета нет — свой генератор на Blade/XMLWriter (полдня) |
| Google Merchant | spatie/laravel-feed как основа либо свой XML |
| Авито Автозагрузка | свой XML по их схеме |
Хостинг-специфика
- S3-совместимые хранилища РФ (Selectel, VK Cloud, Yandex Object Storage) — работают через стандартный
league/flysystem-aws-s3-v3, только endpoint в конфиге. - Google reCAPTCHA нестабильна в РФ → Cloudflare Turnstile, hCaptcha или spatie/laravel-honeypot (для простых форм достаточно honeypot + rate limit).
- Почта: SMTP через unisender/sendsay/mail.ru для рассылок; транзакционная — свой SMTP или ресенд через РФ-провайдеров.