Quick Guide To Run PHP Tests on LambdaTest Selenium Grid

LambdaTest Selenium Automation Grid is an on cloud Selenium grid that you can leverage to run your automation test scripts on 2000+ different browser and operating system environments. It’s a scalable, reliable, and secure online Selenium grid infrastructure that not only helps you in increasing test coverage, but also cut down execution of your test automation builds by significant margin. This post will help you get started with running your PHP based Selenium automation scripts on LambdaTest Selenium grid.

Prerequisites

Running PHP scripts require your local system to have both PHP and Composer. Here’s how you can setup your PHP environment for running Selenium scripts.

First step is to install the latest PHP build. Latest MacOS systems come with PHP pre-installed, however for windows users and linux users, you can download PHP from here.

Next step is to install Composer. Open up terminal and navigate to the folder that have PHP installed. Run the following command.

php -r "copy('https://getcomposer.org/installer', 'composer-setup.php');"
php -r "if (hash_file('sha384', 'composer-setup.php') === '93b54496392c062774670ac18b134c3b3a95e5a5e5c8f1a9f115f203b75bf9a129d5daa8ba6a13e2cc8a1da0806388a8') { echo 'Installer verified'; } else { echo 'Installer corrupt'; unlink('composer-setup.php'); } echo PHP_EOL;"
php composer-setup.php
php -r "unlink('composer-setup.php');"

php -r "copy('https://getcomposer.org/installer', 'composer-setup.php');"

php -r "if (hash_file('sha384', 'composer-setup.php') === '93b54496392c062774670ac18b134c3b3a95e5a5e5c8f1a9f115f203b75bf9a129d5daa8ba6a13e2cc8a1da0806388a8') { echo 'Installer verified'; } else { echo 'Installer corrupt'; unlink('composer-setup.php'); } echo PHP_EOL;"

php composer-setup.php

php -r "unlink('composer-setup.php');"

If you are using xampp or mamp you may have to open up PHP shell by pressing the button shown in picture below.

Once you have composer installed, you can leverage Composer to download and install Selenium dependencies. For that first create a composer.json file in your directory and add the following code to the json.

{
  "require": {
    "phpunit/phpunit-selenium": "*",
    "facebook/webdriver": "dev-master"
  } 
}

