https://github.com/sjinks/php-stribog
GOST R 34.11-2012 (Stribog) Hash Function implementation for PHP.
https://github.com/sjinks/php-stribog
gost3411 gost3411-2012 hash php php-extension stribog
Last synced: about 1 month ago
JSON representation
GOST R 34.11-2012 (Stribog) Hash Function implementation for PHP.
- Host: GitHub
- URL: https://github.com/sjinks/php-stribog
- Owner: sjinks
- License: mit
- Created: 2014-09-20T01:45:35.000Z (over 10 years ago)
- Default Branch: master
- Last Pushed: 2024-12-30T17:13:48.000Z (5 months ago)
- Last Synced: 2025-03-24T02:22:26.541Z (about 2 months ago)
- Topics: gost3411, gost3411-2012, hash, php, php-extension, stribog
- Language: C
- Homepage:
- Size: 186 KB
- Stars: 19
- Watchers: 3
- Forks: 11
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# php-stribog
[](https://github.com/sjinks/php-stribog/actions/workflows/test.yml)
GOST R 34.11-2012 (Stribog) Hash Function Implementation for PHP.
Tested with PHP 5.2, 5.3, 5.4, 5.5, 5.6, 7.0, 7.1, 7.2, 7.3, 7.4, 8.0, 8.1, 8.2, 8.3, 8.4, and nightly (8.5 as of writing)
## Introduction
This extension provides the implementation of GOST R 34.11-2012 256- and 512-bit hash functions to use with PHP [hash](http://php.net/hash) extension.
The extension does not introduce any new functions; instead, it registers three hashes:
* `stribog-256` (GOST R 34.11-2012 256-bit hash function);
* `stribog-512` (GOST R 34.11-2012 512-bit hash function);
* `stribog` (alias of `stribog-512`).
These hashes can be used with any function from PHP `hash` extension.
The implementation of the hash function (`gost3411-2012-*.c`) is based on the implementation by [Alexey Degtyarev](https://www.streebog.net/en/), see `LICENSE.gost`.
The changes made to Alexey's code:
* the MMX implementation was almost completely rewritten in order not to use SSE instructions;
* optimization of 64-bit version of `extract()` — gained extra 0.7 MB/s;
* the generic implementation was optimized by removing unnecessary `memcpy` calls;
* inline functions instead of macros;
* the implementation (generic/MMX/SSE) is chosen at runtime depending on CPU capabilities (GCC 4.6 or newer is required for that);
* fixed `add512()` implementation.
## Installing/Configuring
```bash
phpize
./configure
make
sudo make install
```
You will also need to add
```
extension=stribog.so
```
to your `php.ini`.
There are no configuration directives defined in `php.ini`.
## Usage Example
**Hash calculation:**
```php
$data = '012345678901234567890123456789012345678901234567890123456789012';
echo hash('stribog256', $data), PHP_EOL;
echo hash('stribog512', $data), PHP_EOL;
echo hash('stribog', $data), PHP_EOL;
```
**HMAC calculation:**
```php
$data = 'Very secret data';
$key = 'password';
echo hash_hmac('stribog', $data, $key);
```