<!-- Конфигурация MKF AntiBot -->
          <script>
              window.MKFAntiBotConfig = {
                  // Базовая конфигурация
                  debug: false,
                  logo: "/path/to/your-logo.png",
                  captchaKey: "your-smartcaptcha-key",
                  serverURL: "https://your-server.com/api/antibot/",
                  // Дополнительные настройки будут добавлены ниже
              };
          </script>
          
          <!-- Подключение библиотеки MKF AntiBot -->
          <script src="/path/to/mkf-antibot.js" defer></script>

window.MKFAntiBotConfig = {
              debug: false,
              logo: "https://example.com/logo.png",
              captchaKey: "your-smartcaptcha-key",
              serverURL: "https://api.example.com/mkf-antibot/",
              strictMode: true,
              cookieName: "mkf_antibot_verified",
              cookieExpiration: 30
          };

window.MKFAntiBotConfig = {
              debug: false,
              logo: "/logo.png",
              captchaKey: "your-smartcaptcha-key",
              serverURL: "https://your-server.com/api/antibot/",
              
              // Настройки защиты форм
              formsProtection: {
                  enabled: true,
                  formIds: ['contactForm', 'subscribeForm'] // ID форм для защиты
              },
              
              // Настройки защиты контента
              contentProtection: {
                  mode: 'visual', // Режим защиты контента: 'visual' или 'full'
                  preserveScripts: true,
                  preserveContext: true
              },
              
              // Настройки поведенческого анализа
              behaviorAnalysis: {
                  enabled: true
              },
              
              // Настройки отслеживания детектов
              detectionTracking: {
                  enabled: true
              }
          };

window.MKFAntiBotConfig = {
              debug: false,
              logo: "/logo.png",
              captchaKey: "your-smartcaptcha-key",
              serverURL: "https://your-server.com/api/antibot/",
              
              // Включение режима мониторинга
              monitoringMode: {
                  enabled: true,             // Включаем режим мониторинга
                  trackToAnalytics: true,    // Отправлять события в аналитику
                  blockForms: false,         // Не блокировать формы при обнаружении бота
                  stealthMode: false,        // Показывать визуальные индикаторы обнаружения
                  logDetections: true,       // Расширенное логирование обнаружений
                  detectionThreshold: 50,    // Порог для регистрации события обнаружения
                  visualIndicator: true,     // Показывать индикатор режима мониторинга
                  samplingRate: 100          // Процент ботов для отслеживания (100 = все)
              },
              
              // Защита форм (опционально)
              formsProtection: {
                  enabled: true,
                  formIds: ['contactForm']
              },
              
              // Настройки поведенческого анализа
              behaviorAnalysis: {
                  enabled: true
              }
          };

