Xdebug support in PHPStorm

.gitignore

@@ -2,3 +2,5 @@
 *.phar
 composer.lock
 vendor
+.idea
+behat.yml

behat.yml.dist

@@ -2,7 +2,9 @@ default:
   suites:
     default:
       path: %paths.base%/features
-      contexts: [Behat\MinkExtension\Context\MinkContext]
+      contexts:
+        - Behat\MinkExtension\Context\MinkContext
+        - Behat\MinkExtension\Tests\FeatureContext
   extensions:
     Behat\MinkExtension:
       base_url: http://en.wikipedia.org/

composer.json

@@ -1,40 +1,48 @@
 {
-    "name": "behat/mink-extension",
-    "type": "behat-extension",
-    "description": "Mink extension for Behat",
-    "keywords": ["web", "test", "browser", "gui"],
-    "homepage": "http://extensions.behat.org/mink",
-    "license": "MIT",
-    "authors": [
-        {
-            "name": "Konstantin Kudryashov",
-            "email": "[email protected]"
-        },
-        {
-            "name": "Christophe Coevoet",
-            "email": "[email protected]"
-        }
-    ],
-
-    "require": {
-        "php":          ">=5.3.2",
-        "behat/behat":  "~3.0,>=3.0.5",
-        "behat/mink":   "~1.5",
-        "symfony/config": "~2.2|~3.0"
+  "name": "behat/mink-extension",
+  "type": "behat-extension",
+  "description": "Mink extension for Behat",
+  "keywords": [
+    "web",
+    "test",
+    "browser",
+    "gui"
+  ],
+  "homepage": "http://extensions.behat.org/mink",
+  "license": "MIT",
+  "authors": [
+    {
+      "name": "Konstantin Kudryashov",
+      "email": "[email protected]"
     },
-
-    "require-dev": {
-        "phpspec/phpspec":          "~2.0",
-        "behat/mink-goutte-driver": "~1.1"
-    },
-
-    "autoload": {
-        "psr-0": { "Behat\\MinkExtension": "src/" }
-    },
-
-    "extra": {
-        "branch-alias": {
-            "dev-master": "2.1.x-dev"
-        }
+    {
+      "name": "Christophe Coevoet",
+      "email": "[email protected]"
+    }
+  ],
+  "require": {
+    "php": ">=5.3.2",
+    "behat/behat": "~3.0,>=3.0.5",
+    "behat/mink": "~1.5",
+    "symfony/config": "~2.2|~3.0"
+  },
+  "require-dev": {
+    "phpspec/phpspec": "~2.0",
+    "behat/mink-goutte-driver": "~1.1"
+  },
+  "autoload": {
+    "psr-0": {
+      "Behat\\MinkExtension": "src/"
+    }
+  },
+  "autoload-dev": {
+    "psr-4": {
+      "Behat\\MinkExtension\\Tests\\": "features/src"
+    }
+  },
+  "extra": {
+    "branch-alias": {
+      "dev-master": "2.1.x-dev"
     }
+  }
 }

features/src/FeatureContext.php

@@ -0,0 +1,54 @@
+<?php
+
+namespace Behat\MinkExtension\Tests;
+
+use Behat\Mink\Exception\ExpectationException;
+use Behat\MinkExtension\Context\RawMinkContext;
+
+/**
+ * Feature context for testing advanced scenarios.
+ */
+class FeatureContext extends RawMinkContext
+{
+
+    /**
+     * @BeforeScenario @MockXdebug
+     */
+    public function setUpXdebugMock()
+    {
+        $_SERVER['XDEBUG_CONFIG'] = 'xdebug';
+    }
+
+    /**
+     * @Then /^I should have the "([^"]*)" cookie with value "([^"]*)"$/
+     */
+    public function iShouldHaveTheCookieWithValue($cookie_name, $cookie_expected_value) {
+        if ($cookie_real_value = $this->getSession()->getCookie($cookie_name)) {
+            if ($cookie_real_value !== $cookie_expected_value) {
+                throw new ExpectationException(
+                  'The cookie with name ' . $cookie_name . ' was found, but does not contain ' . $cookie_real_value . ', yet it contains ' . $cookie_expected_value . '.',
+                  $this->getSession()
+                );
+            }
+        } else {
+            throw new ExpectationException(
+              'The cookie with name ' . $cookie_name . ' was not found',
+              $this->getSession()
+            );
+        }
+    }
+
+    /**
+     * @Then /^I should not have the "([^"]*)" cookie$/
+     */
+    public function iShouldNotHaveTheCookie($cookie_name)
+    {
+        if ($cookie_real_value = $this->getSession()->getCookie($cookie_name)) {
+            throw new ExpectationException(
+              'The cookie with name ' . $cookie_name . ' was not found, but it should not be present.',
+              $this->getSession()
+            );
+        }
+    }
+
+}

features/xdebug.feature

@@ -0,0 +1,13 @@
+Feature: Xdebug
+  In order to properly develop with BDD
+  As a feature developer
+  I need to be able to use my debugger
+
+  Scenario: Xdebug cookie should not be present on normal requests
+    Given I am on "/wiki/Main_Page"
+    Then I should not have the "XDEBUG_SESSION" cookie
+
+  @MockXdebug
+  Scenario: Xdebug cookie should be passed on to requests
+    Given I am on "/wiki/Main_Page"
+    Then I should have the "XDEBUG_SESSION" cookie with value "xdebug"

src/Behat/MinkExtension/Context/RawMinkContext.php

@@ -25,6 +25,18 @@ class RawMinkContext implements MinkAwareContext
     private $mink;
     private $minkParameters;
 
+    /**
+     * Currently supports PHPSTORM.
+     *
+     * @beforeScenario
+     */
+    public function setUpXdebugIfIdeIsConfigured()
+    {
+        if (isset($_SERVER['XDEBUG_CONFIG'])) {
+            $this->getSession()->setCookie('XDEBUG_SESSION', 'xdebug');
+        }
+    }
+
     /**
      * Sets Mink instance.
      *