├── LICENSE
├── alipay_donate.jpg
├── .gitignore
├── src
    ├── TekinTCaptcha
    │   ├── RequestMethod.php
    │   ├── RequestMethod
    │   │   ├── Curl.php
    │   │   ├── Post.php
    │   │   ├── Get.php
    │   │   ├── Socket.php
    │   │   ├── CurlPost.php
    │   │   ├── CurlGet.php
    │   │   └── SocketPost.php
    │   ├── TekinTCaptcha.php
    │   ├── RequestParameters.php
    │   └── Response.php
    └── autoload.php
├── .travis.yml
├── phpunit.xml
├── composer.json
├── tests
    └── TekinTCaptcha
    │   ├── RequestMethod
    │       ├── CurlPostTest.php
    │       ├── SocketPostTest.php
    │       └── PostTest.php
    │   ├── RequestParametersTest.php
    │   ├── TekinTCaptchaTest.php
    │   └── ResponseTest.php
├── examples
    ├── index.html
    └── login.php
└── README.md


/LICENSE:
--------------------------------------------------------------------------------
https://raw.githubusercontent.com/tekintian/TekinTCaptcha/HEAD/LICENSE


--------------------------------------------------------------------------------
/alipay_donate.jpg:
--------------------------------------------------------------------------------
https://raw.githubusercontent.com/tekintian/TekinTCaptcha/HEAD/alipay_donate.jpg


--------------------------------------------------------------------------------
/.gitignore:
--------------------------------------------------------------------------------
1 | /composer.lock
2 | /vendor/
3 | /reports/
4 | *.sublime-project
5 | *.sublime-workspace
6 | 


--------------------------------------------------------------------------------
/src/TekinTCaptcha/RequestMethod.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | namespace TekinTCaptcha;
 4 | 
 5 | /**
 6 |  * Method used to send the request to the service.
 7 |  */
 8 | interface RequestMethod
 9 | {
10 | 
11 |     /**
12 |      * Submit the request with the specified parameters.
13 |      *
14 |      * @param RequestParameters $params Request parameters
15 |      * @return string Body of the TekinTCaptcha response
16 |      */
17 |     public function submit(RequestParameters $params);
18 | }
19 | 


--------------------------------------------------------------------------------
/.travis.yml:
--------------------------------------------------------------------------------
 1 | language: php
 2 | 
 3 | sudo: false
 4 | 
 5 | php:
 6 |   - '5.5'
 7 |   - '5.6'
 8 |   - '7.0'
 9 |   - '7.1'
10 |   - '7.2'
11 |   - hhvm
12 |   - nightly
13 | 
14 | before_script:
15 |   - composer install
16 |   - phpenv version-name | grep ^5.[34] && echo "extension=apc.so" >> ~/.phpenv/versions/$(phpenv version-name)/etc/php.ini ; true
17 |   - phpenv version-name | grep ^5.[34] && echo "apc.enable_cli=1" >> ~/.phpenv/versions/$(phpenv version-name)/etc/php.ini ; true
18 | 
19 | script:
20 |   - vendor/bin/phpunit
21 | 


--------------------------------------------------------------------------------
/phpunit.xml:
--------------------------------------------------------------------------------
 1 | <?xml version="1.0" encoding="UTF-8"?>
 2 | <phpunit bootstrap="src/autoload.php" verbose="true">
 3 |      <testsuites>
 4 |         <testsuite name="TekinTCaptcha">
 5 |             <directory suffix="Test.php">./tests/TekinTCaptcha</directory>
 6 |        </testsuite>
 7 |     </testsuites>
 8 |     
 9 |     <filter>
10 |         <whitelist processUncoveredFilesFromWhitelist="true">
11 |             <directory suffix=".php">./src/TekinTCaptcha</directory>
12 |         </whitelist>
13 |     </filter>
14 | 
15 |     <logging>
16 |         <log type="coverage-html" target="./reports" charset="UTF-8"/>
17 |     </logging>
18 | </phpunit>
19 | 


--------------------------------------------------------------------------------
/src/TekinTCaptcha/RequestMethod/Curl.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | namespace TekinTCaptcha\RequestMethod;
 4 | 
 5 | /**
 6 |  * Convenience wrapper around the cURL functions to allow mocking.
 7 |  */
 8 | class Curl
 9 | {
10 | 
11 |     /**
12 |      * @see http://php.net/curl_init
13 |      * @param string $url
14 |      * @return resource cURL handle
15 |      */
16 |     public function init($url = null)
17 |     {
18 |         return curl_init($url);
19 |     }
20 | 
21 |     /**
22 |      * @see http://php.net/curl_setopt_array
23 |      * @param resource $ch
24 |      * @param array $options
25 |      * @return bool
26 |      */
27 |     public function setoptArray($ch, array $options)
28 |     {
29 |         return curl_setopt_array($ch, $options);
30 |     }
31 | 
32 |     /**
33 |      * @see http://php.net/curl_exec
34 |      * @param resource $ch
35 |      * @return mixed
36 |      */
37 |     public function exec($ch)
38 |     {
39 |         return curl_exec($ch);
40 |     }
41 | 
42 |     /**
43 |      * @see http://php.net/curl_close
44 |      * @param resource $ch
45 |      */
46 |     public function close($ch)
47 |     {
48 |         curl_close($ch);
49 |     }
50 | }
51 | 


--------------------------------------------------------------------------------
/composer.json:
--------------------------------------------------------------------------------
 1 | {
 2 |     "name": "tekintian/tekintcaptcha",
 3 |     "description": "腾讯验证码, 腾讯防水墙, 验证码, 滑动验证码, 智能滑动验证码PHP扩展, TekinTCaptcha - A Client library for Tencent Captcha, a service that protect websites from spam and abuse.",
 4 |     "type": "library",
 5 |     "keywords": ["滑动验证码","腾讯验证码","验证码","腾讯防水墙", "智能滑动验证码", "tencent", "TencentCaptcha", "captcha", "spam", "abuse"],
 6 |     "homepage": "http://tekin.yunnan.ws/",
 7 |     "license": "BSD-3-Clause",
 8 |     "support": {
 9 |         "forum": "https://tekin.yunnan.ws/tekintcaptcha",
10 |         "source": "https://github.com/tekintian/tekintcaptcha"
11 |     },
12 |     "require": {
13 |         "php": ">=5.6"
14 |     },
15 |     "require-dev": {
16 |         "phpunit/phpunit": "^6.5"
17 |     },
18 |     "autoload": {
19 |         "psr-4": {
20 |             "TekinTCaptcha\\": "src/TekinTCaptcha"
21 |         }
22 |     },
23 |     "extra": {
24 |         "branch-alias": {
25 |             "dev-master": "1.1.x-dev"
26 |         }
27 |     },
28 |     
29 |     "repositories": {
30 |     "packagist": {
31 |         "type": "composer",
32 |         "url": "https://packagist.phpcomposer.com"
33 |     }
34 |     }
35 | }
36 | 


--------------------------------------------------------------------------------
/src/autoload.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | /* An autoloader for TekinTCaptcha\Foo classes. This should be required()
 4 |  * by the user before attempting to instantiate any of the TekinTCaptcha
 5 |  * classes.
 6 |  */
 7 | 
 8 | spl_autoload_register(function ($class) {
 9 |     if (substr($class, 0, 14) !== 'TekinTCaptcha\\') {
10 |       /* If the class does not lie under the "TekinTCaptcha" namespace,
11 |        * then we can exit immediately.
12 |        */
13 |       return;
14 |     }
15 | 
16 |     /* All of the classes have names like "TekinTCaptcha\Foo", so we need
17 |      * to replace the backslashes with frontslashes if we want the
18 |      * name to map directly to a location in the filesystem.
19 |      */
20 |     $class = str_replace('\\', '/', $class);
21 | 
22 |     /* First, check under the current directory. It is important that
23 |      * we look here first, so that we don't waste time searching for
24 |      * test classes in the common case.
25 |      */
26 |     $path = dirname(__FILE__).'/'.$class.'.php';
27 |     if (is_readable($path)) {
28 |         require_once $path;
29 |     }
30 | 
31 |     /* If we didn't find what we're looking for already, maybe it's
32 |      * a test class?
33 |      */
34 |     $path = dirname(__FILE__).'/../tests/'.$class.'.php';
35 |     if (is_readable($path)) {
36 |         require_once $path;
37 |     }
38 | });
39 | 


