2017 © Pedro Peláez
 

library base64-coder

Converts a selector and token pair to base64 forth and back.

image

germania-kg/base64-coder

Converts a selector and token pair to base64 forth and back.

  • Wednesday, September 6, 2017
  • by germania-kg
  • Repository
  • 2 Watchers
  • 0 Stars
  • 39 Installations
  • PHP
  • 0 Dependents
  • 0 Suggesters
  • 0 Forks
  • 0 Open issues
  • 9 Versions
  • 0 % Grown

The README.md

Germania KG · Base64Coder

Converts a selector and token pair to base64 forth and back., (*1)

Packagist PHP version Tests, (*2)

Installation with Composer

$ composer require germania-kg/base64-coder

Usage

Instantiation

<?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;

Encoding selector and token

<?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
}

Decoding encoded selector and token pair

<?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
}

Exceptions

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

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

Pimple Service Provider

<?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;

Issues

See issues list., (*3)

Development

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

Unit tests

Either copy phpunit.xml.dist to phpunit.xml and adapt to your needs, or leave as is. Run PhpUnit test or composer scripts like this:, (*4)

$ composer test
# or
$ vendor/bin/phpunit

The Versions

06/09 2017

dev-develop

dev-develop

Converts a selector and token pair to base64 forth and back.

  Sources   Download

MIT

The Requires

 

The Development Requires

by Carsten Witt

encode decode base64 randomlib random_compat

06/09 2017

dev-master

9999999-dev

Converts a selector and token pair to base64 forth and back.

  Sources   Download

MIT

The Requires

 

The Development Requires

by Carsten Witt

encode decode base64 randomlib random_compat

18/08 2017

1.1.0

1.1.0.0

  Sources   Download

MIT

The Requires

 

The Development Requires

by Carsten Witt

19/12 2016

1.0.5

1.0.5.0

  Sources   Download

MIT

The Requires

 

The Development Requires

by Carsten Witt

19/12 2016

1.0.4

1.0.4.0

  Sources   Download

MIT

The Requires

 

The Development Requires

by Carsten Witt

19/12 2016

1.0.3

1.0.3.0

  Sources   Download

MIT

The Requires

 

The Development Requires

by Carsten Witt

19/12 2016

1.0.2

1.0.2.0

  Sources   Download

MIT

The Requires

 

The Development Requires

by Carsten Witt

15/12 2016

1.0.1

1.0.1.0

  Sources   Download

MIT

The Requires

 

The Development Requires

by Carsten Witt

12/12 2016

1.0.0

1.0.0.0

  Sources   Download

MIT

The Requires

 

The Development Requires

by Carsten Witt