Skip to main content

Selenium With Codeception

Run Codeception 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.

Prerequisites​

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

  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

  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/codeception-selenium-sample
cd codeception-selenium-sample

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.

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

Step 3: Configure Your Test Capabilities​

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

In the test script, update your test capabilities. Notice the declaration of class name "AcceptanceTester". This class specifies test configuration, port number, browser name, browser version, and other desired capabilities.

# Codeception Test Suite Configuration
#
# Suite for acceptance tests.
# Perform tests in browser using the WebDriver or PhpBrowser.
# If you need both WebDriver and PHPBrowser tests - create a separate suite.
  
class_name: AcceptanceTester
modules:
    enabled:
        - WebDriver:
            url: 'https://lambdatest.github.io/sample-todo-app/'
            host: '{username}:{token}@hub.lambdatest.com' #provide your TestMu AI credentials
            port: 80
            browser: chrome
             
            capabilities:
            name: 'Codeception Example'
            build: '1.0'   
            browserName: 'Chrome' # request the latest version of chrome
            platform: 'ANY'
            version: '71.0'
            tunnel: false # sets tunnel value to true for routing traffic through your local machine
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 Codeception test from the command line.

./vendor/bin/codecept run --steps

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 Codeception Tests Using Agent Skills​

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

The codeception-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/codeception-skill .claude/skills/

# For Cursor / Copilot
cp -r agent-skills/codeception-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/).

Last updated on

Test across 3000+ combinations of browsers, real devices & OS.

Book Demo

Help and Support

Related Articles