--------------------------------------------------------------------------------
/tests/TekinTCaptcha/RequestMethod/CurlPostTest.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | namespace TekinTCaptcha\RequestMethod;
 4 | 
 5 | use \TekinTCaptcha\RequestParameters;
 6 | use \PHPUnit\Framework\TestCase;
 7 | 
 8 | class CurlPostTest extends TestCase
 9 | {
10 | 
11 |     protected function setUp()
12 |     {
13 |         if (!extension_loaded('curl')) {
14 |             $this->markTestSkipped(
15 |                     'The cURL extension is not available.'
16 |             );
17 |         }
18 |     }
19 | 
20 |     public function testSubmit()
21 |     {
22 |         $curl = $this->getMock('\\TekinTCaptcha\\RequestMethod\\Curl',
23 |                 array('init', 'setoptArray', 'exec', 'close'));
24 |         $curl->expects($this->once())
25 |                 ->method('init')
26 |                 ->willReturn(new \stdClass);
27 |         $curl->expects($this->once())
28 |                 ->method('setoptArray')
29 |                 ->willReturn(true);
30 |         $curl->expects($this->once())
31 |                 ->method('exec')
32 |                 ->willReturn('RESPONSEBODY');
33 |         $curl->expects($this->once())
34 |                 ->method('close');
35 | 
36 |         $pc = new CurlPost($curl);
37 |         $response = $pc->submit(new RequestParameters("aid","AppSecretKey", "Ticket","Randstr","UserIP"));
38 |         $this->assertEquals('RESPONSEBODY', $response);
39 |     }
40 | }
41 | 


--------------------------------------------------------------------------------
/tests/TekinTCaptcha/RequestParametersTest.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | namespace TekinTCaptcha;
 4 | use \PHPUnit\Framework\TestCase;
 5 | 
 6 | class RequestParametersTest extends TestCase
 7 | {
 8 | 
 9 |     public function provideValidData()
10 |     {
11 |         return array(
12 |             array('aid','AppSecretKey', 'Ticket','Randstr','UserIP',array(
13 |                 'aid'=>'aid','AppSecretKey'=>'AppSecretKey','Ticket'=>'Ticket','Randstr'=>'Randstr','UserIP'=>'UserIP'
14 |             ),array('aid','AppSecretKey', 'Ticket','Randstr','UserIP',array('aid'=>'aid','AppSecretKey'=>'AppSecretKey','Ticket'=>'Ticket','Randstr'=>'Randstr'),'aid=aid&AppSecretKey=AppSecretKey&Ticket=Ticket&Randstr=Randstr')
15 |         ));
16 |     }
17 | 
18 |     /**
19 |      * @dataProvider provideValidData
20 |      */
21 |     public function testToArray($aid, $AppSecretKey, $Ticket, $Randstr,$UserIP, $expectedArray, $expectedQuery)
22 |     {
23 |         $params = new RequestParameters($aid, $AppSecretKey, $Ticket, $Randstr,$UserIP);
24 |         $this->assertEquals($params->toArray(), $expectedArray);
25 |     }
26 | 
27 |     /**
28 |      * @dataProvider provideValidData
29 |      */
30 |     public function testToQueryString($aid, $AppSecretKey, $Ticket, $Randstr,$UserIP, $expectedArray, $expectedQuery)
31 |     {
32 |         $params = new RequestParameters($aid, $AppSecretKey, $Ticket, $Randstr,$UserIP);
33 |         $this->assertEquals($params->toQueryString(), $expectedQuery);
34 |         
35 |     }
36 | }
37 | 


--------------------------------------------------------------------------------
/examples/index.html:
--------------------------------------------------------------------------------
 1 | <!DOCTYPE html>
 2 | <html lang="en">
 3 | <head>
 4 | 	<meta charset="UTF-8">
 5 | 	<title>Tekin TencentCAPTCHA Example</title>
 6 | </head>
 7 | <body>
 8 | 	 <p>Complete the Tekin TencentCAPTCHA then submit the form.</p>
 9 |     <form id="login-form" action="login.php" method="post">
10 |         <fieldset>
11 |             <legend>An example form</legend>
12 |             <p>Example input A: <input type="text" name="ex-a" value="foo"></p>
13 |             <p>Example input B: <input type="text" name="ex-b" value="bar"></p>
14 | 
15 |              <!-- 验证码票据验证数据隐藏表单 -->
16 |            <input type="hidden" id="ticket" name="Ticket" value="">
17 |             <input type="hidden" id="randstr" name="Randstr" value="">
18 |             <!-- 验证码票据验证数据隐藏表单 end -->
19 | 
20 |             <p>
21 |               <input type="button" id="TencentCaptcha" data-appid="2050171219" data-cbfn="myTCaptchaCallback" value="登录">
22 |             </p>
23 | 
24 |         </fieldset>
25 |     </form>
26 |  <script type="text/javascript" src="https://ssl.captcha.qq.com/TCaptcha.js"></script>
27 |  <script type="text/javascript">
28 | 
29 | function myTCaptchaCallback(res){
30 | 	console.log(res)
31 |     var ticket = document.getElementById("ticket");
32 |     var randstr = document.getElementById("randstr");
33 |    
34 |     // res（未通过验证）= {ret: 1, ticket: null}
35 |     // res（验证成功） = {ret: 0, ticket: "String", randstr: "String"}
36 |     if(res.ret === 0){
37 |     	/*将获取的票据信息写入到表单隐藏域中*/
38 |         ticket.value=res.ticket;
39 |         randstr.value=res.randstr;
40 |         /* 提交表单*/
41 |         document.getElementById("login-form").submit();
42 |     }
43 | }
44 | </script>
45 | </body>
46 | </html>


--------------------------------------------------------------------------------
/src/TekinTCaptcha/RequestMethod/Post.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | namespace TekinTCaptcha\RequestMethod;
 4 | 
 5 | use TekinTCaptcha\RequestMethod;
 6 | use TekinTCaptcha\RequestParameters;
 7 | 
 8 | /**
 9 |  * Sends POST requests to the TekinTCaptcha service.
10 |  */
11 | class Post implements RequestMethod
12 | {
13 |     /**
14 |      * URL to which requests are POSTed.
15 |      * @const string
16 |      */
17 |     const TCAPTCHA_VERIFY_URL = 'https://ssl.captcha.qq.com/ticket/verify';
18 | 
19 |     /**
20 |      * Submit the POST request with the specified parameters.
21 |      *
22 |      * @param RequestParameters $params Request parameters
23 |      * @return string Body of the TekinTCaptcha response
24 |      */
25 |     public function submit(RequestParameters $params)
26 |     {
27 |         /**
28 |          * PHP 5.6.0 changed the way you specify the peer name for SSL context options.
29 |          * Using "CN_name" will still work, but it will raise deprecated errors.
30 |          */
31 |         $peer_key = version_compare(PHP_VERSION, '5.6.0', '<') ? 'CN_name' : 'peer_name';
32 |         $options = array(
33 |             'http' => array(
34 |                 'header' => "Content-type: application/x-www-form-urlencoded\r\n",
35 |                 'method' => 'POST',
36 |                 'content' => $params->toQueryString(),
37 |                 // Force the peer to validate (not needed in 5.6.0+, but still works)
38 |                 'verify_peer' => true,
39 |                 // Force the peer validation to use www.google.com
40 |                 $peer_key => 'www.yunnan.ws',
41 |             ),
42 |         );
43 |         
44 |         $context = stream_context_create($options);
45 |         return file_get_contents(self::TCAPTCHA_VERIFY_URL, false, $context);
46 |     }
47 | }
48 | 


--------------------------------------------------------------------------------
/src/TekinTCaptcha/RequestMethod/Get.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | namespace TekinTCaptcha\RequestMethod;
 4 | 
 5 | use TekinTCaptcha\RequestMethod;
 6 | use TekinTCaptcha\RequestParameters;
 7 | 
 8 | /**
 9 |  * Sends POST requests to the TekinTCaptcha service.
10 |  */
11 | class Get implements RequestMethod
12 | {
13 |     /**
14 |      * URL to which requests are POSTed.
15 |      * @const string
16 |      */
17 |     const TCAPTCHA_VERIFY_URL = 'https://ssl.captcha.qq.com/ticket/verify';
18 | 
19 |     /**
20 |      * Submit the POST request with the specified parameters.
21 |      *
22 |      * @param RequestParameters $params Request parameters
23 |      * @return string Body of the TekinTCaptcha response
24 |      */
25 |     public function submit(RequestParameters $params)
26 |     {
27 |         /**
28 |          * PHP 5.6.0 changed the way you specify the peer name for SSL context options.
29 |          * Using "CN_name" will still work, but it will raise deprecated errors.
30 |          */
31 |         $peer_key = version_compare(PHP_VERSION, '5.6.0', '<') ? 'CN_name' : 'peer_name';
32 |         $options = array(
33 |             'http' => array(
34 |                 // 'header' => "Content-type: application/x-www-form-urlencoded\r\n",
35 |                 'method' => 'GET',
36 |                 'content' => $params->toQueryString(),
37 |                 // Force the peer to validate (not needed in 5.6.0+, but still works)
38 |                  // 'verify_peer' => true,
39 |                 // Force the peer validation to use www.google.com
40 |                  // $peer_key => 'www.yunnan.ws',
41 |             ),
42 |         );
43 |         
44 |         $context = stream_context_create($options);
45 | 
46 |         return file_get_contents(self::TCAPTCHA_VERIFY_URL, false, $context);
47 |     }
48 | }
49 | 


--------------------------------------------------------------------------------
/tests/TekinTCaptcha/TekinTCaptchaTest.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | namespace TekinTCaptcha;
 4 | use \PHPUnit\Framework\TestCase;
 5 | 
 6 | class TencentCaptchaTest extends TestCase
 7 | {
 8 |     /**
 9 |      * @expectedException \RuntimeException
10 |      * @dataProvider invalidAppSecretKeyProvider
11 |      */
12 |     public function testExceptionThrownOnInvalidAppSecretKey($invalid)
13 |     {
14 |         $rc = new TekinTCaptcha($invalid);
15 |     }
16 | 
17 |     public function invalidAppSecretKeyProvider()
18 |     {
19 |         return array(
20 |             array(''),
21 |             array(null),
22 |             array(0),
23 |             array(new \stdClass()),
24 |             array(array()),
25 |         );
26 |     }
27 | 
28 |     public function testVerifyReturnsErrorOnMissingTicket()
29 |     {
30 |         $rc = new TekinTCaptcha('Ticket','Randstr');
31 |         $Ticket = $rc->verify('');
32 |         $this->assertFalse($Ticket->isSuccess());
33 |         $this->assertEquals(array('missing-input-ticket'), $Ticket->getErrMsg());
34 |     }
35 | 
36 |     public function testVerifyReturnsErrorOnMissingRandstr()
37 |     {
38 |         $rc = new TekinTCaptcha('Ticket','Randstr');
39 |         $Ticket = $rc->verify('Ticket');
40 |         $this->assertFalse($Ticket->isSuccess());
41 |         $this->assertEquals(array('missing-input-randstr'), $Ticket->getErrMsg());
42 |     }
43 |     public function testVerifyReturnsResponse()
44 |     {
45 |         $method = $this->getMock('\\TekinTCaptcha\\RequestMethod', array('submit'));
46 |         $method->expects($this->once())
47 |                 ->method('submit')
48 |                 ->with($this->callback(function ($params) {
49 | 
50 |                             return true;
51 |                         }))
52 |                 ->will($this->returnValue('{"success": true}'));
53 |         ;
54 |         $rc = new TekinTCaptcha('aid','AppSecretKey', $method);
55 |         $Ticket = $rc->verify('Ticket','Randstr');
56 |         $this->assertTrue($Ticket->isSuccess());
57 |     }
58 | }
59 | 


--------------------------------------------------------------------------------
/src/TekinTCaptcha/RequestMethod/Socket.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | namespace TekinTCaptcha\RequestMethod;
 4 | 
 5 | /**
 6 |  * Convenience wrapper around native socket and file functions to allow for
 7 |  * mocking.
 8 |  */
 9 | class Socket
10 | {
11 |     private $handle = null;
12 | 
13 |     /**
14 |      * fsockopen
15 |      * 
16 |      * @see http://php.net/fsockopen
17 |      * @param string $hostname
18 |      * @param int $port
19 |      * @param int $errno
20 |      * @param string $errstr
21 |      * @param float $timeout
22 |      * @return resource
23 |      */
24 |     public function fsockopen($hostname, $port = -1, &$errno = 0, &$errstr = '', $timeout = null)
25 |     {
26 |         $this->handle = fsockopen($hostname, $port, $errno, $errstr, (is_null($timeout) ? ini_get("default_socket_timeout") : $timeout));
27 | 
28 |         if ($this->handle != false && $errno === 0 && $errstr === '') {
29 |             return $this->handle;
30 |         }
31 |         return false;
32 |     }
33 | 
34 |     /**
35 |      * fwrite
36 |      * 
37 |      * @see http://php.net/fwrite
38 |      * @param string $string
39 |      * @param int $length
40 |      * @return int | bool
41 |      */
42 |     public function fwrite($string, $length = null)
43 |     {
44 |         return fwrite($this->handle, $string, (is_null($length) ? strlen($string) : $length));
45 |     }
46 | 
47 |     /**
48 |      * fgets
49 |      * 
50 |      * @see http://php.net/fgets
51 |      * @param int $length
52 |      * @return string
53 |      */
54 |     public function fgets($length = null)
55 |     {
56 |         return fgets($this->handle, $length);
57 |     }
58 | 
59 |     /**
60 |      * feof
61 |      * 
62 |      * @see http://php.net/feof
63 |      * @return bool
64 |      */
65 |     public function feof()
66 |     {
67 |         return feof($this->handle);
68 |     }
69 | 
70 |     /**
71 |      * fclose
72 |      * 
73 |      * @see http://php.net/fclose
74 |      * @return bool
75 |      */
76 |     public function fclose()
77 |     {
78 |         return fclose($this->handle);
79 |     }
80 | }
81 | 


--------------------------------------------------------------------------------
/src/TekinTCaptcha/RequestMethod/CurlPost.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | namespace TekinTCaptcha\RequestMethod;
 4 | 
 5 | use TekinTCaptcha\RequestMethod;
 6 | use TekinTCaptcha\RequestParameters;
 7 | 
 8 | /**
 9 |  * Sends cURL request to the TekinTCaptcha service.
10 |  * Note: this requires the cURL extension to be enabled in PHP
11 |  * @see http://php.net/manual/en/book.curl.php
12 |  */
13 | class CurlPost implements RequestMethod
14 | {
15 |     /**
16 |      * URL to which requests are sent via cURL.
17 |      * @const string
18 |      */
19 |     const TCAPTCHA_VERIFY_URL = 'https://ssl.captcha.qq.com/ticket/verify';
20 | 
21 |     /**
22 |      * Curl connection to the TekinTCaptcha service
23 |      * @var Curl
24 |      */
25 |     private $curl;
26 | 
27 |     public function __construct(Curl $curl = null)
28 |     {
29 |         if (!is_null($curl)) {
30 |             $this->curl = $curl;
31 |         } else {
32 |             $this->curl = new Curl();
33 |         }
34 |     }
35 | 
36 |     /**
37 |      * Submit the cURL request with the specified parameters.
38 |      *
39 |      * @param RequestParameters $params Request parameters
40 |      * @return string Body of the TekinTCaptcha response
41 |      */
42 |     public function submit(RequestParameters $params)
43 |     {
44 |         $handle = $this->curl->init(self::TCAPTCHA_VERIFY_URL);
45 | 
46 |         $options = array(
47 |             CURLOPT_POST => true,
48 |             CURLOPT_POSTFIELDS => $params->toQueryString(),
49 |             CURLOPT_HTTPHEADER => array(
50 |                 'Content-Type: application/x-www-form-urlencoded'
51 |             ),
52 |             CURLINFO_HEADER_OUT => false,
53 |             CURLOPT_HEADER => false,
54 |             CURLOPT_DNS_USE_GLOBAL_CACHE => true,
55 |             CURLOPT_RETURNTRANSFER => true,
56 |             CURLOPT_SSL_VERIFYPEER => true
57 |         );
58 |         $this->curl->setoptArray($handle, $options);
59 | 
60 |         $rawResponse = $this->curl->exec($handle);
61 |         $this->curl->close($handle);
62 | 
63 |         return $rawResponse;
64 |     }
65 | }
66 | 


