PHPackages                             mvadzim/visualception - 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. [Testing &amp; Quality](/categories/testing)
4. /
5. mvadzim/visualception

ActiveLibrary[Testing &amp; Quality](/categories/testing)

mvadzim/visualception
=====================

Visual regression tests for Codeception

2.0.3(6y ago)0277Apache-2.0PHPPHP &gt;=5.4.0

Since Mar 1Pushed 6y ago1 watchersCompare

[ Source](https://github.com/mvadzim/VisualCeption)[ Packagist](https://packagist.org/packages/mvadzim/visualception)[ Docs](https://github.com/mvadzim/VisualCeption)[ RSS](/packages/mvadzim-visualception/feed)WikiDiscussions master Synced 5d ago

READMEChangelog (4)Dependencies (1)Versions (9)Used By (0)

VisualCeption fork
==================

[](#visualception-fork)

This is **fork** of [visual regression tests for Codeception](https://github.com/Codeception/VisualCeption).

Install
-------

[](#install)

```
composer require mvadzim/visualception:dev-master

```

#### Sample config:

[](#sample-config)

```
modules:
    enabled:
        - WebDriver:
            url: http://localhost.com
            browser: firefox
        - VisualCeption:
            maximumDeviation: 5                                   # deviation in percent
            saveCurrentImageIfFailure: true                       # if true, VisualCeption saves the current
            fullScreenShot: resize                                # fullpage screenshot (resize/scroll/false)
            referenceImageDir: "/home/qa/img_storage/[browser]/"  # "[browser]" replaced to "firefox"
            currentImageDir: "visualception/current/[browser]/"   # tests/_output/visualception/current/firefox/
            report: true         # tests/_output/vcresult.html
            referenceImageDeleteLink: "http://mytestserver.example.com/delete_reference_image.php?file=[file]&browser=[browser]&environment=dev"
```

Note
----

[](#note)

Форк делался для себя и под свои запросы, из-за этого не нужно надеятся на его стабильность и безбажность даже для базовых вариантов использования.

#### Изменения:

[](#изменения)

- Новые пути для сохраниения текущих и эталонных скриншотов, "\[browser\]" в пути автоматически заменяется на имя браузера
- Новые методы seeVisualChangesInCurrentPage и dontSeeVisualChangesInCurrentPage которым не нужно передавать идентификатор (им выступает урл сейчас открытой страницы)
- fullScreenShot: 'resize' - изменяет размер окна браузера на высоту страницы (нужно запускать на виртуальном экране большой высоты)
- Новый шаблон для отчетов
- Возможность удалять элементы со страницы (display:none)
- В отчете не затираются результаты предыдущих запусков
- Добавлена ссылка на удаление эталонных скриншотов

#### Простой пример

[](#простой-пример)

```
class VisualCest
{
   /**
    * @env firefox
    * @env chrome
    *
    * @example(url="https://time.is/ru/Kyiv", wantTo="Страница точного времени в Киеве, этот тест будет постоянно падать")
    * @example(url="https://github.com/pricing", wantTo="Страница с ценами на гитхаб, этот тест будет падать редко")
    * @example(url="https://time.is/uk/Kyiv", wantTo="Сторінка точного часу в Києві, цей тест буде постійно падати")
    */
   public function visualTest(\AcceptanceTester $I, \Codeception\Example $example)
   {
       $I->wantTo('Визуальная проверка важных страниц');
       $I->amOnUrl($example['url']);
       $I->dontSeeVisualChangesInCurrentPage(['div#twd'], ['iframe']); // div#twd set style "visibility: hidden;" iframe set "display: none;"
   }
}
```

[![sample report screenshot](visualception-report.png)](visualception-report.png)

###  Health Score

30

—

LowBetter than 64% of packages

Maintenance20

Infrequent updates — may be unmaintained

Popularity11

Limited adoption so far

Community16

Small or concentrated contributor base

Maturity63

Established project with proven stability

 Bus Factor3

3 contributors hold 50%+ of commits

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

Every ~147 days

Recently: every ~111 days

Total

8

Last Release

2333d ago

Major Versions

0.9.0 → 1.0.02017-08-18

1.0.2 → 2.0.02019-11-22

### Community

Maintainers

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

---

Top Contributors

[![buresmi7](https://avatars.githubusercontent.com/u/1267665?v=4)](https://github.com/buresmi7 "buresmi7 (24 commits)")[![mvadzim](https://avatars.githubusercontent.com/u/14044901?v=4)](https://github.com/mvadzim "mvadzim (18 commits)")[![DavertMik](https://avatars.githubusercontent.com/u/220264?v=4)](https://github.com/DavertMik "DavertMik (17 commits)")[![DigitalProducts](https://avatars.githubusercontent.com/u/7011638?v=4)](https://github.com/DigitalProducts "DigitalProducts (14 commits)")[![RayRom](https://avatars.githubusercontent.com/u/9988573?v=4)](https://github.com/RayRom "RayRom (6 commits)")[![toddy](https://avatars.githubusercontent.com/u/977658?v=4)](https://github.com/toddy "toddy (4 commits)")[![spaceman-cb](https://avatars.githubusercontent.com/u/19659124?v=4)](https://github.com/spaceman-cb "spaceman-cb (2 commits)")[![MatissJanis](https://avatars.githubusercontent.com/u/886567?v=4)](https://github.com/MatissJanis "MatissJanis (1 commits)")[![eXorus](https://avatars.githubusercontent.com/u/1255561?v=4)](https://github.com/eXorus "eXorus (1 commits)")[![sebastianneubert](https://avatars.githubusercontent.com/u/2872569?v=4)](https://github.com/sebastianneubert "sebastianneubert (1 commits)")[![the-web-hates-me](https://avatars.githubusercontent.com/u/4029191?v=4)](https://github.com/the-web-hates-me "the-web-hates-me (1 commits)")

###  Code Quality

TestsCodeception

### Embed Badge

![Health badge](/badges/mvadzim-visualception/health.svg)

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

###  Alternatives

[phpspec/prophecy

Highly opinionated mocking framework for PHP 5.3+

8.5k551.7M682](/packages/phpspec-prophecy)[vimeo/psalm

A static analysis tool for finding errors in PHP applications

5.8k77.5M6.7k](/packages/vimeo-psalm)[brianium/paratest

Parallel testing for PHP

2.5k118.8M754](/packages/brianium-paratest)[beberlei/assert

Thin assertion library for input validation in business models.

2.4k96.9M570](/packages/beberlei-assert)[mikey179/vfsstream

Virtual file system to mock the real file system in unit tests.

1.4k108.0M2.7k](/packages/mikey179-vfsstream)[orchestra/testbench

Laravel Testing Helper for Packages Development

2.2k39.1M32.1k](/packages/orchestra-testbench)

PHPackages © 2026

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