Halite は、その基盤となる暗号化操作のすべてを libsodium に依存する高水準暗号化インターフェースです。
Halite は、Paragon Initiative Enterprises によって、エコシステムの改善と PHP における暗号化 の安全性と実装の容易さを向上させる継続的な取り組みの結果として作成されました。
Halite ドキュメント はオンラインで読むことができます。
Halite は Mozilla Public License 2.0 のもとでリリースされています。派生作品を MPL の条件のもとで公開せずに Halite を拡張したい場合は、商用ライセンス を Paragon Initiative Enterprises から取得できます。
バックエンド Web アプリケーション向けの MPL ソフトウェアの条件に満足しているが、Halite を使用するアプリケーション向けのサポート契約を購入したい場合は、それも Paragon Initiative Enterprises が提供しています。
重要: 以前のバージョンの Halite は GNU Public License バージョン 3 (GPLv3) のもとで提供されていました。Mozilla Public License の条件のもとで利用できるのは Halite 4.0.1 以降のみです。
Halite を使用する前に、プロジェクトの要件に合うバージョンを選択する必要があります。利用可能な Halite のバージョンごとの要件の違いを以下に簡単に示します。
| PHP | libsodium | PECL libsodium | サポート | |
|---|---|---|---|---|
| Halite 5.1 以降 | 8.1.0 | 1.0.18 | N/A (standard) | ✔️ アクティブ |
| Halite 5.0.x | 8.0.0 | 1.0.18 | N/A (standard) | ✔️ アクティブ |
| Halite 4.1+ | 7.2.0 | 1.0.15 | N/A (standard) | ❌ サポート対象外 |
| Halite 4.0 | 7.2.0 | 1.0.13 | N/A (standard) | ❌ サポート対象外 |
| Halite 3 | 7.0.0 | 1.0.9 | 1.0.6 / 2.0.4 | ❌ サポート対象外 |
| Halite 2 | 7.0.0 | 1.0.9 | 1.0.6 | ❌ サポート対象外 |
| Halite 1 | 5.6.0 | 1.0.6 | 1.0.2 | ❌ サポート対象外 |
注: Halite 5.0.x は PHP 8.0 で動作しますが、パフォーマンスは PHP 8.1 よりも劣ります。
5.1 より前のバージョンの Halite が必要な場合は、そのブランチに固有のドキュメントを参照してください。
Halite をインストールするには、まず libsodium をインストール する必要があります。 PHP 拡張機能が必要な場合と不要な場合があります。ほとんどの人にとって、これは次のコマンドを実行することを意味します...
sudo apt-get install php7.2-sodium
...または、お使いのオペレーティングシステムと PHP バージョンに応じた同等のコマンドを実行します。
行き詰まった場合は、@aolko によるこのステップバイステップガイド が役立つかもしれません。
前提条件をインストールしたら、Composer を通じて Halite をインストールします:
composer require paragonie/halite:^5
Halite の無料サポートは、最新のメジャーバージョン (現在は 5) にのみ適用されます。
お使いの企業で旧バージョンの Halite のサポートが必要な場合は、Paragon Initiative Enterprises にお問い合わせ のうえ、商用サポートのオプションについてご照会ください。
旧バージョンの Halite から簡単に移行する方法が必要な場合は、halite-legacy を確認してください。
ドキュメント を確認してください。基本的な Halite API はシンプルさを重視して設計されています: