Selenium With PHPUnit

---

Run PHPUnit tests on the TestMu AI cloud grid. This guide covers setup, running a sample test, configuring capabilities, and testing locally hosted pages.

Sample repo

All the code used in this guide is available in the sample repository.

View on GitHub

Prerequisites

---

Complete the following steps before you begin automation testing with Selenium and PHPUnit.

1. Install the latest PHP on your system. Use the following commands in the terminal:

   • MacOS: Previous versions of MacOS have PHP installed by default. For the latest MacOS versions starting with Monterey, download and install PHP manually:

   /bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"
   brew install php
   • Windows: Download PHP from PHP for Windows and add it to your system PATH. Refer to the PHP Windows installation guide to ensure PHP is accessible through Command Prompt (cmd).

2. Download composer in the project directory (Linux/MacOS, Windows).

   Note: To use the composer command directly, it either should have been downloaded in the project directory or should be accessible globally which can be done by the command below:

   mv composer.phar /usr/local/bin/composer

Step 1: Clone the Sample Project

---

Clone the repository and install dependencies.

git clone https://github.com/LambdaTest/Php-PhpUnit-Selenium
cd Php-PhpUnit-Selenium

Install the composer dependencies:

composer install

Step 2: Set Your Credentials

---

Configure your credentials to connect to the TestMu AI Selenium Grid.

Set TestMu AI Username and Access Key in environment variables.

macOS / Linux

export LT_USERNAME="undefined"
export LT_ACCESS_KEY="undefined"

Windows

set LT_USERNAME="undefined"
set LT_ACCESS_KEY="undefined"

Step 3: Configure Your Test Capabilities

---

Define browser, version, and OS settings for your test run.

In LambdaTestSetup.php file, update your test capabilities to select OS, browser, browser version, and other settings.

$capabilities = array(
	"build" => "Sample PHPUnit Build",
	"name" => "Sample PHPUnit Test",
	"platform" => "Windows 10",
	"browserName" => "Chrome",
	"version" => "latest"
 );	

Capabilities Generator

Use the TestMu AI Capabilities Generator to auto-generate the capabilities class for your test requirements.

Step 4: Run the Test

---

Execute the PHPUnit test from the command line.

composer single

To run parallel tests:

composer parallel

To run both single and parallel tests at once:

composer test

Step 5: View Your Results

---

Check the test output on the console and the TestMu AI dashboard.

Visit the TestMu AI Automation Dashboard to view your test results. The dashboard provides:

• Text logs for each test step
• Screenshots captured during execution
• Video recordings of the full test session

Run PHPUnit Tests Using Agent Skills

---

Use AI coding assistants to generate and run PHPUnit tests with the TestMu AI Agent Skill.

The phpunit-skill is part of TestMu AI Agent Skills - structured packages that teach AI coding assistants how to write production-grade test automation.

Install the skill:

git clone https://github.com/LambdaTest/agent-skills.git
cp -r agent-skills/phpunit-skill .claude/skills/

# For Cursor / Copilot
cp -r agent-skills/phpunit-skill .cursor/skills/

tip

Install all available framework skills at once by cloning the repository directly into your tool's skills directory (e.g., .claude/skills/, .cursor/skills/).