Image to Image in PHP

This page describes how to convert between images formats in PHP using the Pdfcrowd API. The API is easy to use and the integration takes only a few of lines of code.

Samples

Installation

Download pdfcrowd-5.6.2-php.zip, unzip it and require pdfcrowd.php in your code.

We also offer other installation options (Composer, GitHub).

Authentication

Authentication is needed in order to use the Pdfcrowd API. The credentials used for accessing the API are your Pdfcrowd username and the API key.

To get your personal API credentials, you can start a free API trial or buy the API license.

Examples

<?php
require "pdfcrowd.php";

try
{
    // create the API client instance
    $client = new \Pdfcrowd\ImageToImageClient("your_username", "your_apikey");

    // configure the conversion
    $client->setOutputFormat("jpg");

    // run the conversion and write the result to a file
    $client->convertFileToFile("/path/to/logo.png", "logo.jpg");
}
catch(\Pdfcrowd\Error $why)
{
    // report the error
    error_log("Pdfcrowd Error: {$why}\n");

    // rethrow or handle the exception
    throw $why;
}

?>
<?php
require "pdfcrowd.php";

try
{
    // create the API client instance
    $client = new \Pdfcrowd\ImageToImageClient("your_username", "your_apikey");

    // configure the conversion
    $client->setOutputFormat("jpg");

    // run the conversion and store the result into the "image" variable
    $image = $client->convertFile("/path/to/logo.png");

    // at this point the "image" variable contains JPG raw data and
    // can be sent in an HTTP response, saved to a file, etc.
}
catch(\Pdfcrowd\Error $why)
{
    // report the error
    error_log("Pdfcrowd Error: {$why}\n");

    // rethrow or handle the exception
    throw $why;
}

?>
<?php
require "pdfcrowd.php";

try
{
    // create the API client instance
    $client = new \Pdfcrowd\ImageToImageClient("your_username", "your_apikey");

    // configure the conversion
    $client->setOutputFormat("jpg");

    // create an output stream for the conversion result
    $output_stream = fopen("logo.jpg", "wb");

    // check for a file creation error
    if (!$output_stream)
        throw new \Exception(error_get_last()['message']);

    // run the conversion and write the result into the output stream
    $client->convertFileToStream("/path/to/logo.png", $output_stream);

    // close the output stream
    fclose($output_stream);
}
catch(\Pdfcrowd\Error $why)
{
    // report the error
    error_log("Pdfcrowd Error: {$why}\n");

    // rethrow or handle the exception
    throw $why;
}

?>
<?php
require "pdfcrowd.php";

try
{
    // create the API client instance
    $client = new \Pdfcrowd\ImageToImageClient("your_username", "your_apikey");

    // configure the conversion
    $client->setOutputFormat("jpg");

    // run the conversion and write the result to a file
    $client->convertUrlToFile("https://pdfcrowd.com/static/images/logo.png", "logo.jpg");
}
catch(\Pdfcrowd\Error $why)
{
    // report the error
    error_log("Pdfcrowd Error: {$why}\n");

    // rethrow or handle the exception
    throw $why;
}

?>
<?php
require "pdfcrowd.php";

try
{
    // create the API client instance
    $client = new \Pdfcrowd\ImageToImageClient("your_username", "your_apikey");

    // configure the conversion
    $client->setOutputFormat("jpg");

    // run the conversion and store the result into the "image" variable
    $image = $client->convertUrl("https://pdfcrowd.com/static/images/logo.png");

    // at this point the "image" variable contains JPG raw data and
    // can be sent in an HTTP response, saved to a file, etc.
}
catch(\Pdfcrowd\Error $why)
{
    // report the error
    error_log("Pdfcrowd Error: {$why}\n");

    // rethrow or handle the exception
    throw $why;
}

?>
<?php
require "pdfcrowd.php";

