PHPackages                             different-technology/wraith-php - 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. [Utility & Helpers](/categories/utility)
4. /
5. different-technology/wraith-php

ActiveLibrary[Utility & Helpers](/categories/utility)

different-technology/wraith-php
===============================

PHP Wraith is a screenshot comparison tool using Selenium - written in PHP.

1.0.0(5y ago)08MITPHPPHP ^7.4

Since Feb 4Pushed 4y ago1 watchersCompare

[ Source](https://github.com/different-technology/wraith-php)[ Packagist](https://packagist.org/packages/different-technology/wraith-php)[ RSS](/packages/different-technology-wraith-php/feed)WikiDiscussions main Synced 6d ago

READMEChangelogDependencies (2)Versions (2)Used By (0)

[![Packagist Release](https://camo.githubusercontent.com/dbd3ee8cc1ae3ba5cd5077cda5bd895fe5008d40c99b5ddbe7817b75b379394d/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f762f646966666572656e742d746563686e6f6c6f67792f7772616974682d7068702e7376673f7374796c653d666c61742d737175617265)](https://packagist.org/packages/different-technology/wraith-php)[![Packagist Downloads](https://camo.githubusercontent.com/56c6782cd3f8f055d5834e0f1f4897f81233a87911f4724c4afb12b7affddc1f/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f64742f646966666572656e742d746563686e6f6c6f67792f7772616974682d7068702e7376673f7374796c653d666c61742d737175617265)](https://packagist.org/packages/different-technology/wraith-php)[![GitHub License](https://camo.githubusercontent.com/d354d7ee9caacbc778c222df214cab31ca59c56ba21f9b7f635c4672081ff2bc/68747470733a2f2f696d672e736869656c64732e696f2f6769746875622f6c6963656e73652f646966666572656e742d746563686e6f6c6f67792f7772616974682d7068702e7376673f7374796c653d666c61742d737175617265)](https://github.com/different-technology/wraith-php/blob/main/LICENSE)

PHP Wraith
==========

[](#php-wraith)

PHP Wraith is a website crawler & screenshot comparison tool using Selenium - written in PHP.

This tool is based on the ideas of [bbc/wraith](https://github.com/bbc/wraith).

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

[](#installation)

### Prerequisites

[](#prerequisites)

System requirements:

- PHP version (> 7.4) with PHP extensions `imagick` and `json` (see [composer.json](../main/composer.json))
- [Composer](https://getcomposer.org/)

### Install sources

[](#install-sources)

**Either** install this package via composer:

```
composer require different-technology/wraith-php
```

**Or** clone the code from GitHub:

```
git clone git@github.com:different-technology/wraith-php.git
cd wraith-php
composer install
```

### Chromedriver

[](#chromedriver)

Download the chromedriver for your Chrome version:

Place the chromedriver here (optional): `bin/chromedriver`

Setup
-----

[](#setup)

Configure your website in your own YAML config file in `/configs`.

See example in [/configs/example.yml](../main/configs/example.yml)

Start
-----

[](#start)

### Run chromedriver (optional)

[](#run-chromedriver-optional)

The `chromedriver` has to run on configured port (default: `4444`) while executing the commands.

Start the chromedriver

```
bin/chromedriver --port=4444
```

You can also use the autostart option to start the chromedriver automatically if it's not available.

### Screenshots

[](#screenshots)

Call the `screenshot` command with your config name (file name without `.yml` extension).

```
php app.php screenshot {{your-config-name}} {{threads-count(optional)}}
```

The results are store in the directory `/data/screenshots/{{your-config-name}}/{{current-date-time}}`.

Feel free to rename the last directory name from `{{current-date-time}}` to something meaningful.

#### Example:

[](#example)

```
# Take screenshots
php app.php screenshot example 3
# Rename screenshots to "before-update"
mv data/screenshots/example/2021-02-04_10-10-55 data/screenshots/example/before-update
```

### Compare

[](#compare)

Call the `compare` command with your config name (file name without `.yml` extension).

Provide the two directory names to compare.

```
php app.php compare {{your-config-name}} {{directory1}} {{directory2}}
```

#### Example:

[](#example-1)

```
php app.php compare example 2021-02-04_00-05-35 2021-02-04_00-38-37
```

### Join

[](#join)

Cou can join a running job to work in threads on a single task (the task has to support jobs).

Just lookup the job-id in the directory `/data/jobs/`.

```
php app.php join {{your-config-name}} {{job-id}}
```

#### Example:

[](#example-2)

```
php app.php join example d6f7f694f8563362e17ae6ab64d1578f
```

### List commands

[](#list-commands)

Cou can list all available commands with the `help` command of symfony:

```
php app.php list
```

### Show results

[](#show-results)

Open this file in your browser to see the results: `public/index.html`

###  Health Score

23

—

LowBetter than 27% of packages

Maintenance20

Infrequent updates — may be unmaintained

Popularity4

Limited adoption so far

Community7

Small or concentrated contributor base

Maturity53

Maturing project, gaining track record

 Bus Factor1

Top contributor holds 100% 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.

###  Release Activity

Cadence

Unknown

Total

1

Last Release

1928d ago

### Community

Maintainers

![](https://www.gravatar.com/avatar/39af3f9c14f1d619d2584ae31552504f2f12424a947ee8d8c7a64e1ef23f47d2?d=identicon)[lagerregal](/maintainers/lagerregal)

---

Top Contributors

[![Lagerregal](https://avatars.githubusercontent.com/u/2297740?v=4)](https://github.com/Lagerregal "Lagerregal (10 commits)")

### Embed Badge

![Health badge](/badges/different-technology-wraith-php/health.svg)

```
[![Health](https://phpackages.com/badges/different-technology-wraith-php/health.svg)](https://phpackages.com/packages/different-technology-wraith-php)
```

###  Alternatives

[orchestra/canvas

Code Generators for Laravel Applications and Packages

21017.2M158](/packages/orchestra-canvas)[netgen/content-browser

Netgen Content Browser is a Symfony bundle that provides an interface which selects items from any kind of backend and returns the IDs of selected items back to the calling code.

14112.1k8](/packages/netgen-content-browser)

PHPackages © 2026

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