paragonie/haliteInterface de cryptographie de haut niveau propulsée par libsodium
Halite est une interface de cryptographie de haut niveau qui s'appuie sur libsodium pour toutes ses opérations cryptographiques sous-jacentes.
Halite a été créé par Paragon Initiative Enterprises à la suite de nos efforts continus pour améliorer l'écosystème et rendre la cryptographie en PHP plus sûre et plus facile à mettre en œuvre.
Vous pouvez lire la documentation de Halite en ligne.
Halite est publié sous licence publique Mozilla 2.0. Des licences commerciales sont disponibles auprès de Paragon Initiative Enterprises si vous souhaitez étendre Halite sans rendre vos œuvres dérivées disponibles selon les termes de la MPL.
Si vous êtes satisfait des termes du logiciel MPL pour les applications web backend mais que vous souhaitez acheter un contrat de support pour votre application qui utilise Halite, ceux-ci sont également proposés par Paragon Initiative Enterprises.
Important : Les versions antérieures de Halite étaient disponibles sous licence publique générale GNU version 3 (GPLv3). Seules Halite 4.0.1 et les versions plus récentes sont disponibles selon les termes de la licence publique Mozilla.
Avant de pouvoir utiliser Halite, vous devez choisir une version qui correspond aux exigences de votre projet. Les différences entre les exigences des versions disponibles de Halite sont brièvement présentées ci-dessous.
| PHP | libsodium | PECL libsodium | Support | |
|---|---|---|---|---|
| Halite 5.1 et plus récent | 8.1.0 | 1.0.18 | N/A (standard) | ✔️ Actif |
| Halite 5.0.x | 8.0.0 | 1.0.18 | N/A (standard) | ✔️ Actif |
| Halite 4.1+ | 7.2.0 | 1.0.15 | N/A (standard) | ❌ Non pris en charge |
| Halite 4.0 | 7.2.0 | 1.0.13 | N/A (standard) | ❌ Non pris en charge |
| Halite 3 | 7.0.0 | 1.0.9 | 1.0.6 / 2.0.4 | ❌ Non pris en charge |
| Halite 2 | 7.0.0 | 1.0.9 | 1.0.6 | ❌ Non pris en charge |
| Halite 1 | 5.6.0 | 1.0.6 | 1.0.2 | ❌ Non pris en charge |
Note : Halite 5.0.x fonctionne sur PHP 8.0, mais les performances sont moins bonnes que sur PHP 8.1.
Si vous avez besoin d'une version de Halite antérieure à 5.1, consultez la documentation relative à cette branche particulière.
Pour installer Halite, vous devez d'abord installer libsodium. Vous pouvez ou non avoir besoin de l'extension PHP. Pour la plupart des gens, cela signifie exécuter...
sudo apt-get install php7.2-sodium
...ou une commande équivalente pour votre système d'exploitation et votre version de PHP.
Si vous êtes bloqué, ce guide pas à pas contribué par @aolko peut vous être utile.
Une fois les prérequis installés, installez Halite via Composer :
composer require paragonie/halite:^5
Le support gratuit de Halite ne s'étend qu'à la version majeure la plus récente (actuellement la 5).
Si votre entreprise a besoin d'une prise en charge pour une ancienne version de Halite, contactez Paragon Initiative Enterprises pour vous renseigner sur les options de support commercial.
Si vous avez besoin d'un moyen simple de migrer depuis les anciennes versions de Halite, consultez halite-legacy.
Consultez la documentation. L'API de base de Halite est conçue pour la simplicité :