README

将 选择器 和 令牌 对转换为前后base64编码。

使用Composer安装

$ composer require germania-kg/base64-coder

用法

实例化

<?php
use Germania\Base64Coder\Base64Coder;
use Germania\Base64Coder\Exceptions\EncodingException;
use Germania\Base64Coder\Exceptions\DecodingException;

// Optional:
$logger    = new Monolog;
$separator = "::" // Default;

// Setup
$coder = new Base64Coder( $separator, $logger );
$coder = new Base64Coder( $separator );
$coder = new Base64Coder;

编码选择器和令牌

<?php
$selector = "user_john";
$token    = "somerandomvalue";

try {
	$encoded = $coder->encode( $selector, $token);
	// Result is something like
	// "RGllcyBpc3ftvZ::GllcmVuZGVyIFN0cmluZw=="
} 
catch (EncodingException $e) {
	// PHP's base64_encode had returned FALSE
}

解码编码的选择器和令牌对

<?php
$encoded_value = 'RGllcyBpc3ftvZ::GllcmVuZGVyIFN0cmluZw==';

try {
	$decoded = $cookie_coder->decode( $encoded_value );

	// Result object:
	echo $decoded->selector; // "user_john"
	echo $decoded->token;    // "somerandomvalue"
	
catch (DecodingException $e) {
	// PHP's base64_decode had returned FALSE
}

异常

<?php
use Germania\Base64Coder\Exceptions\CoderExceptionInterface;

class EncodingException implements CoderExceptionInterface {}
class DecodingException implements CoderExceptionInterface {}

Pimple 服务提供者

<?php
use Germania\Base64Coder\Providers\PimpleServiceProvider;
use Germania\Base64Coder\EncoderCallable;
use Germania\Base64Coder\DecoderCallable;
use Germania\Base64Coder\Base64Coder;
use Psr\Log\LoggerInterface;

// have your Pimple DIC ready, and optionally a PSR3 Logger:
$sp = new PimpleServiceProvider;
$custom_separator = "::";
$sp = new PimpleServiceProvider($separator, $psr3_logger);

$sp->register( $dic );

// Grab your services;
// See also above examaples.
$base64coder = $dic[Base64Coder::class];

$encoder = $dic['Cookie.Encryptor']; // Deprecated
$encoder = $dic[EncoderCallable::class];
$encoded_string = $encoder("selector", "token");

$decoder = $dic['Cookie.Decryptor']; // Deprecated
$decoder = $dic[DecoderCallable::class];
$decoded_obj = $decoder( $encoded_string );

echo $decoded_obj->selector;
echo $decoded_obj->token;

问题

查看 问题列表。

开发

$ git clone https://github.com/GermaniaKG/Base64Coder.git
$ cd Base64Coder
$ composer install

单元测试

可以复制 phpunit.xml.dist 到 phpunit.xml 并根据您的需求进行调整，或者保持原样。运行 PhpUnit 测试或composer脚本，如下所示

$ composer test
# or
$ vendor/bin/phpunit