newscoop / recaptcha-bundle
此扩展包提供了简单的reCAPTCHA表单字段集成,这是https://github.com/excelwebzone/EWZRecaptchaBundle的分支。
Requires
This package is not auto-updated.
Last update: 2024-09-24 06:31:39 UTC
README
此扩展包为Symfony提供了简单的reCAPTCHA表单字段。
还实现了Silex框架的桥梁:跳转到文档。
安装
步骤 1: 使用Composer并启用扩展包
使用Composer安装EWZRecaptchaBundle,只需将以下内容添加到您的composer.json
文件中
// composer.json { // ... "require": { // ... "excelwebzone/recaptcha-bundle": "dev-master" } }
注意:请将上面的片段中的dev-master
替换为最新的稳定分支,例如2.0.*
。
然后,您可以通过在您的composer.json
文件所在的目录中运行Composer的update
命令来安装新的依赖项。
$ php composer.phar update
现在,Composer将自动下载所有必需的文件,并为您安装它们。接下来,您只需更新您的AppKernel.php
文件,并注册新的扩展包。
<?php // in AppKernel::registerBundles() $bundles = array( // ... new EWZ\Bundle\RecaptchaBundle\EWZRecaptchaBundle(), // ... );
步骤 2: 配置扩展包
将以下内容添加到您的配置文件中
# app/config/config.yml ewz_recaptcha: public_key: here_is_your_public_key private_key: here_is_your_private_key locale_key: %kernel.default_locale%
注意:此扩展包允许客户端浏览器选择安全的https或不安全的http API。
您可以轻松禁用reCAPTCHA(例如在本地或测试环境中)
# app/config/config.yml ewz_recaptcha: // ... enabled: false
恭喜!您已经准备好了!
基本用法
在创建新的表单类时,添加以下行以创建字段
<?php public function buildForm(FormBuilder $builder, array $options) { // ... $builder->add('recaptcha', 'ewz_recaptcha'); // ... }
您可以使用“attr > options”选项向reCAPTCHA传递额外的选项
<?php public function buildForm(FormBuilder $builder, array $options) { // ... $builder->add('recaptcha', 'ewz_recaptcha', array( 'attr' => array( 'options' => array( 'theme' => 'clean' ) ) )); // ... }
使用以下方法验证字段
<?php use EWZ\Bundle\RecaptchaBundle\Validator\Constraints as Recaptcha; /** * @Recaptcha\True */ public $recaptcha;
另一种方法是将验证约束作为FormType的选项传递。这样,您的数据类只包含有意义的属性。如果我们以上面的例子为例,buildForm方法将看起来像这样。请注意,如果将mapped=>false
设置,则注解将不起作用。您还必须设置constraints
<?php use EWZ\Bundle\RecaptchaBundle\Validator\Constraints\True; public function buildForm(FormBuilder $builder, array $options) { // ... $builder->add('recaptcha', 'ewz_recaptcha', array( 'attr' => array( 'options' => array( 'theme' => 'clean' ) ), 'mapped' => false, 'constraints' => array( new True() ) )); // ...
表单模板资源现在通过容器的扩展自动注册。然而,您始终可以实施您自己的自定义表单小部件。
PHP:
<?php $view['form']->setTheme($form, array('EWZRecaptchaBundle:Form')) ?> <?php echo $view['form']->widget($form['recaptcha'], array( 'attr' => array( 'options' => array( 'theme' => 'clean', ), ), )) ?>
Twig:
{% form_theme form 'EWZRecaptchaBundle:Form:ewz_recaptcha_widget.html.twig' %} {{ form_widget(form.recaptcha, { 'attr': { 'options' : { 'theme' : 'clean', }, } }) }}
如果您不使用表单,您仍然可以使用JavaScript实现reCAPTCHA字段。
PHP:
<div id="recaptcha-container"></div> <script type="text/javascript"> $(document).ready(function() { $.getScript("<?php echo \EWZ\Bundle\RecaptchaBundle\Form\Type\RecaptchaType::RECAPTCHA_API_JS_SERVER ?>", function() { Recaptcha.create("<?php echo $form['recaptcha']->get('public_key') ?>", "recaptcha-container", { theme: "clean", }); }); }; </script>
Twig:
<div id="recaptcha-container"></div> <script type="text/javascript"> $(document).ready(function() { $.getScript("{{ constant('\\EWZ\\Bundle\\RecaptchaBundle\\Form\\Type\\RecaptchaType::RECAPTCHA_API_JS_SERVER') }}", function() { Recaptcha.create("{{ form.recaptcha.get('public_key') }}", "recaptcha-container", { theme: "clean" }); }); }); </script>
自定义
如果您想使用自定义主题,请在设置主题之前放置您的代码块
<div id="recaptcha_widget"> <div id="recaptcha_image"></div> <div class="recaptcha_only_if_incorrect_sol" style="color:red">Incorrect please try again</div> <span class="recaptcha_only_if_image">Enter the words above:</span> <span class="recaptcha_only_if_audio">Enter the numbers you hear:</span> <input type="text" id="recaptcha_response_field" name="recaptcha_response_field" /> <div><a href="javascript:Recaptcha.reload()">Get another CAPTCHA</a></div> <div class="recaptcha_only_if_image"><a href="javascript:Recaptcha.switch_type('audio')">Get an audio CAPTCHA</a></div> <div class="recaptcha_only_if_audio"><a href="javascript:Recaptcha.switch_type('image')">Get an image CAPTCHA</a></div> <div><a href="javascript:Recaptcha.showhelp()">Help</a></div> </div> {% form_theme form 'EWZRecaptchaBundle:Form:ewz_recaptcha_widget.html.twig' %} {{ form_widget(form.recaptcha, { 'attr': { 'options' : { 'theme' : 'custom', }, } }) }}
进一步阅读:自定义reCAPTCHA的外观和感觉