PHPackages topvisor/uncaptcha - PHPackages - PHPackages [Skip to content](#main-content)[PHPackages](/)[Directory](/)[Categories](/categories)[Trending](/trending)[Leaderboard](/leaderboard)[Changelog](/changelog)[Analyze](/analyze)[Collections](/collections)[Log in](/login)[Sign up](/register) 1. [Directory](/) 2. / 3. [Utility & Helpers](/categories/utility) 4. / 5. topvisor/uncaptcha ActiveLibrary[Utility & Helpers](/categories/utility) topvisor/uncaptcha ================== Library for solve captcha by services 1.4.4(1y ago)0642MITPHPPHP >=7.3 Since Jun 10Pushed 1y ago3 watchersCompare [ Source](https://github.com/topvisor/uncaptcha)[ Packagist](https://packagist.org/packages/topvisor/uncaptcha)[ RSS](/packages/topvisor-uncaptcha/feed)WikiDiscussions master Synced 1mo ago READMEChangelog (10)DependenciesVersions (17)Used By (0) Uncaptcha ========= [](#uncaptcha) PHP библиотека для разгадывания капч на сайтах. Работает в паре с одним из выбранных вами сервисов для разгадывания капч. В примерах используется популярный сервис Рукапча, отличительной особенностью которого является качественная работа с кириллическими капчами: . Поддерживает работу с сервисами следующих вид капч: - ImageToText - ReCaptcha V2 - ReCaptcha V2 Invisible - ReCaptcha V3 - FunCaptcha - GeeTest - hCaptcha - Custom - гибкая настройка других видов капч Установка ========= [](#установка) Используйте [composer](https://getcomposer.org/) для установки. composer.json: ``` { "repositories":[ { "url":"https://github.com/topvisor/uncaptcha.git", "type":"git" } ], "require": { "topvisor/uncaptcha": "~1.3" } } ``` Пример использования библиотеки для распознавания текста на картинке ==================================================================== [](#пример-использования-библиотеки-для-распознавания-текста-на-картинке) ``` // ImageToText и другие модули распознавания см. в директории /src/ include_once('%PATH_TO_COMPOSER%/vendor/autoload.php'); // создаем объект на основе модуля ImageToText - распознавание текстовой капчи $uncaptcha = new \Topvisor\Uncaptcha\ImageToText(); $uncaptcha->setTimeout(20); // таймаут соедиения $uncaptcha->setTaskTimeout(240); // таймаут разгадывания $uncaptcha->setDebugLevel(1); // 0 - без лога, 1 - короткий лог, 2 - полный лог $uncaptcha->setDebugLabel('rc'); $uncaptcha->setUseHTTPS(true); $uncaptcha->setHost('rucaptcha.com'); $uncaptcha->setV(1); // in.php / res.php style $uncaptcha->setKey('%API_KEY%'); $uncaptcha->setBodyFromFile('%URL_IMAGE%'); $result = $uncaptcha->resolve(); if(!$result){ echo 'Ошибка разгадывания капчи: '.$uncaptcha->getErrorMessage(); return; } echo 'Капча разгадана: "'.$result.'" за '.$uncaptcha->getTaskElapsed().' сек.'; ``` Логи, полученные в результате разгадывания, будут выведены на экран. Дополнительно к ним можно получить доступ через getDebugLog(), например для записи в БД: ``` $logs = $uncaptcha->getDebugLog(); ``` В зависимости от того, принята ли капча сервером, можно отправить уведомление сервису: ``` // $uncaptcha->reportGood(); // капча разгадана верно // $uncaptcha->reportGood(); // капча разгадана неверно ``` Модули библиотеки ================= [](#модули-библиотеки) - FunCaptcha - FunCaptchaProxyless - GeeTest - GeeTestProxyless - HCaptcha - HCaptchaProxyless - ImageToText - ReCaptchaV2 - ReCaptchaV2Proxyless - RecaptchaV3 - RecaptchaV3Proxyless - Custom - модуль, для проивзольной настройки параметров капчи через $uncaptcha->setPost() Каждый модуль может содержать различный набор методов для необходимой настройки Для начала работы с одной из них необходимо создать объекта: ``` $uncaptcha = new \Topvisor\Uncaptcha\ImageToText(); // далее необходимо указать доступ к сервису и опции для разгадывания капчи и запустить разгадывание (см. пример выше) ``` Базовые методы ============== [](#базовые-методы) Базовые методы доступны для всех модулей Настройки сервиса - setReferalId(string $referalId) - код referalId может испоьзвоаться в некоторых сервисах - setUseHTTPS(bool $useHTTPS) - использовать https - **setHost(string $host)** - хост сервиса для распознавания - **setV(int $v)** - версия API сервиса, поддерживаеся два значения: - 1: API style: $host/in.php / simplesite.com/res.php?action=%methodName% - 2: API style: $host/%methodName% - **setKey(string $clientKey)** - ваш API ключ к сервису - setTimeout() - таймаут соединения, по умолчанию 20 секунд Настройки капчи - setCreateTaskPost(array $createTaskPost) - проивзольный набор параметров запроса, в основном используется для настройки модуля Custom - setTaskTimeout(int $timeout) - таймаут на разгадывание капчи, по умолчанию 240 секунд Процесс рагазывания - **resolve()** - запустить разгадывание, в случае успеза вернет результат - getTaskid() - получить id задачи, id создается при начале разгадывания, см. resolve() - getTaskElapsed() - получить время, затраченное на разгадывание капчи - getErrorMessage() - получить текст последней ошибки - getResult() - иногда требуется получить больше информации, чем просто текст с картинки. Этот метод вернет объект с результатом Отладка / логирование - setDebugLevel() - 0: без лога, 1: короткий лог, 2: подробный лог - setDebugFormat() - 0: text, 1: html - setDebugLabel() - установить название для лога - clearDebugLog() - очистить лог - getDebugLog() - получить массив строк лога ### Health Score 33 — LowBetter than 75% of packages Maintenance39 Infrequent updates — may be unmaintained Popularity15 Limited adoption so far Community11 Small or concentrated contributor base Maturity58 Maturing project, gaining track record Bus Factor1 Top contributor holds 54.2% of commits — single point of failure How is this calculated?**Maintenance (25%)** — Last commit recency, latest release date, and issue-to-star ratio. Uses a 2-year decay window. **Popularity (30%)** — Total and monthly downloads, GitHub stars, and forks. Logarithmic scaling prevents top-heavy scores. **Community (15%)** — Contributors, dependents, forks, watchers, and maintainers. Measures real ecosystem engagement. **Maturity (30%)** — Project age, version count, PHP version support, and release stability. ### Release Activity Cadence Every ~109 days Recently: every ~305 days Total 16 Last Release 524d ago PHP version history (2 changes)v1.2PHP ^7.3 v1.3.5PHP >=7.3 ### Community Maintainers ![](https://avatars.githubusercontent.com/u/59361374?v=4)[Topvisor LLC](/maintainers/topvisor)[@topvisor](https://github.com/topvisor) --- Top Contributors [![Artemeey](https://avatars.githubusercontent.com/u/4234863?v=4)](https://github.com/Artemeey "Artemeey (13 commits)")[![decaseal](https://avatars.githubusercontent.com/u/13977868?v=4)](https://github.com/decaseal "decaseal (7 commits)")[![M0r64n](https://avatars.githubusercontent.com/u/16107872?v=4)](https://github.com/M0r64n "M0r64n (4 commits)") --- Tags phpcaptchaimage captchafuncaptchageetesthcaptcharucaptcharecaptcha 3UncaptchareCaptcha 2Anti сaptchaРукапчаРекапчаРекапча 2Рекапча 3Текстовые капчи ### Embed Badge ![Health badge](/badges/topvisor-uncaptcha/health.svg) ``` [![Health](https://phpackages.com/badges/topvisor-uncaptcha/health.svg)](https://phpackages.com/packages/topvisor-uncaptcha) ``` ### Alternatives [2captcha/2captcha PHP package for easy integration with 2captcha API 86430.0k3](/packages/2captcha-2captcha)[jumper423/yii2-captcha Распознавание капч для всех популярных сервисов rucaptcha.com, 2captcha.com, pixodrom.com, captcha24.com, socialink.ru, anti-captcha.com 172.6k2](/packages/jumper423-yii2-captcha) PHPackages © 2026 [Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)