mcustiel / phiremock-codeception-extension
Codeception extension for Phiremock. Allows to stub remote services for HTTP requests.
Installs: 703 921
Dependents: 6
Suggesters: 1
Security: 0
Stars: 29
Watchers: 6
Forks: 19
Open Issues: 0
Type:project
Requires
- php: ^8.0
- codeception/codeception: ^5.0
- symfony/process: >=5.0.0 <8.0.0
Requires (Dev)
- codeception/module-phpbrowser: ^3.0
- codeception/module-rest: ^3.0
- guzzlehttp/guzzle: ^7.0
- mcustiel/phiremock-server: ^1.0
Suggests
- guzzlehttp/guzzle: Version 6 to execute phiremock-server as default
- mcustiel/phiremock-server: As a dev-requirement. Allows the extension to start phiremock automatically from vendor/bin
- dev-master
- v3.1.0
- v3.0.0
- v2.2.2
- v2.2.1
- v2.2.0
- v2.1.3
- v2.1.2
- v2.1.1
- v2.1.0
- v2.0.0
- v2.0.0-beta.1
- v1.9.0
- v1.8.1
- v1.8.0
- v1.7.0
- v1.6.0
- v1.5.4
- v1.5.3
- v1.5.2
- v1.5.1
- v1.5.0
- v1.4.1
- v1.4.0
- v1.3.2
- v1.3.1
- v1.3.0
- v1.2.4
- v1.2.3
- v1.2.2
- v1.2.1
- v1.2.0
- v1.1.0
- v1.0.1
- v1.0.0
- dev-version-3.x
- dev-version-2.x
- dev-version-1.x
This package is auto-updated.
Last update: 2024-10-22 18:25:46 UTC
README
Codeception extension to make working with Phiremock Server even easier. It allows to start a Phiremock Server before a suite is executed and stop it when the suite ends.
Installation
Composer:
"require-dev": { "mcustiel/phiremock-codeception-extension": "^3.0" }
Optionally, you can install Phiremock Server in case you want to have it between your dependencies. If not, you need to specify the path to phiremock in the configuration.
"require-dev": { "mcustiel/phiremock-codeception-extension": "^2.0", "mcustiel/phiremock-server": "^1.0", "guzzlehttp/guzzle": "^6.0" }
Phiremock server has been made an optional dependency in case you want to run it from a phar file, a global composer dependency or in a docker container, and not have it as a project dependency.
Configuration
extensions: enabled: - \Codeception\Extension\Phiremock config: \Codeception\Extension\Phiremock: listen: 127.0.0.1:18080 # defaults to 0.0.0.0:8086 bin_path: ../vendor/bin # defaults to codeception_dir/../vendor/bin logs_path: /var/log/my_app/tests/logs # defaults to codeception's tests output dir debug: true # defaults to false wait_until_ready: true # defaults to false wait_until_ready_timeout: 15 # (seconds) defaults to 30 wait_until_ready_interval: 100 # (microseconds) defaults to 50000 expectations_path: /my/expectations/path # defaults to tests/_expectations server_factory: \My\FactoryClass # defaults to 'default' extra_instances: [] # deaults to an empty array suites: [] # defaults to an empty array certificate: /path/to/cert # defaults to null certificate_key: /path/to/cert-key # defaults to null cert_passphrase: 'my-pass' # defaults to null
Note: Since Codeception version 2.2.7, extensions configuration can be added directly in the suite configuration file. That will avoid phiremock to be started for every suite.
Parameters
listen
Specifies the interface and port where phiremock must listen for requests.
Default: 0.0.0.0:8086
bin_path
Path where Phiremock Server's "binary" is located. You can, for instance, point to the location of the phar in your file system.
Default: codeception_dir/../vendor/bin/phiremock
logs_path
Path where to write the output.
Default: codeception's tests output dir
debug
Whether to write debug data to log file.
Default: false
start_delay
Time to wait after Phiremock Server is started before running the tests (used to give time to Phiremock Server to boot)
Default: 0
wait_until_ready
This is more robust alternative to start_delay. It will check if Phiremock Server is actually running before running the tests. Note: it depends on Phiremeock Client to be installed via composer (it is used to check the status of Phiremock Server).
Default: false
wait_until_ready_timeout
This will be used only if wait_until_ready is set to true. You can specify after how many seconds it will stop checking if Phiremock Server is running.
Default: 30
expectations_path
Specifies a directory to search for json files defining expectations to load by default.
Default: codecption_dir/_expectations
certificate
Path to a certificate file to allow phiremock-server to listen for secure https connections.
Default: null. Meaning phiremock will only listen on unsecured http connections.
certificate-key
Path to the certificate key file.
Default: null.
cert-passphrase
Path to the certificate passphrase used to encrypt the certificate (only needed if encrypted).
Default: null. Meaning no decryption based in passphrase will be performed.
suites
Specifies a list of suites for which the phiremock-server must be executed.
Default: [] Empty array, meaning that phiremock will be executed for each suite.
extra_instances
Allows to specify more instances of phiremock-server to run. This is useful if you want, for instance, run one instance listening for http and one listening for https connections. Each instance has its own configuration, and can separately run for different suites.
Default: [] Empty array, meaning that no extra phiremock-server instances are configured.
Example:
extensions: enabled: - \Codeception\Extension\Phiremock config: \Codeception\Extension\Phiremock: listen: 127.0.0.1:18080 debug: true expectations_path: /my/expectations/path-1 suites: - acceptance extra_instances: - listen: 127.0.0.1:18081 debug: true start_delay: 1 expectations_path: /my/expectations/path-2 suites: - acceptance - api certificate: /path/to/cert certificate_key: /path/to/cert-key cert_passphrase: 'my-pass'
server_factory
Specifies a Factory class extending \Mcustiel\Phiremock\Server\Factory\Factory
. Useful if you want to provide your own PSR. This works only if you install phiremock as a local dependency required in your composer file.
Default: default
Example: If this is in your composer.json:
"require-dev": { "mcustiel/phiremock-codeception-extension": "v2.0", "mcustiel/phiremock-server": "^1.0", "guzzlehttp/guzzle": "^7.0"
Then you can create a factory as follows:
<?php namespace My\Namespace; use GuzzleHttp; use Mcustiel\Phiremock\Server\Factory\Factory; use Psr\Http\Client\ClientInterface; class FactoryWithGuzzle7 extends Factory { public function createHttpClient(): ClientInterface { return new GuzzleHttp\Client(); } }
and in the extension config provide the fully qualified namespace to that class:
enabled: - \Codeception\Extension\Phiremock config: \Codeception\Extension\Phiremock: server_factory: \My\Namespace\FactoryWithGuzzle7
See also:
- Phiremock Server: https://github.com/mcustiel/phiremock-server
- Phiremock Codeception Module: https://github.com/mcustiel/phiremock-codeception-module