หน้าแรก>ซอร์สโค้ด 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 Client และ Nyholm PSR-7
        • การค้นพบไคลเอนต์ http
    • คีย์ลับ
    • คีย์ idempotency
    • ตรวจสอบ
    • การตอบสนอง
    • รหัสข้อผิดพลาดในการอธิบาย

การติดตั้ง 

 composer require usarise/turnstile

เริ่มต้น

การติดตั้ง Symfony HTTP Client และ Nyholm PSR7 และ USARISE Turnstile 

 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 Client และ Nyholm PSR-7

การติดตั้ง nyholm psr7 และ php http curl client 
 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 ,
);

การค้นพบไคลเอนต์ http

การติดตั้ง PHP http discovery 
 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 ภายใต้ Turnstile

กุญแจจริง

API Keys ที่ 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

หากแอปพลิเคชันต้องการให้ลองคำขอที่ล้มเหลวอีกครั้งจะต้องใช้ฟังก์ชันการทำงานของ 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 ()

คัดค้านอาร์เรย์

อาร์เรย์ของข้อมูล JSON ที่ประมวลผลตามคุณสมบัติของคลาส Response : success , errorCodes , challengeTs , hostname , action , cdata 

 $ response -> toArray (strict: true )

รหัสข้อผิดพลาดในการใช้คำอธิบาย

แปลงรหัสข้อผิดพลาดเป็นคำอธิบายในภาษาที่เหมาะสม (ภาษาอังกฤษเริ่มต้น) 

 use Turnstile  Error { Code , Description };

var_dump (
    Code:: toDescription (
        codes: $ response -> errorCodes ,
        descriptions: Description:: TEXTS , // Default
    ),
);
ขยาย
ข้อมูลเพิ่มเติม
แอปที่เกี่ยวข้อง
แนะนำสำหรับคุณ
ข้อมูลที่เกี่ยวข้อง ทั้งหมด