class Response in reCAPTCHA 8.2

The response returned from the service.

Hierarchy

• class \ReCaptcha\Response

File

recaptcha-php/src/ReCaptcha/Response.php, line 32

Namespace

ReCaptcha

class Response {

  /**
   * Success or failure.
   * @var boolean
   */
  private $success = false;

  /**
   * Error code strings.
   * @var array
   */
  private $errorCodes = array();

  /**
   * The hostname of the site where the reCAPTCHA was solved.
   * @var string
   */
  private $hostname;

  /**
   * Timestamp of the challenge load (ISO format yyyy-MM-dd'T'HH:mm:ssZZ)
   * @var string
   */
  private $challengeTs;

  /**
   * APK package name
   * @var string
   */
  private $apkPackageName;

  /**
   * Score assigned to the request
   * @var float
   */
  private $score;

  /**
   * Action as specified by the page
   * @var string
   */
  private $action;

  /**
   * Build the response from the expected JSON returned by the service.
   *
   * @param string $json
   * @return \ReCaptcha\Response
   */
  public static function fromJson($json) {
    $responseData = json_decode($json, true);
    if (!$responseData) {
      return new Response(false, array(
        ReCaptcha::E_INVALID_JSON,
      ));
    }
    $hostname = isset($responseData['hostname']) ? $responseData['hostname'] : null;
    $challengeTs = isset($responseData['challenge_ts']) ? $responseData['challenge_ts'] : null;
    $apkPackageName = isset($responseData['apk_package_name']) ? $responseData['apk_package_name'] : null;
    $score = isset($responseData['score']) ? floatval($responseData['score']) : null;
    $action = isset($responseData['action']) ? $responseData['action'] : null;
    if (isset($responseData['success']) && $responseData['success'] == true) {
      return new Response(true, array(), $hostname, $challengeTs, $apkPackageName, $score, $action);
    }
    if (isset($responseData['error-codes']) && is_array($responseData['error-codes'])) {
      return new Response(false, $responseData['error-codes'], $hostname, $challengeTs, $apkPackageName, $score, $action);
    }
    return new Response(false, array(
      ReCaptcha::E_UNKNOWN_ERROR,
    ), $hostname, $challengeTs, $apkPackageName, $score, $action);
  }

  /**
   * Constructor.
   *
   * @param boolean $success
   * @param string $hostname
   * @param string $challengeTs
   * @param string $apkPackageName
   * @param float $score
   * @param strong $action
   * @param array $errorCodes
   */
  public function __construct($success, array $errorCodes = array(), $hostname = null, $challengeTs = null, $apkPackageName = null, $score = null, $action = null) {
    $this->success = $success;
    $this->hostname = $hostname;
    $this->challengeTs = $challengeTs;
    $this->apkPackageName = $apkPackageName;
    $this->score = $score;
    $this->action = $action;
    $this->errorCodes = $errorCodes;
  }

  /**
   * Is success?
   *
   * @return boolean
   */
  public function isSuccess() {
    return $this->success;
  }

  /**
   * Get error codes.
   *
   * @return array
   */
  public function getErrorCodes() {
    return $this->errorCodes;
  }

  /**
   * Get hostname.
   *
   * @return string
   */
  public function getHostname() {
    return $this->hostname;
  }

  /**
   * Get challenge timestamp
   *
   * @return string
   */
  public function getChallengeTs() {
    return $this->challengeTs;
  }

  /**
   * Get APK package name
   *
   * @return string
   */
  public function getApkPackageName() {
    return $this->apkPackageName;
  }

  /**
   * Get score
   *
   * @return float
   */
  public function getScore() {
    return $this->score;
  }

  /**
   * Get action
   *
   * @return string
   */
  public function getAction() {
    return $this->action;
  }
  public function toArray() {
    return array(
      'success' => $this
        ->isSuccess(),
      'hostname' => $this
        ->getHostname(),
      'challenge_ts' => $this
        ->getChallengeTs(),
      'apk_package_name' => $this
        ->getApkPackageName(),
      'score' => $this
        ->getScore(),
      'action' => $this
        ->getAction(),
      'error-codes' => $this
        ->getErrorCodes(),
    );
  }

}

Members

Name	Modifiers	Type	Description	Overrides
Response::$action	private	property	Action as specified by the page
Response::$apkPackageName	private	property	APK package name
Response::$challengeTs	private	property	Timestamp of the challenge load (ISO format yyyy-MM-dd'T'HH:mm:ssZZ)
Response::$errorCodes	private	property	Error code strings.
Response::$hostname	private	property	The hostname of the site where the reCAPTCHA was solved.
Response::$score	private	property	Score assigned to the request
Response::$success	private	property	Success or failure.
Response::fromJson	public static	function	Build the response from the expected JSON returned by the service.
Response::getAction	public	function	Get action
Response::getApkPackageName	public	function	Get APK package name
Response::getChallengeTs	public	function	Get challenge timestamp
Response::getErrorCodes	public	function	Get error codes.
Response::getHostname	public	function	Get hostname.
Response::getScore	public	function	Get score
Response::isSuccess	public	function	Is success?
Response::toArray	public	function
Response::__construct	public	function	Constructor.