setono/bot-detection-bundle

A Symfony bundle that allows you to test if a user agent is a bot

v1.13.0 2025-02-03 09:33 UTC

Requires

• php: >=7.4
• symfony/config: ^5.4 || ^6.4 || ^7.0
• symfony/dependency-injection: ^5.4 || ^6.4 || ^7.0
• symfony/http-foundation: ^5.4 || ^6.4 || ^7.0
• symfony/http-kernel: ^5.4 || ^6.4 || ^7.0
• twig/twig: ^2.14 || ^3.4

Requires (Dev)

• infection/infection: ^0.26.6 || ^0.27.0
• matomo/device-detector: ^5.0 || ^6.0
• matthiasnoback/symfony-dependency-injection-test: ^4.3 || ^5.1
• nette/php-generator: ^3.6 || ^4.1
• phpspec/prophecy-phpunit: ^2.0
• phpunit/phpunit: ^9.6
• psalm/plugin-phpunit: ^0.18
• setono/code-quality-pack: ^2.9
• shipmonk/composer-dependency-analyser: ^1.8
• symfony/console: ^5.4 || ^6.4 || ^7.0
• symfony/yaml: ^5.4 || ^6.4 || ^7.0
• webmozart/assert: ^1.11

MIT

• Joachim Løvgaard

README

Detect if the user agent is a bot and act upon it. Under the hood this bundle uses the matomo-org/device-detector, but instead of just using that library this library has a very small subset of user agents that it checks first (i.e. major search engines). This makes it much faster in detecting those very common bots and hence speeds up your request cycle.

Installation

composer require setono/bot-detection-bundle

This installs and enables the plugin automatically if you're using Symfony Flex. If not, add the bundle manually to bundles.php.

Usage

You can use the bot detector in your services:

<?php

use Setono\BotDetectionBundle\BotDetector\BotDetectorInterface;

final class YourService
{
    private BotDetectorInterface $botDetector;

    public function __construct(BotDetectorInterface $botDetector)
    {
        $this->botDetector = $botDetector;
    }

    public function yourAction(): void
    {
        if ($this->botDetector->isBotRequest()) {
            // do something to this bot!
        }

        // ...
    }
}

and you can use it inside your twig templates:

{% if is_bot_request() %}
    I knew you where a bot!
{% endif %}