PHP code example of converthub / php-sdk

    
        
<?php
require_once('vendor/autoload.php');

/* Start to develop here. Best regards https://php-download.com/ */

    

converthub / php-sdk example snippets

ConvertHub\ConvertHubClient;

// Initialize the client
$client = new ConvertHubClient('YOUR_API_KEY');

// Convert a file
$job = $client->conversions()->convert(
    'path/to/document.pdf',
    'docx'
);

// Wait for completion
$completedJob = $client->jobs()->waitForCompletion($job->getJobId());

// Get download URL
if ($completedJob->isCompleted()) {
    echo "Download URL: " . $completedJob->getDownloadUrl();
}

$client = new ConvertHubClient('YOUR_API_KEY');

$client = new ConvertHubClient('YOUR_API_KEY', [
    'base_url' => 'https://api.converthub.com', // Custom API endpoint
    'timeout' => 30,                             // Request timeout in seconds
    'connect_timeout' => 10,                     // Connection timeout
    'retry_enabled' => true,                     // Enable automatic retries
    'max_retries' => 3,                         // Maximum retry attempts
]);

$accountInfo = $client->getAccount();

echo "Credits Remaining: " . $accountInfo['credits_remaining'] . "\n";
echo "Plan: " . $accountInfo['plan']['name'] . "\n";
echo "Total Credits: " . $accountInfo['plan']['credits'] . "\n";
echo "File Size Limit: " . $accountInfo['plan']['file_size_limit_mb'] . " MB\n";

// Check if running low on credits
if ($accountInfo['credits_remaining'] < 10) {
    echo "Warning: Running low on credits!\n";
}

// Calculate usage percentage
$account = $client->getAccount();
$usedCredits = $account['plan']['credits'] - $account['credits_remaining'];
$usagePercent = round(($usedCredits / $account['plan']['credits']) * 100, 1);

echo "Credits Used: {$usedCredits}/{$account['plan']['credits']} ({$usagePercent}%)\n";

// Check file size before conversion
$filePath = 'large-file.pdf';
$fileSize = filesize($filePath);

if ($fileSize > $account['plan']['file_size_limit']) {
    echo "File too large for your plan. Max size: " . $account['plan']['file_size_limit_mb'] . " MB\n";
    echo "Please upgrade your plan to convert larger files.\n";
}

// Simple conversion
$job = $client->conversions()->convert(
    'path/to/image.png',
    'jpg'
);

echo "Job ID: " . $job->getJobId() . "\n";
echo "Status: " . $job->getStatus() . "\n";

// Convert a file from URL
$job = $client->conversions()->convertFromUrl(
    'https://example.com/document.pdf',
    'docx'
);

// Poll for completion
while ($job->isProcessing()) {
    sleep(2);
    $job = $client->jobs()->getStatus($job->getJobId());
}

if ($job->isCompleted()) {
    echo "Download: " . $job->getDownloadUrl() . "\n";
} else {
    echo "Error: " . $job->getErrorMessage() . "\n";
}

$job = $client->jobs()->getStatus('job_123e4567-e89b-12d3-a456-426614174000');

if ($job->isCompleted()) {
    echo "Conversion completed!\n";
    echo "Download URL: " . $job->getDownloadUrl() . "\n";
    echo "File size: " . $job->getFileSize() . " bytes\n";
    echo "Expires at: " . $job->getExpiresAt() . "\n";
} elseif ($job->isFailed()) {
    echo "Conversion failed: " . $job->getErrorMessage() . "\n";
} else {
    echo "Still processing...\n";
}

// Get download info
$downloadInfo = $client->jobs()->getDownloadUrl($job->getJobId());

echo "Filename: " . $downloadInfo->getFilename() . "\n";
echo "Size: " . $downloadInfo->getFileSizeFormatted() . "\n";

// Download to local file
$success = $downloadInfo->downloadTo('path/to/save/converted.docx');

if ($success) {
    echo "File downloaded successfully!\n";
}

// Simple - extract text and wait for result
$job = $client->ocr()->imageToTextAndWait('path/to/scan.png');

// Download the extracted text
$downloadInfo = $client->jobs()->getDownloadUrl($job->getJobId());
$downloadInfo->downloadTo('output/extracted.txt');

// Async - submit and poll manually
$job = $client->ocr()->imageToText('path/to/scan.png');
echo "Job ID: " . $job->getJobId() . "\n";

$completedJob = $client->jobs()->waitForCompletion($job->getJobId());

use ConvertHub\Models\OcrOptions;

// Extract text from a scanned PDF
$job = $client->ocr()->pdfToTextAndWait('path/to/scanned.pdf');

// With options - force OCR even if text layer exists
$job = $client->ocr()->pdfToTextAndWait(
    'path/to/scanned.pdf',
    OcrOptions::make()->language('eng')->forceOcr()
);

