paragonie/haliteInterfaz de criptografía de alto nivel impulsada por libsodium
Halite es una interfaz de criptografía de alto nivel que depende de libsodium para todas sus operaciones criptográficas subyacentes.
Halite fue creado por Paragon Initiative Enterprises como resultado de nuestros continuos esfuerzos por mejorar el ecosistema y hacer que la criptografía en PHP sea más segura y fácil de implementar.
Puedes leer la Documentación de Halite en línea.
Halite se publica bajo la Mozilla Public License 2.0. Hay licencias comerciales disponibles en Paragon Initiative Enterprises si deseas extender Halite sin tener que disponibilizar tus obras derivadas bajo los términos de la MPL.
Si estás satisfecho con los términos del software MPL para aplicaciones web backend pero deseas adquirir un contrato de soporte para tu aplicación que utiliza Halite, también se ofrecen en Paragon Initiative Enterprises.
Importante: Las versiones anteriores de Halite estaban disponibles bajo la GNU Public License versión 3 (GPLv3). Solo Halite 4.0.1 y versiones posteriores están disponibles bajo los términos de la Mozilla Public License.
Antes de que puedas usar Halite, debes elegir una versión que se ajuste a los requisitos de tu proyecto. Las diferencias entre los requisitos de las versiones disponibles de Halite se resumen brevemente a continuación.
| PHP | libsodium | PECL libsodium | Soporte | |
|---|---|---|---|---|
| Halite 5.1 y posterior | 8.1.0 | 1.0.18 | N/A (estándar) | ✔️ Activo |
| Halite 5.0.x | 8.0.0 | 1.0.18 | N/A (estándar) | ✔️ Activo |
| Halite 4.1+ | 7.2.0 | 1.0.15 | N/A (estándar) | ❌ No soportado |
| Halite 4.0 | 7.2.0 | 1.0.13 | N/A (estándar) | ❌ No soportado |
| Halite 3 | 7.0.0 | 1.0.9 | 1.0.6 / 2.0.4 | ❌ No soportado |
| Halite 2 | 7.0.0 | 1.0.9 | 1.0.6 | ❌ No soportado |
| Halite 1 | 5.6.0 | 1.0.6 | 1.0.2 | ❌ No soportado |
Nota: Halite 5.0.x funciona en PHP 8.0, pero el rendimiento es peor que en PHP 8.1.
Si necesitas una versión de Halite anterior a la 5.1, consulta la documentación relevante para esa rama en particular.
Para instalar Halite, primero debes instalar libsodium. Puede que necesites o no la extensión de PHP. Para la mayoría de las personas, esto significa ejecutar...
sudo apt-get install php7.2-sodium
...o un comando equivalente para tu sistema operativo y versión de PHP.
Si estás atascado, esta guía paso a paso contribuida por @aolko puede ser útil.
Una vez que tengas los requisitos previos instalados, instala Halite a través de Composer:
composer require paragonie/halite:^5
El soporte gratuito (gratis) para Halite solo se extiende a la versión principal más reciente (actualmente la 5).
Si tu empresa requiere soporte para una versión anterior de Halite, contacta con Paragon Initiative Enterprises para consultar las opciones de soporte comercial.
Si necesitas una forma sencilla de migrar desde versiones anteriores de Halite, consulta halite-legacy.
Consulta la documentación. La API básica de Halite está diseñada para la simplicidad: