All your Base85
Install
Install with composer.
$ composer require tuupola/base85
This branch requires PHP 7.1 or up. The older 1.x branch supports also PHP 5.6 and 7.0.
$ composer require "tuupola/base85:^1.0"
Usage
This package has both pure PHP and GMP based encoders. By default encoder and decoder will use GMP functions if the extension is installed. If GMP is not available pure PHP encoder will be used instead.
$base85 = new Tuupola\Base85;
$encoded = $base85->encode(random_bytes(128));
$decoded = $base85->decode($encoded);
If you are encoding to and from integer use the implicit decodeInteger() and encodeInteger() methods.
$integer = $base85->encodeInteger(987654321); /* 3o4PT */
print $base85->decodeInteger("3o4PT", true); /* 987654321 */
Note that encoding a string and an integer will yield different results.
$string = $base85->encode("987654321"); /* 3B/rU2)I*E0` */
$integer = $base85->encodeInteger(987654321); /* 3o4PT */
Encoding modes
ASCII85 encoding. This is the default. 0x00000000 is compressed to z. Spaces are not compressed.
use Tuupola\Base85;
$ascii85 = new Base85([
"characters" => Base85::ASCII85,
"compress.spaces" => false,
"compress.zeroes" => true
]);
print $ascii85->encode("Hello world!"); /* 87cURD]j7BEbo80 */
Adobe ASCII85 encoding is same as previous except data is enclosed between <~ and ~>.
use Tuupola\Base85;
$adobe85 = new Base85([
"characters" => Base85::ASCII85,
"compress.spaces" => false,
"compress.zeroes" => true,
"prefix" => "<~",
"suffix" => "~>"
]);
print $adobe85->encode("Hello world!"); /* <~87cURD]j7BEbo80~> */
ZeroMQ (Z85) encoding. NOTE! Even though specification says input length must be divisible by 4, this is not currently enforced. Spaces and zeroes are not compressed.
use Tuupola\Base85;
$z85 = new Base85([
"characters" => Base85::Z85,
"compress.spaces" => false,
"compress.zeroes" => false
]);
print $z85->encode("Hello world!"); /* NM=qnZy<MXa+]NF */
Character set from RFC1924 which is an April fools joke. Spaces and zeroes are not compressed.
use Tuupola\Base85;
$rfc1924 = new Base85([
"characters" => Base85::RFC1924,
"compress.spaces" => false,
"compress.zeroes" => false
]);
print $rfc1924->encode("Hello world!"); /* NM&qnZy<MXa%^NF */
Speed
Pure PHP encoder seems to be faster than the GMP implementation. Below benchmarks use random_bytes(128) as data.
$ php --version
PHP 8.0.1 (cli) (built: Jan 8 2021 09:07:02) ( NTS )
$ vendor/bin/phpbench run benchmarks/ --report=default
+-----------------+-----------------+-------+
| subject | mean | diff |
+-----------------+-----------------+-------+
| benchGmpDecoder | 24,515.692ops/s | 1.01x |
| benchPhpDecoder | 24,666.509ops/s | 1.00x |
+-----------------+-----------------+-------+
+-----------------+-----------------+-------+
| subject | mean | diff |
+-----------------+-----------------+-------+
| benchGmpEncoder | 9,654.448ops/s | 4.76x |
| benchPhpEncoder | 45,944.903ops/s | 1.00x |
+-----------------+-----------------+-------+
Static Proxy
If you prefer static syntax use the provided static proxy.
use Tuupola\Base85Proxy as Base85;
print Base85::encode("Hello world!") /* 87cURD]j7BEbo80 */
To change static proxy options set the Base85::$options variable.
use Tuupola\Base85;
use Tuupola\Base85Proxy as Z85;
Z85::$options = [
"characters" => Base85::Z85,
"compress.spaces" => false,
"compress.zeroes" => false
];
print Z85::encode("Hello world!"); /* NM=qnZy<MXa+]NF */
Testing
You can run tests either manually or automatically on every code change. Automatic tests require entr to work.
$ make test
$ brew install entr
$ make watch
Contributing
Please see CONTRIBUTING for details.
Security
If you discover any security related issues, please email [email protected] instead of using the issue tracker.
License
The MIT License (MIT). Please see License File for more information.
69 Dec 23, 2022
34 Jan 1, 2023
9 Dec 9, 2021
2 Oct 9, 2022
570 Dec 27, 2022
2 Sep 18, 2022
5k Dec 22, 2022
11 Mar 15, 2022
2 Nov 9, 2022
13 Apr 14, 2022
1 Jan 12, 2022
596 Jan 6, 2023
51 Dec 5, 2022
139 Sep 9, 2022
666 Dec 24, 2022
6 Jun 5, 2023
6 Jun 11, 2023
22 Dec 1, 2022
2 Oct 6, 2021