{"id":27777808,"url":"https://github.com/zemasterkrom/zmkr-cloudflare-turnstile-bundle","last_synced_at":"2025-04-30T07:12:00.633Z","repository":{"id":204532261,"uuid":"712077055","full_name":"Zemasterkrom/zmkr-cloudflare-turnstile-bundle","owner":"Zemasterkrom","description":"Extensible and configurable integration of Cloudflare Turnstile with Symfony","archived":false,"fork":false,"pushed_at":"2025-02-26T21:58:59.000Z","size":155,"stargazers_count":7,"open_issues_count":0,"forks_count":1,"subscribers_count":1,"default_branch":"main","last_synced_at":"2025-04-30T07:11:54.284Z","etag":null,"topics":["anti-spam","bundle","captcha","cloudflare","form","security","symfony","turnstile"],"latest_commit_sha":null,"homepage":"","language":"PHP","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/Zemasterkrom.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2023-10-30T18:40:23.000Z","updated_at":"2025-03-10T11:21:17.000Z","dependencies_parsed_at":"2023-11-25T01:25:04.664Z","dependency_job_id":"beff8e85-2bb5-4be7-8b4d-4f4c03ffdedc","html_url":"https://github.com/Zemasterkrom/zmkr-cloudflare-turnstile-bundle","commit_stats":null,"previous_names":["zemasterkrom/cf-turnstile-bundle","zemasterkrom/cloudflare-turnstile-bundle","zemasterkrom/zmkr-cloudflare-turnstile-bundle"],"tags_count":4,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Zemasterkrom%2Fzmkr-cloudflare-turnstile-bundle","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Zemasterkrom%2Fzmkr-cloudflare-turnstile-bundle/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Zemasterkrom%2Fzmkr-cloudflare-turnstile-bundle/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Zemasterkrom%2Fzmkr-cloudflare-turnstile-bundle/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/Zemasterkrom","download_url":"https://codeload.github.com/Zemasterkrom/zmkr-cloudflare-turnstile-bundle/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":251658213,"owners_count":21622822,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["anti-spam","bundle","captcha","cloudflare","form","security","symfony","turnstile"],"created_at":"2025-04-30T07:11:59.844Z","updated_at":"2025-04-30T07:12:00.626Z","avatar_url":"https://github.com/Zemasterkrom.png","language":"PHP","funding_links":[],"categories":[],"sub_categories":[],"readme":"ZmkrCloudflareTurnstileBundle\n=============================\n\n[![CI Status](https://github.com/zemasterkrom/zmkr-cloudflare-turnstile-bundle/actions/workflows/ci.yaml/badge.svg)](https://github.com/zemasterkrom/zmkr-cloudflare-turnstile-bundle/actions)\n[![codecov](https://codecov.io/gh/zemasterkrom/zmkr-cloudflare-turnstile-bundle/graph/badge.svg)](https://codecov.io/gh/Zemasterkrom/zmkr-cloudflare-turnstile-bundle/)\n\nRequires **Symfony `\u003e= 5.0`** and **PHP `\u003e= 7.4`**. Tested up to **Symfony 7**.\n\nThe purpose of this bundle is to facilitate the configuration and integration of the **Cloudflare Turnstile** captcha system into **Symfony** forms.\n\nSummary of features provided:\n- Automatic captcha rendering, language configuration and validation\n- Timeout management\n- Client-side error domain management\n- reCAPTCHA / hCaptcha compatibility mode\n- Possibility of using custom JavaScript rendering logic\n- Possibility of marking captchas as required\n\nGet started\n-----------\n\n### With Symfony Flex\n\nRun the following command with **Composer**:\n\n`composer require zemasterkrom/zmkr-cloudflare-turnstile-bundle`\n\nIf you have not explicitly allowed \"contrib\" recipes in your *composer.json* file, you will be prompted with the following message for `zemasterkrom/zmkr-cloudflare-turnstile-bundle`:\n\n\u003e Do you want to execute this recipe?\n\nAnswer **yes** for `zemasterkrom/zmkr-cloudflare-turnstile-bundle`.\n\nFinally, modify the `zemasterkrom/zmkr-cloudflare-turnstile-bundle` section of the `.env` file to add your **Cloudflare Turnstile** application keys:\n\n```\n###\u003e zemasterkrom/zmkr-cloudflare-turnstile-bundle ###\nCLOUDFLARE_TURNSTILE_SITEKEY=\u003csitekey\u003e\nCLOUDFLARE_TURNSTILE_SECRET_KEY=\u003csecret_key\u003e\n###\u003c zemasterkrom/zmkr-cloudflare-turnstile-bundle ###\n```\n\n### Without Symfony Flex\n\nInstall **Composer** dependencies:\n\n`composer require zemasterkrom/zmkr-cloudflare-turnstile-bundle`\n\nRegister the bundle inside the `config/bundles.php` file:\n\n```php\nreturn [\n    //...\n    Zemasterkrom\\CloudflareTurnstileBundle\\ZmkrCloudflareTurnstileBundle::class =\u003e ['all' =\u003e true],\n];\n```\n\nCreate the `config/packages/zmkr_cloudflare_turnstile.yaml` configuration file:\n\n```yaml\nzmkr_cloudflare_turnstile:\n    captcha:\n        sitekey: \"%env(CLOUDFLARE_TURNSTILE_SITEKEY)%\"\n        secret_key: \"%env(CLOUDFLARE_TURNSTILE_SECRET_KEY)%\"\n```\n\nAdd your **Cloudflare Turnstile** application keys to the `.env` file:\n\n```\nCLOUDFLARE_TURNSTILE_SITEKEY=\u003csitekey\u003e\nCLOUDFLARE_TURNSTILE_SECRET_KEY=\u003csecret_key\u003e\n```\n\nUsage\n-----\n\nTo add a **Cloudflare Turnstile** captcha to a form, you need to associate a `CloudflareTurnstileType` field in your form builder:\n\n```php\n\u003c?php\n\nnamespace App\\Form\\Type;\n\nuse Symfony\\Component\\Form\\AbstractType;\nuse Symfony\\Component\\Form\\Extension\\Core\\Type\\TextType;\nuse Symfony\\Component\\Form\\FormBuilderInterface;\nuse Zemasterkrom\\CloudflareTurnstileBundle\\Form\\Type\\CloudflareTurnstileType;\n\nclass ContactType extends AbstractType\n{\n    public function buildForm(FormBuilderInterface $builder, array $options): void\n    {\n        $builder\n            -\u003eadd('first_name', TextType::class, [\n                'label' =\u003e 'First name'\n            ])\n            -\u003eadd('last_name', TextType::class, [\n                'label' =\u003e 'Last name'\n            ])\n            -\u003eadd('cf_turnstile_response', CloudflareTurnstileType::class);\n    }\n}\n```\n\nValidation will be performed automatically when you check the form that is associated with a ``CloudflareTurnstileType``:\n\n```php\n\u003c?php\n\nnamespace App\\Controller;\n\nuse App\\Form\\Type\\ContactType;\nuse Symfony\\Bundle\\FrameworkBundle\\Controller\\AbstractController;\nuse Symfony\\Component\\HttpFoundation\\Request;\nuse Symfony\\Component\\HttpFoundation\\Response;\n\nclass CloudflareTurnstileTestController extends AbstractController\n{\n    public function validateContactForm(Request $request): Response\n    {\n        $form = $this-\u003ecreateForm(ContactType::class);\n        $form-\u003ehandleRequest($request);\n\n        if ($form-\u003eisSubmitted() \u0026\u0026 $form-\u003eisValid()) {\n            // The form has been submitted and is valid: execute your actions here\n        }\n\n        // The form has not been submitted or is invalid: if there is an error, an error message will be registered in your form\n        return $this-\u003erender('\u003ctwig_template_path\u003e', [\n            'form' =\u003e $form-\u003ecreateView(),\n        ]);\n    }\n}\n```\n\nDocumentation\n-------------\nFor advanced usage, please see the [documentation](docs/index.md).\n\nLicense\n-------\nThis bundle is licensed under the MIT license. The license is accessible [here](LICENSE).\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fzemasterkrom%2Fzmkr-cloudflare-turnstile-bundle","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fzemasterkrom%2Fzmkr-cloudflare-turnstile-bundle","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fzemasterkrom%2Fzmkr-cloudflare-turnstile-bundle/lists"}