vakata/asn1

An ASN1 encoder / decoder

asn1

![Software License][ico-license] ![Code Coverage][ico-scrutinizer], _(*1)

Am ASN1 encoder / decoder., _(*2)

Install

Via Composer, _(*3)

``` bash $ composer require vakata/asn1, <sub>(*4)</sub>

## Usage

The main part of the library are the `Decoder` and `Encoder` classes.

```php
// first create an instance (there is a fromFile static method as well)
$decoded = \vakata\asn1\Decoder::fromString("...ASN1 data here ...");
// you can then inspect the parsed raw data
$decoded->structure(); // more info
$decoded->values(); // just values
// or map the data to an existing map
$decoded->map($mapArray);

// the encoder on the otherhand needs some data and a map
\vakata\asn1\Encoder::encode($dataArray, $mapArray);

There are helper classes in the structures namespace - these help with working with common known structures. All the structures have fromString and fromFile static constructor methods, and a toArray method., <sub>(*5)</sub>

``` php // Timestamp example: \vakata\asn1\structures\TimestampRequest::fromString($tsq)->toArray(); \vakata\asn1\structures\TimestampResponse::fromFile('/path/to/timestamp/response')->toArray(); \vakata\asn1\structures\TimestampRequest::generateFromFile('/path/to/file/to/timestamp'); // You can also work with Certificate, CRL, OCSPRequest, OCSPResponse, P7S, <sub>(*6)</sub>

Read more in the [API docs](api.md)

## Testing

``` bash
$ composer test

Contributing

Please see CONTRIBUTING for details., <sub>(*7)</sub>

Security

If you discover any security related issues, please email github@vakata.com instead of using the issue tracker., <sub>(*8)</sub>

Credits

• vakata
• All Contributors

License

The MIT License (MIT). Please see License File for more information., <sub>(*9)</sub>