- PHP 7.3+
- The
ext-json
extension.
composer require deviantintegral/har
, or
download the CLI tool.
This library supports reading and writing HTTP Archive files. These archives are JSON objects containing one or more HTTP request and response pairs. In particular, this library is useful for taking HTTP requests exported from a browser's developer tools or with a proxy like mitmproxy and using them as mocks in tests.
Features include:
- Reading a HAR into a fully-typed set of classes.
- Writing a
\Deviantintegral\Har\Har
back out into a HAR JSON string. - Adapters for PSR-7 Request and Response interfaces.
- An interface and
\Deviantintegral\Har\HarRepository
class to load HARs from a filesystem or other backend. - A CLI tool to split a HAR file into single files per request / response pair.
See ReadmeTest.php for an example of how to use this library.
The HAR specification documents some fields as -1
if they do not have a
value. Other fields, like comment
, may be omitted.
Fields that may be omitted will have a has
method that should be called
before calling get
. For integer fields, the return value must be checked for
-1
.
This library aims to preserve the actual JSON representation of loaded objects. However, in some cases, this is not possible. In particular, PHP only supports up to 6 digits in ISO 8601 timestamps, so any additional precision is lost. See HarTest for an example that checks the reading and writing of a HAR.