libresign/behat-builtin-extension

Behat extension to run php built-in web server

v0.6.2 2024-03-14 20:24 UTC

Requires

• ext-sockets: *

Requires (Dev)

• bamarni/composer-bin-plugin: ^1.8
• behat/behat: ^3.12
• phpunit/phpunit: ^9.5
• roave/security-advisories: dev-latest

AGPL-3.0+

• Vitor Mattos

README

Extension to use built-in PHP server on Behat tests

Instalation

composer require libresign/behat-builtin-extension
vendor/bin/behat --init

Configuration

Add the extension to your behat.yml:

default:
  extensions:
    PhpBuiltin\Server:
      verbose: false
      rootDir: /var/www/html
      host: localhost

Config values

config	default	Environment	Description
verbose	false	BEHAT_VERBOSE	Enables/disables verbose mode
rootDir	/var/www/html	BEHAT_HOST	Specifies http root dir
host	localhost	BEHAT_ROOT_DIR	Host domain or IP
runAs		BEHAT_RUN_AS	The username to be used to run the built-in server
workers	0	BEHAT_WORKERS	The quantity of workers to use. More informations here searching by PHP_CLI_SERVER_WORKERS

You can also use -v option to enable verbose mode. Example

vendor/bin/behat -v

The verbose mode will show:

• The rootDir used
• The output of PHP Built-in server

Usage example

<?php

use Behat\Behat\Context\Context;
use PhpBuiltin\RunServerListener;

/**
 * Defines application features from the specific context.
 */
class FeatureContext implements Context
{
    private string $baseUrl;
    public function __construct()
    {
        $this->baseUrl = RunServerListener::getServerRoot();
    }

    public function sendRequest(string $verb, string $url, ?array $body = null, array $headers = []): void
    {
        $client = new Client();

        $fullUrl = $this->baseUrl . ltrim($url, '/');

        $options['headers'] = $headers;

        if (is_array($body)) {
            $options['form_params'] = $body;
        }

        try {
            $this->response = $client->{$verb}($fullUrl, $options);
        } catch (ClientException $e) {
            $this->response = $e->getResponse();
        } catch (ServerException $e) {
            $this->response = $e->getResponse();
        }
    }
}