DEV Community

Cover image for How to generate an image: using PHP GD Library. (part 1)
Emmanuel C. Okolie
Emmanuel C. Okolie

Posted on • Updated on

How to generate an image: using PHP GD Library. (part 1)

photo by Christiana Morillo from Pexels: https://www.pexels.com/photo/close-up-photo-of-person-typing-on-laptop-1181675/

Introduction

PHP GD is a library that performs fantastic tasks that helps you to do several things with your image. As a PHP Developer, There are times when you have to survey into some advance functionality of your stack. And one is the GD library, is not easily done by most developers.
and it helps you do anything with image.

If you’re ready, let's proceed to this PHP amazing library that helps you generate, and draw an image.

What is GD Library

GD is an acronym that stands for “GRAPHIC DRAW”.

The GD library in PHP enables you to create image data, and it’s the most used image processing tool in PHP. GD was originally developed by Thomas Boutell. By far it is a powerful image-processing library for PHP (it is also available for other languages like Perl).

GD library allows you to dynamically create and edit of images, charts thumbnails, etc. The following file type that can be created or edited using the GD library, are GIF, JPEG, and PNG.

How Does GD Library work

One thing you should understand is that the GD library has a pattern in which it works. Now if you don’t follow the process of the GD library you won’t see anything on your interface. Below are the steps for implementing GD library in your project:

Step 1:
You must check if the GD library is enabled in your system local server (XAMMP). If it’s disabled you have to enable it, once it’s enabled you are good to go.

If yours is enabled you will see a display similar to the image below. To see if the GD library is enabled in your local server, go to your PHP index file and echo **phpinfo();** then you’ll see the GD support in your interface.

little example, from (me) Rabbi Emmykolic

Step 2:
You will go to your **index.php** and create an image tag. And in the src of the image tag, you’ll write the address of the PHP file where you want to write the GD codes. So the image tag will look like this.

An Example From (me) Rabbi Emmykolic

Now, this is where you’ll write the PHP code.

little example, from (me) Rabbi Emmykolic

<img src="gd.php">
Enter fullscreen mode Exit fullscreen mode

After this step, you’ll start writing some functions of the GD library. In the PHP file your GD will start working automatically.

Using GD Library in your projects


Example *****1:* Using GD Library to create a Color-box with a JPEG extension, when saved.

*****Step1:* Create an image with the specified dimensions

$image = imageCreate(300,200);
Enter fullscreen mode Exit fullscreen mode

Step2: Create a color (this first call to imageColorAllocate also automatically sets the image background color)

   $colorRed = imageColorAllocate($image, 255,0,0);
Enter fullscreen mode Exit fullscreen mode

Step3: Create another color

$colorYellow = imageColorAllocate($image, 255,255,0);
Enter fullscreen mode Exit fullscreen mode

Step4: Draw a rectangle

imageFilledRectangle($image, 50, 50, 250, 150, $colorYellow);
Enter fullscreen mode Exit fullscreen mode

Step5: Set type of image and send the output

header("Content-type: image/jpeg");
imageJpeg($image);
Enter fullscreen mode Exit fullscreen mode

Step6: Release memory

   imageDestroy($image);


<?php
   $image = imageCreate(300,200);

   $colorRed = imageColorAllocate($image, 255,0,0);
   $colorYellow = imageColorAllocate($image, 255,255,0);

   imageFilledRectangle($image, 50, 50, 250, 150, $colorYellow);

   header("Content-type: image/jpeg");
   imageJpeg($image);

   imageDestroy($image);
?>
Enter fullscreen mode Exit fullscreen mode

By running the above code, you will get the output seen in the image below:

little example, from (me) Rabbi Emmykolic

Example *****2:* How to use GD library to create and rotate a png image.

Run the code below to see how to rotate an image. You’ll have to put an image to the PHP file you’re working with, else it won’t dispaly on your interface.

// Create an image with the specified dimensions
   $image = imagecreatefrompng("africa_coin.png");//and the name of the image with specified extension.

    // Create a color
   $colorYellow = imageColorAllocate($image, 255,255,0);

  // Rotate
   $image=imagerotate($image, 60, $colorYellow);

   // Set type of image and send the output
   header("Content-type: image/png");
   imagePng($image);

   // Release memory
   imageDestroy($image);
Enter fullscreen mode Exit fullscreen mode

By running the above code, you will get the output below:

little example, from (me) Rabbi Emmykolic

Why you should use GD Library

GD is an advanced PHP, you can agree with me often advanced PHP developers are the one using GD library. So if you want to be a king in the PHP realm you have to use stuff like this.

Another reason you should use GD library is that it helps you do dynamic things with images, in your PHP files.

Lastly, It saves you the stress of writing lots of JavaScript, CSS & HTML code…

Other things GD Library can be used for

There are so many things out there that the GD library can be used for, it depends on the developer. Here are a few things you can use the GD library to achieve:

  • You can use the GD library to build a Captcha system.
  • You can use the GD library to reduce the quality of an image. ## How to generate an image with GD Library

The way to generate images in GD is pretty simple if you have used it before. The first step to making an image to show is to use the **ImageCreate()** function. Then specify the width and height. But if you want to create an image with a png extension you’ll have to use the **ImageCreatePng()** function.

The functions mentioned above, are few listed function that can be used to create a GD library. so the pics below shows some of those function.

little example, from (me) Rabbi Emmykolic

Conclusion

We’ve come to the end of this tutorial, hopefully you got some ideas from the teaching. From the tutorial, we were able to bring to generate an png and jpg images using the GD library.

This is not the end of the tutorial, we’ll talk more about how to use GD to make other things.

See you next time, enjoy!

About the Author

Emmanuel C. Okolie kick-started his journey as a software engineer in 2020. Over the years, he has grown full-blown skills in JavaScript, PHP, HTML & CSS, and more.

He is freelancing, building clients' websites, and writing technical tutorials teaching others how to do what he does.

Emmanuel C. Okolie is open and available to hear from you. You can reach him on Linked In, Google, Facebook, GitHub, Twitter, or on his website.

Top comments (2)

Collapse
 
nnekajenny profile image
Jennifer Eze

great

Collapse
 
emmykolic profile image
Emmanuel C. Okolie

Thanks 😊 ma'am