- Использование reCAPTCHA с PHP,Использование reCAPTCHA с PHP
- Быстрый старт
- Клиентская сторона (как сделать так, чтобы изображение CAPTCHA отображалось)
- Сторона сервера (как проверить, ввел ли пользователь правильный ответ)
- Дальнейшее чтение
- Справочное руководство по PHP-плагинам
- Функция recaptcha_get_html
- Функция recaptcha_check_answer
- Почтовый ящик
- Быстрый старт
- Клиентская сторона (как сделать так, чтобы изображение CAPTCHA отображалось)
- Сторона сервера (как проверить, ввел ли пользователь правильный ответ)
- Дальнейшее чтение
- Справочное руководство по PHP-плагинам
- Функция recaptcha_get_html
- Функция recaptcha_check_answer
- Почтовый ящик
Использование reCAPTCHA с PHP,Использование reCAPTCHA с PHP
Оптимизируйте свои подборки Сохраняйте и классифицируйте контент в соответствии со своими настройками.
Важно : API reCAPTCHA версии 1.0 больше не поддерживается, обновите его до версии 2.0. Узнать больше
PHP-библиотека reCAPTCHA предоставляет простой способ размещения CAPTCHA на вашем PHP-сайте, помогая вам предотвратить злоупотребление ботами. Библиотека является оберткой для reCAPTCHA API .
Чтобы использовать reCAPTCHA с PHP, вы можете скачать библиотеку reCAPTCHA PHP . Вам понадобится только один файл оттуда (recaptchalib.php). Остальные файлы — это примеры, ридми и юридические документы — они не влияют на функциональность.
Быстрый старт
После того, как вы подписались на ключи API, ниже приведены основные инструкции по установке reCAPTCHA на вашем сайте. Полное справочное руководство по плагину PHP можно найти ниже.
Клиентская сторона (как сделать так, чтобы изображение CAPTCHA отображалось)
Если вы хотите использовать библиотеку PHP для отображения виджета reCAPTCHA, вам необходимо вставить этот фрагмент кода внутрь элемента , где будет размещен виджет reCAPTCHA:
require_once('recaptchalib.php'); $publickey = "your_public_key"; // you got this from the signup page echo recaptcha_get_html($publickey); С кодом ваша форма может выглядеть примерно так:
Не забудьте установить $publickey, заменив your_public_key своим открытым ключом API.
Обратите внимание, что значением атрибута «action» является «verify.php». Теперь verify.php — это файл назначения, в который отправляются значения этой формы. Поэтому вам понадобится файл verify.php в том же месте, что и клиентский html.
Функция require_once в приведенном выше примере предполагает, что файл recaptchalib.php находится в том же каталоге, что и ваш файл формы. Если он находится в другом каталоге, вы должны связать его соответствующим образом. Например, если ваш recaptchalib.php находится в каталоге с именем «captcha», который находится на том же уровне, что и ваш файл формы, функция будет выглядеть так: require_once(‘captcha/recaptchalib.php’) .
Сторона сервера (как проверить, ввел ли пользователь правильный ответ)
Следующий код должен быть размещен в верхней части файла verify.php:
Обратите внимание, что этот код запрашивает закрытый ключ, который не следует путать с открытым ключом. Вы получаете это на той же странице, что и открытый ключ.
Также убедитесь, что ваша форма настроена на получение переменных формы с использованием $_POST вместо $_REQUEST, и что сама форма использует метод POST.
Вот и все! Теперь reCAPTCHA должна работать на вашем сайте.
Дальнейшее чтение
Справочное руководство по PHP-плагинам
Ниже приведен полный список всех методов PHP-плагина reCAPTCHA.
Функция recaptcha_get_html
Функция recaptcha_get_html отображает HTML-код, представляющий пользователю reCAPTCHA.
| recaptcha_get_html | |
| Параметр | |
| $pubkey — строка. необходимый. | Ваш открытый ключ reCAPTCHA со страницы регистрации API |
| $ошибка — строка. необязательный (по умолчанию null) | Если эта строка установлена, в области reCAPTCHA будет отображаться указанный код ошибки. Этот код ошибки исходит из ReCaptchaResponse->$error |
| $use_ssl — логическое значение. необязательный (false по умолчанию) | Следует ли использовать API на основе SSL? Если вы показываете страницу пользователю через SSL, обязательно установите для этого параметра значение true, чтобы в браузере пользователя не появлялось диалоговое окно с ошибкой. |
| Возвращаемое значение | Строка, содержащая HTML для размещения на веб-странице. |
Функция recaptcha_check_answer
После того, как пользователь заполнил HTML-форму, включая свой ответ на CAPTCHA, мы хотим проверить его ответ при отправке формы с помощью функции recaptcha_check_answer . Ответ пользователя будет в двух полях формы: recaptcha_challenge_field и recaptcha_response_field . Библиотека reCAPTCHA отправит HTTP-запрос на сервер reCAPTCHA и проверит ответ пользователя.
| recaptcha_check_answer | |
| Параметр | |
| $privkey — строка. необходимый. | Ваш закрытый ключ reCAPTCHA со страницы регистрации API . |
| $remoteip — строка. необходимый. | IP-адрес пользователя в формате 192.168.0.1. |
| $вызов — строка. необходимый. | Значение поля формы recaptcha_challenge_field |
| $ответ — строка. необходимый | Значение поля формы recaptcha_response_field |
| Возвращаемое значение | Экземпляр класса ReCaptchaResponse |
| ReCaptchaResponse | |
| Поле | |
| $is_valid — логическое значение | Считал ли reCAPTCHA ответ правильным? |
| $ошибка — строка | Если ответ был неверным, в чем была проблема? Этот код ошибки можно использовать в recaptcha_get_html. |
| Возвращаемое значение | HTML или необработанный URL-адрес для декодирования адреса электронной почты, в зависимости от того, какую функцию вы вызвали. |
Почтовый ящик
PHP-библиотека reCAPTCHA включает привязки для Mailhide API. Этот API позволяет обернуть электронное письмо в reCAPTCHA, чтобы спамеры не увидели его: exam . @example.com.
Mailhide API состоит из двух функций recaptcha_mailhide_html и recaptcha_mailhide_url . Функции имеют одинаковые параметры. Версия _html возвращает HTML, который можно напрямую разместить на вашей веб-странице. Часть передаваемого сообщения электронной почты с именем пользователя усекается и заменяется ссылкой, вызывающей Mailhide. Версия _url дает вам URL-адрес для декодирования электронной почты и оставляет за вами возможность поместить электронную почту в HTML.
| recaptcha_mailhide_url / recaptcha_mailhide_html | |
| Параметр | |
| $pubkey — строка | Открытый ключ Mailhide со страницы регистрации |
| $privkey — строка | Закрытый ключ Mailhide со страницы регистрации |
| $ электронная почта — строка | Адрес электронной почты, который вы хотите скрыть. |
В следующем примере показано, как использовать Mailhide:
http://www.google.com/recaptcha/mailhide/apikey $mailhide_pubkey = ''; $mailhide_privkey = ''; ?> The Mailhide encoding of example@example.com is .
The url for the email is:
Важно : API reCAPTCHA версии 1.0 больше не поддерживается, обновите его до версии 2.0. Узнать больше
PHP-библиотека reCAPTCHA предоставляет простой способ размещения CAPTCHA на вашем PHP-сайте, помогая вам предотвратить злоупотребление ботами. Библиотека является оберткой для reCAPTCHA API .
Чтобы использовать reCAPTCHA с PHP, вы можете скачать библиотеку reCAPTCHA PHP . Вам понадобится только один файл оттуда (recaptchalib.php). Остальные файлы — это примеры, ридми и юридические документы — они не влияют на функциональность.
Быстрый старт
После того, как вы подписались на ключи API, ниже приведены основные инструкции по установке reCAPTCHA на вашем сайте. Полное справочное руководство по плагину PHP можно найти ниже.
Клиентская сторона (как сделать так, чтобы изображение CAPTCHA отображалось)
Если вы хотите использовать библиотеку PHP для отображения виджета reCAPTCHA, вам необходимо вставить этот фрагмент кода внутрь элемента , где будет размещен виджет reCAPTCHA:
require_once('recaptchalib.php'); $publickey = "your_public_key"; // you got this from the signup page echo recaptcha_get_html($publickey); С кодом ваша форма может выглядеть примерно так:
Не забудьте установить $publickey, заменив your_public_key своим открытым ключом API.
Обратите внимание, что значением атрибута «action» является «verify.php». Теперь verify.php — это файл назначения, в который отправляются значения этой формы. Поэтому вам понадобится файл verify.php в том же месте, что и клиентский html.
Функция require_once в приведенном выше примере предполагает, что файл recaptchalib.php находится в том же каталоге, что и ваш файл формы. Если он находится в другом каталоге, вы должны связать его соответствующим образом. Например, если ваш recaptchalib.php находится в каталоге с именем «captcha», который находится на том же уровне, что и ваш файл формы, функция будет выглядеть так: require_once(‘captcha/recaptchalib.php’) .
Сторона сервера (как проверить, ввел ли пользователь правильный ответ)
Следующий код должен быть размещен в верхней части файла verify.php:
Обратите внимание, что этот код запрашивает закрытый ключ, который не следует путать с открытым ключом. Вы получаете это на той же странице, что и открытый ключ.
Также убедитесь, что ваша форма настроена на получение переменных формы с использованием $_POST вместо $_REQUEST, и что сама форма использует метод POST.
Вот и все! Теперь reCAPTCHA должна работать на вашем сайте.
Дальнейшее чтение
Справочное руководство по PHP-плагинам
Ниже приведен полный список всех методов PHP-плагина reCAPTCHA.
Функция recaptcha_get_html
Функция recaptcha_get_html отображает HTML-код, представляющий пользователю reCAPTCHA.
| recaptcha_get_html | |
| Параметр | |
| $pubkey — строка. необходимый. | Ваш открытый ключ reCAPTCHA со страницы регистрации API |
| $ошибка — строка. необязательный (по умолчанию null) | Если эта строка установлена, в области reCAPTCHA будет отображаться указанный код ошибки. Этот код ошибки исходит из ReCaptchaResponse->$error |
| $use_ssl — логическое значение. необязательный (false по умолчанию) | Следует ли использовать API на основе SSL? Если вы показываете страницу пользователю через SSL, обязательно установите для этого параметра значение true, чтобы в браузере пользователя не появлялось диалоговое окно с ошибкой. |
| Возвращаемое значение | Строка, содержащая HTML для размещения на веб-странице. |
Функция recaptcha_check_answer
После того, как пользователь заполнил HTML-форму, включая свой ответ на CAPTCHA, мы хотим проверить его ответ при отправке формы с помощью функции recaptcha_check_answer . Ответ пользователя будет в двух полях формы: recaptcha_challenge_field и recaptcha_response_field . Библиотека reCAPTCHA отправит HTTP-запрос на сервер reCAPTCHA и проверит ответ пользователя.
| recaptcha_check_answer | |
| Параметр | |
| $privkey — строка. необходимый. | Ваш закрытый ключ reCAPTCHA со страницы регистрации API . |
| $remoteip — строка. необходимый. | IP-адрес пользователя в формате 192.168.0.1. |
| $вызов — строка. необходимый. | Значение поля формы recaptcha_challenge_field |
| $ответ — строка. необходимый | Значение поля формы recaptcha_response_field |
| Возвращаемое значение | Экземпляр класса ReCaptchaResponse |
| ReCaptchaResponse | |
| Поле | |
| $is_valid — логическое значение | Считал ли reCAPTCHA ответ правильным? |
| $ошибка — строка | Если ответ был неверным, в чем была проблема? Этот код ошибки можно использовать в recaptcha_get_html. |
| Возвращаемое значение | HTML или необработанный URL-адрес для декодирования адреса электронной почты, в зависимости от того, какую функцию вы вызвали. |
Почтовый ящик
PHP-библиотека reCAPTCHA включает привязки для Mailhide API. Этот API позволяет обернуть электронное письмо в reCAPTCHA, чтобы спамеры не увидели его: exam . @example.com.
Mailhide API состоит из двух функций recaptcha_mailhide_html и recaptcha_mailhide_url . Функции имеют одинаковые параметры. Версия _html возвращает HTML, который можно напрямую разместить на вашей веб-странице. Часть передаваемого сообщения электронной почты с именем пользователя усекается и заменяется ссылкой, вызывающей Mailhide. Версия _url дает вам URL-адрес для декодирования электронной почты и оставляет за вами возможность поместить электронную почту в HTML.
| recaptcha_mailhide_url / recaptcha_mailhide_html | |
| Параметр | |
| $pubkey — строка | Открытый ключ Mailhide со страницы регистрации |
| $privkey — строка | Закрытый ключ Mailhide со страницы регистрации |
| $ электронная почта — строка | Адрес электронной почты, который вы хотите скрыть. |
В следующем примере показано, как использовать Mailhide:
http://www.google.com/recaptcha/mailhide/apikey $mailhide_pubkey = ''; $mailhide_privkey = ''; ?> The Mailhide encoding of example@example.com is .
The url for the email is:
Если не указано иное, контент на этой странице предоставляется по лицензии Creative Commons «С указанием авторства 4.0», а примеры кода – по лицензии Apache 2.0. Подробнее об этом написано в правилах сайта. Java – это зарегистрированный товарный знак корпорации Oracle и ее аффилированных лиц.
Последнее обновление: 2023-02-14 UTC.