Captcha

كلمة التحقق

تثبيت

مع الملحن :

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

الاستخدام

يمكنك إنشاء كلمة التحقق باستخدام 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 إذا كان من الممكن قراءة التعرف الضوئي على الحروف باستخدام برنامج 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) ، يحفظ رمز التحقق في ملف jpeg في اسم الملف $، بالجودة المحددة
• get($quality = 80) ، يُرجع بيانات jpeg
• output($quality = 80) ، يقوم بإخراج كود jpeg مباشرةً إلى المتصفح
• setBackgroundColor($r, $g, $b) ، يضبط لون الخلفية لفرضه (سيؤدي هذا إلى تعطيل العديد من التأثيرات ولا يوصى به)
• setBackgroundImages(array($imagepath1, $imagePath2)) يضبط صور الخلفية المخصصة لاستخدامها كخلفية captcha. يوصى بتعطيل تأثيرات الصورة عند تمرير صور مخصصة للخلفية (ignore_all_effets). يتم اختيار صورة عشوائية من القائمة التي تم تمريرها، ويجب تمرير المسارات الكاملة لملفات الصور.
• 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

رخصة

هذه المكتبة خاضعة لترخيص معهد ماساتشوستس للتكنولوجيا، ألق نظرة على ملف LICENSE