nearsoft/php-selenium-client

This library allows creating Selenium Server V2 tests in PHP. It communicates with the WebDriver API through the official JsonWireProtocol.

PHP-SeleniumClient

PHP interaction with Selenium Webdriver API, _(*1)

Description

This library allows the interaction with Selenium Server V2 in PHP. It communicates with the WebDriver API through the official JsonWireProtocol., _(*2)

One of the goals is to provide a client usage as close as possible to the Selenium Official libraries (such as Java's, c#'s). Most methods are named as the same as of these libraries'. In this way, whenever a developer runs into ideas or documentation in Java Client, the same techniques can be implemented by using this library., _(*3)

Documentation

Version 2, _(*4)

Version 1, _(*5)

Quickstart

• Start a session by creating an instance of WebDriver. By default, the test will run in firefox, _(*6)

  $driver = new WebDriver();

• As an alternative you can define desired capabilities for the session, _(*7)

  $desiredCapabilities = new DesiredCapabilities("chrome");
  $driver = new WebDriver($desiredCapabilities);

• Navigate by using the WebDriver::get method from the WebDriver Class, _(*8)

  $driver->get("www.nearsoft.com");

• Get elements from the DOM in current location, _(*9)

  $textbox1 = $driver->findElement(By::id("someTextBoxId"));
  
  $button1 = $driver->findElement(By::cssSelector("html body div#content input#someButtonId"));

• Manipulate located elements, _(*10)

  $textbox1->sendKeys("Some text to send");
  
  $textbox1->getAttribute("value");
  
  $button1->click();

• Find element within elements, _(*11)

  $modal1->findElement(By::id("someModalId"));
  $listItems = $modal1->findElements(By::tagName("li"));

• Switch between windows, _(*12)

  $driver->switchTo()->window("windowName");

• Manage alerts $alert = $driver->switchTo()->alert(); $alert->getText(); $alert->accept(); $alert->dismiss();, _(*13)

• Wait for elements to be present, _(*14)

  $webElement = $driver->waitForElementUntilIsPresent(By::id("someElementId"));
  
  //or
  
  $wait = new WebDriverWait(8);
  $webElement = $wait->until($driver,"findElement",array(By::id("someElementId"),true));