--------------------------------------------------------------------------------
/src/TekinTCaptcha/RequestMethod/CurlGet.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | namespace TekinTCaptcha\RequestMethod;
 4 | 
 5 | use TekinTCaptcha\RequestMethod;
 6 | use TekinTCaptcha\RequestParameters;
 7 | 
 8 | /**
 9 |  * Sends cURL request to the TekinTCaptcha service.
10 |  * Note: this requires the cURL extension to be enabled in PHP
11 |  * @see http://php.net/manual/en/book.curl.php
12 |  */
13 | class CurlGet implements RequestMethod
14 | {
15 |     /**
16 |      * URL to which requests are sent via cURL.
17 |      * @const string
18 |      */
19 |     const TCAPTCHA_VERIFY_URL = 'https://ssl.captcha.qq.com/ticket/verify';
20 | 
21 |     /**
22 |      * Curl connection to the TekinTCaptcha service
23 |      * @var Curl
24 |      */
25 |     private $curl;
26 | 
27 |     public function __construct(Curl $curl = null)
28 |     {
29 |         if (!is_null($curl)) {
30 |             $this->curl = $curl;
31 |         } else {
32 |             $this->curl = new Curl();
33 |         }
34 |     }
35 | 
36 |     /**
37 |      * Submit the cURL request with the specified parameters.
38 |      *
39 |      * @param RequestParameters $params Request parameters
40 |      * @return string Body of the TekinTCaptcha response
41 |      */
42 |     public function submit(RequestParameters $params)
43 |     {
44 |         $handle = $this->curl->init();
45 | 
46 |         $options = array(
47 |             CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
48 |             CURLOPT_HTTPGET => true,
49 |             CURLOPT_USERAGENT => 'Mozilla/5.0 (Windows NT 5.1) AppleWebKit/537.22 (KHTML, like Gecko) Chrome/25.0.1364.172 Safari/537.22',
50 |             CURLOPT_URL => self::TCAPTCHA_VERIFY_URL.'?'.$params->toQueryString(),
51 |             CURLOPT_TIMEOUT => 30,
52 |             CURLOPT_CONNECTTIMEOUT => 30,
53 |             CURLOPT_RETURNTRANSFER => true,
54 |             CURLOPT_SSL_VERIFYHOST => false,
55 |             CURLOPT_SSL_VERIFYPEER => false
56 |         );
57 |         $this->curl->setoptArray($handle, $options);
58 | 
59 |         $rawResponse = $this->curl->exec($handle);
60 |         $this->curl->close($handle);
61 |  
62 |         return $rawResponse;
63 |     }
64 | }
65 | 


--------------------------------------------------------------------------------
/tests/TekinTCaptcha/ResponseTest.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | namespace TekinTCaptcha;
 4 | use \PHPUnit\Framework\TestCase;
 5 | 
 6 | class ResponseTest extends TestCase
 7 | {
 8 | 
 9 |     /**
10 |      * @dataProvider provideJson
11 |      */ 
12 |     public function testFromJson($json, $success, $msg, $status, $evil_level)
13 |     {
14 |         $Ticket = Response::fromJson($json);
15 |         $this->assertEquals($success, $Ticket->isSuccess());
16 |         $this->assertEquals($msg, $Ticket->getErrMsg());
17 |         $this->assertEquals($status, $Ticket->getStatus());
18 |         $this->assertEquals($evil_level, $Ticket->getEvilLevel());
19 |     }
20 | 
21 |     public function provideJson()
22 |     {
23 |         return array(
24 |             array('{"success": true}', true, array(), 1,null),
25 |             array('{"success": true, "err_msg": "OK"}', true, array(), 1,null),
26 |             array('{"success": false, "err_msg": ["test"]}', false, array('test'), 0, null),
27 |             array('{"success": false, "err_msg": ["test"], "response": "0"}', false, array('test'), 0, null),
28 |             array('{"success": true, "err_msg": ["test"]}', true, array(),1, null),
29 |             array('{"success": true, "err_msg": ["OK"], "response": "1"}', true, array(), '1',10),
30 |             array('{"success": false}', false, array(), 0, null),
31 |           
32 |             array('BAD JSON', false, array('invalid-json'), -1, null),
33 |         );
34 |     }
35 | 
36 |     public function testIsSuccess()
37 |     {
38 |         $Ticket = new Response(true);
39 |         $this->assertTrue($Ticket->isSuccess());
40 | 
41 |         $Ticket = new Response(false);
42 |         $this->assertFalse($Ticket->isSuccess());
43 | 
44 |         $Ticket = new Response(true, array(), 1);
45 |         $this->assertEquals('1', $Ticket->getStatus());
46 |     }
47 | 
48 |     public function testGetErrMsg()
49 |     {
50 |         $errMsg = array('test');
51 |         $Ticket = new Response(true, $errMsg);
52 |         $this->assertEquals($errMsg, $Ticket->getErrMsg());
53 |     }
54 | 
55 |     public function testGetStatus()
56 |     {
57 |       $status = 1;
58 |       $errMsg = array();
59 |       $Ticket = new Response(true, $errMsg, $status);
60 |       $this->assertEquals($status, $Ticket->getStatus());
61 |     }
62 | 
63 |      public function testGetEvilLevel()
64 |     {
65 |       $evilLevel = 10;
66 |       $errMsg = array();
67 |       $Ticket = new Response(true, $errMsg, 1, $evilLevel);
68 |       $this->assertEquals($evilLevel, $Ticket->getEvilLevel());
69 |     }
70 | }
71 | 


--------------------------------------------------------------------------------
/tests/TekinTCaptcha/RequestMethod/SocketPostTest.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | namespace TekinTCaptcha\RequestMethod;
 4 | 
 5 | use TekinTCaptcha\RequestParameters;
 6 | use \PHPUnit\Framework\TestCase;
 7 | 
 8 | class SocketPostTest extends TestCase
 9 | {
10 | 
11 |     public function testSubmitSuccess()
12 |     {
13 |         $socket = $this->getMock('\\TekinTCaptcha\\RequestMethod\\Socket', array('fsockopen', 'fwrite', 'fgets', 'feof', 'fclose'));
14 |         $socket->expects($this->once())
15 |                 ->method('fsockopen')
16 |                 ->willReturn(true);
17 |         $socket->expects($this->once())
18 |                 ->method('fwrite');
19 |         $socket->expects($this->once())
20 |                 ->method('fgets')
21 |                 ->willReturn("HTTP/1.1 200 OK\n\nRESPONSEBODY");
22 |         $socket->expects($this->exactly(2))
23 |                 ->method('feof')
24 |                 ->will($this->onConsecutiveCalls(false, true));
25 |         $socket->expects($this->once())
26 |                 ->method('fclose')
27 |                 ->willReturn(true);
28 | 
29 |         $ps = new SocketPost($socket);
30 |         $response = $ps->submit(new RequestParameters("aid","AppSecretKey", "Ticket","Randstr","UserIP"));
31 |         $this->assertEquals('RESPONSEBODY', $response);
32 |     }
33 | 
34 |     public function testSubmitBadResponse()
35 |     {
36 |         $socket = $this->getMock('\\TekinTCaptcha\\RequestMethod\\Socket', array('fsockopen', 'fwrite', 'fgets', 'feof', 'fclose'));
37 |         $socket->expects($this->once())
38 |                 ->method('fsockopen')
39 |                 ->willReturn(true);
40 |         $socket->expects($this->once())
41 |                 ->method('fwrite');
42 |         $socket->expects($this->once())
43 |                 ->method('fgets')
44 |                 ->willReturn("HTTP/1.1 500 NOPEn\\nBOBBINS");
45 |         $socket->expects($this->exactly(2))
46 |                 ->method('feof')
47 |                 ->will($this->onConsecutiveCalls(false, true));
48 |         $socket->expects($this->once())
49 |                 ->method('fclose')
50 |                 ->willReturn(true);
51 | 
52 |         $ps = new SocketPost($socket);
53 |         $response = $ps->submit(new RequestParameters("aid","AppSecretKey", "Ticket","Randstr","UserIP"));
54 |         $this->assertEquals(SocketPost::BAD_RESPONSE, $response);
55 |     }
56 | 
57 |     public function testSubmitBadRequest()
58 |     {
59 |         $socket = $this->getMock('\\TekinTCaptcha\\RequestMethod\\Socket', array('fsockopen'));
60 |         $socket->expects($this->once())
61 |                 ->method('fsockopen')
62 |                 ->willReturn(false);
63 |         $ps = new SocketPost($socket);
64 |         $response = $ps->submit(new RequestParameters("aid","AppSecretKey", "Ticket","Randstr","UserIP"));
65 |         $this->assertEquals(SocketPost::BAD_REQUEST, $response);
66 |     }
67 | }
68 | 


