crc32
(PHP 4 >= 4.0.1, PHP 5)
crc32 — Calcule la somme de contrôle CRC32
Description
$str
)
Génère la somme de contrôle cyclique CRC32, calculée sur 32 bits, et
appliquée à la chaîne str
. Cette fonction est
généralement utilisée pour valider l'intégrité de données durant une
transmission.
En raison du fait que le type entier de PHP est signé, la plupart des sommes de contrôle crc32 se trouve être des entiers négatifs sur les plateformes 32bits. Sur des installations 64bits, tous les résultats de la fonction crc32() seront des entiers positifs.
Aussi, vous devez utiliser le formatteur "%u" de la fonction sprintf() ou de la fonction printf() pour récupérer une représentation en chaîne de caractères de la somme de contrôle non-signée de la fonction crc32() au format décimal.
Pour une représentation hexadécimale de la somme de contrôle, vous pouvez utiliser soit le formatteur "%x" de la fonction sprintf() ou de la fonction printf() , ou bien les fonctions de conversion dechex(), les deux solutions prennent soin de convertir le résultat de la fonction crc32() en un entier non-signé.
Sur les installations 64bits, la fonction retournera aussi des entiers négatifs pour des valeurs retournées très grandes, mais cela va casser la conversion en héxadécimal en ayant une position 0xFFFFFFFF######## supplémentaire. Sachant que la représentation décimale semble être le cas le plus largement utilisé, nous avons décidé de ne pas la casser même si elle casse directement la comparaison décimale dans 50% des cas lors d'un passage de 32 à 64bits.
Avec du recul, le fait que la fonction retourne un entier n'était peut-être pas la meilleure idée, et le fait de retourner une représentation héxadécimale sous la forme d'une chaîne de caractères (tel que le fait la fonction md5()) aurait pû être une meilleure solution pour commencer.
Pour une solution plus pérenne, vous pouvez vous retourner vers la fonction
générique hash(). hash("crc32b", $str)
va retourner la même chaîne de caractères que dechex(crc32($str))
.
Liste de paramètres
-
str
-
Les données.
Valeurs de retour
Retourne la somme de contrôle crc32 de la chaîne
str
, sous la forme d'un entier.
Exemples