revolution/salvager

Tiny WebCrawler for Laravel using Playwright

2.1.0 2025-12-14 02:04 UTC

Requires

• php: ^8.3
• playwright-php/playwright: ^1.0

Requires (Dev)

• laravel/pint: ^1.26
• mockery/mockery: ^1.6.1
• orchestra/testbench: ^10.8
• phpunit/phpunit: ^12.4
• revolution/laravel-boost-copilot-cli: ^1.0

MIT

• kawax

• laravel
• playwright

README

Tiny WebCrawler for Laravel using Playwright.

Version 2

Version 2 has been reworked as a simple package that depends on Playwright. It only implements minimal functionality, since you can use playwright-php/playwright directly.

Requirements

• PHP >= 8.3
• Laravel >= 12.x

Installation

composer require revolution/salvager

Install Playwright browsers:

vendor/bin/playwright-install --browsers

Or install Playwright browsers with OS dependencies:

vendor/bin/playwright-install --with-deps

Usage

The browser will be terminated when you exit Salvager::browse(), so please obtain any necessary data within the Salvager::browse() closure. The Page object cannot be used outside of Salvager::browse().

use Revolution\Salvager\Facades\Salvager;
use Playwright\Page\Page;

class SalvagerController
{
    public function __invoke()
    {
         Salvager::browse(function (Page $page) use (&$url, &$text) {
            $page->goto('https://example.com/');
            $page->screenshot(config('salvager.screenshots').'example.png');

            $url = $page->url();
            $text = $page->locator('p')->first()->innerText();
        });

        dump($url);
        dump($text);
    }
}

If you want more control, just launch the browser with Salvager::launch().

use Playwright\Browser\BrowserContextInterface;
use Revolution\Salvager\Facades\Salvager;

/* @var BrowserContextInterface $browser */
$browser = Salvager::launch();

$page = $browser->newPage();
$page->goto('https://example.com/');
// Do something...

// Don't forget to close the browser
$browser->close();

LICENSE

MIT