Captcha

แคปช่า

การติดตั้ง

โดยมีผู้แต่ง :

{
    ...
    "require" : {
        "gregwar/captcha" : " 1.* "
    }
}

การใช้งาน

คุณสามารถสร้าง captcha ด้วย CaptchaBuilder :

 <?php

use Gregwar  Captcha  CaptchaBuilder ;

$ builder = new CaptchaBuilder ;
$ builder -> build ();

จากนั้นคุณสามารถบันทึกลงในไฟล์:

 <?php

$ builder -> save ( ' out.jpg ' );

หรือส่งออกโดยตรง:

 <?php

header ( ' Content-type: image/jpeg ' );
$ builder -> output ();

หรืออินไลน์โดยตรงในหน้า HTML:

<img src=" <?php echo $ builder->inline(); ?> " />

คุณจะสามารถรับโค้ดและเปรียบเทียบกับอินพุตของผู้ใช้:

 <?php

// Example: storing the phrase in the session to test for the user 
// input later
$ _SESSION [ ' phrase ' ] = $ builder -> getPhrase ();

คุณสามารถเปรียบเทียบวลีกับการป้อนข้อมูลของผู้ใช้:

 if ( $ builder -> testPhrase ( $ userInput )) {
    // instructions if user phrase is good
}
else {
    // user phrase is wrong
}

เอพีไอ

คุณสามารถใช้ฟังก์ชันวิทยานิพนธ์:

• __construct($phrase = null) สร้างตัวสร้างด้วยวลีที่กำหนด หากวลีนั้นเป็นโมฆะ ระบบจะสร้างวลีแบบสุ่มขึ้นมา
• getPhrase() ช่วยให้คุณสามารถรับเนื้อหาวลีได้
• setDistortion($distortion) , เปิดหรือปิดใช้งานการบิดเบือน เรียกมันก่อน build()
• isOCRReadable() คืนค่า true หาก OCR สามารถอ่านได้โดยใช้ซอฟต์แวร์ ocrad คุณจะต้องเปิดใช้งาน shell_exec ติดตั้ง imagemagick และ ocrad
• buildAgainstOCR($width = 150, $height = 40, $font = null) สร้างโค้ดจนกระทั่ง ocrad ไม่สามารถอ่านได้
• build($width = 150, $height = 40, $font = null) สร้างโค้ดด้วย $width, $height และ $font ที่กำหนด ตามค่าเริ่มต้น แบบอักษรแบบสุ่มจะถูกใช้จากไลบรารี
• save($filename, $quality = 80) บันทึก captcha ลงใน jpeg ใน $filename ด้วยคุณภาพที่กำหนด
• get($quality = 80) ส่งคืนข้อมูล jpeg
• output($quality = 80) ส่งออกโค้ด jpeg ไปยังเบราว์เซอร์โดยตรง
• setBackgroundColor($r, $g, $b) , ตั้งค่าสีพื้นหลังเพื่อบังคับ (ซึ่งจะปิดการใช้งานเอฟเฟกต์จำนวนมากและไม่แนะนำ)
• setBackgroundImages(array($imagepath1, $imagePath2)) , ตั้งค่าภาพพื้นหลังที่กำหนดเองเพื่อใช้เป็นพื้นหลัง captcha ขอแนะนำให้ปิดการใช้งานเอฟเฟ็กต์รูปภาพเมื่อส่งรูปภาพที่กำหนดเองสำหรับพื้นหลัง (ignore_all_effects) รูปภาพแบบสุ่มถูกเลือกจากรายการที่ส่งผ่าน โดยจะต้องส่งพาธแบบเต็มไปยังไฟล์รูปภาพ
• setInterpolation($interpolate) , เปิดหรือปิดการใช้งานการแก้ไข (เปิดใช้งานโดยค่าเริ่มต้น) การปิดใช้งานจะเร็วขึ้น แต่รูปภาพจะดูน่าเกลียดกว่า
• setIgnoreAllEffects($ignoreAllEffects) ปิดการใช้งานเอฟเฟกต์ทั้งหมดบนภาพ captcha แนะนำให้ใช้เมื่อส่งภาพพื้นหลังที่กำหนดเองสำหรับแคปช่า
• testPhrase($phrase) คืนค่าเป็นจริงหากวลีที่กำหนดนั้นดี
• setMaxBehindLines($lines) ตั้งค่าจำนวนบรรทัดสูงสุดที่อยู่ด้านหลังโค้ด
• setMaxFrontLines($lines) กำหนดจำนวนบรรทัดสูงสุดที่ด้านหน้าของโค้ด

หากคุณต้องการเปลี่ยนจำนวนอักขระ คุณสามารถเรียกใช้ตัวสร้างวลีได้โดยตรงโดยใช้พารามิเตอร์เพิ่มเติม:

 use Gregwar  Captcha  CaptchaBuilder ;
use Gregwar  Captcha  PhraseBuilder ;

// Will build phrases of 3 characters
$ phraseBuilder = new PhraseBuilder ( 4 );

// Will build phrases of 5 characters, only digits
$ phraseBuilder = new PhraseBuilder ( 5 , ' 0123456789 ' );

// Pass it as first argument of CaptchaBuilder, passing it the phrase
// builder
$ captcha = new CaptchaBuilder ( null , $ phraseBuilder );

คุณยังสามารถส่งวลีที่ต้องการไปยังผู้สร้างได้โดยตรง:

 // Building a Captcha with the "hello" phrase
$ captcha = new CaptchaBuilder ( ' hello ' );

ตัวอย่างที่สมบูรณ์

หากคุณต้องการดูตัวอย่าง คุณสามารถดู demo/form.php ซึ่งใช้ demo/session.php เพื่อเรนเดอร์ captcha และตรวจสอบหลังจากการส่ง

ชุดซิมโฟนี

คุณสามารถดูพื้นที่เก็บข้อมูลต่อไปนี้เพื่อเพลิดเพลินไปกับชุดรวม Symfony 2 ที่บรรจุตัวสร้าง captcha นี้: https://github.com/Gregwar/CaptchaBundle

ส่วนขยาย Yii2

คุณสามารถใช้ส่วนขยายต่อไปนี้เพื่อรวมเข้ากับ Yii2 Framework : https://github.com/juliardi/yii2-captcha

ใบอนุญาต

ไลบรารีนี้อยู่ภายใต้ลิขสิทธิ์ของ MIT โปรดดูไฟล์ LICENSE