Menu

Tree [973573] main v1.0.0 /
 History

HTTPS access


File Date Author Commit
 .github 2023-07-26 Vertonim Vertonim [973573] Initial commit
 src 2023-07-26 Vertonim Vertonim [973573] Initial commit
 .gitignore 2023-07-26 Vertonim Vertonim [973573] Initial commit
 LICENSE 2023-07-26 Vertonim Vertonim [973573] Initial commit
 README.md 2023-07-26 Vertonim Vertonim [973573] Initial commit
 autoload.php 2023-07-26 Vertonim Vertonim [973573] Initial commit
 composer.json 2023-07-26 Vertonim Vertonim [973573] Initial commit

Read Me

Vertopal-PHP

Vertopal-PHP is a PHP library for easy access to
Vertopal file conversion API.

Using Vertopal-PHP, you can get started quickly and easily implement
the support of converting +350 file formats into your project.

Installing Vertopal-PHP

Vertopal-PHP is available on
Packagist and
can be installed using Composer:

composer require vertopal/vertopal-php

If you're not using Composer, you can also download the most recent version of
Vertopal-PHP source code as a ZIP file from the
release page
and load each class file manually.

Requirements

  • PHP 7.4.0 or higher
  • cURL extension enabled

Using Vertopal-PHP

To use Vertopal-PHP you need to
obtain an App-ID and a Security Token
as client credentials for API authentication.

The following code illustrates
GIF to APNG conversion using
the Vertopal PHP library.

<?php
// Import Vertopal classes into the global namespace
use Vertopal\API\Credential;
use Vertopal\API\V1;

// Load Composer Autoloader
require "vendor/autoload.php";

// Create a client credential instance using your app ID and security token
$app = "your-app-id";
$token = "your-security-token";
$credential = new Credential($app, $token);

// Set HTTP request timeout high enough for Synchronous Conversion
V1::$timeout = 120;

// Set input and output details
$inputFile = "MickeyMouse.gif";
$inputPath = "/path/to/" . $inputFile;
$outputFormat = "apng";
$outputFile = "MyConvertedFile.apng";

// Call the minimum tasks required for a file conversion
$response = V1::upload($inputFile, $inputPath, $credential);
$connector = $response->result->output->connector;

$response = V1::convert($outputFormat, $credential, $connector, null, V1::SYNC);
$connector = $response->result->output->connector;

$response = V1::downloadURL($credential, $connector);
$connector = $response->result->output->connector;

V1::downloadFile($credential, $connector, $outputFile);