ویژگی تصویر

تابع crc32() در PHP

  /  PHP   /  تابع crc32() در PHP
بنر تبلیغاتی الف
آموزش PHP

تابع crc32() در PHP یک تابع ساده و سریع برای محاسبه CRC-32 (Cyclic Redundancy Check) از یک رشته باینری یا متنی است. این مقدار برای تشخیص خطاهای تصادفی در داده‌ها مفید است اما نباید آن را به‌عنوان تابعی رمزنگاری‌شده یا امن در نظر گرفت؛ زیرا CRC32 مقاومت لازم در برابر حملات یا برخوردهای عمدی ندارد.

ویژگی‌های کلیدی

  • سرعت بالا و پیاده‌سازی سبک در PHP.
  • خروجی 32 بیتی که معمولاً برای بررسی یکپارچگی یا تولید کلیدهای سریع استفاده می‌شود.
  • برای مقایسه یا تشخیص تغییرات تصادفی مناسب است، اما برای امنیت یا امضاهای دیجیتال نامناسب است.

امضا و استفاده پایه‌ای

امضای تابع:

int crc32 ( string $str )

تابع یک عدد صحیح 32 بیتی بازمی‌گرداند که نمایانگر مقدار CRC-32 رشته ورودی است.

مثال‌های عملی

محاسبه CRC32 برای یک رشته

<?php
$text = "Hello, world!";
$crc = crc32($text);
echo $crc . PHP_EOL;
echo sprintf("%u", $crc) . PHP_EOL; // unsigned decimal
echo sprintf("%08x", $crc) . PHP_EOL; // hex (padded)
?>

در این مثال ابتدا مقدار برگشتی تابع crc32 چاپ می‌شود. برای اینکه همواره مقدار صحیح_unsigned را مشاهده کنیم از sprintf(“%u”, …) استفاده می‌کنیم و sprintf(“%08x”, …) برای نمایش هگزادسیمال 8 رقمی (معمولاً قالب دیده‌شده برای CRC32) کاربرد دارد.

مقایسه دو فایل یا دو رشته برای تشخیص تغییرات

<?php
$file1 = file_get_contents('file1.bin');
$file2 = file_get_contents('file2.bin');

if (crc32($file1) === crc32($file2)) {
    echo "Probably identical (CRC matched).n";
} else {
    echo "Different (CRC differs).n";
}
?>

توجه داشته باشید که برابر بودن CRC دلیلی قطعی برای یکسان بودن فایل‌ها نیست (احتمال برخورد یا collision وجود دارد)، ولی برای چک‌های سریع و غیرامنیتی معمولاً کفایت می‌کند.

نکات مهم و تله‌های رایج

  • مقدار منفی در پلتفرم‌های 32 بیتی: روی سیستم‌های 32 بیتی، اگر بیت 31 مقدار CRC یک باشد، PHP ممکن است مقدار را به‌صورت عدد صحیح منفی برگرداند زیرا نوع عدد صحیح در PHP علامت‌دار است. برای نمایش مقدار unsigned از sprintf(“%u”, crc32(…)) استفاده کنید.
  • استفاده به‌جای توابع رمزنگاری: CRC32 برای امنیت طراحی نشده است؛ برای اهداف رمزنگاری از توابعی مانند hash(‘sha256’, …) یا hash_hmac استفاده کنید.
  • برخورد (Collision): احتمال برخورد نسبت به توابع بیشتر طولانی‌تر وجود دارد؛ برای مقایسه‌های بسیار حساس از الگوریتم‌های قوی‌تر استفاده کنید.

روش دریافت مقدار هگزادسیمال ثابت (8 کاراکتر)

<?php
$val = crc32("my data");
$hex = sprintf("%08x", $val & 0xFFFFFFFF);
echo $hex, "n";
?>

عملگر & 0xFFFFFFFF برای اینکه روی هر پلتفرمی (32 یا 64 بیتی) مقدار را به‌صورت 32 بیتی بی‌علامت محدود کند مفید است و سپس sprintf قالب هگز با صفر دهی سمت چپ را تولید می‌کند.

مقایسه با hash(‘crc32b’) و hash_file

تابع hash() با الگوریتم‌های ‘crc32’ یا ‘crc32b’ هم می‌تواند مقدار CRC را به‌صورت هگزادسیمال برگرداند. همچنین برای فایل‌ها hash_file(‘crc32b’, $filename) یک روش مستقیم و بهینه است.

تابعنوع خروجیمزیت
crc32($str)int (ممکن است منفی روی 32 بیت)سریع و ساده برای رشته‌ها
sprintf(“%u”, crc32($str))decimal unsignedنمایش عدد مثبت سازگار با 32 بیت
sprintf(“%08x”, crc32($str))hex stringنمایش هگز استاندارد 8 رقمی
hash(‘crc32b’, $str)hex lowercaseخروجی هگز بدون مسئله علامت
hash_file(‘crc32b’, $file)hexبرای فایل‌های بزرگ بهینه

محاسبه CRC32 برای فایل‌های بزرگ (با استفاده از Hash API)

<?php
$fp = fopen('large_file.bin', 'rb');
$ctx = hash_init('crc32b');

hash_update_stream($ctx, $fp);
$hex = hash_final($ctx);

fclose($fp);
echo $hex, "n";
?>

این روش از حافظه کمتری استفاده می‌کند چون فایل را قطعه‌قطعه می‌خواند و CRC را به‌صورت جریان (stream) محاسبه می‌کند. مناسب فایل‌های بزرگ است.

موارد کاربرد و بهترین شیوه‌ها

  • استفاده برای بررسی سریع یکپارچگی فایل یا داده‌ها در میان‌مدت، مثل کش، کلیدهای هش سریع، یا بررسی تغییرات فایل‌ها.
  • عدم استفاده برای مطابقت امنیتی یا احراز هویت؛ به‌جای آن از توابع امن مانند SHA-256 یا HMAC استفاده کنید.
  • برای تضمین نمایش یکسان از sprintf(“%u”, …) یا sprintf(“%08x”, …) استفاده کنید تا پایدار و بدون وابستگی به پلتفرم خروجی داشته باشید.
  • برای داده‌های خیلی بزرگ یا جریان‌ها از hash_update_stream و hash_init با ‘crc32b’ بهره ببرید.

جمع‌بندی

تابع crc32() ابزار ساده و بسیار سریع برای محاسبه CRC-32 در PHP است که برای کاربردهای غیرامنیتی مثل تشخیص تغییرات تصادفی، تولید کلیدهای سریع یا بررسی‌های یکپارچگی مناسب است. هنگام استفاده به تفاوت‌های 32/64 بیتی و احتمال خروجی منفی توجه کنید و در صورت نیاز خروجی را به فرم unsigned یا هگز تبدیل کنید. برای کاربردهای بزرگ و فایل‌های حجیم از API هش جریان‌محور استفاده نمایید.

آیا این مطلب برای شما مفید بود ؟

خیر
بله
موضوعات شما در انجمن: