https://github.com/fyrts/chrome-devtools-protocol

Chrome Devtools Protocol client for PHP
https://github.com/fyrts/chrome-devtools-protocol

Last synced: 4 months ago
JSON representation

Chrome Devtools Protocol client for PHP

• Host: GitHub
• URL: https://github.com/fyrts/chrome-devtools-protocol
• Owner: fyrts
• License: mit
• Fork: true (jakubkulhan/chrome-devtools-protocol)
• Created: 2022-12-14T15:13:35.000Z (over 2 years ago)
• Default Branch: master
• Last Pushed: 2025-01-16T03:03:06.000Z (4 months ago)
• Last Synced: 2025-01-19T04:51:41.315Z (4 months ago)
• Language: PHP
• Size: 5.97 MB
• Stars: 1
• Watchers: 0
• Forks: 1
• Open Issues: 1
• Metadata Files:
  • Readme: README.md
  • License: LICENSE

Awesome Lists containing this project

README

        
# Chrome Devtools Protocol PHP client

[![Build](https://github.com/Fyrts/chrome-devtools-protocol/actions/workflows/phpunit.yml/badge.svg)](https://github.com/Fyrts/chrome-devtools-protocol/actions/workflows/phpunit.yml)

[![Latest Stable Version](https://poser.pugx.org/fyrts/chrome-devtools-protocol/v/stable?format=flat)](https://packagist.org/packages/fyrts/chrome-devtools-protocol)

[![License](https://poser.pugx.org/fyrts/chrome-devtools-protocol/license?format=flat)](https://packagist.org/packages/fyrts/chrome-devtools-protocol)

> PHP client for [Chrome Devtools Protocol](https://chromedevtools.github.io/devtools-protocol/).

## Installation

`composer require fyrts/chrome-devtools-protocol`

## Basic usage

```php

// context creates deadline for operations

$ctx = Context::withTimeout(Context::background(), 30 /* seconds */);

// launcher starts chrome process ($instance)

$launcher = new Launcher();

$instance = $launcher->launch($ctx);

try {

	// work with new tab

	$tab = $instance->open($ctx);

	$tab->activate($ctx);

	$devtools = $tab->devtools();

	try {

		$devtools->page()->enable($ctx);

		$devtools->page()->navigate($ctx, NavigateRequest::builder()->setUrl("https://www.google.com/")->build());

		$devtools->page()->awaitLoadEventFired($ctx);

		// ... work with page ...

		// e.g.

		// - print to PDF: $devtools->page()->printToPDF($ctx, PrintToPDFRequest::make());

		// - capture screenshot: $devtools->page()->captureScreenshot($ctx, CaptureScreenshotRequest::builder()->setFormat("jpg")->setQuality(95)->build());

	} finally {

		// devtools client needs to be closed

		$devtools->close();

	}

} finally {

	// process needs to be killed

	$instance->close();

}

```

## Headless Chrome isolated contexts

Headless Chrome supports feature called *browser contexts* - they're like incognito windows - cookies, local storage etc. are not shared. After *browser context* is destroyed, user data created in given context, are destroyed.

Unlike incognito windows, there can be multiple isolate *browser contexts* at the same time.

```php

$ctx = Context::withTimeout(Context::background(), 10);

$launcher = new Launcher();

$instance = $launcher->launch($ctx);

try {

	$session = $instance->createSession($ctx);

	try {

		// $session implements DevtoolsClientInterface, same as returned from Tab::devtools()

	} finally {

		$session->close();

	}

} finally {

	$instance->close();

}

```

## License

Licensed under MIT license. See `LICENSE` file.