====== recognize ======

**Каноническая страница:** [[https://humanemulator.net/objects/WEB/rucaptcha/functional/recognize.php|https://humanemulator.net/objects/WEB/rucaptcha/functional/recognize.php]]

[[objects:start|← Objects]]

----

Справка Human Emulator rucaptcha: recognize

RuCaptcha"; ?>

recognize

recognize($filename, $apikey, $path ='http://www.rucaptcha.com',  $is_verbose = true, $rtimeout = 5, $mtimeout = 120, $is_phrase = 0, $is_regsense = 0, $is_numeric = 0, $min_len = 0, $max_len = 0,$is_russian = 0);
- распознать капчу из заданного файла
* $filename – путь к файлу с капчей
* $apikey – ключ для идентификации на сервисе
* $path – путь к сервису
* $is_verbose - включить/выключить verbose mode (комментирование происходящего): false(выключить),  true(включить)
* $rtimeout - задержка между опросами статуса капчи
* $mtimeout - время ожидания ввода капчи
* $is_phrase - 0 либо 1 - флаг "в капче 2 и более слов"
* $is_regsense - 0 либо 1 - флаг "регистр букв в капче имеет значение"
* $is_numeric - 0 либо 1 - флаг "капча состоит только из цифр"
* $min_len - 0 (без ограничений), любая другая цифра указывает минимальную длину текста капчи
* $max_len - 0 (без ограничений), любая другая цифра указывает максимальную длину текста капчи
* $is_russian - 0 либо 1 - флаг "капча должна демонстрироваться только русскоязычным работникам"

Пример:

$text=recognize("/path/to/file/captcha.jpg","ваш_ключ_из_админки",true);

$text=recognize("/path/to/file/captcha.jpg","ваш_ключ_из_админки",false);  //отключено комментирование

$text=recognize("/path/to/file/captcha.jpg","ваш_ключ_из_админки",false,1,0,0,5);  //отключено комментирование, капча состоит из двух слов, общая минимальная длина равна 5 символам

После отработки функция возвращает результат своей работы в скрипт :

* Результат распознования – капчу или код-строку с ответом об ошибке:

* ERROR_KEY_DOES_NOT_EXIST - вы использовали неверный captcha ключ в запросе

* ERROR_WRONG_ID_FORMAT - некорректный идентификатор капчи, принимаются только цифры

* ERROR_CAPTCHA_UNSOLVABLE - капчу не смогли разгадать 5 разных работников