PHPackages                             myerscode/beacon - PHPackages - PHPackages  [Skip to content](#main-content)[PHPackages](/)[Directory](/)[Categories](/categories)[Trending](/trending)[Leaderboard](/leaderboard)[Changelog](/changelog)[Analyze](/analyze)[Collections](/collections)[Log in](/login)[Sign up](/register)

1. [Directory](/)
2. /
3. [HTTP &amp; Networking](/categories/http)
4. /
5. myerscode/beacon

ActiveLibrary[HTTP &amp; Networking](/categories/http)

myerscode/beacon
================

A fluent PHP wrapper for web page content retrieval, screenshots, PDFs, Lighthouse audits, and concurrent site crawling using Chrome.

111↓92.9%PHPCI passing

Since Jun 11Pushed 3w agoCompare

[ Source](https://github.com/myerscode/beacon)[ Packagist](https://packagist.org/packages/myerscode/beacon)[ RSS](/packages/myerscode-beacon/feed)WikiDiscussions main Synced today

READMEChangelogDependenciesVersions (4)Used By (0)

[![Latest Stable Version](https://camo.githubusercontent.com/ffd3596178fe10e510cc37684d1b9ee5b07429fd48f3f60211fde8d222632a60/68747470733a2f2f706f7365722e707567782e6f72672f6d79657273636f64652f626561636f6e2f762f737461626c65)](https://packagist.org/packages/myerscode/beacon)[![Total Downloads](https://camo.githubusercontent.com/37038220458de9288ea1b6c3227f98e33f06c7f1832f43172954d132a4f3bb0e/68747470733a2f2f706f7365722e707567782e6f72672f6d79657273636f64652f626561636f6e2f646f776e6c6f616473)](https://packagist.org/packages/myerscode/beacon)[![PHP Version Require](https://camo.githubusercontent.com/25e0be663a8c42a05f57765967225bd97cf43c488436f17ec74d4983604bfdd5/687474703a2f2f706f7365722e707567782e6f72672f6d79657273636f64652f626561636f6e2f726571756972652f706870)](https://packagist.org/packages/myerscode/beacon)[![License](https://camo.githubusercontent.com/d04e36b90fe66f802938224942df1d97838c313ad997fcc3e1b3a154a9a4c44b/68747470733a2f2f706f7365722e707567782e6f72672f6d79657273636f64652f626561636f6e2f6c6963656e7365)](https://github.com/myerscode/beacon/blob/main/LICENSE)[![Tests](https://github.com/myerscode/beacon/actions/workflows/tests.yml/badge.svg?branch=main)](https://github.com/myerscode/beacon/actions/workflows/tests.yml)[![codecov](https://camo.githubusercontent.com/7bb2d7cf5a832fcc72470667247077df8a872f51445e319dd551ab8ee0fdae08/68747470733a2f2f636f6465636f762e696f2f67682f6d79657273636f64652f626561636f6e2f67726170682f62616467652e737667)](https://codecov.io/gh/myerscode/beacon)

Beacon
======

[](#beacon)

A fluent PHP wrapper around [Symfony Panther](https://github.com/symfony/panther) for web page content retrieval and site analysis. Renders JavaScript-heavy pages (SPAs, React, Vue, etc.) and provides an easy API for source code, screenshots, PDFs, meta tags, link extraction, Lighthouse audits, and concurrent site crawling.

Requirements
------------

[](#requirements)

- PHP 8.5 or higher
- Chrome/Chromium browser installed
- Node.js 16 or higher (only required for Lighthouse features)
- [Lighthouse CLI](https://www.npmjs.com/package/lighthouse) (only required for Lighthouse features)

Installation
------------

[](#installation)

```
composer require myerscode/beacon
```

ChromeDriver is installed automatically on `composer install` — Beacon detects your Chrome version and downloads the matching driver for your platform. See [Managing Dependencies](docs/advanced-usage.md#managing-dependencies) for manual install, update, and clean commands.

Quick Start
-----------

[](#quick-start)

```
// Get the fully rendered HTML of any page
$html = beacon()->visit('https://example.com')->source();

// Take a screenshot or save as PDF
beacon()->visit('https://example.com')->screenshot('/tmp/shot.png');
beacon()->visit('https://example.com')->pdf('/tmp/page.pdf');

// Page info
$title  = beacon()->visit('https://example.com')->title();
$status = beacon()->visit('https://example.com')->statusCode();
$links  = beacon()->visit('https://example.com')->links();
$meta   = beacon()->visit('https://example.com')->meta();

// Lighthouse audit
$scores = beacon()->visit('https://example.com')->lighthouse();

// Crawl the site for broken links
$results = beacon()->visit('https://example.com')->crawl();
$broken  = $results->broken();
```

Documentation
-------------

[](#documentation)

- [Page](docs/page.md) — content, screenshots, PDF, links, meta, status code
- [Lighthouse](docs/lighthouse.md) — category scores, individual audits, configuration, reports
- [Crawler](docs/crawler.md) — concurrent spider crawl, broken link detection, retries, throttling
- [Advanced Usage](docs/advanced-usage.md) — browser configuration, dependency management
- [CI/CD](docs/ci-cd.md) — GitHub Actions, GitLab CI, and other pipeline setups

Issues
------

[](#issues)

Bug reports and feature requests can be submitted on the [Github Issue Tracker](https://github.com/myerscode/beacon/issues).

Contributing
------------

[](#contributing)

Contributions are welcome! Please see [contributing.md](https://github.com/myerscode/docs/blob/master/contributing.md) for guidelines on how to contribute to this project.

License
-------

[](#license)

The MIT License (MIT). Please see [License File](LICENSE) for more information.

###  Health Score

23

—

LowBetter than 26% of packages

Maintenance62

Regular maintenance activity

Popularity7

Limited adoption so far

Community8

Small or concentrated contributor base

Maturity15

Early-stage or recently created project

 Bus Factor1

Top contributor holds 93.6% of commits — single point of failure

How is this calculated?**Maintenance (25%)** — Last commit recency, latest release date, and issue-to-star ratio. Uses a 2-year decay window.

**Popularity (30%)** — Total and monthly downloads, GitHub stars, and forks. Logarithmic scaling prevents top-heavy scores.

**Community (15%)** — Contributors, dependents, forks, watchers, and maintainers. Measures real ecosystem engagement.

**Maturity (30%)** — Project age, version count, PHP version support, and release stability.

### Community

Maintainers

![](https://www.gravatar.com/avatar/a3d9923c8c4269fbe7076613da7e814719743f643cb115b441ccee8aeaa1290e?d=identicon)[oniice](/maintainers/oniice)

---

Top Contributors

[![oniice](https://avatars.githubusercontent.com/u/2676321?v=4)](https://github.com/oniice "oniice (44 commits)")[![dependabot[bot]](https://avatars.githubusercontent.com/in/29110?v=4)](https://github.com/dependabot[bot] "dependabot[bot] (3 commits)")

### Embed Badge

![Health badge](/badges/myerscode-beacon/health.svg)

```
[![Health](https://phpackages.com/badges/myerscode-beacon/health.svg)](https://phpackages.com/packages/myerscode-beacon)
```

###  Alternatives

[php-http/cache-plugin

PSR-6 Cache plugin for HTTPlug

25126.1M82](/packages/php-http-cache-plugin)[illuminate/http

The Illuminate Http package.

11937.9M6.9k](/packages/illuminate-http)[rdkafka/rdkafka

A PHP extension for Kafka

2.2k24.3k1](/packages/rdkafka-rdkafka)[httpsoft/http-message

Strict and fast implementation of PSR-7 and PSR-17

87965.9k114](/packages/httpsoft-http-message)[mezzio/mezzio-router

Router subcomponent for Mezzio

265.4M92](/packages/mezzio-mezzio-router)[serpapi/google-search-results-php

Get Google, Bing, Baidu, Ebay, Yahoo, Yandex, Home depot, Naver, Apple, Duckduckgo, Youtube search results via SerpApi.com

69127.2k](/packages/serpapi-google-search-results-php)

PHPackages © 2026

[Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)