// Create a searchable PDF from an image (adds invisible text layer)
$job = $client->ocr()->imageToSearchablePdf('path/to/scan.png');

// Add OCR text layer to an existing scanned PDF
$job = $client->ocr()->makeSearchablePdf('path/to/scanned.pdf');

use ConvertHub\Models\OcrOptions;

$options = OcrOptions::make()
    ->language('eng+deu')       // Multiple languages with '+'
    ->deskew()                  // Straighten skewed scans
    ->rotatePages()             // Auto-detect page rotation
    ->removeBackground()        // Remove background noise
    ->clean()                   // Clean up image before OCR
    ->forceOcr()                // OCR all pages, even with existing text
    ->dpi(300)                  // Higher DPI for better accuracy
    ->pageSegmentationMode(6)   // Single uniform block of text
    ->outputFilename('result.txt')
    ->metadata(['batch' => 'invoice_scan_2024']);

$job = $client->ocr()->imageToTextAndWait('scan.png', $options);

// Using the options builder
$options = $client->conversions()->options()
    ->setQuality(90)                        // Image quality (1-100)
    ->setResolution('1920x1080')           // Resolution for images/videos
    ->setBitrate('320k')                   // Audio/video bitrate
    ->setSampleRate(44100)                 // Audio sample rate
    ->setOutputFilename('my-document.pdf') // Custom output filename
    ->toArray();

$job = $client->conversions()->convert(
    'path/to/file.jpg',
    'pdf',
    $options
);

// Or pass options directly
$job = $client->conversions()->convert(
    'path/to/audio.wav',
    'mp3',
    [
        'options' => [
            'bitrate' => '320k',
            'sample_rate' => 48000
        ],
        'output_filename' => 'high-quality.mp3'
    ]
);

// For files over 50MB, use chunked upload
$largeFile = 'path/to/large-video.mov';
$targetFormat = 'mp4';

// Automatic chunked upload with progress tracking
$job = $client->chunkedUpload()->uploadLargeFile(
    $largeFile,
    $targetFormat,
    [
        'webhook_url' => 'https://your-app.com/webhook',
        'metadata' => ['video_id' => '12345']
    ],
    null, // Use default chunk size
    function ($currentChunk, $totalChunks, $percentage) {
        echo "Progress: {$currentChunk}/{$totalChunks} ({$percentage}%)\n";
    }
);

echo "Conversion started: " . $job->getJobId() . "\n";

// For more control over the chunked upload process
$fileSize = filesize('large-file.mov');
$chunkSize = 10 * 1024 * 1024; // 10MB chunks
$totalChunks = ceil($fileSize / $chunkSize);

// 1. Initialize session
$session = $client->chunkedUpload()->initSession(
    'large-file.mov',
    $fileSize,
    $totalChunks,
    'mp4'
);

// 2. Upload chunks
$handle = fopen('large-file.mov', 'rb');
for ($i = 0; $i < $totalChunks; $i++) {
    $chunk = fread($handle, $chunkSize);
    $client->chunkedUpload()->uploadChunk(
        $session->getSessionId(),
        $i,
        $chunk
    );
    echo "Uploaded chunk " . ($i + 1) . " of {$totalChunks}\n";
}
fclose($handle);

// 3. Complete upload and start conversion
$job = $client->chunkedUpload()->complete($session->getSessionId());

// Set up webhook for async notification
$job = $client->conversions()->convert(
    'document.pdf',
    'docx',
    [
        'webhook_url' => 'https://your-app.com/webhooks/conversion-complete'
    ]
);

// In your webhook handler:
$payload = json_decode(file_get_contents('php://input'), true);

if ($payload['status'] === 'completed') {
    $downloadUrl = $payload['result']['download_url'];
    // Process the converted file
} else {
    $error = $payload['error']['message'];
    // Handle error
}

// Add custom metadata for tracking
$job = $client->conversions()->convert(
    'invoice.pdf',
    'png',
    [
        'metadata' => [
            'user_id' => 'user_123',
            'invoice_id' => 'inv_456',
            'department' => 'accounting'
        ]
    ]
);

// Retrieve metadata from completed job
$completedJob = $client->jobs()->getStatus($job->getJobId());
$metadata = $completedJob->getMetadata();
echo "Invoice ID: " . $metadata['invoice_id'] . "\n";

$formats = $client->formats()->all();

echo "Total formats: " . $formats['total_formats'] . "\n";

foreach ($formats['formats'] as $type => $formatList) {
    echo "\n{$type}:\n";
    foreach ($formatList as $format) {
        echo "  - {$format['extension']} ({$format['mime_type']})\n";
    }
}

// Check if a format is supported
if ($client->formats()->isSupported('heic')) {
    echo "HEIC format is supported\n";
}

