PHP convert_uudecode() Function

What You’ll Learn

The convert_uudecode() function decodes strings encoded with the uuencode algorithm—a legacy binary-to-text format from Unix and early email systems. It pairs with convert_uuencode() and is useful when working with old encoded data.

Definition and Usage

In PHP, convert_uudecode() takes a uuencoded string and returns the original data. uuencode converts binary bytes into printable ASCII so they could travel through text-only systems. Each encoded line typically starts with a character indicating the line length, followed by encoded payload characters.

📝 Syntax

The convert_uudecode() function accepts one string parameter:

string|false convert_uudecode(string $string)

Parameters

• $string — the uuencoded data to decode. Must be valid uuencode output (typically produced by convert_uuencode()).

Return Value

Returns the decoded string on success, or false if decoding fails. The original input is not modified.

Examples Gallery

Run these examples in PHP 7+. Each demonstrates a common pattern beginners encounter with convert_uudecode().

<?php
$original = "Hello, PHP!";
$encoded  = convert_uuencode($original);
$decoded  = convert_uudecode($encoded);

echo "Original: $original\n";
echo "Encoded:\n$encoded\n";
echo "Decoded:  $decoded\n";
?>

Original: Hello, PHP!
Encoded:
+2&5L;&\L(%!(4"$`
Decoded:  Hello, PHP!

<?php
$messages = ["test", "Binary\x00data", "Multi\nline\ntext"];

foreach ($messages as $msg) {
    $back = convert_uudecode(convert_uuencode($msg));
    $ok   = ($back === $msg) ? "yes" : "no";
    echo "Match ($ok): " . json_encode($msg) . "\n";
}
?>

Match (yes): "test"
Match (yes): "Binary\u0000data"
Match (yes): "Multi\nline\ntext"

<?php
// uuencoded form of "test\ntext test a" (legacy sample)
$encoded = "0=&5S=`IT97AT('1E<W0@86X@97)S='9E(&9O<F5C=\"!O8FH-,3`I";

$decoded = convert_uudecode($encoded);

echo "Decoded:\n$decoded\n";
echo "Length: " . strlen($decoded) . " bytes\n";
?>

Decoded:
test
text test a
Length: 15 bytes

<?php
$plainText = "This is not uuencoded";
$result    = convert_uudecode($plainText);

if ($result === false) {
    echo "Decoding failed.\n";
} else {
    echo "Unexpected result: " . bin2hex($result) . "\n";
}

// Safe pattern: only decode known uuencode output
$safe = convert_uuencode("Known data");
echo convert_uudecode($safe) . "\n";
?>

Unexpected result: <varies — invalid decode may return false or binary junk>
Known data

<?php
$data = "Sample binary\xFF\xFE data";

$uu  = convert_uuencode($data);
$b64 = base64_encode($data);

echo "uuencode length:  " . strlen($uu) . "\n";
echo "Base64 length:    " . strlen($b64) . "\n";

echo "uudecode match:   " . (convert_uudecode($uu) === $data ? "yes\n" : "no\n");
echo "base64 match:     " . (base64_decode($b64) === $data ? "yes\n" : "no\n");
?>

uuencode length:  29
Base64 length:    28
uudecode match:   yes
base64 match:     yes

🚀 Common Use Cases

• Legacy email attachments — decode uuencoded sections in old Unix mail files.
• Maintaining old PHP scripts — understand code that still calls uuencode functions.
• Historical file formats — read uuencoded data from 1980s–1990s software archives.
• Round-trip testing — verify convert_uuencode() output decodes correctly.
• Learning encoding history — compare uuencode with modern Base64 approaches.

📝 Notes

• Input must be valid uuencode output—plain text produces unreliable results.
• Always pair with convert_uuencode() when you control both sides of the encoding.
• Check for false return value when decoding external or untrusted data.
• For new projects, prefer base64_encode() / base64_decode().
• uuencode and uudecode functions were deprecated in PHP 8.4; plan migrations for long-term PHP 9 compatibility.

💡 Best Practices