README

一个PHP框架，允许您使用ASN.1结构编码ITU-T X.690编码规则进行编码和解码。这种编码在X.509 PKI环境或异构计算机系统之间的通信中非常常用。

API允许您将ASN.1结构编码成二进制数据，如证书签名请求（CSR）、X.509证书或证书吊销列表（CRL）。PHPASN1还可以读取BER编码的二进制数据到单独的PHP对象中，这些对象可以由用户操作，然后重新编码。

现在可以在CHANGELOG.md中找到变更日志。

依赖关系

PHPASN1需要受安全支持的安全PHP版本以及gmp或bcmath扩展。

对旧PHP版本的支持

对于PHP 5版本，使用v1.x。
对于PHP 7版本，使用v2.5.x。

直接从网络加载对象标识符名称时使用curl。

安装

安装此库的首选方法是依靠Composer。

$ composer require genkgo/php-asn1

用法

编码ASN.1结构

PHPASN1为每个实现的ASN.1通用类型提供一个类。构造函数应该是相当直观的，所以您应该没有太大困难开始使用。所有数据都将使用DER编码进行编码。

use FG\ASN1\OID;
use FG\ASN1\Universal\Integer;
use FG\ASN1\Universal\Boolean;
use FG\ASN1\Universal\Enumerated;
use FG\ASN1\Universal\IA5String;
use FG\ASN1\Universal\ObjectIdentifier;
use FG\ASN1\Universal\PrintableString;
use FG\ASN1\Universal\Sequence;
use FG\ASN1\Universal\Set;
use FG\ASN1\Universal\NullObject;

$integer = new Integer(123456);        
$boolean = new Boolean(true);
$enum = new Enumerated(1);
$ia5String = new IA5String('Hello world');

$asnNull = new NullObject();
$objectIdentifier1 = new ObjectIdentifier('1.2.250.1.16.9');
$objectIdentifier2 = new ObjectIdentifier(OID::RSA_ENCRYPTION);
$printableString = new PrintableString('Foo bar');

$sequence = new Sequence($integer, $boolean, $enum, $ia5String);
$set = new Set($sequence, $asnNull, $objectIdentifier1, $objectIdentifier2, $printableString);

$myBinary  = $sequence->getBinary();
$myBinary .= $set->getBinary();

echo base64_encode($myBinary);

解码二进制数据

解码BER编码的二进制数据与编码一样简单

use FG\ASN1\ASNObject;

$base64String = ...
$binaryData = base64_decode($base64String);        
$asnObject = ASNObject::fromBinary($binaryData);


// do stuff

如果您已经确切知道预期的数据应该是什么样子，可以使用FG\ASN1\TemplateParser

use FG\ASN1\TemplateParser;

// first define your template
$template = [
    Identifier::SEQUENCE => [
        Identifier::SET => [
            Identifier::OBJECT_IDENTIFIER,
            Identifier::SEQUENCE => [
                Identifier::INTEGER,
                Identifier::BITSTRING,
            ]
        ]
    ]
];

// if your binary data is not matching the template you provided this will throw an `\Exception`:
$parser = new TemplateParser();
$object = $parser->parseBinary($data, $template);

// there is also a convenience function if you parse binary data from base64:
$object = $parser->parseBase64($data, $template);

您可以使用此函数确保数据确实具有您所期望的格式。

导航解码数据

所有构造的类（即Sequence和Set）都可以通过数组访问或使用迭代器进行导航。您可以在以下位置找到示例：这里，这里和这里。

给我更多示例！

要查看API类的一些示例用法或一些生成的输出，请查看示例。

贡献

我该如何贡献？

该项目不再维护，因此不接受任何新的贡献。

历史贡献者

非常感谢Friedrich Große。他维护了这个库11年。当然，还要感谢迄今为止的所有贡献者！

许可

本库遵循 MIT 许可协议进行分发。

genkgo / php-asn1

维护者

详情