paragonie/haliteKryptografie-Schnittstelle auf hoher Ebene, basierend auf libsodium
Halite ist eine High-Level-Schnittstelle für Kryptografie, die für alle ihre zugrunde liegenden kryptografischen Operationen auf libsodium aufbaut.
Halite wurde von Paragon Initiative Enterprises als Ergebnis unserer fortgesetzten Bemühungen entwickelt, das Ökosystem zu verbessern und Kryptografie in PHP sicherer und einfacher zu implementieren.
Sie können die Halite-Dokumentation online lesen.
Halite wird unter der Mozilla Public License 2.0 veröffentlicht. Kommerzielle Lizenzen sind verfügbar bei Paragon Initiative Enterprises, falls Sie Halite erweitern möchten, ohne Ihre abgeleiteten Werke unter den Bedingungen der MPL verfügbar zu machen.
Wenn Sie mit den Bedingungen von MPL-Software für Backend-Webanwendungen zufrieden sind, aber einen Supportvertrag für Ihre Anwendung erwerben möchten, die Halite verwendet, werden diese ebenfalls von Paragon Initiative Enterprises angeboten.
Wichtig: Frühere Versionen von Halite waren unter der GNU Public License Version 3 (GPLv3) verfügbar. Nur Halite 4.0.1 und neuere Versionen sind unter den Bedingungen der Mozilla Public License verfügbar.
Bevor Sie Halite verwenden können, müssen Sie eine Version auswählen, die den Anforderungen Ihres Projekts entspricht. Die Unterschiede zwischen den Anforderungen der verfügbaren Versionen von Halite werden im Folgenden kurz hervorgehoben.
| PHP | libsodium | PECL libsodium | Unterstützung | |
|---|---|---|---|---|
| Halite 5.1 und neuer | 8.1.0 | 1.0.18 | N/A (Standard) | ✔️ Aktiv |
| Halite 5.0.x | 8.0.0 | 1.0.18 | N/A (Standard) | ✔️ Aktiv |
| Halite 4.1+ | 7.2.0 | 1.0.15 | N/A (Standard) | ❌ Nicht unterstützt |
| Halite 4.0 | 7.2.0 | 1.0.13 | N/A (Standard) | ❌ Nicht unterstützt |
| Halite 3 | 7.0.0 | 1.0.9 | 1.0.6 / 2.0.4 | ❌ Nicht unterstützt |
| Halite 2 | 7.0.0 | 1.0.9 | 1.0.6 | ❌ Nicht unterstützt |
| Halite 1 | 5.6.0 | 1.0.6 | 1.0.2 | ❌ Nicht unterstützt |
Hinweis: Halite 5.0.x funktioniert unter PHP 8.0, aber die Leistung ist schlechter als unter PHP 8.1.
Wenn Sie eine Version von Halite vor 5.1 benötigen, lesen Sie die Dokumentation, die für diesen speziellen Zweig relevant ist.
Um Halite zu installieren, müssen Sie zunächst libsodium installieren. Möglicherweise benötigen Sie die PHP-Erweiterung. Für die meisten Menschen bedeutet das, Folgendes auszuführen...
sudo apt-get install php7.2-sodium
...oder einen entsprechenden Befehl für Ihr Betriebssystem und Ihre PHP-Version.
Wenn Sie nicht weiterkommen, kann diese Schritt-für-Schritt-Anleitung von @aolko hilfreich sein.
Sobald Sie die Voraussetzungen installiert haben, installieren Sie Halite über Composer:
composer require paragonie/halite:^5
Kostenloser (gratis) Support für Halite erstreckt sich nur auf die neueste Hauptversion (derzeit 5).
Wenn Ihr Unternehmen Support für eine ältere Version von Halite benötigt, kontaktieren Sie Paragon Initiative Enterprises, um sich nach kommerziellen Support-Optionen zu erkundigen.
Wenn Sie einen einfachen Weg benötigen, um von älteren Versionen von Halite zu migrieren, schauen Sie sich halite-legacy an.
Sehen Sie sich die Dokumentation an. Die grundlegende Halite-API ist auf Einfachheit ausgelegt: