Stars: 237
Forks: 54
Pull Requests: 5
Issues: 16
Watchers: 15
Last Updated: 2021-08-20 17:15:12
Convertio APIs Client Library for PHP
License:
Languages: PHP
This is a lightweight wrapper for the Convertio API.
Feel free to use, improve or modify this wrapper! If you have questions contact us or open an issue on GitHub.
You can find full API reference here: https://convertio.co/api/docs/
Following example will render remote web page into PNG image:
<?php
require_once 'autoload.php'; // Comment this line if you use Composer to install the package
use \Convertio\Convertio;
$API = new Convertio("_YOUR_API_KEY_"); // You can obtain API Key here: https://convertio.co/api/
$API->startFromURL('http://google.com/', 'png') // Convert (Render) HTML Page to PNG
->wait() // Wait for conversion finish
->download('./google.png') // Download Result To Local File
->delete(); // Delete Files from Convertio hosts
Following example will convert local DOCX file to PDF:
<?php
require_once 'autoload.php'; // Comment this line if you use Composer to install the package
use \Convertio\Convertio;
$API = new Convertio("_YOUR_API_KEY_"); // You can obtain API Key here: https://convertio.co/api/
$API->start('./input.docx', 'pdf')->wait()->download('./output.pdf')->delete();
Following example will extract clean text from DOCX:
<?php
require_once 'autoload.php'; // Comment this line if you use Composer to install the package
use \Convertio\Convertio;
$API = new Convertio("_YOUR_API_KEY_"); // You can obtain API Key here: https://convertio.co/api/
$Text = $API->start('./test.docx', 'txt')->wait()->fetchResultContent()->result_content;
$API->delete();
echo $Text;
Following example will override default API parameters in case you don't have SSL enabled in your PHP installation or want to limit execution time:
<?php
require_once 'autoload.php'; // Comment this line if you use Composer to install the package
use \Convertio\Convertio;
$API = new Convertio("_YOUR_API_KEY_"); // You can obtain API Key here: https://convertio.co/api/
$API->settings(array('api_protocol' => 'http', 'http_timeout' => 10));
$API->startFromURL('http://google.com/', 'png')->wait()->download('./google.png')->delete();
Following example will convert pages 1-3,5,7 of PDF into editable DOCX, using OCR (Optical Character Recognition) for English and Spanish languages (Full list of available languages):
<?php
require_once 'autoload.php'; // Comment this line if you use Composer to install the package
use \Convertio\Convertio;
$API = new Convertio("_YOUR_API_KEY_");
$API->start('./test.pdf', 'docx', // Convert PDF (which contain scanned pages) into editable DOCX
[ // Setting Conversion Options (Docs: https://convertio.co/api/docs/#options)
'ocr_enabled' => true, // Enabling OCR
'ocr_settings' => [ // Defining OCR Settings
'langs' => ['eng','spa'], // OCR language list (Full list: https://convertio.co/api/docs/#ocr_langs)
'page_nums' => '1-3,5,7' // Page numbers to process (optional)
]
]
)
->wait() // Wait for conversion finish
->download('./test.docx') // Download Result To Local File
->delete(); // Delete Files from Convertio hosts
You can use Composer or simply Download the Release
The preferred method is via composer. Follow the installation instructions if you do not already have composer installed.
Once composer is installed, execute the following command in your project root to install this library:
composer require convertio/convertio-php
Finally, be sure to include the autoloader:
<?php
require_once '/path/to/your-project/vendor/autoload.php';
You can download the package in its entirety. The Releases page lists all stable versions.
Download any file with the name convertio-php-[RELEASE_NAME].zip
for a package including this library and its dependencies.
Uncompress the zip file you download, and include the autoloader in your project:
<?php
require_once '/path/to/convertio-php/autoload.php';
use \Convertio\Convertio;
$API = new Convertio("_YOUR_API_KEY_");
//...
The following example shows how to catch the different exception types which can occur at conversions:
<?php
require_once 'autoload.php'; // Comment this line if you use Composer to install the package
use \Convertio\Convertio;
use \Convertio\Exceptions\APIException;
use \Convertio\Exceptions\CURLException;
try {
$API = new Convertio("_YOUR_API_KEY_");
$API->start('./test.pdf', 'docx')->wait()->download('test.docx')->delete();
} catch (APIException $e) {
echo "API Exception: " . $e->getMessage() . " [Code: ".$e->getCode()."]" . "\n";
} catch (CURLException $e) {
echo "HTTP Connection Exception: " . $e->getMessage() . " [CURL Code: ".$e->getCode()."]" . "\n";
} catch (Exception $e) {
echo "Miscellaneous Exception occurred: " . $e->getMessage() . "\n";
}
The following example is usable for conversions that is not instant and may require some time to complete. In this case you may define the callback URL (More info), which gets notified when the conversion is over (either successful or not):
<?php
require_once 'autoload.php'; // Comment this line if you use Composer to install the package
use \Convertio\Convertio;
use \Convertio\Exceptions\APIException;
use \Convertio\Exceptions\CURLException;
try {
$API = new Convertio("_YOUR_API_KEY_"); // You can obtain API Key here: https://convertio.co/api/
$API->start('./test.avi', 'hevc', [ // Start AVI => HEVC conversion
"callback_url" => "https://path/to/callback.php" // Defined publicly available callback URL
]);
} catch (APIException $e) {
echo "API Exception: " . $e->getMessage() . " [Code: ".$e->getCode()."]" . "\n";
} catch (CURLException $e) {
echo "HTTP Connection Exception: " . $e->getMessage() . " [CURL Code: ".$e->getCode()."]" . "\n";
} catch (Exception $e) {
echo "Miscellaneous Exception occurred: " . $e->getMessage() . "\n";
}
The exception handling in this code snippet is essential. Conversion errors throw APIException which have to be handled properly. Please, read more info about step parameter.
<?php
require_once 'autoload.php'; // Comment this line if you use Composer to install the package
use \Convertio\Convertio;
use \Convertio\Exceptions\APIException;
use \Convertio\Exceptions\CURLException;
try {
$API = new Convertio("_YOUR_API_KEY_"); // You can obtain API Key here: https://convertio.co/api/
$API->__set('convert_id', $_GET['id']); // Set Conversion ID
if ($_GET['step'] == 'finished') { // If conversion finished
$API->download('test.hevc.mp4') // Download result into local file
->delete(); // Delete it from conversion server
} else { // Otherwise handle error in appropriate way
echo "Conversion failed." . "\n";
}
} catch (APIException $e) {
echo "API Exception: " . $e->getMessage() . " [Code: ".$e->getCode()."]" . "\n";
} catch (CURLException $e) {
echo "HTTP Connection Exception: " . $e->getMessage() . " [CURL Code: ".$e->getCode()."]" . "\n";
} catch (Exception $e) {
echo "Miscellaneous Exception occurred: " . $e->getMessage() . "\n";
}
The following example is usable for conversions that is not instant and may require some time to complete. In this case you may get the conversion ID and check the conversion status later, omitting "->wait()" call and making conversion starting process instant:
<?php
require_once 'autoload.php'; // Comment this line if you use Composer to install the package
use \Convertio\Convertio;
use \Convertio\Exceptions\APIException;
use \Convertio\Exceptions\CURLException;
try {
$API = new Convertio("_YOUR_API_KEY_"); // You can obtain API Key here: https://convertio.co/api/
$ConvertID = $API->start('./test.avi', 'hevc') // Start AVI => HEVC conversion
->getConvertID(); // Get the Conversion ID
} catch (APIException $e) {
echo "API Exception: " . $e->getMessage() . " [Code: ".$e->getCode()."]" . "\n";
} catch (CURLException $e) {
echo "HTTP Connection Exception: " . $e->getMessage() . " [CURL Code: ".$e->getCode()."]" . "\n";
} catch (Exception $e) {
echo "Miscellaneous Exception occurred: " . $e->getMessage() . "\n";
}
The exception handling in this code snippet is essential. Conversion errors throw APIException which have to be handled properly.
<?php
require_once 'autoload.php'; // Comment this line if you use Composer to install the package
use \Convertio\Convertio;
use \Convertio\Exceptions\APIException;
use \Convertio\Exceptions\CURLException;
try {
$API = new Convertio("_YOUR_API_KEY_"); // You can obtain API Key here: https://convertio.co/api/
$API->__set('convert_id', $ConvertID); // Set Conversion ID. $ConvertID is a string, obtained in previous snippet
$API->status(); // Check status of the conversion
if ($API->step == 'finish') { // If conversion finished
$API->download('test.hevc.mp4')->delete(); // Save result into local file and download it from conversion server
} else { // Otherwise print some message
echo "Conversion didn't finish yet." . "\n";
echo "Check back later." . "\n";
}
} catch (APIException $e) {
echo "API Exception: " . $e->getMessage() . " [Code: ".$e->getCode()."]" . "\n";
} catch (CURLException $e) {
echo "HTTP Connection Exception: " . $e->getMessage() . " [CURL Code: ".$e->getCode()."]" . "\n";
} catch (Exception $e) {
echo "Miscellaneous Exception occurred: " . $e->getMessage() . "\n";
}