window.MKFAntiBotConfig = {
                  // Базовая конфигурация...
                  
                  // Настройка аналитики
                  analytics: [
                      {
                          name: 'Yandex.Metrika',
                          type: 'js',
                          async: true,
                          code: `(function(m,e,t,r,i,k,a){m[i]=m[i]||function(){(m[i].a=m[i].a||[]).push(arguments)};
                              m[i].l=1*new Date();
                              for (var j = 0; j < document.scripts.length; j++) {if (document.scripts[j].src === r) { return; }}
                              k=e.createElement(t),a=e.getElementsByTagName(t)[0],k.async=1,k.src=r,a.parentNode.insertBefore(k,a)})
                              (window, document, "script", "https://mc.yandex.ru/metrika/tag.js", "ym");
              
                              ym(12345678, "init", {
                                  clickmap:true,
                                  trackLinks:true,
                                  accurateTrackBounce:true,
                                  webvisor:true
                              });`,
                          noscript: '<div><img src="https://mc.yandex.ru/watch/12345678" style="position:absolute; left:-9999px;" alt=""></div>'
                      },
                      {
                          name: 'Google Analytics',
                          type: 'js',
                          async: true,
                          code: `(function() {
                            var script = document.createElement('script');
                            script.async = true;
                            script.src = 'https://www.googletagmanager.com/gtag/js?id=G-XXXXXXXXXXX';
                            document.head.appendChild(script);
              
                            window.dataLayer = window.dataLayer || [];
                            function gtag(){dataLayer.push(arguments);}
                            gtag('js', new Date());
                            gtag('config', 'G-XXXXXXXXXXX');
                          })();`,
                          noscript: '<iframe><src="https://www.googletagmanager.com/ns.html?id=G-XXXXXXXXXXX" height="0" width="0" style="display:none;visibility:hidden"></iframe>'
                  ],
                  
                  // Настройка отправки событий в аналитику
                  analyticsTracking: {
                      enabled: true,
                      yandexMetrikaId: '12345678',
                      trackForms: true,
                      trackBehavior: true
                  }
              };

window.MKFAntiBotConfig = {
              // Базовая конфигурация
              debug: false,
              serverURL: "https://your-server.com/api/antibot/", // Обязательный параметр
              
              // Настройки проверки IP
              ipChecking: {
                  enabled: true,           // Включить/выключить модуль
                  timeout: 2000,           // Таймаут запроса в миллисекундах
                  retryAttempts: 2,        // Количество повторных попыток при ошибке
              },
              
              // Настройки режима мониторинга (если требуется)
              monitoringMode: {
                  enabled: false,          // Режим мониторинга без блокировки
                  trackToAnalytics: true   // Отправлять события в аналитику
              }
          }

GET /check-ip?ip={ip}

// Пример данных, отправляемых в аналитику
          {
              event_category: 'Security',
              event_action: 'suspicious_ip_detected',
              event_label: 'monitoring_mode',
              value: 100,
              ip: '1.2.3.4',
              details: {
                  status: 'blocked',
                  reason: 'malicious_activity',
                  list: 'tor_exit_nodes',
                  confidence: 90
              },
              timestamp: Date.now()
          }

8.8.8.8 # Комментарий о причине блокировки
          192.168.1.0/24 # Блокировка подсети
          2001:0db8:85a3:0000:0000:8a2e:0370:7334 # Блокировка IPv6

GET /check-ip?ip={ip}

GET /check-ip?ip={ip}&extended=true

{
              "success": true,
              "ip": "1.2.3.4",
              "check_result": {
                  "status": "blocked",
                  "reason": "malicious_activity",
                  "list": "tor_exit_nodes",
                  "confidence": 90,
                  "metadata": {
                      "first_seen": "2023-10-15T12:00:00Z",
                      "last_activity": "2023-11-20T08:15:22Z",
                      "attack_types": ["bruteforce", "scanning"],
                      "times_reported": 24
                  }
              },
              "geo": {
                  "country": "US",
                  "region": "California",
                  "city": "San Francisco"
              }
          }

// Получаем IP-адрес клиента
          const ip = await window.MKFAntiBotInstance.getClientIP();
          
          // Проверяем IP
          const result = await window.MKFAntiBotInstance.ipChecker.check(ip);
          
          // Проверяем результат
          if (result.isSuspicious) {
              console.log('Подозрительный IP:', result.ip);
              console.log('Детали:', result.details);
          }

// Проверяем конкретный IP
          const result = await window.MKFAntiBotInstance.ipChecker.check('8.8.8.8');
          console.log('Результат проверки:', result);

window.MKFAntiBotConfig = {
              // Включение и настройка детектора смены IP
              ipChangeDetection: {
                  enabled: true,              // Включить/выключить модуль
                  checkInterval: 5000,        // Интервал проверки IP в миллисекундах
                  maxChecks: 1000,            // Максимальное количество проверок за сессию
                  suspiciousChangesThreshold: 2, // Порог подозрительных изменений
                  
                  // Пороговые значения времени
                  timeThresholds: {
                      minTimeBetweenChanges: 30000,    // Минимальное время между сменами IP (30 сек)
                      suspiciousRapidChanges: 300000,  // Подозрительно частые смены (5 минут)
                  },
                  
                  // Веса для разных типов изменений
                  weights: {
                      countryChange: 100,     // Смена страны
                      regionChange: 50,       // Смена региона
                      cityChange: 30,         // Смена города
                      ispChange: 40,          // Смена провайдера
                      proxyDetected: 70,      // Обнаружен прокси
                      vpnDetected: 70,        // Обнаружен VPN
                      torDetected: 90,        // Обнаружен TOR
                      datacenterSwitch: 60,   // Переключение на датацентр
                      typeChange: 80          // Смена типа IP (например, с жилого на хостинг)
                  }
              }
          }

window.MKFAntiBotConfig = {
              // Базовая конфигурация...
              
              // Режим мониторинга
              monitoringMode: {
                  enabled: true,              // Включить режим мониторинга
                  trackToAnalytics: true,     // Отправлять события в аналитику
                  stealthMode: false          // Скрытый режим без визуальных индикаторов
              },
              
              // Конфигурация детектора смены IP
              ipChangeDetection: {
                  enabled: true,
                  // Остальные настройки...
              }
          }

// Пример данных, отправляемых в аналитику
          {
              event_category: 'Security',
              event_label: 'critical_ip_change_detected',
              event_action: 'critical_ip_change',
              value: changes.totalScore,
              changes: {
                  details: {
                      countryChange: {
                          from: 'RU',
                          to: 'US'
                      },
                      proxyDetected: true,
                      typeChange: {
                          from: 'residential',
                          to: 'datacenter'
                      }
                  },
                  timePatterns: {
                      score: 40,
                      patterns: {
                          tooFrequent: true,
                          uniformChanges: false,
                          rapidSuccession: true
                      },
                      timeSinceLastChange: 15000
                  },
                  totalScore: 270,
                  initialIP: '192.168.1.1',
                  lastIP: '8.8.8.8',
                  newIP: '1.1.1.1'
              },
              suspiciousChanges: 3,
              monitoringMode: true
          }

window.MKFAntiBotConfig = {
              // Настройки защиты форм
              formsProtection: {
                  enabled: true,             // Включение/отключение защиты форм
                  formIds: ['contactForm'],  // ID форм для защиты (пустой массив = все формы)
                  excludeFormIds: [],        // ID форм, которые не нужно защищать
                  selector: "form",          // CSS-селектор для поиска форм
                  protected: true,           // Включить защиту всех найденных форм
                  
                  // Основные настройки
                  scoreThreshold: 100,       // Порог подозрительности для блокировки
                  adaptiveMode: true,        // Адаптивный режим защиты
                  strictMode: false,         // Строгий режим проверки
                  
                  // Настройки анализа поведения
                  behavioralAnalysis: {
                      mouseSampling: 50,             // Интервал сэмплирования мыши (мс)
                      mouseSamplesRequired: 10,      // Минимальное количество сэмплов
                      maxLinearMovement: 0.8,        // Максимальная линейность движения 
                      minNaturalSpeedVariation: 0.3, // Мин. вариация скорости для естественности
                      minFocusTime: 100,             // Минимальное время фокуса на поле (мс)
                      maxFocusTime: 20000,           // Максимальное время фокуса на поле (мс)
                      minTypingInterval: 50,         // Минимальный интервал между нажатиями (мс)
                      maxTypingInterval: 1000,       // Максимальный интервал между нажатиями (мс)
                      minCorrectionsRatio: 0.1,      // Мин. соотношение исправлений к вводу
                      maxFieldSpeed: 300,            // Макс. скорость заполнения поля (символов/мин)
                      fieldSequenceChecks: true,     // Проверка последовательности заполнения
                      tabUsageAnalysis: true,        // Анализ использования клавиши Tab
                      mousePatternAnalysis: true     // Анализ паттернов движения мыши
                  },
                  
                  // Настройки ловушек
                  traps: {
                      count: {
                          min: 2,                    // Минимальное количество ловушек
                          max: 5                     // Максимальное количество ловушек
                      },
                      types: ["hidden", "visible", "disguised"], // Типы используемых ловушек
                      complexity: {
                          min: 1,                    // Минимальная сложность ловушек
                          max: 3                     // Максимальная сложность ловушек
                      },
                      autoRestore: true,             // Авто-восстановление удаленных ловушек
                      mutation: true                 // Динамическое изменение ловушек
                  }
                  
                  // Другие настройки опущены для краткости
              }
          }

// Пример данных, отправляемых в аналитику
          {
              event_category: 'Security',
              event_action: 'form_bot_detected_monitoring',
              event_label: 'form_10293874',
              value: 350, // Подозрительный счет
              formId: 'contactForm',
              fieldsWithoutFocus: 3,
              suspiciousFields: 2,
              totalFilledLength: 127,
              threshold: 100,
              factors: {
                  honeypotFilled: 500,
                  scriptInjection: 150,
                  noFocusInput: 100
              },
              monitoringMode: true
          }

window.MKFAntiBotConfig = {
              // Базовая конфигурация поведенческого анализа
              behaviorAnalysis: {
                  enabled: true,              // Включение/отключение модуля
                  checkInterval: 1000,        // Интервал проверки в мс
              },
              
              // Пороговые значения для определения ботов
              thresholds: {
                  timeWindow: 3000,           // Временное окно для анализа в мс
                  overallScore: 0.45,         // Общий порог подозрительности
                  linearityScore: 0.7,        // Порог линейности движений
                  entropyScore: 0.6,          // Порог энтропии движений
                  patternScore: 0.5,          // Порог повторяемости паттернов
                  suspiciousEventsThreshold: 2 // Количество подозрительных событий для реакции
              },
              
              // Режим мониторинга
              monitoringMode: {
                  enabled: false,             // Режим мониторинга без блокировки
                  trackToAnalytics: true      // Отправка событий в аналитику
              }
          }

// Пример данных, отправляемых в аналитику
          {
              event_category: 'Security',
              event_action: 'behavior_bot_detected',
              event_label: 'critical_behavior_monitoring',
              value: metrics.overall * 100,
              type: 'critical',
              overall: metrics.overall,
              mouseScore: metrics.mouse.overallScore,
              linearity: metrics.mouse.linearityScore,
              pattern: metrics.mouse.patternScore,
              entropy: metrics.mouse.entropyScore,
              threshold: threshold,
              monitoringMode: true
          }

window.MKFAntiBotConfig = {
              // Включение и основные настройки детектора поисковых ботов
              searchBotConfig: {
                  enabled: true,          // Включить/выключить модуль
                  cacheTTL: 3600,         // Время жизни кеша в секундах
                  debug: false,           // Режим отладки
                  
                  // Для тестирования (только в режиме разработки)
                  testMode: false,        // Режим тестирования 
                  testIP: null            // Тестовый IP-адрес
              }
          }

window.MKFAntiBotConfig = {
              searchBotConfig: {
                  enabled: true,
                  cacheTTL: 7200,          // Увеличенное время кеширования (2 часа)
                  debug: true,             // Подробное логирование
                  
                  // Настройка ограничений
                  maxRequestsPerMinute: 60 // Максимальное количество запросов в минуту
              },
              
              // Добавление пользовательских ботов
              customBots: {
                  myBot: {
                      patterns: ['MyCustomBot', 'MyCompanyCrawler'],
                      verify: {
                          domains: ['mycompany.com'],
                          ipRanges: ['192.168.1.0/24']
                      }
                  }
              }
          }

// Пример данных, отправляемых в аналитику
          {
              event_category: 'Security',
              event_label: 'searchbot_verified',
              provider: 'google',         // Поисковая система
              ip: '66.249.64.123',        // IP-адреса бота
              hostname: 'crawler.googlebot.com', // Обратная DNS запись
              timestamp: Date.now(),
              monitoringMode: true
          }

customBots: {
              // Бот для внутреннего мониторинга
              internalMonitor: {
                  patterns: ['CompanyMonitorBot/1.0', 'InternalCrawler'],
                  verify: {
                      domains: ['monitoring.company.com', 'crawler.company.com'],
                      ipRanges: ['10.0.0.0/8', '172.16.0.0/12']
                  }
              },
              
              // Бот для партнерской системы
              partnerBot: {
                  patterns: ['PartnerScraper/2.0'],
                  verify: {
                      domains: ['partner-domain.com'],
                      ipRanges: ['203.0.113.0/24']
                  }
              }
          }

// Настройка для тестирования Google Bot
          window.MKFAntiBotConfig = {
              searchBotConfig: {
                  enabled: true,
                  debug: true,
                  testMode: true,
                  testIP: '66.249.66.1',   // IP-адрес Googlebot (для тестирования)
                  testUserAgent: 'Mozilla/5.0 (compatible; Googlebot/2.1; +http://www.google.com/bot.html)'
              }
          }

window.MKFAntiBotConfig = {
              // Режим отладки
              debug: false,
              
              // Пороговые значения для оценки подозрительности
              thresholds: {
                  timeWindow: 3000, // Временное окно для анализа в мс
                  overallScore: 0.45 // Порог для определения бота (0-1)
              },
              
              // Настройка режима мониторинга
              monitoringMode: {
                  enabled: false, // Включение режима мониторинга
                  trackToAnalytics: true // Отправлять события в аналитику
              }
          }

window.MKFAntiBotConfig = {
              debug: true, // Включаем подробное логирование
              
              thresholds: {
                  timeWindow: 2000, // Уменьшенное окно для более быстрой реакции
                  overallScore: 0.35 // Более строгий порог (чем ниже, тем строже)
              },
              
              // Дополнительные настройки детекции
              detectionTracking: {
                  enabled: true, // Включить сохранение детектов
                  retryAttempts: 3, // Количество попыток отправки
                  retryDelay: 1000 // Задержка между попытками в мс
              }
          }

// Пример данных, отправляемых в аналитику
          {
              event_category: 'Security',
              event_label: botResult.botType || 'unknown',
              value: 100,
              botType: botResult.botType,
              details: botResult,
              timestamp: Date.now()
          }

window.MKFAntiBotConfig = {
              debug: false,
              logo: "/path/to/logo.png",
              captchaKey: "your-smartcaptcha-key",
              serverURL: "https://your-server/api/",
              
              // Режим защиты активен, когда monitoringMode отключен или отсутствует
              monitoringMode: {
                  enabled: false
              },
              
              // Настройки защиты контента
              contentProtection: {
                  mode: 'visual', // или 'full'
                  preserveScripts: true,
                  preserveContext: true,
                  safeInitialization: true,
                  initializationDelay: 100,
                  scriptTimeout: 5000,
                  skipPatterns: ["mkf-antibot.js", "google-analytics", "gtag", "metrika"]
              },
              
              // Защита форм
              formsProtection: {
                  enabled: true,
                  formIds: [], // пустой массив = защита всех форм
                  selector: "form",
                  scoreThreshold: 150,
                  adaptiveMode: true,
                  strictMode: false
              },
              
              // Обнаружение ботов
              botdUrl: "https://openfpcdn.io/botd/v1",
              thresholds: {
                  timeWindow: 3000,
                  overallScore: 0.45
              },
              
              // Обнаружение смены IP
              ipChangeDetection: {
                  enabled: true,
                  checkInterval: 5000,
                  maxChecks: 1000,
                  suspiciousChangesThreshold: 2
              },
              
              // Поведенческий анализ
              behaviorAnalysis: {
                  enabled: true
              }
          };

window.MKFAntiBotConfig = {
              debug: false,
              logo: "/path/to/logo.png",
              captchaKey: "your-smartcaptcha-key",
              serverURL: "https://your-server/api/",
              
              // Включение режима мониторинга
              monitoringMode: {
                  enabled: true,                // Включить режим мониторинга
                  trackToAnalytics: true,       // Отправлять события в аналитику
                  blockForms: false,            // Не блокировать формы
                  stealthMode: false,           // Не использовать скрытый режим
                  logDetections: true,          // Расширенное логирование обнаружений
                  detectionThreshold: 50,       // Порог для регистрации события
                  visualIndicator: true,        // Показывать индикатор режима
                  samplingRate: 100             // Процент ботов для отслеживания
              },
              
              // Настройки отслеживания в аналитике
              analyticsTracking: {
                  enabled: true,
                  yandexMetrikaId: '12345678',
                  trackForms: true,
                  trackBehavior: true
              },
              
              // Другие настройки аналогичны режиму защиты
              formsProtection: { enabled: true },
              behaviorAnalysis: { enabled: true },
              ipChangeDetection: { enabled: true }
          };

// Включение режима мониторинга
          if (window.MKFAntiBotInstance) {
              window.MKFAntiBotInstance.setMonitoringMode(true, {
                  visualIndicator: true,
                  stealthMode: false
              });
          }
          
          // Возврат к режиму защиты
          if (window.MKFAntiBotInstance) {
              window.MKFAntiBotInstance.setMonitoringMode(false);
          }

/
          ├── config.php - Основной файл конфигурации
          ├── public/
          │   └── index.php - Точка входа API
          ├── core/
          │   ├── BaseChecker.php - Базовый класс для проверок
          │   ├── Database.php - Взаимодействие с данными
          │   ├── IPAPIProvider.php - Провайдер IP-API
          │   ├── IPDataProviderInterface.php - Интерфейс провайдеров данных IP
          │   ├── IPInfoChecker.php - Проверка информации IP
          │   ├── IPListChecker.php - Проверка IP по спискам
          │   ├── IPWhoisProvider.php - Провайдер IPWhois
          │   ├── RequestHandler.php - Обработчик HTTP запросов
          │   └── SmartCaptchaVerifier.php - Верификация Яндекс SmartCaptcha
          ├── data/
          │   ├── detections/ - Сохраненные детекты
          │   └── ip_lists/ - Списки IP для проверки
          └── logs/
              └── access.log - Логи доступа

return [
              'debug' => true, // Режим отладки (true/false)
              'version' => '1.0.0', // Версия API
              'allowedDomains' => ['domain.com', 'sub.domain.com'], // Разрешенные домены для CORS
              'allowedIPs' => ['127.0.0.1', '192.168.1.0/24'], // Разрешенные IP-адреса
              'captchaKey' => 'your_smartcaptcha_key', // Секретный ключ Яндекс SmartCaptcha
              'dbPath' => __DIR__ . '/data/detections', // Путь к директории с данными
              
              // Настройки проверки IP
              'ipInfo' => [
                  'ipapiKey' => null, // API ключ для IP-API (необязательно)
                  'providers' => ['ipapi', 'ipwhois'], // Используемые провайдеры (порядок важен)
                  'cacheTTL' => 3600, // Время кеширования в секундах
                  'verifySSL' => true, // Проверка SSL сертификатов
                  'timeout' => 5, // Таймаут запросов в секундах
                  'extendedFields' => true // Использовать расширенные поля
              ]
          ];

{
              "success": true,
              "ip": "8.8.8.8",
              "check_result": {
                  "status": "clean"
              }
          }

{
              "token": "токен_от_смарткапчи",
              "ip": "ip_клиента" // опционально
          }

{
              "success": true,
              "code": 200,
              "executionTime": 0.423
          }

{
              "type": "behavior|form|ip_change",
              "data": {
                  // любые данные о подозрительной активности
              },
              "fingerprint": {
                  // данные браузерного отпечатка
              }
          }

{
              "success": true,
              "ip": "8.8.8.8",
              "data": {
                  "country": {
                      "code": "US",
                      "name": "United States"
                  },
                  "city": "Mountain View",
                  "isp": "Google LLC",
                  "type": "datacenter",
                  "flags": {
                      "isDatacenter": true,
                      "isHosting": true
                  }
              },
              "meta": {
                  "cached": true,
                  "source": ["ipapi", "ipwhois"],
                  "timestamp": "2024-02-15T12:00:00+00:00"
              }
          }

{
              "success": true,
              "period": "24h",
              "stats": [
                  {
                      "type": "behavior",
                      "count": 153,
                      "unique_ips": 87
                  },
                  {
                      "type": "form",
                      "count": 42,
                      "unique_ips": 15
                  }
              ]
          }

8.8.8.8 # Комментарий о причине блокировки
          192.168.1.0/24 # Блокировка подсети
          2001:0db8:85a3:0000:0000:8a2e:0370:7334 # Блокировка IPv6

$checker = new IPListChecker($config);
          $checker->addIP('192.168.1.1', 'Подозрительная активность');

addIP(trim($ip), trim($comment));
          }
          
          echo "Список обновлен: " . count($ips) . " IP адресов\n";

config = $config;
                  $this->apiKey = $config['customApiKey'] ?? null;
              }
              
              public function getData(string $ip, bool $extended = false): array
              {
                  // Запрос к внешнему API или внутренней базе данных
                  // ...
                  
                  // Форматирование ответа в соответствии с требованиями системы
                  return [
                      'country' => [
                          'code' => 'US',
                          'name' => 'United States'
                      ],
                      'region' => 'California',
                      'city' => 'San Francisco',
                      'location' => [
                          'lat' => 37.773972,
                          'lon' => -122.431297
                      ],
                      'timezone' => 'America/Los_Angeles',
                      'isp' => 'Example ISP',
                      'type' => 'residential',
                      'asn' => [
                          'number' => 'AS123456',
                          'name' => 'Example Network',
                          'route' => '192.168.0.0/16'
                      ]
                  ];
              }
              
              public function isAvailable(): bool
              {
                  // Проверка доступности провайдера
                  return true;
              }
              
              public function getName(): string
              {
                  return 'custom';
              }
          }

'ipInfo' => [
              'providers' => ['custom', 'ipapi', 'ipwhois'], // Добавляем свой провайдер в начало списка
              'customApiKey' => 'ваш_ключ_api', // Дополнительные параметры для кастомного провайдера
              // ...остальные настройки
          ]