--------------------------------------------------------------------------------
/src/TekinTCaptcha/RequestMethod/SocketPost.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | namespace TekinTCaptcha\RequestMethod;
 4 | 
 5 | use TekinTCaptcha\RequestMethod;
 6 | use TekinTCaptcha\RequestParameters;
 7 | 
 8 | /**
 9 |  * Sends a POST request to the TekinTCaptcha service, but makes use of fsockopen()
10 |  * instead of get_file_contents(). This is to account for people who may be on
11 |  * servers where allow_url_open is disabled.
12 |  */
13 | class SocketPost implements RequestMethod
14 | {
15 |     /**
16 |      * TekinTCaptcha service host.
17 |      * @const string
18 |      */
19 |     const RECAPTCHA_HOST = 'ssl.captcha.qq.com';
20 | 
21 |     /**
22 |      * @const string TekinTCaptcha service path
23 |      */
24 |     const SITE_VERIFY_PATH = '/ticket/verify';
25 | 
26 |     /**
27 |      * @const string Bad request error
28 |      */
29 |     const BAD_REQUEST = '{"success": false, "err_msg": ["invalid-request"]}';
30 | 
31 |     /**
32 |      * @const string Bad response error
33 |      */
34 |     const BAD_RESPONSE = '{"success": false, "err_msg": ["invalid-response"]}';
35 | 
36 |     /**
37 |      * Socket to the TekinTCaptcha service
38 |      * @var Socket
39 |      */
40 |     private $socket;
41 | 
42 |     /**
43 |      * Constructor
44 |      *
45 |      * @param \TekinTCaptcha\RequestMethod\Socket $socket optional socket, injectable for testing
46 |      */
47 |     public function __construct(Socket $socket = null)
48 |     {
49 |         if (!is_null($socket)) {
50 |             $this->socket = $socket;
51 |         } else {
52 |             $this->socket = new Socket();
53 |         }
54 |     }
55 | 
56 |     /**
57 |      * Submit the POST request with the specified parameters.
58 |      *
59 |      * @param RequestParameters $params Request parameters
60 |      * @return string Body of the TekinTCaptcha response
61 |      */
62 |     public function submit(RequestParameters $params)
63 |     {
64 |         $errno = 0;
65 |         $errstr = '';
66 | 
67 |         if (false === $this->socket->fsockopen('ssl://' . self::RECAPTCHA_HOST, 443, $errno, $errstr, 30)) {
68 |             return self::BAD_REQUEST;
69 |         }
70 | 
71 |         $content = $params->toQueryString();
72 | 
73 |         $request = "POST " . self::SITE_VERIFY_PATH . " HTTP/1.1\r\n";
74 |         $request .= "Host: " . self::RECAPTCHA_HOST . "\r\n";
75 |         $request .= "Content-Type: application/x-www-form-urlencoded\r\n";
76 |         $request .= "Content-length: " . strlen($content) . "\r\n";
77 |         $request .= "Connection: close\r\n\r\n";
78 |         $request .= $content . "\r\n\r\n";
79 | 
80 |         $this->socket->fwrite($request);
81 |         $rawResponse = '';
82 | 
83 |         while (!$this->socket->feof()) {
84 |             $rawResponse .= $this->socket->fgets(4096);
85 |         }
86 | 
87 |         $this->socket->fclose();
88 | 
89 |         if (0 !== strpos($rawResponse, 'HTTP/1.1 200 OK')) {
90 |             return self::BAD_RESPONSE;
91 |         }
92 | 
93 |         $parts = preg_split("#\n\s*\n#Uis", $rawResponse);
94 | 
95 |         return $parts[1];
96 |     }
97 | }
98 | 


--------------------------------------------------------------------------------
/src/TekinTCaptcha/TekinTCaptcha.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | namespace TekinTCaptcha;
 4 | 
 5 | /**
 6 |  * TekinTCaptcha client.
 7 |  */
 8 | class TekinTCaptcha
 9 | {
10 |      /**
11 |      * Shared app id for the site.
12 |      * @var string
13 |      */
14 |     private $aid;
15 | 
16 |     /**
17 |      * Shared AppSecretKey for the site.
18 |      * @var string
19 |      */
20 |     private $AppSecretKey;
21 | 
22 |     /**
23 |      * Method used to communicate with service. Defaults to POST request.
24 |      * @var RequestMethod
25 |      */
26 |     private $requestMethod;
27 | 
28 |     /**
29 |      * Create a configured instance to use the TekinTCaptcha service.
30 |      *
31 |      * @param int $aid shared App ID between site and TCaptcha server.
32 |      * @param string $AppSecretKey shared AppSecretKey between site and  TCaptcha server.
33 |      * @param RequestMethod $requestMethod method used to send the request. Defaults to POST.
34 |      * @throws \RuntimeException if $aid, $AppSecretKey is invalid
35 |      */
36 |     public function __construct($aid, $AppSecretKey, RequestMethod $requestMethod = null)
37 |     {
38 |        
39 |         if (empty($aid)) {
40 |             throw new \RuntimeException('No app id provided');
41 |         }
42 |         if (!is_numeric($aid)) {
43 |             throw new \RuntimeException("The provided aid must be a number");
44 |         }
45 | 
46 |         if (empty($AppSecretKey)) {
47 |             throw new \RuntimeException('No AppSecretKey provided');
48 |         }
49 | 
50 |         if (!is_string($AppSecretKey)) {
51 |             throw new \RuntimeException('The provided AppSecretKey must be a string');
52 |         }
53 | 
54 |         $this->aid = $aid;
55 |         $this->AppSecretKey = $AppSecretKey;
56 | 
57 |         if (!is_null($requestMethod)) {
58 |             $this->requestMethod = $requestMethod;
59 |         } else {
60 |             $this->requestMethod = new RequestMethod\CurlGet();
61 |         }
62 |     }
63 | 
64 |     /**
65 |      * Calls the TekinTCaptcha siteverify API to verify whether the user passes
66 |      * @param string $Ticket The value of Ticket in the submitted form.
67 |      * @param string $Randstr The value of Randstr in the submitted form.
68 |      * @param string $UserIP The end user's IP address.
69 |      * @return Response Response from the service.
70 |      */
71 |     public function verify($Ticket, $Randstr, $UserIP = null)
72 |     {
73 |         // Discard empty solution submissions
74 |         if (empty($Ticket)) {
75 |             $TekinTCaptchaResponse = new Response(false, array('missing-input-ticket'));
76 |             return $TekinTCaptchaResponse;
77 |         }
78 |         if (empty($Randstr)) {
79 |             $TekinTCaptchaResponse = new Response(false, array('missing-input-randstr'));
80 |             return $TekinTCaptchaResponse;
81 |         }
82 | 
83 |         $params = new RequestParameters($this->aid, $this->AppSecretKey, $Ticket, $Randstr, $UserIP);
84 | 
85 |         $rawResponse = $this->requestMethod->submit($params);
86 | 
87 |         return Response::fromJson($rawResponse);
88 |     }
89 | }
90 | 


