PHP图片输出函数返回text/html无响应内容排查求助

Let's troubleshoot this step by step—your function looks solid on paper, but the text/html Content-Type and missing response usually point to headers not being sent correctly, or hidden output interfering. Here's what to check and fix:

1. First, Check for Hidden Output Before Headers #

The #1 culprit here is accidental output before your sendImage function runs. This could be:

• A space, newline, or UTF-8 BOM before the <?php opening tag in your script (or any included files)
• Echo/print statements, var dumps, or even error messages from earlier code that you didn't notice

To confirm this, add a check right before calling your function:

$file = $_SERVER['DOCUMENT_ROOT'] . '/images/image.png'; 
// Check if headers were already sent (and where)
if (headers_sent($outputFile, $outputLine)) {
    die("Headers already sent from $outputFile line $outputLine");
}
sendImage($file);

If this outputs an error, track down that line and remove the extra output.

2. Make Sure getimagesize Isn't Failing #

Even if the file exists, it might not be a valid image, or PHP might not have permission to read its metadata. Update your function to validate the getimagesize result:

function sendImage(string $file, int $browser_cache = 2592000) { 
    if (file_exists($file)) { 
        // Validate image metadata
        $imageInfo = getimagesize($file);
        if (!$imageInfo) {
            http_response_code(400);
            die("Invalid image file: $file");
        }
        $mime = $imageInfo['mime']; 

        // Rest of your code...
    } else {
        http_response_code(404);
        die("File not found: $file");
    }
}

3. Clear Output Buffering #

PHP's output buffering might be holding onto hidden content that's forcing the text/html header. Add a buffer cleanup right before sending headers:

function sendImage(string $file, int $browser_cache = 2592000) { 
    if (file_exists($file)) { 
        $imageInfo = getimagesize($file);
        if (!$imageInfo) {
            http_response_code(400);
            die("Invalid image file: $file");
        }
        $mime = $imageInfo['mime']; 

        // Clear any buffered output
        if (ob_get_length() > 0) {
            ob_clean();
        }

        header("Content-Type: ". $mime); 
        header("Cache-Control: private, max-age=".$browser_cache); 
        header('Expires: '.gmdate('D, d M Y H:i:s', time()+$browser_cache).' GMT'); 
        header('Content-Length: '.filesize($file)); 
        readfile($file); 
        exit; 
    } else {
        http_response_code(404);
        die("File not found: $file");
    }
}

4. Verify File Read Permissions #

Just because the file exists doesn't mean the PHP process can read it. Add a check for readability:

function sendImage(string $file, int $browser_cache = 2592000) { 
    if (!file_exists($file)) {
        http_response_code(404);
        die("File not found: $file");
    }
    if (!is_readable($file)) {
        http_response_code(403);
        die("PHP doesn't have permission to read: $file");
    }
    // Rest of your code...
}

5. Turn on Error Reporting #

You might be missing critical warnings (like header send failures). Add this at the very top of your script:

error_reporting(E_ALL);
ini_set('display_errors', 1);

This will show you any hidden errors that are breaking the function.

Final Robust Version of Your Function #

Putting it all together, here's the improved function that handles edge cases and gives clear debugging feedback:

function sendImage(string $file, int $browser_cache = 2592000) { 
    // Basic file checks
    if (!file_exists($file)) {
        http_response_code(404);
        die("File not found: $file");
    }
    if (!is_readable($file)) {
        http_response_code(403);
        die("File is not readable: $file");
    }

    // Validate image metadata
    $imageInfo = getimagesize($file);
    if (!$imageInfo) {
        http_response_code(400);
        die("Invalid image file: $file");
    }
    $mime = $imageInfo['mime']; 

    // Clear buffered output
    if (ob_get_length() > 0) {
        ob_clean();
    }

    // Send proper headers
    header("Content-Type: ". $mime); 
    header("Cache-Control: private, max-age=".$browser_cache); 
    header('Expires: '.gmdate('D, d M Y H:i:s', time()+$browser_cache).' GMT'); 
    header('Content-Length: '.filesize($file)); 

    // Output the image
    readfile($file); 
    exit; 
}

Most likely, the issue is hidden output before your headers are sent—check the headers_sent result first, that's almost always the fix for this exact symptom.

内容的提问来源于stack exchange，提问作者Benny Thadikaran