try
{
    // create the API client instance
    $client = new \Pdfcrowd\ImageToImageClient("your_username", "your_apikey");

    // configure the conversion
    $client->setOutputFormat("jpg");

    // create an output stream for the conversion result
    $output_stream = fopen("logo.jpg", "wb");

    // check for a file creation error
    if (!$output_stream)
        throw new \Exception(error_get_last()['message']);

    // run the conversion and write the result into the output stream
    $client->convertUrlToStream("https://pdfcrowd.com/static/images/logo.png", $output_stream);

    // close the output stream
    fclose($output_stream);
}
catch(\Pdfcrowd\Error $why)
{
    // report the error
    error_log("Pdfcrowd Error: {$why}\n");

    // rethrow or handle the exception
    throw $why;
}

?>
<?php
require "pdfcrowd.php";

try
{
    // create the API client instance
    $client = new \Pdfcrowd\ImageToImageClient("your_username", "your_apikey");

    // configure the conversion
    $client->setOutputFormat("jpg");

    // run the conversion and write the result to a file
    $client->convertRawDataToFile(file_get_contents("/path/to/logo.png"), "logo.jpg");
}
catch(\Pdfcrowd\Error $why)
{
    // report the error
    error_log("Pdfcrowd Error: {$why}\n");

    // rethrow or handle the exception
    throw $why;
}

?>
<?php
require "pdfcrowd.php";

try
{
    // create the API client instance
    $client = new \Pdfcrowd\ImageToImageClient("your_username", "your_apikey");

    // configure the conversion
    $client->setOutputFormat("jpg");

    // run the conversion and store the result into the "image" variable
    $image = $client->convertRawData(file_get_contents("/path/to/logo.png"));

    // at this point the "image" variable contains JPG raw data and
    // can be sent in an HTTP response, saved to a file, etc.
}
catch(\Pdfcrowd\Error $why)
{
    // report the error
    error_log("Pdfcrowd Error: {$why}\n");

    // rethrow or handle the exception
    throw $why;
}

?>
<?php
require "pdfcrowd.php";

try
{
    // create the API client instance
    $client = new \Pdfcrowd\ImageToImageClient("your_username", "your_apikey");

    // configure the conversion
    $client->setOutputFormat("jpg");

    // create an output stream for the conversion result
    $output_stream = fopen("logo.jpg", "wb");

    // check for a file creation error
    if (!$output_stream)
        throw new \Exception(error_get_last()['message']);

    // run the conversion and write the result into the output stream
    $client->convertRawDataToStream(file_get_contents("/path/to/logo.png"), $output_stream);

    // close the output stream
    fclose($output_stream);
}
catch(\Pdfcrowd\Error $why)
{
    // report the error
    error_log("Pdfcrowd Error: {$why}\n");

    // rethrow or handle the exception
    throw $why;
}

?>
<?php
require "pdfcrowd.php";

try
{
    // create the API client instance
    $client = new \Pdfcrowd\ImageToImageClient("your_username", "your_apikey");

    // configure the conversion
    $client->setOutputFormat("jpg");
    $client->setDebugLog(true);

    // run the conversion and write the result to a file
    $client->convertFileToFile("/path/to/logo.png", "logo.jpg");
    
    // print URL to the debug log
    echo "Debug log url: " . $client->getDebugLogUrl() . "\n";
    
    // print the number of available conversion credits in your account
    echo "Remaining credit count: " . $client->getRemainingCreditCount() . "\n";
    
    // print the number of credits consumed by the conversion
    echo "Consumed credit count: " . $client->getConsumedCreditCount() . "\n";
    
    // print the unique ID of the conversion
    echo "Job id: " . $client->getJobId() . "\n";
    
    // print the size of the output in bytes
    echo "Output size: " . $client->getOutputSize() . "\n";
}
catch(\Pdfcrowd\Error $why)
{
    // report the error
    error_log("Pdfcrowd Error: {$why}\n");

    // rethrow or handle the exception
    throw $why;
}

?>

Troubleshooting

API Method Reference

Refer for details to the API Method Reference.