--------------------------------------------------------------------------------
/src/TekinTCaptcha/RequestParameters.php:
--------------------------------------------------------------------------------
  1 | <?php
  2 | 
  3 | namespace TekinTCaptcha;
  4 | 
  5 | /**
  6 |  * Stores and formats the parameters for the request to the TekinTCaptcha service.
  7 |  */
  8 | class RequestParameters
  9 | {
 10 |     /**
 11 |     * app id
 12 |      * @var int
 13 |     */
 14 |     private $aid;
 15 | 
 16 |     /**
 17 |      * Site AppSecretKey.
 18 |      * @var string
 19 |      */
 20 |     private $AppSecretKey;
 21 | 
 22 |     /**
 23 |      * Form Ticket.
 24 |      * @var string
 25 |      */
 26 |     private $Ticket;
 27 | 
 28 |      /**
 29 |      * Form Randstr.
 30 |      * @var string
 31 |      */
 32 |     private $Randstr;
 33 | 
 34 |     /**
 35 |      * Remote user's IP address.
 36 |      * @var string
 37 |      */
 38 |     private $UserIP;
 39 | 
 40 |     /**
 41 |      * 
 42 |      *
 43 |      * @param int $aid Site app id.
 44 |      * @param string $AppSecretKey Site AppSecretKey.
 45 |      * @param string $Ticket Value from TekinTCaptcha response form field.
 46 |      * @param string $Randstr Value from TekinTCaptcha response form field.
 47 |      * @param string $UserIP User's IP address.
 48 |      */
 49 |     public function __construct($aid, $AppSecretKey, $Ticket, $Randstr, $UserIP = null) {
 50 |         $this->aid = $aid;
 51 |         $this->AppSecretKey = $AppSecretKey;
 52 |         $this->Ticket = $Ticket;
 53 |         $this->Randstr = $Randstr;
 54 |         if (is_null($UserIP)) {
 55 |             $this->UserIP = $this->getRealIp();
 56 |         }else{
 57 |            $this->UserIP = $UserIP;
 58 |         }
 59 |         
 60 |     }
 61 | 
 62 |     /**
 63 |      * Array representation.
 64 |      *
 65 |      * @return array Array formatted parameters.
 66 |      */
 67 |     public function toArray()
 68 |     {
 69 | 
 70 |         $params = array('aid' => $this->aid, 'AppSecretKey' => $this->AppSecretKey, 'Ticket' => $this->Ticket, 'Randstr' => $this->Randstr, 'UserIP'=>$this->UserIP);
 71 | 
 72 |         return $params;
 73 |     }
 74 | 
 75 |     /**
 76 |      * Query string representation for HTTP request.
 77 |      *
 78 |      * @return string Query string formatted parameters.
 79 |      */
 80 |     public function toQueryString()
 81 |     {
 82 |         return http_build_query($this->toArray());
 83 |         // return http_build_query($this->toArray(), '', '&');
 84 |     }
 85 | 
 86 |     /**
 87 |      * Gets the real ip.
 88 |      * @author     (tekin <tekintian@gmail.com>)
 89 |      * @return     boolean  The real ip.
 90 |      */
 91 |     public function getRealIp(){
 92 |         $ip = false;
 93 |         if (!empty($_SERVER["HTTP_CLIENT_IP"])) {
 94 |             $ip = $_SERVER["HTTP_CLIENT_IP"];
 95 |         }
 96 |         if (!empty($_SERVER['HTTP_X_FORWARDED_FOR'])) {
 97 |             $ips = explode(", ", $_SERVER['HTTP_X_FORWARDED_FOR']);
 98 |             if ($ip) {
 99 |                 array_unshift($ips, $ip);
100 |                 $ip = false;
101 |             }
102 |             for ($i = 0; $i < count($ips); $i++) {
103 |                 if (!preg_match("/^(10|172\.16|192\.168)\./i", $ips[$i])) {
104 |                     $ip = $ips[$i];
105 |                     break;
106 |                 }
107 |             }
108 |         }
109 |         return ($ip ? $ip : $_SERVER['REMOTE_ADDR']);
110 |     }
111 | 
112 | }
113 | 


--------------------------------------------------------------------------------
/src/TekinTCaptcha/Response.php:
--------------------------------------------------------------------------------
  1 | <?php
  2 | 
  3 | namespace TekinTCaptcha;
  4 | 
  5 | /**
  6 |  * The response returned from the service.
  7 |  */
  8 | class Response
  9 | {
 10 |     /**
 11 |      * Success or failure.
 12 |      * @var boolean
 13 |      */
 14 |     private $success = false;
 15 | 
 16 |     /**
 17 |      * 验证信息[optional]
 18 |      * @var array()
 19 |      */
 20 |     private $msg = array();
 21 | 
 22 |     /**
 23 |      * 状态码  1 验证成功； 0 验证失败； 100 AppSecretKey参数校验错误； -1 通讯失败
 24 |      * @var int
 25 |      */
 26 |     private $status = -1;
 27 | 
 28 |     /**
 29 |      * 恶意等级[optional]  0--100 ；  -1 通讯失败
 30 |      * @var int
 31 |      */
 32 |     private $evil_level = null;
 33 | 
 34 |     /**
 35 |      * Build the response from the expected JSON returned by the service.
 36 |      *
 37 |      * @param string $json
 38 |      * @return \TekinTCaptcha\Response
 39 |      */
 40 |     public static function fromJson($json)
 41 |     {
 42 |         $responseData = json_decode($json, true);
 43 | 
 44 |         if (!$responseData) {
 45 |             return new Response(false, array('invalid-json'));
 46 |         }
 47 | 
 48 |         $status = isset($responseData['response']) ? $responseData['response'] : -1;
 49 |         $msg = isset($responseData['err_msg']) ? $responseData['err_msg'] : array();
 50 |         $evil_level = isset($responseData['evil_level']) ? $responseData['evil_level'] : null;
 51 | 
 52 |         switch ($status) {
 53 |             case '0':
 54 |             //验证失败
 55 |                 return new Response(false, $msg, $status, $evil_level);
 56 |                 break;
 57 |             case '1':
 58 |             //验证成功
 59 |                 return new Response(true, $msg, $status, $evil_level);
 60 |                 break;
 61 |              case '100':
 62 |               //AppSecretKey参数校验错误
 63 |                 return new Response(false, $msg, $status, $evil_level);
 64 |                 break;
 65 |             default:
 66 |                 return new Response(false, $msg, $status, $evil_level);
 67 |                 break;
 68 |         }
 69 | 
 70 |     }
 71 | 
 72 |     /**
 73 |      * Constructor.
 74 |      *
 75 |      * @param boolean $success
 76 |      * @param array $msg
 77 |      * @param string $evil_level
 78 |      */
 79 |     public function __construct($success, $msg = array(), $status = -1, $evil_level = null)
 80 |     {
 81 |         $this->success = $success;
 82 |         $this->msg = $msg;
 83 |         $this->status = $status;
 84 |         $this->evil_level = $evil_level;
 85 |     }
 86 | 
 87 |     /**
 88 |      * Is success?
 89 |      *
 90 |      * @return boolean
 91 |      */
 92 |     public function isSuccess()
 93 |     {
 94 |         return $this->success;
 95 |     }
 96 | 
 97 |     /**
 98 |      * Get error codes.
 99 |      *
100 |      * @return array
101 |      */
102 |     public function getErrMsg()
103 |     {
104 |         return $this->msg;
105 |     }
106 | 
107 |     /**
108 |      * 状态码获取
109 |      *
110 |      * @return     <type>  The status.
111 |      */
112 |     public function getStatus()
113 |     {
114 |         return $this->status;
115 |     }
116 | 
117 |     /**
118 |      * Get evil_level.
119 |      *
120 |      * @return string
121 |      */
122 |     public function getEvilLevel()
123 |     {
124 |       return $this->evil_level;
125 |     }
126 | }
127 | 


