HAR Parser

Library to parse and generate HAR file format.

Usage

Load you HAR file with an Parser object or with Log entity.

With Parser class:

useElGigi\HarParser\Parser;
$harFile = newParser();
$log = $harFile->parse('/path/of/my/file.har', contentIsFile: true);
$log = $harFile->parse(['my' => 'har decoded']);

With Log entity class:

useElGigi\HarParser\Entities\Log;
$log = Log::load(json_decode(file_get_contents('/path/of/my/file.har'), true));

Entities

The HAR file is distributed in several entities:

• Log
  • Creator
  • Browser
  • Page[]
    • PageTimings
  • Entry[]
    • Request
      • Cookie[]
      • Header[]
      • PostData
    • Response
      • Cookie[]
      • Header[]
      • Content
    • Timings

Builder

Two builders are available to construct an HAR file from entities:

• Builder: build a Log entity from others entities
• BuilderStream: build directly the JSON file in stream to prevent memory usage

Both implements BuilderInterface:

• BuilderInterface::reset(): void: reset builder data
• BuilderInterface::setVersion(string $version): void: define version of HAR file (default: 1.2)
• BuilderInterface::setCreator(string $creator): void: set creator entity
• BuilderInterface::setBrowser(string $browser): void: set browser entity
• BuilderInterface::addPage(Page ...$page): void: add a page entity (or multiple pages)
• BuilderInterface::addEntry(Entry ...$entry): void: add an entry entity (or multiple entries)
• BuilderInterface::setComment(?string $comment): void: define comment of HAR file

For stream builder, the constructor attempt a valid resource (writeable and seekable).

For standard builder, the constructor accept an HAR file, for example, complete an existent HAR.

Anonymize HAR

In some cases, like unit tests, you need to anonymize your HAR file.

The Anonymizer class it's do for that!

class Anonymizer
{
/** * Add header to redact. * * @param string ...$regex * * @return void */publicfunctionaddHeaderToRedact(string ...$regex): void;
/** * Add query string to redact. * * @param string ...$regex * * @return void */publicfunctionaddQueryStringToRedact(string ...$regex): void;
/** * Add post data to redact. * * @param string ...$regex * * @return void */publicfunctionaddPostDataToRedact(string ...$regex): void;
/** * Add accepted mime. * * @param string ...$mime * * @return void */publicfunctionaddAcceptedMime(string ...$mime): void;
/** * Add content to redact. * * @param array $regexes * * @return void */publicfunctionaddContentToRedact(array$regexes): void;
/** * Add callback. * * @param callable ...$callback * * @return void */publicfunctionaddCallback(callable ...$callback): void;
/** * Anonymize HAR file. * * @param Log $log * * @return Log * @throws InvalidArgumentException */publicfunctionanonymize(Log$log): Log;
}