selenium-4 changes

Author: RutvikChandla

.gitignore

@@ -0,0 +1 @@
+/vendor

README.md

@@ -1 +1,56 @@
+# 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(
+    "browserName" => "iPhone",
+    "device" => "iPhone 11",
+    "realMobile" => "true",
+    "os_version" => "14.0",
+    "name" => "BStack-[Php] Sample Test", // test name
+    "build" => "BStack Build Number 1" // CI/CD job or build name
+);
+// IMP: Use your browserstack username and accesskey
+$web_driver = RemoteWebDriver::create("https://USERNAME:[email protected]/wd/hub",$caps);
+```
+
+3. Run tests
+Single test
+```
+php single.php
+```
+
+Local test
+Along with step-2 also use your Accesskey to bs_loca_args
+```php
+# In file ./scripts/local.php
+# You can also set an environment variable - "BROWSERSTACK_ACCESS_KEY".
+$bs_local_args = array("key" => "ACCESS_KEY");
+```
+
+```
+php single.php
+```

composer.json

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

composer.lock

@@ -0,0 +1,47 @@
+<?php
+    require_once("vendor/autoload.php");
+    use Facebook\WebDriver\Remote\RemoteWebDriver;
+    use Facebook\WebDriver\WebDriverBy;
+    use Facebook\WebDriver\WebDriverExpectedCondition;
+    use BrowserStack\Local;
+
+    # Creates an instance of Local
+    $bs_local = new Local();
+  
+    # You can also set an environment variable - "BROWSERSTACK_ACCESS_KEY".
+    $bs_local_args = array("key" => "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();
+    $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",
+    );
+    $web_driver = RemoteWebDriver::create("https://USERNAME:[email protected]/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();
+?>