--------------------------------------------------------------------------------
/tests/TekinTCaptcha/RequestMethod/PostTest.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | namespace TekinTCaptcha\RequestMethod;
 4 | 
 5 | use TekinTCaptcha\RequestParameters;
 6 | use \PHPUnit\Framework\TestCase;
 7 | 
 8 | class PostTest extends TestCase
 9 | {
10 |     public static $assert = null;
11 |     protected $parameters = null;
12 |     protected $runcount = 0;
13 | 
14 |     public function setUp()
15 |     {
16 |         $this->parameters = new RequestParameters("aid","AppSecretKey", "Ticket","Randstr","UserIP");
17 |     }
18 | 
19 |     public function tearDown()
20 |     {
21 |         self::$assert = null;
22 |     }
23 | 
24 |     public function testHTTPContextOptions()
25 |     {
26 |         $req = new Post();
27 |         self::$assert = array($this, "httpContextOptionsCallback");
28 |         $req->submit($this->parameters);
29 |         $this->assertEquals(1, $this->runcount, "The assertion was ran");
30 |     }
31 | 
32 |     public function testSSLContextOptions()
33 |     {
34 |         $req = new Post();
35 |         self::$assert = array($this, "sslContextOptionsCallback");
36 |         $req->submit($this->parameters);
37 |         $this->assertEquals(1, $this->runcount, "The assertion was ran");
38 |     }
39 | 
40 |     public function httpContextOptionsCallback(array $args)
41 |     {
42 |         $this->runcount++;
43 |         $this->assertCommonOptions($args);
44 | 
45 |         $options = stream_context_get_options($args[2]);
46 |         $this->assertArrayHasKey('http', $options);
47 | 
48 |         $this->assertArrayHasKey('method', $options['http']);
49 |         $this->assertEquals("POST", $options['http']['method']);
50 | 
51 |         $this->assertArrayHasKey('content', $options['http']);
52 |         $this->assertEquals($this->parameters->toQueryString(), $options['http']['content']);
53 | 
54 |         $this->assertArrayHasKey('header', $options['http']);
55 |         $headers = array(
56 |             "Content-type: application/x-www-form-urlencoded",
57 |         );
58 |         foreach ($headers as $header) {
59 |             $this->assertContains($header, $options['http']['header']);
60 |         }
61 |     }
62 | 
63 |     public function sslContextOptionsCallback(array $args)
64 |     {
65 |         $this->runcount++;
66 |         $this->assertCommonOptions($args);
67 | 
68 |         $options = stream_context_get_options($args[2]);
69 |         $this->assertArrayHasKey('http', $options);
70 |         $this->assertArrayHasKey('verify_peer', $options['http']);
71 |         $this->assertTrue($options['http']['verify_peer']);
72 | 
73 |         $key = version_compare(PHP_VERSION, "5.6.0", "<") ? "CN_name" : "peer_name";
74 | 
75 |         $this->assertArrayHasKey($key, $options['http']);
76 |         $this->assertEquals("www.yunnan.ws", $options['http'][$key]);
77 |     }
78 | 
79 |     protected function assertCommonOptions(array $args)
80 |     {
81 |         $this->assertCount(3, $args);
82 |         $this->assertStringStartsWith("https://ssl.captcha.qq.com/ticket/verify", $args[0]);
83 |         $this->assertFalse($args[1]);
84 |         $this->assertTrue(is_resource($args[2]), "The context options should be a resource");
85 |     }
86 | }
87 | 
88 | function file_get_contents()
89 | {
90 |     if (PostTest::$assert) {
91 |         return call_user_func(PostTest::$assert, func_get_args());
92 |     }
93 |     // Since we can't represent maxlen in userland...
94 |     return call_user_func_array('file_get_contents', func_get_args());
95 | }
96 | 


