paragonie/haliteInterface de criptografia de alto nível alimentada por libsodium.
Halite é uma interface de criptografia de alto nível que depende do libsodium para todas as suas operações de criptografia subjacentes.
Halite foi criado pela Paragon Initiative Enterprises como resultado de nossos esforços contínuos para melhorar o ecossistema e tornar a criptografia em PHP mais segura e fácil de implementar.
Você pode ler a Documentação do Halite online.
Halite é distribuído sob a Mozilla Public License 2.0. Licenças comerciais estão disponíveis na Paragon Initiative Enterprises se você desejar estender o Halite sem disponibilizar seus trabalhos derivados sob os termos da MPL.
Se você está satisfeito com os termos do software MPL para aplicações web de backend, mas gostaria de adquirir um contrato de suporte para sua aplicação que usa Halite, eles também são oferecidos pela Paragon Initiative Enterprises.
Importante: Versões anteriores do Halite estavam disponíveis sob a GNU Public License versão 3 (GPLv3). Apenas Halite 4.0.1 e mais recentes estão disponíveis sob os termos da Mozilla Public License.
Antes de usar o Halite, você deve escolher uma versão que atenda aos requisitos do seu projeto. As diferenças entre os requisitos das versões disponíveis do Halite são brevemente destacadas abaixo.
| PHP | libsodium | PECL libsodium | Suporte | |
|---|---|---|---|---|
| Halite 5.1 e mais recentes | 8.1.0 | 1.0.18 | N/A (standard) | ✔️ Ativo |
| Halite 5.0.x | 8.0.0 | 1.0.18 | N/A (standard) | ✔️ Ativo |
| Halite 4.1+ | 7.2.0 | 1.0.15 | N/A (standard) | ❌ Não Suportado |
| Halite 4.0 | 7.2.0 | 1.0.13 | N/A (standard) | ❌ Não Suportado |
| Halite 3 | 7.0.0 | 1.0.9 | 1.0.6 / 2.0.4 | ❌ Não Suportado |
| Halite 2 | 7.0.0 | 1.0.9 | 1.0.6 | ❌ Não Suportado |
| Halite 1 | 5.6.0 | 1.0.6 | 1.0.2 | ❌ Não Suportado |
Nota: Halite 5.0.x funciona no PHP 8.0, mas o desempenho é pior do que no PHP 8.1.
Se você precisar de uma versão do Halite anterior à 5.1, consulte a documentação relevante para esse ramo específico.
Para instalar o Halite, você primeiro precisa instalar o libsodium. Você pode ou não precisar da extensão PHP. Para a maioria das pessoas, isso significa executar...
sudo apt-get install php7.2-sodium
...ou um comando equivalente para o seu sistema operacional e versão do PHP.
Se você estiver com dificuldades, este guia passo a passo contribuído por @aolko pode ser útil.
Depois de instalar os pré-requisitos, instale o Halite via Composer:
composer require paragonie/halite:^5
O suporte gratuito (sem custo) para o Halite se estende apenas à versão principal mais recente (atualmente a 5).
Se sua empresa precisar de suporte para uma versão antiga do Halite, entre em contato com a Paragon Initiative Enterprises para saber sobre as opções de suporte comercial.
Se você precisar de uma maneira fácil de migrar de versões antigas do Halite, confira halite-legacy.
Consulte a documentação. A API básica do Halite é projetada para simplicidade: