paragonie/haliteВысокоуровневый криптографический интерфейс на основе libsodium
Halite — это высокоуровневый криптографический интерфейс, который полагается на libsodium для всех своих базовых криптографических операций.
Halite был создан Paragon Initiative Enterprises в рамках наших постоянных усилий по улучшению экосистемы и повышению безопасности и простоты внедрения криптографии в PHP.
Вы можете прочитать документацию Halite онлайн.
Halite выпускается под лицензией Mozilla Public License 2.0. Коммерческие лицензии доступны в Paragon Initiative Enterprises, если вы хотите расширить Halite, не распространяя свои производные работы на условиях MPL.
Если вас устраивают условия MPL-программного обеспечения для серверных веб-приложений, но вы хотели бы приобрести контракт на поддержку для своего приложения, использующего Halite, такие контракты также предлагаются Paragon Initiative Enterprises.
Важно: Более ранние версии Halite были доступны под GNU Public License версии 3 (GPLv3). Только Halite 4.0.1 и новее доступны на условиях Mozilla Public License.
Прежде чем использовать Halite, необходимо выбрать версию, которая соответствует требованиям вашего проекта. Различия между требованиями доступных версий Halite кратко описаны ниже.
| PHP | libsodium | PECL libsodium | Поддержка | |
|---|---|---|---|---|
| Halite 5.1 и новее | 8.1.0 | 1.0.18 | Н/Д (стандарт) | ✔️ Активна |
| Halite 5.0.x | 8.0.0 | 1.0.18 | Н/Д (стандарт) | ✔️ Активна |
| Halite 4.1+ | 7.2.0 | 1.0.15 | Н/Д (стандарт) | ❌ Не поддерживается |
| Halite 4.0 | 7.2.0 | 1.0.13 | Н/Д (стандарт) | ❌ Не поддерживается |
| 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.
Если вам нужна версия Halite до 5.1, обратитесь к документации, соответствующей этой конкретной ветке.
Чтобы установить Halite, сначала необходимо установить libsodium. Расширение PHP может понадобиться, а может и нет. Для большинства людей это означает выполнение...
sudo apt-get install php7.2-sodium
...или эквивалентной команды для вашей операционной системы и версии PHP.
Если у вас возникли трудности, может помочь это пошаговое руководство, предоставленное @aolko.
После установки необходимых компонентов установите Halite через Composer:
composer require paragonie/halite:^5
Бесплатная поддержка Halite распространяется только на самую последнюю основную версию (в настоящее время 5).
Если вашей компании требуется поддержка более старой версии Halite, свяжитесь с Paragon Initiative Enterprises, чтобы узнать о вариантах коммерческой поддержки.
Если вам нужен простой способ миграции со старых версий Halite, обратите внимание на halite-legacy.
Ознакомьтесь с документацией. Базовый API Halite спроектирован с упором на простоту: