bhittani/web-driver

A convenience wrapper around facebook's php-webdriver

0.6.0 2021-06-07 14:26 UTC

Requires

• php: >=5.6
• bhittani/download: ^0.2.0
• php-webdriver/webdriver: ^1.8
• symfony/console: *
• symfony/process: *

Requires (Dev)

• friendsofphp/php-cs-fixer: ^2.16
• phpunit/phpunit: <8

MIT

• Kamal Khan

• testing
• process
• web
• driver
• chrome
• phantomjs
• php-webdriver

README

Run and/or control a web driver programmatically.

• Requirements
• Install
  • Install chrome driver
  • Install phantomjs driver
• Usage
  • Chrome Web Driver
  • Phantomjs Web Driver
• API
  • Example
• Advanced
  • TODO
• Changelog
• Testing
• Contributing
• Security
• Credits
• License

Requirements

• PHP >= 5.6.4

Install

You may install this package using composer.

$ composer require bhittani/web-driver --prefer-dist

Install chrome driver

$ vendor/bin/install-chrome-driver

Install phantomjs driver

$ vendor/bin/install-phantomjs-driver

Usage

This package conveniently wraps the Facebook's PHP Web Driver and by default offers drivers for chrome and phantomjs.

Chrome Web Driver

First ensure you have installed the chrome driver.

<?php

use Bhittani\WebDriver\Chrome;

$driver = Chrome::make();

Phantomjs Web Driver

First ensure you have installed the phantomjs driver.

<?php

use Bhittani\WebDriver\Phantomjs;

$driver = Phantomjs::make();

API

All driver instances extend Facebook\WebDriver\Remote\RemoteWebDriver, hence, the same API applies.

Example

<?php

$googleDotCom = $driver->get('https://google.com');

$googleDotCom->getTitle(); // 'Google'

Advanced

TODO

• Document the usage of process.
• Document the usage of custom ports.
• Document the usage of payload (chrome)

Changelog

Please see CHANGELOG for more information on what has changed.

Testing

$ git clone https://github.com/kamalkhan/web-driver

$ cd web-driver

$ composer install

$ composer install-drivers

$ composer test

Contributing

Please see CONTRIBUTING and CONDUCT for details.

Security

If you discover any security related issues, please email [e-mail] instead of using the issue tracker.

Credits

• Kamal Khan
• All Contributors

License

The MIT License (MIT). Please see the License File for more information.