{

"require": {

"phpunit/phpunit-selenium": "*",

"facebook/webdriver": "dev-master"

}

Installing Selenium Dependencies For PHP

Now all you would have to do is to run composer to install Selenium. You can do that by running following command in your terminal:

composer install

1	composer install

If you are using Xampp or Mamp you may have to be a little more specific.

php composer.phar install

1	php composer.phar install

Sample PHP and Selenium Test To Get You started

Once you have installed and setup PHP and Selenium, you are now ready to run PHP automation scripts on LambdaTest Selenium Grid. Checkout the simple sample code below. This is a simple PHP and Selenium automation script that opens up google.com, search LambdaTest in google search and outputs the title of the resultant google search page. You can also fork it from our PHP GitHub repository.

PHP Sample Test

<?php
 
/*
    LambdaTest selenium automation sample example
    Configuration
    ----------
    username: Username can be found at automation dashboard
    accessToken:  AccessToken can be generated from automation dashboard or profile section
 
    Result
    -------
    Execute PHP Automation Tests on LambdaTest Distributed Selenium Grid
*/
 
require 'vendor/autoload.php';
 
class LambdaTest{
 
  /*
      Setup remote driver
      Params
      ----------
      platform : Supported platform - (Windows 10, Windows 8.1, Windows 8, Windows 7, macOS High Sierra, macOS Sierra, OS X El Capitan, OS X Yosemite, OS X Mavericks)
      browserName : Supported platform - (chrome, firefox, Internet Explorer, MicrosoftEdge, Safari)
      version :  Supported list of version can be found at https://www.lambdatest.com/capabilities-generator/
  */
  protected static $driver;
 
  public function searchTextOnGoogle() {
    # username: Username can be found at automation dashboard      
    $LT_USERNAME = "{username}";
     
    # accessKey:  AccessKey can be generated from automation dashboard or profile section
    $LT_APPKEY = "{accessKey}";
 
    $LT_BROWSER = "chrome";
    $LT_BROWSER_VERSION ="63.0";
    $LT_PLATFORM = "windows 10";
     
    # URL: https://{username}:{accessToken}@hub.lambdatest.com/wd/hub
    $url = "https://". $LT_USERNAME .":" . $LT_APPKEY ."@hub.lambdatest.com/wd/hub";       
     
    # setting desired capabilities for the test
    $desired_capabilities = new DesiredCapabilities();
        $desired_capabilities->setCapability('browserName',$LT_BROWSER);
        $desired_capabilities->setCapability('version', $LT_BROWSER_VERSION);
        $desired_capabilities->setCapability('platform', $LT_PLATFORM);
        $desired_capabilities->setCapability('name', "Php");
        $desired_capabilities->setCapability('build', "Php Build");
        $desired_capabilities->setCapability('network', true);
        $desired_capabilities->setCapability('visual', true);
        $desired_capabilities->setCapability('video ', true);
        $desired_capabilities->setCapability('console', true);
     
    /*
        Setup remote driver
        Params
        ----------
        Execute test:  navigate google.com search LambdaTest
        Result
        -------
        print title
    */
        self::$driver = RemoteWebDriver::create($url, $desired_capabilities);      
                 
    self::$driver->get("https://www.google.com/ncr");
 
        $element = self::$driver->findElement(WebDriverBy::name("q"));
    if($element) {
      $element->sendKeys("LambdaTest");
      $element->submit();
    }
     
    print self::$driver->getTitle();
    self::$driver->quit();
  }    
}
 
$lambdaTest = new LambdaTest();
$lambdaTest->searchTextOnGoogle(); 
 
?>

<?php

LambdaTest selenium automation sample example

Configuration

----------

username: Username can be found at automation dashboard

accessToken: AccessToken can be generated from automation dashboard or profile section

Result

-------

Execute PHP Automation Tests on LambdaTest Distributed Selenium Grid

require 'vendor/autoload.php';

class LambdaTest{

Setup remote driver

Params

----------

platform : Supported platform - (Windows 10, Windows 8.1, Windows 8, Windows 7, macOS High Sierra, macOS Sierra, OS X El Capitan, OS X Yosemite, OS X Mavericks)

browserName : Supported platform - (chrome, firefox, Internet Explorer, MicrosoftEdge, Safari)

version : Supported list of version can be found at https://www.lambdatest.com/capabilities-generator/

protected static $driver;

public function searchTextOnGoogle() {

# username: Username can be found at automation dashboard

$LT_USERNAME = "{username}";

# accessKey: AccessKey can be generated from automation dashboard or profile section

$LT_APPKEY = "{accessKey}";

$LT_BROWSER = "chrome";

$LT_BROWSER_VERSION ="63.0";

$LT_PLATFORM = "windows 10";

# URL: https://{username}:{accessToken}@hub.lambdatest.com/wd/hub

$url = "https://". $LT_USERNAME .":" . $LT_APPKEY ."@hub.lambdatest.com/wd/hub";

# setting desired capabilities for the test

$desired_capabilities = new DesiredCapabilities();

$desired_capabilities->setCapability('browserName',$LT_BROWSER);

$desired_capabilities->setCapability('version', $LT_BROWSER_VERSION);

$desired_capabilities->setCapability('platform', $LT_PLATFORM);

$desired_capabilities->setCapability('name', "Php");

$desired_capabilities->setCapability('build', "Php Build");

$desired_capabilities->setCapability('network', true);

$desired_capabilities->setCapability('visual', true);

$desired_capabilities->setCapability('video ', true);

$desired_capabilities->setCapability('console', true);

Setup remote driver

Params

----------

Execute test: navigate google.com search LambdaTest

Result

-------

print title

self::$driver = RemoteWebDriver::create($url, $desired_capabilities);

self::$driver->get("https://www.google.com/ncr");

$element = self::$driver->findElement(WebDriverBy::name("q"));

if($element) {

$element->sendKeys("LambdaTest");

$element->submit();

}

print self::$driver->getTitle();

self::$driver->quit();

}

$lambdaTest = new LambdaTest();

$lambdaTest->searchTextOnGoogle();

You can execute the test from your terminal through this command.

vendor/bin/phpunit lambdatest.php

1	vendor/bin/phpunit lambdatest.php

Do note the use of remote webdriver here. We have passed browser environment configurations through capabilities class. You can set your environment details as you wish.

To setup your own environment for the test you can leverage our Capability Generator tool.

Tear Down: The tear down method helps LambdaTest platform understand when the execution of a test is finished. It’s important to tear down each test or else it will give timeout errors