// Check if a specific conversion is supported
if ($client->formats()->isConversionSupported('pdf', 'docx')) {
    echo "PDF to DOCX conversion is available\n";
}

// Get all possible conversions for a format
$conversions = $client->formats()->getConversions('png');
echo "PNG can be converted to:\n";
foreach ($conversions['available_conversions'] as $conversion) {
    echo "  - {$conversion['target_format']}\n";
}

use ConvertHub\Exceptions\ValidationException;
use ConvertHub\Exceptions\AuthenticationException;
use ConvertHub\Exceptions\ApiException;

try {
    $job = $client->conversions()->convert('file.pdf', 'docx');
} catch (ValidationException $e) {
    // Handle validation errors
    echo "Validation Error: " . $e->getMessage() . "\n";
    
    if ($e->getValidationErrors()) {
        foreach ($e->getValidationErrors() as $field => $errors) {
            echo "  {$field}: " . implode(', ', $errors) . "\n";
        }
    }
} catch (AuthenticationException $e) {
    // Handle authentication errors
    echo "Authentication Error: " . $e->getMessage() . "\n";
    echo "Error Code: " . $e->getErrorCode() . "\n";
} catch (ApiException $e) {
    // Handle general API errors
    echo "API Error: " . $e->getMessage() . "\n";
    
    if ($e->getCode() === 429) {
        // Rate limiting
        $retryAfter = $e->getErrorDetails()['retry_after'] ?? 60;
        echo "Rate limited. Retry after {$retryAfter} seconds\n";
    }
}

ConvertHub\ConvertHubClient;
use ConvertHub\Exceptions\ApiException;

class DocumentProcessor
{
    private ConvertHubClient $client;
    
    public function __construct(string $apiKey)
    {
        $this->client = new ConvertHubClient($apiKey);
    }
    
    public function processDocument(string $inputFile, string $targetFormat): ?string
    {
        try {
            echo "Starting conversion of {$inputFile} to {$targetFormat}...\n";
            
            // Start conversion
            $job = $this->client->conversions()->convert(
                $inputFile,
                $targetFormat,
                [
                    'metadata' => [
                        'timestamp' => time(),
                        'source_file' => basename($inputFile)
                    ]
                ]
            );
            
            echo "Job created: {$job->getJobId()}\n";
            
            // Wait for completion with timeout
            $completedJob = $this->client->jobs()->waitForCompletion(
                $job->getJobId(),
                2,  // Poll every 2 seconds
                120 // Max wait 2 minutes
            );
            
            if ($completedJob->isCompleted()) {
                // Download the converted file
                $downloadInfo = $this->client->jobs()->getDownloadUrl(
                    $completedJob->getJobId()
                );
                
                $outputFile = 'output/' . $downloadInfo->getFilename();
                
                if ($downloadInfo->downloadTo($outputFile)) {
                    echo "✅ Conversion successful!\n";
                    echo "📁 Saved to: {$outputFile}\n";
                    echo "📏 Size: " . $downloadInfo->getFileSizeFormatted() . "\n";
                    
                    // Clean up - delete from server
                    $this->client->jobs()->delete($completedJob->getJobId());
                    
                    return $outputFile;
                }
            } else {
                echo "❌ Conversion failed: " . $completedJob->getErrorMessage() . "\n";
            }
            
        } catch (ApiException $e) {
            echo "❌ API Error: " . $e->getMessage() . "\n";
        } catch (\Exception $e) {
            echo "❌ Unexpected error: " . $e->getMessage() . "\n";
        }
        
        return null;
    }
}

// Usage
$processor = new DocumentProcessor('YOUR_API_KEY');
$processor->processDocument('documents/report.pdf', 'docx');

// Convert multiple files in parallel
$files = [
    ['input' => 'file1.pdf', 'format' => 'docx'],
    ['input' => 'file2.png', 'format' => 'jpg'],
    ['input' => 'file3.mp3', 'format' => 'wav'],
];

$jobs = [];

// Start all conversions
foreach ($files as $file) {
    $job = $client->conversions()->convert(
        $file['input'],
        $file['format']
    );
    $jobs[] = [
        'job' => $job,
        'input' => $file['input'],
        'format' => $file['format']
    ];
    echo "Started conversion: {$file['input']} -> {$file['format']}\n";
}

// Wait for all to complete
foreach ($jobs as $jobInfo) {
    $completedJob = $client->jobs()->waitForCompletion(
        $jobInfo['job']->getJobId()
    );
    
    if ($completedJob->isCompleted()) {
        echo "✅ {$jobInfo['input']} converted successfully\n";
    } else {
        echo "❌ {$jobInfo['input']} failed: " . $completedJob->getErrorMessage() . "\n";
    }
}

bash
composer