Browser header declaration for an image

Return the correct image Content-Type

A PHP endpoint that outputs only an image should send an image MIME type before any image bytes. Do not send HTML or whitespace before header().

<?php
$image = imagecreatetruecolor(300, 90);
$background = imagecolorallocate($image, 240, 240, 240);
$text = imagecolorallocate($image, 20, 70, 150);
imagefilledrectangle($image, 0, 0, 299, 89, $background);
imagestring($image, 5, 20, 35, 'Dynamic PNG', $text);

header('Content-Type: image/png');
imagepng($image);
imagedestroy($image);
?>

Current example first; the original tutorial examples below are retained and cleaned up for continued learning.

When we are drawing images on the fly we have to tell the browser about the content we are sending to it. We can't display an image by telling the browser that we are sending text or html code. To this we have to use header declaration at the first line of data we send to the browser window.

header("Content-Type: image/jpeg");

Without this line at the starting of the data (not the starting of the page) if we send an image browser will display non recognized characters on the screen. So we have to tell browser that we are sending an image. We also can't send any text or data along with the image. So we will be using another window to display any graph or image not the existing window were some text or data is already there. We also can't mix both in the new window.

By default browser is set to display text only.

Let us use this to create an image and then display the same in a web page.

<?php
header ("Content-Type: image/jpeg");
///// Create the image ////////
$im = @ImageCreate (100,40)
or die ("Cannot Initialize new GD image stream");

$background_color = ImageColorAllocate ($im, 204, 204, 204); // Assign background color
$text_color = ImageColorAllocate ($im, 51, 51, 255);      // text color is given 

ImageString($im,5,10,10,'PLUS2NET',$text_color); // Random string  from session added 

ImageJpeg ($im); // image displayed
imagedestroy($im); // Memory allocation for the image is removed. 
?>

Output is here

To display the above generated image we used this HTML code.

<img src=gd-imagestring-demo.php>

Integrated with other html code in a full web page.

<!DOCTYPE html>
<html lang="en">
<head>
    <meta charset="UTF-8">
    <meta name="viewport" content="width=device-width, initial-scale=1.0">
    <title>Dynamic Image in PHP</title>
</head>
<body>

  <h2 class="text-primary">Generated Image from PHP</h2>
  <p class="text-muted">The image below is dynamically generated by test1.php.</p>

  <img src="test1.php?time=<?php echo time(); ?>" alt="Dynamic Image" >

</body>
</html>

This code dynamically loads an image generated by the test1.php script. The query string ?time=<?php echo time(); ?> appends a unique timestamp to the image URL using PHP's time() function.
We can also link to different domains.

<img src="https://www.example.com/dir/test1.php?time=<?php echo time(); ?> alt="Dynamic Image" >

🔄 Why is time() included?

Including time() in the query string prevents the browser from caching the image. Since time() returns the current UNIX timestamp (which changes every second), it ensures that a fresh version of the image is loaded each time the page is refreshed. Without this, the browser might serve a cached version of the image, which may not reflect the most recent updates from test1.php.

✅ Benefit: Ensures the image is dynamically refreshed and stays up to date. 🚀

Use Case: Generating Dynamic Images: Show how to generate dynamic images like CAPTCHA, charts, or watermarks using PHP GD functions.
Captcha Generation
GD functions

Subhendu Mohapatra

Author & Instructor at plus2net

I write and maintain practical tutorials on Python, PHP, SQL, JavaScript, HTML, jQuery, and web development at plus2net. The tutorials focus on clear explanations, working examples, and code that readers can test and adapt while learning.

About the author Watch on YouTube

Connect:

Subscribe to our YouTube Channel here

Send Dynamically Generated Images from PHP with HTTP Headers

Return the correct image Content-Type

🔄 Why is time() included?

Subhendu Mohapatra