首頁>PHP源碼>其他類別
下載

旋轉門PHP客戶庫

啟發在recaptcha上

目錄

  1. 安裝
  2. 入門
  3. 用法
    • 旋轉門
    • 客戶
      • 示例HTTP客戶端
        • guzzle http客戶端
        • Symfony HTTP客戶端和NYHOLM PSR-7
        • Symfony HTTP客戶端和Guzzle PSR-7
        • Symfony HTTP客戶端和Guzzle PSR-7和Discovery
        • Curl HTTP客戶端和NYHOLM PSR-7
        • Discovery HTTP客戶端
    • 秘密鑰匙
    • 掌鍵密鑰
    • 核實
    • 回覆
    • 錯誤代碼到描述

安裝

 composer require usarise/turnstile

入門

安裝Symfony HTTP客戶端和NYHOLM PSR7和USARISE旋轉門

 composer require symfony/http-client nyholm/psr7 usarise/turnstile

Turnstileexample.php 

 <?php

declare (strict_types= 1 );

require_once __DIR__ . ' /vendor/autoload.php ' ;

use Symfony  Component  HttpClient  Psr18Client ;
use Turnstile  Error  Code ;
use Turnstile  Turnstile ;

// Get real API keys at https://dash.cloudflare.com/?to=/:account/turnstile
$ siteKey = ' 1x00000000000000000000AA ' ; // Always passes (Dummy Testing)
$ secretKey = ' 1x0000000000000000000000000000000AA ' ; // Always passes (Dummy Testing)

if ( $ token = $ _POST [ ' cf-turnstile-response ' ] ?? null ) {
    $ turnstile = new Turnstile (
        client: new Psr18Client (),
        secretKey: $ secretKey ,
    );

    $ response = $ turnstile -> verify (
        $ token , // The response provided by the Turnstile client-side render on your site.
        $ _SERVER [ ' REMOTE_ADDR ' ], // With usage CloudFlare: $_SERVER['HTTP_CF_CONNECTING_IP']
    );

    if ( $ response -> success ) {
        echo ' Success! ' ;
    } else {
        $ errors = $ response -> errorCodes ;
        var_dump ( $ errors );
        var_dump (Code:: toDescription ( $ errors ));
    }

    exit ;
}
?>
<!DOCTYPE html>
<html lang="en">
<head>
  <meta charset="UTF-8" />
  <title>Turnstile example</title>
  <script src="https://challenges.cloudflare.com/turnstile/v0/api.js" async defer></script>
</head>
<body>
<form action="" method="POST">
  <!-- The following line controls and configures the Turnstile widget. -->
  <div class="cf-turnstile" data-sitekey=" <?php echo $ siteKey ; ?> " data-theme="light"></div>
  <!-- end. -->
  <button type="submit" value="Submit">Verify</button>
</form>
</body>
</html>

對字符串的響應

 var_dump (( string ) $ response );

對數組的響應

 var_dump ( $ response -> toArray ());

響應對像對數組

 var_dump ( $ response -> toArray (strict: true ));

使用Turnstile

構造

 use Turnstile  Client  Client ;
use Turnstile  Turnstile ;

$ turnstile = new Turnstile (
    client: new Client (...),
    secretKey: ' secret key ' ,
    idempotencyKey: ' idempotency key ' ,
);

簡化的結構

PSR-18客戶，例如php-http/discovery 

 $ turnstile = new Turnstile (
    client: new Psr18Client (),
    secretKey: ' secret key ' ,
    idempotencyKey: ' idempotency key ' ,
);

使用Client

構造

 use Turnstile  Client  Client ;
use Turnstile  TurnstileInterface ;

$ client = new Client (
    client: ..., // implementation PsrHttpClientClientInterface
    requestFactory: ..., // implementation PsrHttpMessageRequestFactoryInterface (default: requestFactory = client)
    streamFactory: ..., // implementation PsrHttpMessageStreamFactoryInterface (default: streamFactory = requestFactory)
    siteVerifyUrl: TurnstileInterface:: SITE_VERIFY_URL , // https://challenges.cloudflare.com/turnstile/v0/siteverify (default)
);

示例HTTP客戶端

guzzle http客戶端

安裝
 composer require guzzlehttp/guzzle
用法
 use GuzzleHttp  Client as GuzzleHttpClient ;
use GuzzleHttp  Psr7  HttpFactory ;
use Turnstile  Client  Client ;

$ client = new Client (
    new GuzzleHttpClient (),
    new HttpFactory (),
);

Symfony HTTP客戶端和NYHOLM PSR-7

安裝Symfony HTTP客戶端和NYHOLM PSR7 
 composer require symfony/http-client nyholm/psr7
用法
 use Symfony  Component  HttpClient  Psr18Client ;
use Turnstile  Client  Client ;

$ client = new Client (
    new Psr18Client (),
);
簡化的結構
 use Symfony  Component  HttpClient  Psr18Client ;

$ client = new Psr18Client ();

Symfony HTTP客戶端和Guzzle PSR-7

安裝Symfony HTTP客戶端和GuzzlehTTP PSR7 
 composer require symfony/http-client guzzlehttp/psr7
用法
 use GuzzleHttp  Psr7  HttpFactory ;
use Symfony  Component  HttpClient  Psr18Client ;
use Turnstile  Client  Client ;

$ client = new Client (
    new Psr18Client (
        responseFactory: new HttpFactory (),
    ),
);
簡化的結構
 use GuzzleHttp  Psr7  HttpFactory ;
use Symfony  Component  HttpClient  Psr18Client ;

$ client = new Psr18Client (
    responseFactory: new HttpFactory (),
);

