全面掌握PHP二进制转十六进制处理技术|原理·实战·避坑·优化·替代方案
php bin2hex是PHP内置函数,用于将二进制数据转换为十六进制字符串表示。其核心作用在于将原始字节流(binary data)以可读、可传输的ASCII十六进制字符串形式呈现,广泛应用于加密、编码、协议解析、日志记录、数据校验等场景。
函数签名:string bin2hex ( string $data ) : string
其中参数$data为原始二进制字符串(非UTF-8文本),返回值为等长两倍的十六进制字符串(每个字节→两个十六进制字符)。例如:
二进制0x41 0x42(即ASCII码的"AB")→ 十六进制字符串"4142"
需注意:该函数不处理编码转换,仅进行字节级映射。与base64_encode不同,php bin2hex生成的是纯十六进制字符集(0-9a-f),无特殊符号,适合在仅支持ASCII字符的环境中安全传输二进制数据(如URL参数、JSON字段、数据库TEXT列),但体积膨胀为原数据2倍。
常见误解是将其与hex2bin混淆——后者是其逆过程,将十六进制字符串还原为原始二进制。二者组合可实现无损数据编码/解码,是PHP中轻量级二进制安全传输的基础方案之一。
random_bytes生成加密随机令牌后,用bin2hex转为字符串存储于Cookie或Headerhash_file('sha256')后,若需可读输出,可用bin2hex转换二进制哈希值bin2hex辅助调试与日志记录bin2hex($binary_string)接受单个参数:
• 类型:string
• 含义:原始二进制数据(可能包含不可见字符、非UTF-8字节)
• 注意:PHP中字符串本质即字节数组,无需显式声明"binary"
\0或非打印字符也照常转换stream_get_contents读取strtoupper转换)PHP 7+中,若参数非字符串类型(如int、array),会抛出TypeError;PHP 5中则可能产生E_WARNING。建议调用前用is_string校验或启用严格类型:
declare(strict_types=1);
try {
$hex = bin2hex($data);
} catch (TypeError $e) {
error_log("Invalid input type: " . gettype($data));
}// ASCII字符串转十六进制
echo bin2hex("Hi!"); // 输出:486921
// 包含控制字符
echo bin2hex("A\0B"); // 输出:410042
// 中文UTF-8编码("中"=E4 B8 AD)
echo bin2hex("中国"); // 输出:e4b8ade59bbd$token = bin2hex(random_bytes(16)); // 示例输出:a1b2c3d4e5f6789012345678abcdef01 // 存入数据库 $stmt->execute(['token' => $token]);
$hash_bin = hash_file('sha256', 'file.bin', true); // 二进制哈希
$hash_hex = bin2hex($hash_bin); // 转十六进制字符串
echo "SHA256: $hash_hex"; // 输出:5e884898da980d30e2c6d56665e4e5c...function isValidHex($str) {
return ctype_xdigit($str) && strlen($str) % 2 === 0;
}
$hex = bin2hex("test");
if (isValidHex($hex)) {
echo "Valid hex string\n";
}$img = file_get_contents('logo.png');
$header = substr($img, 0, 16); // PNG文件头16字节
echo bin2hex($header); // 输出:89504e470d0a1a0a0000000d49484452许多开发者误记为"bin to hex"(hex为缩写),实际完整拼写是"binary to hexadecimal"。命名逻辑与base64_encode一致(base64为缩写),但bin2hex中的"hex"是"hexadecimal"简写,非独立词根。
以下代码是典型错误:
$data = "4869"; // 以为这是"Hi"的hex形式 echo bin2hex($data); // 实际输出:34383639("4869"的ASCII码!)
正确做法:若已有hex字符串"4869",应直接用pack('H*', '4869')或hex2bin('4869')还原。
php bin2hex本身无字节序问题(纯字节映射),但当转换多字节数值时(如int),需注意PHP内部整数存储依赖平台字节序(小端/大端)。建议对数值编码用pack('L*', $num)指定格式再bin2hex。
十六进制字符串中含字母a-f,可能与URL保留字符冲突(如%20)。若用于URL参数,需二次编码:
$safe_hex = urlencode(bin2hex($data));
$data = random_bytes(1000); echo strlen(bin2hex($data)); // 2000 → 膨胀100% echo strlen(base64_encode($data)); // 1368 → 膨胀36.8% echo strlen(rawurlencode($data)); // 约2000+(含%转义)
$data = random_bytes(102400);
$times['bin2hex'] = timer(function() use ($data) {
bin2hex($data);
});
$times['base64_encode'] = timer(function() use ($data) {
base64_encode($data);
});
// 结果示例:
// bin2hex: 0.0021s
// base64_encode: 0.0018sbin2hex(如数据库TEXT列)bin2hex + strtr($hex, 'abcdef', 'ABCDEF')(大写更常见)bin2hex打印若对敏感数据(如密码)做hash_file后用bin2hex存储,攻击者仍可暴力破解。正确做法:
// 错误示例
$hash = bin2hex(hash_file('sha256', 'password.txt', true));
// 正确:使用salt + argon2
$hash = password_hash($password, PASSWORD_ARGON2ID);若bin2hex结果用于SQL拼接,需参数化查询:
// 错误
$sql = "INSERT INTO logs (hex) VALUES ('" . bin2hex($data) . "')";
// 正确
$stmt = $pdo->prepare("INSERT INTO logs (hex) VALUES (?)");
$stmt->execute([bin2hex($data)]);攻击者可上传含恶意代码的文件,计算其bin2hex后嵌入合法文件名(如"image.jpg.bin")。防护要点:
bin2hex结果做白名单过滤(仅允许a-f0-9)password_hash而非自定义哈希bin2hex结果(可截断或哈希)function hexDump($data, $length = 16) {
$hex = bin2hex($data);
$chunks = str_split($hex, $length * 2);
foreach ($chunks as $i => $chunk) {
$offset = $i * $length;
$ascii = preg_replace('/[^[:print:]]/', '.', substr($data, $i * $length, $length));
$hexPart = chunk_split(substr($chunk, 0, $length * 2), 2, ' ');
printf("%08X | %-48s | %s\n", $offset, $hexPart, $ascii);
}
}
hexDump("Hello\nWorld!");输出示例:
00000000 | 48 65 6C 6C 6F 0A 57 6F 72 6C 64 21 | Hello.World!
$debug_data = bin2hex($raw_data);
if (strlen($debug_data) > 64) {
$debug_data = substr($debug_data, 0, 64) . '...';
}
error_log("Debug data: $debug_data");// PHP响应头中添加
header('Content-Type: text/plain; charset=utf-8');
// 输出十六进制而非原始二进制
echo bin2hex($binary_content);当需处理特定格式数值时:
$int = 0x12345678;
$packed = pack('L*', $int); // 32位无符号整数(小端)
echo bin2hex($packed); // 输出:78563412注意:pack格式符需根据平台调整(如'V'强制小端,'N'强制大端)。
十六进制字符集较小,可扩展为Base36(0-9a-z)或Base62(0-9a-zA-Z):
function base62_encode($data) {
$hex = bin2hex($data);
$dec = gmp_init($hex, 16);
return gmp_strval($dec, 62);
}
function base62_decode($str) {
$dec = gmp_init($str, 62);
$hex = gmp_strval($dec, 16);
return hex2bin(str_pad($hex, strlen($str) * 62 / log(62, 16), '0', STR_PAD_LEFT));
}Swoole提供 swoole_serialize,但更适用于对象序列化。对纯二进制数据,原生bin2hex仍最轻量。
在加密场景中,OpenSSL扩展可直接输出十六进制哈希:
$hex = openssl_digest($data, 'sha256', true); // 返回二进制 echo bin2hex($hex); // 或直接用openssl_digest($data, 'sha256')返回hex字符串