🔍

PHP hex2bin(): The Essential Guide to Hex-to-Binary Conversion

Calculating reading time...

In PHP development, handling hexadecimal strings is a common task—whether you’re working with cryptographic hashes, binary file data, network protocols, or legacy systems. PHP provides a simple yet powerful function for converting hexadecimal representations back into raw binary data: hex2bin(). Combined with its counterpart bin2hex(), these functions form a clean, efficient bridge between human‑readable hex and machine‑readable binary.

This article explores everything you need to know about hex2bin(): its syntax, practical use cases, performance considerations, and common pitfalls. By the end, you’ll confidently convert hexadecimal strings to binary in your PHP projects.

What Is hex2bin()?

hex2bin() is a built‑in PHP function that decodes a hexadecimal string into its binary representation. It does the opposite of bin2hex(), which converts binary data into a hexadecimal string.

string hex2bin ( string $data )

Basic Example

$hex = "48656c6c6f"; // "Hello" in hex
$binary = hex2bin($hex);
echo $binary; // Output: Hello

The function parses each pair of hex digits (e.g., 48 → H, 65 → e) and assembles the original binary string.

Why Convert Hex to Binary?

Hexadecimal is often used as a human‑friendly representation of binary data. Common scenarios where you need hex2bin() include:

Using hex2bin() – Practical Examples

1. Decoding a Hash

$hashHex = "5d41402abc4b2a76b9719d911017c592"; // MD5 of "hello"
$hashBin = hex2bin($hashHex);
echo bin2hex($hashBin); // Back to hex: 5d41402abc4b2a76b9719d911017c592

This is especially useful when you need to compare binary hashes or store them in a binary column in a database.

2. Converting Hex‑Encoded File Content

Suppose you have a text file containing hex representation of an image:

$hexData = file_get_contents('image.hex'); // contains something like "FFD8FFE0..."
$binaryData = hex2bin($hexData);
file_put_contents('image.jpg', $binaryData);

Now you have a valid JPEG file.

3. Working with API Responses

Many APIs return hex‑encoded binary data (e.g., a thumbnail image). You can decode it directly:

$response = file_get_contents('https://api.example.com/thumbnail?id=123');
$data = json_decode($response, true);
$imageBin = hex2bin($data['thumbnail_hex']);
// Send appropriate image headers
header('Content-Type: image/jpeg');
echo $imageBin;

bin2hex() – The Opposite Conversion

For completeness, bin2hex() converts binary data to a hexadecimal string:

string bin2hex ( string $data ) 
$binary = "Hello";
$hex = bin2hex($binary); // 48656c6c6f

These two functions are perfect companions. Together they allow you to easily switch between binary and textual representations.

Performance Considerations

hex2bin() is implemented in C and is highly optimized. In most cases, it will be faster than any user‑land loop or custom solution.

Comparison with pack()

You can also achieve hex‑to‑binary conversion using pack():

$binary = pack('H*', $hex);

This is functionally equivalent to hex2bin(). Performance is very similar, but hex2bin() is slightly more readable for this specific task.

User‑Land Alternatives (Avoid)

// Avoid this – it's slower and less robust
function my_hex2bin($hex) {
    $len = strlen($hex);
    $bin = '';
    for ($i = 0; $i < $len; $i += 2) {
        $bin .= chr(hexdec($hex[$i] . $hex[$i+1]));
    }
    return $bin;
}

Stick to hex2bin() for clarity, speed, and built‑in error handling.

Error Handling and Edge Cases

hex2bin() returns false when the input is invalid. This can happen if:

Always validate the return value:

$hex = "48656c6c6f"; // valid
$result = hex2bin($hex);
if ($result === false) {
    // Handle error
    die('Invalid hexadecimal string');
}
echo $result;

Handling Odd‑Length Strings

If you sometimes receive hex strings with an odd number of characters (e.g., from a poorly formatted source), you can pad them with a leading zero:

$hex = "f00"; // odd length
if (strlen($hex) % 2 !== 0) {
    $hex = "0" . $hex;
}
$bin = hex2bin($hex);

However, be cautious—this changes the data. It’s better to fix the source or detect the error.

Exceptions (PHP 8.0+)

Starting with PHP 8.0, hex2bin() throws a ValueError when the input is invalid, instead of returning false. You can catch it:

try {
    $bin = hex2bin($hex);
} catch (ValueError $e) {
    echo "Invalid hex string: " . $e->getMessage();
}

This makes error handling more explicit. If you need compatibility with older versions, use false checks.

Security Considerations

When dealing with hex‑encoded data from user input or external sources, always validate before using hex2bin():

Example of Safe Conversion

$hex = $_POST['hex_data'] ?? '';

if (!ctype_xdigit($hex) || strlen($hex) % 2 !== 0) {
    die('Invalid hex data.');
}

$binary = hex2bin($hex);
// Now safe to use $binary

Real‑World Use Case: Storing Binary Data in MySQL

MySQL has BLOB and BINARY column types designed for raw binary data. Often, you might receive hex strings from a frontend or an API. Instead of storing the hex string (which doubles the size), decode it to binary first:

$hex = $_POST['image_hex']; // from client
if (ctype_xdigit($hex) && strlen($hex) % 2 === 0) {
    $binary = hex2bin($hex);
    $stmt = $pdo->prepare("INSERT INTO images (data) VALUES (?)");
    $stmt->execute([$binary]);
}

This reduces storage space and improves query performance.

Common Pitfalls

  1. Forgetting to check return value: Always verify that hex2bin() succeeded.
  2. Assuming uppercase/lowercase doesn’t matter: It doesn’t—hex2bin() accepts both.
  3. Misinterpreting binary output: If you print the binary result directly, you may see garbled characters or truncated output. Use bin2hex() or var_dump() to inspect.
  4. Using hex2bin() on large strings without memory considerations: While hex2bin() is efficient, a hex string that is 100 MB will produce a 50 MB binary string. Ensure your PHP memory limits are adequate.

Performance Benchmark (Informal)

A quick comparison between hex2bin() and a custom loop on a 1 MB hex string (500k bytes of binary):

The built‑in function is dramatically faster and should always be your first choice.

Conclusion

PHP’s hex2bin() function is a straightforward yet essential tool for any developer working with binary data. It offers:

Remember to always validate your input, handle errors appropriately, and use bin2hex() when you need to go the other direction. Whether you’re decoding API responses, working with cryptographic data, or handling binary file uploads, hex2bin() provides a clean, efficient solution.

Now you’re equipped to seamlessly convert between hexadecimal and binary in PHP—making your applications more robust and performant.

Happy coding, and may your data always decode correctly!