elegisandi/iab-bot-detect

Validate user agent against IAB spiders & bot list

iab-bot-detect

Spider/Bot detection using IAB list, _(*1)

Installation

composer require elegisandi/iab-bot-detect

Laravel/Lumen Integration

• Add IAB's service provider to your config/app.php providers, _(*2)

  elegisandi\IABBotDetect\IabServiceProvider::class, _(*3)

• Add IAB's facade to your config/app.php aliases, _(*4)

  'IAB' => elegisandi\IABBotDetect\IabFacade::class, _(*5)

• Set IAB credentials in your .env file, _(*6)

  IAB_USER=your-iab-user
  IAB_PASSWORD=your-iab-password

If you want to modify the package config, just run:, _(*7)

php artisan vendor:publish --provider=elegisandi\\IABBotDetect\\IabServiceProvider

For Lumen:, _(*8)

• Register IAB's service provider to your bootstrap/app.php, _(*9)

  $app->register(elegisandi\IABBotDetect\IabServiceProvider::class);, _(*10)

Configuration

• Generate whitelist and blacklist cache, _(*11)

  php artisan iab:refresh-list, _(*12)

  You may add the option --overwrite to reset cache., _(*13)

Basic Usage

<?php

use elegisandi\IABBotDetect\Validator;

$user_agent = 'Mozilla/5.0 (compatible; Googlebot/2.1; +http://www.google.com/bot.html)';
$config = [
    'user' => 'YOUR_IAB_USER',
    'password' => 'YOUR_IAB_PASSWORD'
];

try {
    $bot_detect = new Validator($user_agent, $config);

    if($bot_detect->isValidBrowser()) {
        echo 'valid browser';
    } else {
        echo 'invalid browser';
    }
} catch (\Exception $e) {
    // fallback user agent validation
}

S3 Auto Backup, _(*14)

To enable this feature, you must add the following into the 2nd argument of the constructor, _(*15)

's3_backup' => true,
's3_bucket' => 'YOUR_IAB_S3_BUCKET,
's3_region' => 'YOUR_AWS_REGION',
'aws_credentials' => [
    'key' => 'YOUR_AWS_ACCESS_KEY_ID',
    'secret' => 'YOUR_AWS_SECRET_ACCESS_KEY',
]

Laravel/Lumen Usage

<?php

use IAB;

$user_agent = 'Mozilla/5.0 (compatible; Googlebot/2.1; +http://www.google.com/bot.html)';

try {
    if(IAB::isValidBrowser($user_agent)) {
        echo 'valid browser';
    } else {
        echo 'invalid browser';
    }
} catch (\Exception $e) {
    // fallback user agent validation
}

For Lumen:, _(*16)

try {
    if(app('iab')->isValidBrowser($user_agent)) {
        echo 'valid browser';
    } else {
        echo 'invalid browser';
    }
} catch (\Exception $e) {
    // fallback user agent validation
}

S3 Auto Backup, _(*17)

To enable this feature, you must set the following .env variables, _(*18)

IAB_S3_BACKUP=true
IAB_S3_BUCKET=your-s3-bucket-name
AWS_REGION=your-s3-region
AWS_ACCESS_KEY_ID=your-aws-access-key
AWS_SECRET_ACCESS_KEY=your-aws-secret-key

Methods

• setUserAgent($user_agent)

  where $user_agent = User Agent string, _(*19)

• setCredentials($credentials)

  where $credentials = a key-pair values array of your IAB user and password, _(*20)

• isValidBrowser($user_agent)

  where $user_agent could be null, _(*21)

  throws an error exception, _(*22)

  Returns boolean, _(*23)

• isBot($user_agent)

  where $user_agent could be null, _(*24)

  throws an error exception, _(*25)

  Returns boolean, _(*26)

• initialize($overwrite)

  where $overwrite = a boolean flag to overwrite cache files (_default value_: false), _(*27)

  throws an error exception, _(*28)

  Prepares cache files needed for bot detection process., _(*29)

Error Exceptions

• ###### IABRequestException
• ###### IABBackupException
• ###### InvalidIABCacheException
• ###### InvalidIABCredentialsException

Contributing

Open an issue first to discuss potential changes/additions., _(*30)

License

MIT, _(*31)