php-webdriver – Selenium WebDriver bindings for PHP
Php-webdriver library is PHP language binding for Selenium WebDriver, which allows you to control web browsers from PHP.
This library is compatible with Selenium server version 2.x and 3.x. It implements the JsonWireProtocol, which is currently supported by the Selenium server and will also implement the W3C WebDriver specification in the future.
The concepts of this library are very similar to the "official" Java, .NET, Python and Ruby bindings from the Selenium project.
As of 2013, this PHP client has been rewritten from scratch. Using the old version? Check out Adam Goucher's fork of it.
Looking for API documentation of php-webdriver? See https://facebook.github.io/php-webdriver/
Any complaints, questions, or ideas? Post them in the user group https://www.facebook.com/groups/phpwebdriver/.
Installation is possible using Composer.
If you don't already use Composer, you can download the
curl -sS https://getcomposer.org/installer | php
Then install the library:
php composer.phar require facebook/webdriver
The required server is the
selenium-server-standalone-#.jar file provided here: http://selenium-release.storage.googleapis.com/index.html
Download and run the server by replacing # with the current server version. Keep in mind you must have Java 8+ installed to run this command.
java -jar selenium-server-standalone-#.jar
NOTE: If using Firefox, see alternate command below.
Create a Browser Session
When creating a browser session, be sure to pass the url of your running server.
// This would be the url of the host running the server-standalone.jar $host = 'http://localhost:4444/wd/hub'; // this is the default
Make sure to have latest Chrome and Chromedriver versions installed.
$driver = RemoteWebDriver::create($host, DesiredCapabilities::chrome());
Make sure to have latest Firefox and Geckodriver installed.
Because Firefox (and Geckodriver) only support the new W3C WebDriver protocol (which is yet to be implemented by php-webdriver - see issue #469), the protocols must be translated by Selenium Server - this feature is partially available in Selenium Server versions 3.5.0-3.8.1 and you can enable it like this:
java -jar selenium-server-standalone-3.8.1.jar -enablePassThrough false
Now you can start Firefox from your code:
$driver = RemoteWebDriver::create($host, DesiredCapabilities::firefox());
Customize Desired Capabilities
$desired_capabilities = DesiredCapabilities::firefox(); $desired_capabilities->setCapability('acceptSslCerts', false); $driver = RemoteWebDriver::create($host, $desired_capabilities);
- See https://github.com/SeleniumHQ/selenium/wiki/DesiredCapabilities for more details.
NOTE: Above snippets are not intended to be a working example by simply copy-pasting. See example.php for working example.
For latest changes see CHANGELOG.md file.
Some how-tos are provided right here in our GitHub wiki.
Testing framework integration
To take advantage of automatized testing you may want to integrate php-webdriver to your testing framework. There are some projects already providing this:
- Steward integrates php-webdriver directly to PHPUnit, and provides parallelization
- Codeception testing framework provides BDD-layer on top of php-webdriver in its WebDriver module
- You can also check out this blogpost + demo project, describing simple PHPUnit integration
We have a great community willing to help you!
- Via our Facebook Group - If you have questions or are an active contributor consider joining our facebook group and contribute to communal discussion and support
- Via StackOverflow - You can also ask a question or find many already answered question on StackOverflow
- Via GitHub - Another option if you have a question (or bug report) is to submit it here as an new issue
We love to have your help to make php-webdriver better. See CONTRIBUTING.md for more information about contributing and developing php-webdriver.