Symfony HTTP客戶端和Guzzle PSR-7和Discovery

安裝Symfony HTTP客戶端和GuzzlehTTP PSR7和PHP HTTP Discovery 
 composer require symfony/http-client guzzlehttp/psr7 php-http/discovery
用法
 use Symfony  Component  HttpClient  Psr18Client ;
use Turnstile  Client  Client ;

$ client = new Client (
    new Psr18Client (),
);
簡化的結構
 use Symfony  Component  HttpClient  Psr18Client ;

$ client = new Psr18Client ();

Curl HTTP客戶端和NYHOLM PSR-7

安裝NYHOLM PSR7和PHP HTTP捲髮客戶端
 composer require nyholm/psr7 php-http/curl-client
用法
 use Http  Client  Curl  Client as CurlClient ;
use Nyholm  Psr7  Factory  Psr17Factory ;
use Turnstile  Client  Client ;

$ psr17Factory = new Psr17Factory ();

$ client = new Client (
    client: new CurlClient (
        responseFactory: $ psr17Factory ,
        streamFactory: $ psr17Factory ,
    ),
    requestFactory: $ psr17Factory ,
);

Discovery HTTP客戶端

安裝PHP HTTP發現
 composer require php-http/discovery
用法
 use Http  Discovery  Psr18Client ;
use Turnstile  Client  Client ;

$ client = new Client (
    new Psr18Client (),
);
簡化的結構
 use Http  Discovery  Psr18Client ;

$ client = new Psr18Client ();

用法秘密鍵

小部件的秘密鑰匙。秘密鍵可以在旋轉門下的Cloudflare儀表板中的小部件設置下找到。

真正的鑰匙

API鍵https://dash.cloudflare.com/?to=/:account/turnstile

測試鍵

1x0000000000000000000000000000000AA總是通過

2x0000000000000000000000000000000AA總是失敗的

3x0000000000000000000000000000000AA產生“已花費的令牌”錯誤

例子

 use Turnstile  Client  Client ;
use Turnstile  Turnstile ;

// Real API keys at https://dash.cloudflare.com/?to=/:account/turnstile
$ secretKey = ' 1x0000000000000000000000000000000AA ' ;

$ turnstile = new Turnstile (
    client: $ client ,
    secretKey: $ secretKey ,
);

使用型勢力鍵

如果應用程序需要重試失敗的請求，則必須利用IDEMPOTENCY功能。

您可以通過提供uuid作為idempotencyKey參數，然後使用$turnstile->verify(...)使用相同的標記使用所需的次數。

Ramsey Uuid的示例

安裝
 composer require ramsey/uuid
用法
 use Ramsey  Uuid  Uuid ;
use Turnstile  Client  Client ;
use Turnstile  Turnstile ;

$ turnstile = new Turnstile (
    client: $ client ,
    secretKey: $ secretKey , // The site’s secret key.
    idempotencyKey: ( string ) Uuid:: uuid4 (), // The UUID to be associated with the response.
);

$ response = $ turnstile -> verify (
    $ token , // The response that will be associated with the UUID (idempotencyKey)
);

if ( $ response -> success ) {
    // ...
}

$ response = $ turnstile -> verify (
    $ token , // The response associated with UUID (idempotencyKey)
);

if ( $ response -> success ) {
    // ...
}

用法驗證

樣本

 $ response = $ turnstile -> verify (
    token: $ _POST [ ' cf-turnstile-response ' ], // The response provided by the Turnstile client-side render on your site.
);

遠程IP

通過確保當前訪問者是接收令牌的訪問者， remoteIp參數有助於防止濫用。

目前尚未嚴格驗證。

基本用法
 $ response = $ turnstile -> verify (
    token: $ _POST [ ' cf-turnstile-response ' ], // The response provided by the Turnstile client-side render on your site.
    remoteIp: $ _SERVER [ ' REMOTE_ADDR ' ], // The visitor’s IP address.
);
使用Cloudflare 
 $ response = $ turnstile -> verify (
    token: $ _POST [ ' cf-turnstile-response ' ], // The response provided by the Turnstile client-side render on your site.
    remoteIp: $ _SERVER [ ' HTTP_CF_CONNECTING_IP ' ], // The visitor’s IP address.
);

擴展

 $ response = $ turnstile -> verify (
    ...
    challengeTimeout: 300 , // Number of allowed seconds after the challenge was solved.
    expectedHostname: $ _SERVER [ ' SERVER_NAME ' ], // Expected hostname for which the challenge was served.
    expectedAction: ' login ' , // Expected customer widget identifier passed to the widget on the client side.
    expectedCdata: ' sessionid-123456789 ' , // Expected customer data passed to the widget on the client side.
);

用法響應

成功狀態

 $ response -> success

錯誤代碼

 $ response -> errorCodes

挑戰時間戳

 $ response -> challengeTs

主機名

 $ response -> hostname

行動

 $ response -> action

客戶數據

 $ response -> cdata

到字符串

帶有原始JSON數據的字符串

( string ) $ response

到達數組

解碼的JSON數據

 $ response -> toArray ()

對像數組

基於Response類的屬性： success ， errorCodes ， challengeTs ， hostname ， action ， cdata一系列處理的JSON數據數組

 $ response -> toArray (strict: true )

使用錯誤代碼到描述

將錯誤代碼轉換為使用合適語言的描述（默認英語） 

 use Turnstile  Error { Code , Description };

var_dump (
    Code:: toDescription (
        codes: $ response -> errorCodes ,
        descriptions: Description:: TEXTS , // Default
    ),
);
展開
附加信息
相關應用
爲您推薦
相關資訊 全部