README

Proxy provider drivers for jez500/web-scraper-for-laravel.

This package is the companion package that will register named proxy-backed WebScraper drivers into a Laravel application via package auto-discovery.

Installation

composer require jez500/web-scraper-for-laravel-proxies

Once installed, the package service provider registers any drivers listed in the internal driver registry with the base web_scraper factory.

Current State

The package scaffold and auto-registration flow are in place. The first concrete provider driver included is oxylabs.

Adding a Driver

1. Create a driver class that implements Jez500\WebScraperForLaravel\Drivers\WebScraperDriverInterface.
2. Add the driver alias and class to Jez500\WebScraperForLaravelProxies\DriverRegistry::all().
3. The package service provider will automatically register that alias with WebScraper when the package boots.

Oxylabs

The oxylabs driver uses the Oxylabs Web Scraper API realtime endpoint and authenticates with your API user credentials.

Add credentials to your Laravel app:

OXYLABS_USERNAME=your-username
OXYLABS_PASSWORD=your-password

Optionally publish the config:

php artisan vendor:publish --tag=web-scraper-proxies-config

Basic usage:

use Jez500\WebScraperForLaravel\Facades\WebScraper;

$scraper = WebScraper::driver('oxylabs')
    ->from('https://example.com')
    ->get();

Passing Oxylabs request options:

$scraper = WebScraper::driver('oxylabs')
    ->setOptions([
        'geo_location' => 'United States',
        'render' => 'html',
        'user_agent_type' => 'desktop',
    ])
    ->from('https://example.com')
    ->get();

The driver defaults to Oxylabs source=universal, but you can override it with setOptions(['source' => 'google_search']) or package config when using a target-specific source.