--------------------------------------------------------------------------------
/README.md:
--------------------------------------------------------------------------------
  1 | # TekinTCaptcha PHP client library
  2 | ## 基于Google PHP项目设计思想实现的腾讯滑动智能验证码实现PHP中间件。
  3 | 
  4 | * Project page: http://tekin.yunnan.ws/TekinTCaptcha/
  5 | * Repository: https://github.com/tekintian/TekinTCaptcha
  6 | * Version: 1.0.0
  7 | 
  8 | ## Description
  9 | 腾讯验证码, 腾讯防水墙, 验证码, 滑动验证码, 智能滑动验证码PHP扩展, TekinTCaptcha - A Client library for Tencent Captcha, a service that protect websites from spam and abuse.
 10 | TekinTCaptcha is a free CAPTCHA service that protect websites from spam and abuse.
 11 | 
 12 | This is Tencent Captcha code that provides plugins for third-party integration with TekinTCaptcha.
 13 | 
 14 | 
 15 | 
 16 | ## Installation
 17 | 
 18 | ### Composer (Recommended)
 19 | 
 20 | [Composer](https://getcomposer.org/) is a widely used dependency manager for PHP
 21 | packages. This TekinTCaptcha client is available on Packagist as
 22 | [`tekintian/tekintcaptcha`](https://packagist.org/packages/tekintian/tekintcaptcha) and can be
 23 | installed either by running the `composer require` command or adding the library
 24 | to your `composer.json`. To enable Composer for you project, refer to the
 25 | project's [Getting Started](https://getcomposer.org/doc/00-intro.md)
 26 | documentation.
 27 | 
 28 | To add this dependency using the command, run the following from within your
 29 | project directory:
 30 | ```
 31 | composer require tekintian/tekintcaptcha "~1.0"
 32 | ```
 33 | 
 34 | Alternatively, add the dependency directly to your `composer.json` file:
 35 | ```json
 36 | "require": {
 37 |     "tekintian/tekintcaptcha": "~1.0"
 38 | }
 39 | ```
 40 | 
 41 | ### Direct download (no Composer)
 42 | 
 43 | If you wish to install the library manually (i.e. without Composer), then you
 44 | can use the links on the main project page to either clone the repo or download
 45 | the [ZIP file](https://github.com/tekintian/TekinTCaptcha/archive/master.zip). For
 46 | convenience, an autoloader script is provided in `src/autoload.php` which you
 47 | can require into your script instead of Composer's `vendor/autoload.php`. For
 48 | example:
 49 | 
 50 | ```php
 51 | require('/path/to/TekinTCaptcha/src/autoload.php');
 52 | $recaptcha = new \TekinTCaptcha\TekinTCaptcha($aid,$AppSecretKey);
 53 | ```
 54 | 
 55 | The classes in the project are structured according to the
 56 | [PSR-4](http://www.php-fig.org/psr/psr-4/) standard, so you may of course also
 57 | use your own autoloader or require the needed files directly in your code.
 58 | 
 59 | 
 60 | ## Usage
 61 | First, register keys for your site at http://007.qq.com
 62 | 
 63 | When your app receives a form submission containing the `Ticket, Randstr`
 64 | field, you can verify it using:
 65 | ```php
 66 | <?php
 67 | $recaptcha = new \TekinTCaptcha\TekinTCaptcha($aid,$AppSecretKey);
 68 | $resp = $recaptcha->verify($Ticket, $Randstr, $UserIP);
 69 | if ($resp->isSuccess()) {
 70 |     // verified!
 71 |     // if Domain Name Validation turned off don't forget to check hostname field
 72 |     // if($resp->getStatus() === 1) {  }
 73 | } else {
 74 |     $errors = $resp->getErrMsg();
 75 | }
 76 | ```
 77 | 
 78 | You can see an end-to-end working example in
 79 | [examples/index.html](examples/index.html)
 80 | [examples/login.php](examples/login.php)
 81 | 
 82 | # thinkphp5 demo
 83 | 
 84 | conposer require tekintian/tekintcaptcha
 85 | 
 86 | ```php
 87 | //腾讯验证码配置 for config.php / app.php
 88 |     'tenncent_cpatcha'     => [ 
 89 |         'aid' => '123456',
 90 |         'app_secret_key' => 'aaaaadfasdfdsfsdf**',
 91 |     ]
 92 | 
 93 | //for login.php
 94 |  public function login()
 95 |     {
 96 |        // 指定模板输出
 97 |         return $this->fetch('login');
 98 |     }
 99 |     public function doLogin(){
100 |          $post = input('param.'); // 获取全部参数
101 |         if (isset($post['Ticket']) && $post['Ticket'] !='' ) {
102 |             /*从tp5的配置文件中读取aid, AppSecretKey */
103 |             $aid=config('app.tenncent_cpatcha.aid');
104 |             $AppSecretKey=config('app.tenncent_cpatcha.app_secret_key');
105 |             /*实例化 TekinTCaptcha */
106 |             $captcha = new \TekinTCaptcha\TekinTCaptcha($aid,$AppSecretKey);
107 |             /*验证票据*/
108 |             $resp = $captcha->verify($post['Ticket'], $post['Randstr']);
109 |   
110 |             if ($resp->isSuccess()){
111 |                 //验证成功
112 |                 pp($post);
113 | 
114 |                 //验证成功end
115 |             }else{
116 |                 foreach ($resp->getErrMsg() as $msg) {
117 |                     echo '<kbd>' , $msg , '</kbd> ';
118 |                  }
119 |                 echo '<kbd>返回状态码：'. $resp->getStatus() .'</kbd> ';
120 |                 echo '<kbd>恶意等级：'. $resp->getEvilLevel() .'</kbd> ';
121 |             }
122 | 
123 |         }
124 | 
125 |     }
126 | ```
127 | 
128 | # 打赏赞助 Donate
129 | ![Donate with alipay](alipay_donate.jpg "支付宝打赏赞助, Donate with Alipay")


--------------------------------------------------------------------------------
/examples/login.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | // Initiate the autoloader. The file should be generated by Composer.
 4 | // You will provide your own autoloader or require the files directly if you did
 5 | // not install via Composer.
 6 | require_once __DIR__ . '/../src/autoload.php';
 7 | 
 8 | // Register API keys at https://007.qq.com
 9 | $aid = '2050171219';
10 | $AppSecretKey = '0rcAq-BAGv4XFVeN7sRA81Q**';
11 | 
12 | ?>
13 | <html>
14 | <head>
15 | <meta http-equiv="Content-Type" content="text/html; charset=UTF-8"/>
16 | <title>TekinTCaptcha Example</title>
17 | <style type="text/css">
18 | body {
19 |     margin: 1em 5em 0 5em;
20 |     font-family: sans-serif;
21 | }
22 | fieldset {
23 |     display: inline;
24 |     padding: 1em;
25 | }
26 | </style>
27 | </head>
28 | <body>
29 | <h1>TekinTCaptcha Example</h1>
30 | <?php if ($aid === '' || $AppSecretKey === ''): ?>
31 |     <h2>Add your keys</h2>
32 |     <p>If you do not have keys already then visit <kbd>
33 |     <a href = "https://007.qq.com">
34 |         https://007.qq.com</a></kbd> to generate them.
35 | Edit this file and set the respective keys in <kbd>$aid</kbd> and
36 | <kbd>$AppSecretKey</kbd>. Reload the page after this.</p>
37 | <?php
38 | elseif (isset($_POST['Ticket']) && $_POST['Ticket']!=''):
39 | // The POST data here is unfiltered because this is an example.
40 | // In production, *always* sanitise and validate your input'
41 | ?>
42 |     <h2><kbd>POST</kbd> data</h2>
43 |     <kbd><pre><?php var_export($_POST); ?></pre></kbd>
44 |     <?php
45 |     // If the form submission includes the "g-captcha-response" field
46 |     // Create an instance of the service using your AppSecretKey
47 |     $TekinTCaptcha = new \TekinTCaptcha\TekinTCaptcha($aid,$AppSecretKey, new \TekinTCaptcha\RequestMethod\SocketPost());
48 | 
49 |     // If file_get_contents() is locked down on your PHP installation to disallow
50 |     // its use with URLs, then you can use the alternative request method instead.
51 |     // This makes use of fsockopen() instead.
52 |     //  $TekinTCaptcha = new \TekinTCaptcha\TekinTCaptcha($AppSecretKey, new \TekinTCaptcha\RequestMethod\SocketPost());
53 | 
54 |     // Make the call to verify the response and also pass the user's IP address
55 |     $resp = $TekinTCaptcha->verify($_POST['Ticket'], $_POST['Randstr']);
56 |   
57 |     if ($resp->isSuccess()):
58 |     // If the response is a success, that's it!
59 |             ?>
60 |             <h2>Success!</h2>
61 |             <p>That's it. Everything is working. Go integrate this into your real project.</p>
62 |             <p><a href="/">Try again</a></p>
63 |             <?php
64 |     else:
65 | // If it's not successful, then one or more error codes will be returned.
66 |         ?>
67 |         <h2>Something went wrong</h2>
68 |         <p>The following error was returned:
69 |         
70 |          <?php
71 |            echo '<kbd>错误代码：' .$resp->getErrMsg(). '</kbd> ';
72 |                 echo '<kbd>返回状态码：'. $resp->getStatus() .'</kbd> ';
73 |                 echo '<kbd>恶意等级：'. $resp->getEvilLevel() .'</kbd> ';
74 |             ?>
75 |             </p>
76 |         <p>Check the error msg code reference blow <kbd>
77 |         <table data-v-5aad9cdc="" width="810" border="0" cellspacing="0" cellpadding="0"><tr data-v-5aad9cdc="" class="table-header"><td data-v-5aad9cdc="" rowspan="1">错误信息</td> <td data-v-5aad9cdc="" rowspan="1">详细说明</td> <td data-v-5aad9cdc="" rowspan="1">错误信息</td> <td data-v-5aad9cdc="" rowspan="1" class="col-4">详细说明</td></tr> <tr data-v-5aad9cdc="" class="odd"><td data-v-5aad9cdc="" rowspan="1">OK</td> <td data-v-5aad9cdc="" rowspan="1">验证通过</td> <td data-v-5aad9cdc="" rowspan="1">cmd no match</td> <td data-v-5aad9cdc="" rowspan="1" class="col-4">验证码系统命令号不匹配</td></tr> <tr data-v-5aad9cdc="" class="even"><td data-v-5aad9cdc="" rowspan="1">user code len error</td> <td data-v-5aad9cdc="" rowspan="1">验证码长度不匹配</td> <td data-v-5aad9cdc="" rowspan="1">uin no match</td> <td data-v-5aad9cdc="" rowspan="1" class="col-4">号码不匹配</td></tr> <tr data-v-5aad9cdc="" class="odd"><td data-v-5aad9cdc="" rowspan="1">captcha no match</td> <td data-v-5aad9cdc="" rowspan="1">验证码答案不匹配/Randstr参数不匹配</td> <td data-v-5aad9cdc="" rowspan="1">seq redirect</td> <td data-v-5aad9cdc="" rowspan="1" class="col-4">重定向验证</td></tr> <tr data-v-5aad9cdc="" class="even"><td data-v-5aad9cdc="" rowspan="1">verify timeout</td> <td data-v-5aad9cdc="" rowspan="1">验证码签名超时</td> <td data-v-5aad9cdc="" rowspan="1">opt no vcode</td> <td data-v-5aad9cdc="" rowspan="1" class="col-4">操作使用pt免验证码校验错误</td></tr> <tr data-v-5aad9cdc="" class="odd"><td data-v-5aad9cdc="" rowspan="1">Sequnce repeat</td> <td data-v-5aad9cdc="" rowspan="1">验证码签名重放</td> <td data-v-5aad9cdc="" rowspan="1">diff</td> <td data-v-5aad9cdc="" rowspan="1" class="col-4">差别，验证错误</td></tr> <tr data-v-5aad9cdc="" class="even"><td data-v-5aad9cdc="" rowspan="1">Sequnce invalid</td> <td data-v-5aad9cdc="" rowspan="1">验证码签名序列</td> <td data-v-5aad9cdc="" rowspan="1">captcha type not match</td> <td data-v-5aad9cdc="" rowspan="1" class="col-4">验证码类型与拉取时不一致</td></tr> <tr data-v-5aad9cdc="" class="odd"><td data-v-5aad9cdc="" rowspan="1">Cookie invalid</td> <td data-v-5aad9cdc="" rowspan="1">验证码cookie信息不合法</td> <td data-v-5aad9cdc="" rowspan="1">verify type error</td> <td data-v-5aad9cdc="" rowspan="1" class="col-4">验证类型错误</td></tr> <tr data-v-5aad9cdc="" class="even"><td data-v-5aad9cdc="" rowspan="1">verify ip no match</td> <td data-v-5aad9cdc="" rowspan="1">ip不匹配</td> <td data-v-5aad9cdc="" rowspan="1">invalid pkg</td> <td data-v-5aad9cdc="" rowspan="1" class="col-4">非法请求包</td></tr> <tr data-v-5aad9cdc="" class="odd"><td data-v-5aad9cdc="" rowspan="1">decrypt fail</td> <td data-v-5aad9cdc="" rowspan="1">验证码签名解密失败</td> <td data-v-5aad9cdc="" rowspan="1">bad visitor</td> <td data-v-5aad9cdc="" rowspan="1" class="col-4">策略拦截</td></tr> <tr data-v-5aad9cdc="" class="even table-bottom"><td data-v-5aad9cdc="" rowspan="1">appid no match</td> <td data-v-5aad9cdc="" rowspan="1">验证码强校验appid错误</td> <td data-v-5aad9cdc="" rowspan="1">system busy</td> <td data-v-5aad9cdc="" rowspan="1" class="col-4">系统内部错误</td></tr> <tr data-v-5aad9cdc="" class="odd table-bottom"><td data-v-5aad9cdc="" rowspan="1">param err</td> <td data-v-5aad9cdc="" rowspan="1">AppSecretKey参数校验错误</td> <td data-v-5aad9cdc="" rowspan="1"></td> <td data-v-5aad9cdc="" rowspan="1" class="col-4"></td></tr></table>
78 | 
79 |         </kbd> 验证失败，查看并检查配置参数信息。</p>
80 |         <p><a href="/">Try again</a></p>
81 |     <?php endif; ?>
82 | <?php endif; ?>
83 | </body>
84 | </html>
85 | 


--------------------------------------------------------------------------------