Aide for base32 encoding and decoding

functions or class to allow encoding or decoding strings using RFC4648 base32 algorithm.

Installation

Composer

composer require bakame-php/aide-base32

System Requirements

You need:

• PHP >= 8.1 but the latest stable version of PHP is recommended

Usage

The package provides a userland base32 encoding and decoding mechanism.

base32_encode(string $decoded, string $alphabet = PHP_BASE32_ASCII, $padding = '='): string
base32_decode(string $encoded, string $alphabet = PHP_BASE32_ASCII, $padding = '=', bool $strict = false): string|false

Parameters:

• $decoded : the string to encode for base32_encode
• $encoded : the string to decode for base32_decode
• $alphabet : the base32 alphabet, by default PHP_BASE32_ASCII.
• $padding : the padding character
• $strict : tell whether we need to perform strict decoding or not

If the strict parameter is set to true then the base32_decode function will return false

• if encoded sequence length is invalid
• if the input contains character from outside the base64 alphabet.
• if padding is invalid
• if encoded characters do not follow the alphabet lettering.

otherwise listed constraints are silently ignored or discarded.

RFC4648 support

• If $alphabet is PHP_BASE32_ASCII and the $padding is =, conversion is performed per RFC4648 US-ASCII standard.
• If $alphabet is PHP_BASE32_HEX and the $padding is =, conversion is performed per RFC4648 HEX standard.

You MAY provide your own alphabet of 32 characters and your own padding character.

<?php

base32_encode('Bangui');                                  // returns 'IJQW4Z3VNE======'
base32_decode('IJQW4Z3VNE======');                        // returns 'Bangui'
base32_decode('IJQW4Z083VNE======');                      // returns 'Bangui'
base32_decode(encoded:'IJQW4Z083VNE======', strict: true) // return false
base32_encode('Bangui', PHP_BASE32_HEX, '*');             // returns '89GMSPRLD4******'
base32_decode('89GMSPRLD4******', PHP_BASE32_HEX, '*');   // returns 'Bangui'