Sen descrición

Nichlas Severinsen 00f8f666d0 Updated CHANGELOG.md		%!s(int64=4) %!d(string=hai) anos
include	f64831ea7d Finalizing XXH3 implementation	%!s(int64=5) %!d(string=hai) anos
src	0fe5887fd1 More tests	%!s(int64=5) %!d(string=hai) anos
tests	56d331d614 Version specifics	%!s(int64=5) %!d(string=hai) anos
.editorconfig	df8af49600 Initial commit	%!s(int64=5) %!d(string=hai) anos
.gitignore	647e12d214 Added .gitignore and CHANGELOG.md	%!s(int64=5) %!d(string=hai) anos
.php_cs	24d42baa4e Structure changes	%!s(int64=5) %!d(string=hai) anos
CHANGELOG.md	00f8f666d0 Updated CHANGELOG.md	%!s(int64=4) %!d(string=hai) anos
COPYING	f64831ea7d Finalizing XXH3 implementation	%!s(int64=5) %!d(string=hai) anos
LICENSE.txt	df8af49600 Initial commit	%!s(int64=5) %!d(string=hai) anos
README.md	56d331d614 Version specifics	%!s(int64=5) %!d(string=hai) anos
composer.json	0fe5887fd1 More tests	%!s(int64=5) %!d(string=hai) anos
phpunit.xml	24d42baa4e Structure changes	%!s(int64=5) %!d(string=hai) anos

Necklace\XxHash - PHP FFI bindings for libxxhash

This is an FFI binding of the libxxHash library from xxHash for PHP.

You're here because:

You want xxHash in PHP.
You don't want to install an extension.
You're fine with installing the xxhash package on your system to get libxxHash.
You want speed, or at least more speed than a pure PHP implementation of xxHash could get.

If so, you're in the right place.

Getting started

Setup

You will obviously need the xxHash package. In addition you will need libffi, and enable FFI for PHP (You will therefore need PHP version 7.4 or above). libxxhash needs to be v0.6.4 or above.

Here are some common ways to install:

Arch GNU/Linux: sudo pacman -S xxhash libffi
Debian / Ubundu: sudo apt install xxhash libffi
Fedora: sudo dnf install xxhash libffi
OpenSUSE: sudo zypper install xxhash libffi

PHP has to be compiled with the --with-ffi option, most distributions will have done this.

Locate the relevant php.ini file on your system and make sure these two lines are present, uncommented:

extension=ffi
ffi.enable=true

Then, simply add the bindings to your project:

composer require necklace/xxhash-ffi

Let me hash already!

Alright, alright. I know what you want, and I got what you need. You've got files, we got hashes:

Hash a file

<?php

use Necklace\XxHash\XxHash64;

$xxh = new XxHash64;

echo $xxh->hashFile('filename');

cee0f97cde3a4cda

Hey man, I want the latest, fastest, and greatest!

This library supports the XXH3 algorithm, you can use this but beware; it's still labeled experimental : return values from this version are not comparable with other versions.

<?php

use Necklace\XxHash\Xxh3\XxHash64;

$xxh = new XxHash64;

echo $xxh->hashFile('filename');

db70939c6397e562

Look in tests/ for more examples.

License

This repository and all its files is under the same license as the xxHash project; the BSD 2-Clause License.

See COPYING or LICENSE.txt.

Development

Clone and run composer install.

Remember to run ~/.config/composer/vendor/bin/php-cs-fixer fix src/

Tests

Run all tests with php vendor/bin/phpunit from the top directory.

Test memory leaks in tests with vendor/bin/roave-no-leaks.

README.md