PHPackages                             initbiz/oc-selenium2tests-plugin - 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. initbiz/oc-selenium2tests-plugin

Abandoned → [https://github.com/initbiz/selenium2tests-plugin](/?search=https%3A%2F%2Fgithub.com%2Finitbiz%2Fselenium2tests-plugin)October-plugin[Testing &amp; Quality](/categories/testing)

initbiz/oc-selenium2tests-plugin
================================

Write tests in OctoberCMS using Selenium 2

24863PHP

Since Jan 21Pushed 2y ago1 watchersCompare

[ Source](https://github.com/initbiz/selenium2tests-plugin)[ Packagist](https://packagist.org/packages/initbiz/oc-selenium2tests-plugin)[ RSS](/packages/initbiz-oc-selenium2tests-plugin/feed)WikiDiscussions master Synced 2mo ago

READMEChangelogDependenciesVersions (2)Used By (0)

Selenium 2 Tests - Write tests using Selenium 2 with Dusk support
=================================================================

[](#selenium-2-tests---write-tests-using-selenium-2-with-dusk-support)

[![Selenium 2 Tests banner](https://raw.githubusercontent.com/initbiz/selenium2tests-plugin/master/docs/selenium-2-tests.png)](https://raw.githubusercontent.com/initbiz/selenium2tests-plugin/master/docs/selenium-2-tests.png)

This is a repo of OctoberCMS plugin by [InIT.biz](https://init.biz).

How-to
------

[](#how-to)

### System requirements

[](#system-requirements)

1. Java 8 installed in default location of your platform (for example `/usr/bin/java` for Linux)
2. The driver of the browser you want to use for tests (for example [ChromeDriver](http://chromedriver.chromium.org/getting-started))

> **Note for Linux users**
>
> Installing Chromium from your package manager should install ChromeDriver for you

> **Note for Mac users**
>
> You probably will have to link newer version of Java to your default path as described [here](https://stackoverflow.com/a/14875241)

### Installation

[](#installation)

1. You can use three methods to install the plugin:
2. from [OctoberCMS Marketplace](https://octobercms.com/plugin/initbiz-selenium2tests),
3. clone the code from GitHub into `/plugins/initbiz/selenium2tests` directory or
4. install using Composer `composer require --dev initbiz/oc-selenium2tests-plugin`
5. Add `"laravel/dusk": "^2.0"` to your `require-dev` section in `composer.json` file
6. Go to `/plugins/initbiz/selenium2tests`
7. Copy `selenium.php.example` to `selenium.php` and configure your environment

**You can also create `selenium.php` file in your root directory, which will be read when the one in plugin's directory does not exist**

### Testing OctoberCMS basics

[](#testing-octobercms-basics)

It is a good practice not to use the same DB for testing and developing purposes.

In order to configure a different database for testing purposes create directory `testing` in `config` directory and copy `database.php` to the newly-created directory. Then change the default connection as you wish.

After that, if you use `APP_ENV=testing` in your `.env` file, configuration from the `testing` directory will be used.

Writing tests in Selenium 2
---------------------------

[](#writing-tests-in-selenium-2)

There are example tests in `tests/example` directory that use `Ui2TestCase` class.

Running tests
-------------

[](#running-tests)

First of all, you have to run the Selenium 2 standalone server which is included in the package. In order to start Selenium 2 server go to `/plugins/initbiz/selenium2tests` and run `java -jar selenium.jar`.

You are ready to run tests using PHPUnit from OctoberCMS's `vendor/bin/phpunit`.

You can keep test files wherever you want, but `.gitignore` of the plugin will exclude all files from `/tests` except those in `/tests/examples`.

### Browser options (like headless mode)

[](#browser-options-like-headless-mode)

If you want to for example run browser in headless mode, you can add that line to your `selenium.php` file:

```
define('TEST_SELENIUM_BROWSER_OPTIONS', ['--headless']);

```

###  Health Score

22

—

LowBetter than 22% of packages

Maintenance20

Infrequent updates — may be unmaintained

Popularity18

Limited adoption so far

Community14

Small or concentrated contributor base

Maturity33

Early-stage or recently created project

 Bus Factor1

Top contributor holds 96.3% 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://avatars.githubusercontent.com/u/16684450?v=4)[inIT](/maintainers/initbiz)[@initbiz](https://github.com/initbiz)

---

Top Contributors

[![tomaszstrojny](https://avatars.githubusercontent.com/u/8854428?v=4)](https://github.com/tomaszstrojny "tomaszstrojny (79 commits)")[![alxy](https://avatars.githubusercontent.com/u/2057062?v=4)](https://github.com/alxy "alxy (1 commits)")[![Drumbeldore](https://avatars.githubusercontent.com/u/25252969?v=4)](https://github.com/Drumbeldore "Drumbeldore (1 commits)")[![dzapek](https://avatars.githubusercontent.com/u/54842490?v=4)](https://github.com/dzapek "dzapek (1 commits)")

### Embed Badge

![Health badge](/badges/initbiz-oc-selenium2tests-plugin/health.svg)

```
[![Health](https://phpackages.com/badges/initbiz-oc-selenium2tests-plugin/health.svg)](https://phpackages.com/packages/initbiz-oc-selenium2tests-plugin)
```

###  Alternatives

[phpspec/prophecy

Highly opinionated mocking framework for PHP 5.3+

8.5k551.7M678](/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.8M753](/packages/brianium-paratest)[beberlei/assert

Thin assertion library for input validation in business models.

2.4k96.9M571](/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.0k](/packages/orchestra-testbench)

PHPackages © 2026

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