Merge pull request #1 from RutvikChandla/selenium-4

selenium-4 changes

Author: francisf

.gitignore

@@ -0,0 +1,2 @@
+/vendor
+/composer.phar

README.md

@@ -1 +1,60 @@
+# php-selenium-browserstack
 
+## Prerequisites 
+1. `php` and `composer` should be installed in your system
+2. Go to the directory where you have your test scripts and run the command below:
+```
+  composer require php-webdriver/webdriver
+```
+
+## Steps to run test sessions
+1. Install dependencies
+```
+  # If you don't already use Composer, you can download the composer.phar binary:
+  curl -sS https://getcomposer.org/installer | php
+
+  # Include the binding:
+  php composer.phar require browserstack/local:dev-master
+
+  # Install all the dependencies:
+  php composer.phar install
+
+  # Test the installation by running a simple test file, check out example.php in the main repository.
+```
+2. Configure test capabilities
+(To run single test, navigate to ./scripts/single.php)
+
+```php
+$caps = array(
+	'bstack:options' => array(
+		"os" => "OS X",
+		"osVersion" => "Sierra",
+		"buildName" => "Final-Snippet-Test",
+		"sessionName" => "Selenium-4 PHP snippet test",
+		"local" => "false",
+		"seleniumVersion" => "4.0.0",
+	),
+	"browserName" => "Chrome",
+	"browserVersion" => "latest",
+);
+
+// Set you credentails
+$BROWSERSTACK_USERNAME = "BROWSERSTACK_USERNAME";
+$BROWSERSTACK_ACCESS_KEY = "BROWSERSTACK_ACCESS_KEY";
+```
+
+## To run tests
+### Single test
+Run single test session by running.
+```
+php single.php
+```
+### Local test
+Run local test session by running.
+```php
+# Update "BROWSERSTACK_ACCESS_KEY" in bs_local.
+$bs_local_args = array("key" => "ACCESS_KEY");
+```
+```
+php local.php
+```

composer.json

@@ -0,0 +1,6 @@
+{
+    "require": {
+        "browserstack/browserstack-local": "^1.1",
+        "php-webdriver/webdriver": "^1.12"
+    }
+}

composer.lock

@@ -0,0 +1,51 @@
+<?php
+    require_once("vendor/autoload.php");
+    use Facebook\WebDriver\Remote\RemoteWebDriver;
+    use Facebook\WebDriver\WebDriverBy;
+    use Facebook\WebDriver\WebDriverExpectedCondition;
+    use BrowserStack\Local;
+
+    $caps = array(
+        'bstack:options' => array(
+            "os" => "OS X",
+            "osVersion" => "Sierra",
+            "buildName" => "Final-Snippet-Test",
+            "sessionName" => "Selenium-4 PHP snippet test",
+            "local" => "true",
+            "seleniumVersion" => "4.0.0",
+        ),
+        "browserName" => "Chrome",
+        "browserVersion" => "latest",
+    );
+    $BROWSERSTACK_USERNAME = "BROWSERSTACK_USERNAME";
+    $BROWSERSTACK_ACCESS_KEY = "BROWSERSTACK_ACCESS_KEY";
+
+    # Creates an instance of Local
+    $bs_local = new Local();
+
+    # You can also set an environment variable - "BROWSERSTACK_ACCESS_KEY".
+    $bs_local_args = array("key" => $BROWSERSTACK_ACCESS_KEY);
+    # Starts the Local instance with the required arguments
+    $bs_local->start($bs_local_args);
+
+    # Check if BrowserStack local instance is running
+    echo $bs_local->isRunning();
+
+    $web_driver = RemoteWebDriver::create("https://$BROWSERSTACK_USERNAME:$BROWSERSTACK_ACCESS_KEY@hub-cloud.browserstack.com/wd/hub",$caps);
+    try{
+        $web_driver->get("http://bs-local.com:45691/check");
+        $body_text = $web_driver->wait(10000)->until(WebDriverExpectedCondition::presenceOfElementLocated(WebDriverBy::cssSelector("body")))->getText();
+        # Setting the status of test as 'passed' or 'failed' based on the condition; if title of the web page starts with 'BrowserStack'
+        if ($body_text == "Up and running"){
+            $web_driver->executeScript('browserstack_executor: {"action": "setSessionStatus", "arguments": {"status":"passed", "reason": "Local test ran successfully"}}' );
+        }  else {
+            $web_driver->executeScript('browserstack_executor: {"action": "setSessionStatus", "arguments": {"status":"failed", "reason": "Failed to load local test"}}');
+        }
+    }
+    catch(Exception $e){
+        echo 'Message: ' .$e->getMessage();
+    }
+    $web_driver->quit();
+      # Stop the Local instance
+    $bs_local->stop();
+?>