trait XdebugRequestTrait

Same name in other branches
  1. 9 core/tests/Drupal/Tests/XdebugRequestTrait.php \Drupal\Tests\XdebugRequestTrait
  2. 10 core/tests/Drupal/Tests/XdebugRequestTrait.php \Drupal\Tests\XdebugRequestTrait
  3. 11.x core/tests/Drupal/Tests/XdebugRequestTrait.php \Drupal\Tests\XdebugRequestTrait

Hierarchy

1 file declares its use of XdebugRequestTrait
WebTestBase.php in core/modules/simpletest/src/WebTestBase.php

File

core/tests/Drupal/Tests/XdebugRequestTrait.php, line 7

Namespace

Drupal\Tests
View source
trait XdebugRequestTrait {
    
    /**
     * Adds xdebug cookies, from request setup.
     *
     * In order to debug web tests you need to either set a cookie, have the
     * Xdebug session in the URL or set an environment variable in case of CLI
     * requests. If the developer listens to connection on the parent site, by
     * default the cookie is not forwarded to the client side, so you cannot
     * debug the code running on the child site. In order to make debuggers work
     * this bit of information is forwarded. Make sure that the debugger listens
     * to at least three external connections.
     *
     * @param \Symfony\Component\HttpFoundation\Request $request
     *   The request.
     *
     * @return array
     *   The extracted cookies.
     */
    protected function extractCookiesFromRequest(Request $request) {
        $cookie_params = $request->cookies;
        $cookies = [];
        if ($cookie_params->has('XDEBUG_SESSION')) {
            $cookies['XDEBUG_SESSION'][] = $cookie_params->get('XDEBUG_SESSION');
        }
        // For CLI requests, the information is stored in $_SERVER.
        $server = $request->server;
        if ($server->has('XDEBUG_CONFIG')) {
            // $_SERVER['XDEBUG_CONFIG'] has the form "key1=value1 key2=value2 ...".
            $pairs = explode(' ', $server->get('XDEBUG_CONFIG'));
            foreach ($pairs as $pair) {
                list($key, $value) = explode('=', $pair);
                // Account for key-value pairs being separated by multiple spaces.
                if (trim($key, ' ') == 'idekey') {
                    $cookies['XDEBUG_SESSION'][] = trim($value, ' ');
                }
            }
        }
        return $cookies;
    }

}

Members

Title Sort descending Modifiers Object type Summary
XdebugRequestTrait::extractCookiesFromRequest protected function Adds xdebug cookies, from request setup.

Buggy or inaccurate documentation? Please file an issue. Need support? Need help programming? Connect with the Drupal community.