Complete PHP code examples for integrating with the ConvertHub API - a powerful file conversion service supporting 800+ format pairs.

1. Get your API key from https://converthub.com/api
2. Clone this repository:

   git clone https://github.com/converthub-api/php-examples.git
   cd php-examples

3. Install dependencies (optional, for advanced features):

   composer install

4. Configure your API key:

   cp .env.example .env
   # Edit .env and add your API key

5. Run any example:

   php simple-convert/convert.php document.pdf docx

Each directory contains working examples for specific API endpoints:

Direct file upload and conversion (files up to 50MB).

• convert.php - Convert a local file with optional quality settings

# Basic conversion
php simple-convert/convert.php image.png jpg

# With options
php simple-convert/convert.php document.pdf docx --api-key=YOUR_KEY

Convert files directly from URLs without downloading them first.

• convert-from-url.php - Convert a file from any public URL

php url-convert/convert-from-url.php https://example.com/file.pdf docx

Upload and convert large files (up to 2GB) in chunks.

• upload-large-file.php - Upload large files in configurable chunks

# Default 5MB chunks
php chunked-upload/upload-large-file.php video.mov mp4

# Custom chunk size
php chunked-upload/upload-large-file.php large.pdf docx --chunk-size=10

Track and manage conversion jobs with dedicated scripts for each operation.

• check-status.php - Check job status and optionally watch progress
• cancel-job.php - Cancel a running or queued job
• delete-file.php - Delete converted file from storage
• download-result.php - Download the converted file

# Check job status
php job-management/check-status.php job_123e4567-e89b-12d3

# Watch progress until complete
php job-management/check-status.php job_123e4567-e89b-12d3 --watch

# Cancel a running job
php job-management/cancel-job.php job_123e4567-e89b-12d3

# Delete a completed file (with confirmation)
php job-management/delete-file.php job_123e4567-e89b-12d3

# Force delete without confirmation
php job-management/delete-file.php job_123e4567-e89b-12d3 --force

# Download conversion result
php job-management/download-result.php job_123e4567-e89b-12d3

# Download with custom filename
php job-management/download-result.php job_123e4567-e89b-12d3 --output=myfile.pdf

Explore supported formats and conversions.

• list-formats.php - List formats, check conversions, explore possibilities

# List all supported formats
php format-discovery/list-formats.php

# Show all conversions from PDF
php format-discovery/list-formats.php --from=pdf

# Check if specific conversion is supported
php format-discovery/list-formats.php --check=pdf:docx

Receive real-time conversion notifications.

• webhook-receiver.php - Production-ready webhook endpoint

Deploy this file on your server and use its URL as the webhook endpoint:

// When submitting conversions:
$data = [
    'file' => $file,
    'target_format' => 'pdf',
    'webhook_url' => 'https://your-server.com/webhook-receiver.php'
];

All API requests require a Bearer token. Get your API key at https://converthub.com/api.

# Copy the example file
cp .env.example .env

# Edit .env and add your key
CONVERTHUB_API_KEY="your_api_key_here"

php simple-convert/convert.php file.pdf docx --api-key=your_key_here

$apiKey = 'your_api_key_here';
$headers = ['Authorization: Bearer ' . $apiKey];

The API supports 800+ format conversions, some popular ones include:

Customize your conversions with various options:

// In simple-convert/convert.php:
php convert.php image.png jpg --quality=85 --resolution=1920x1080

// Available options:
--quality=N        # Image quality (1-100)
--resolution=WxH   # Output resolution
--bitrate=RATE     # Audio/video bitrate (e.g., "320k")
--sample-rate=N    # Audio sample rate (e.g., 44100)
--output=FILENAME  # Custom output filename

All examples include comprehensive error handling:

// Every script handles API errors properly:
if ($httpCode >= 400) {
    $error = json_decode($response, true);
    echo "Error: " . $error['error']['message'] . "\n";
    echo "Code: " . $error['error']['code'] . "\n";
}

Common error codes:

• AUTHENTICATION_REQUIRED - Missing or invalid API key
• NO_MEMBERSHIP - No active membership found
• INSUFFICIENT_CREDITS - No credits remaining
• FILE_TOO_LARGE - File exceeds size limit
• UNSUPPORTED_FORMAT - Format not supported
• CONVERSION_FAILED - Processing error

• PHP 7.4 or higher
• cURL extension enabled
• (Optional) Composer for dependency management

php simple-convert/convert.php document.pdf docx

php url-convert/convert-from-url.php https://example.com/photo.png jpg

php chunked-upload/upload-large-file.php movie.mov mp4 --chunk-size=10

php job-management/check-status.php job_abc123 --watch

php format-discovery/list-formats.php --check=heic:jpg

• API Documentation: https://converthub.com/api/docs
• Developer Dashboard: https://converthub.com/developers
• Get API Key: https://converthub.com/api
• Email Support: [email protected]

These examples are provided under the MIT License. Feel free to use and modify them for your projects.

Contributions are welcome! Please feel free to submit a Pull Request.

1. Fork the repository
2. Create your feature branch
3. Commit your changes
4. Push to the branch
5. Open a Pull Request

Built with ❤️ by ConvertHub - Making file conversion simple and powerful.