ciaranmcnulty/behat-psr7extension

0.1 2017-05-06 18:32 UTC

Requires

• php: ^7.0
• behat/mink-browserkit-driver: ^1.0
• behat/mink-extension: ^2.0
• psr/http-message: ^1.0
• symfony/http-foundation: ^3.0
• symfony/http-kernel: ^3.0
• symfony/psr-http-message-bridge: ^1.0
• zendframework/zend-diactoros: ^1.0

Requires (Dev)

• behat/behat: ^3.3
• phpunit/phpunit: ^6.1
• slim/slim: ^3.8
• zendframework/zend-expressive: ^2.0.3
• zendframework/zend-expressive-fastroute: ^2.0.0
• zendframework/zend-servicemanager: ^3.3.0

MIT

• Ciaran McNulty

README

This is a proof of concept to show that Behat can drive a PSR-7 application without going via a webserver

It's currently built by combining:

• The existing Mink Browserkit driver, that can test a Symfony app
• The existing Symfony to PSR-7 bridge, to translate requests and resources back and forth

... and integrating into a behat extension

Usage

Install via composer and configure your behat.yml, specifying the php file that will bootstrap the app (see below):

extensions:
  Cjm\Behat\Psr7Extension:
    app: %paths.base%/path/to/file.php

You can then also modify your MinkExtension configuration to use the PSR-7 driver, e.g.:

extensions:
Behat\MinkExtension:
  base_url:  'http://localhost'
  sessions:
    default:
      psr7: ~

Because there is no current standard interface for PSR-7-handling apps, you will need to select one of the following supported approaches.

Zend Expressive applications

Your configuration file will need to return your application file, bootstrapped. For example:

$container = require __DIR__ . '/../config/container.php';
return $container->get('Zend\Expressive\Application');

Slim applications

Your configuration file will need to return your application file, bootstrapped. For example:

<?php

$app = new \Slim\App;
// .. any necessary bootstrapping
return $app;

All other PSR-7 applications

As long as you can write a function that takes a request and returns a response, you should be able to test your app. Your configuration file will need to return return a callable with the right signature. For example:

<?php

use Psr\Http\Message\RequestInterface;
use Psr\Http\Message\ResponseInterface;

// bootstrap your application
$app = new My\App();

return function (RequestInterface $request) use ($app) : ResponseInterface
{
    // exercise your application however you normally would
    return $app->handle($request);
};