README

A powerful and universal PHP/Laravel package for converting various document formats to PDF using multiple converters ( TCPDF, mPDF, LibreOffice). Features robust validation, comprehensive logging, and support for 15+ file formats with Laravel 8-12 support.

Description

PHP PDF Bridge provides a unified interface for document conversion to PDF using several powerful libraries:

TCPDF - for text, HTML and CSV conversion
mPDF - for advanced HTML and CSS processing
LibreOffice (via ncjoes/office-converter) - for DOC/DOCX/XLS/XLSX conversion

Supported Formats

Input formats:

Text: .txt, plain text files
HTML: .html, .htm, HTML markup
CSV: .csv, tabular data
Microsoft Word: .doc, .docx
Microsoft Excel: .xls, .xlsx
Microsoft PowerPoint: .ppt, .pptx
OpenDocument: .odt, .ods, .odp
Rich Text: .rtf

Output format:

PDF - all conversions produce PDF files

✨ Features

🔄 Universal conversion: 15+ formats → PDF (Text, HTML, CSV, DOC/DOCX, XLS/XLSX, PPT/PPTX, ODT, ODS, RTF, etc.)
⚡ Multiple converters: TCPDF, mPDF, LibreOffice with intelligent auto-selection
🛡️ Input validation: File size limits, format validation, content verification
📊 Comprehensive logging: Detailed operation tracking with PSR-3 compatibility
🔧 Flexible configuration: Individual settings for each converter with environment support
🔍 Converter diagnostics: Built-in tools for checking converter availability and LibreOffice installation
🎯 Smart error handling: Detailed exception handling with validation feedback
🚀 Artisan commands: Powerful CLI tools for conversion and diagnostics
🏗️ Laravel integration: Service provider, facades, and dependency injection ready
🧪 Fully tested: Comprehensive test suite with PHPUnit
📐 Modern architecture: Interfaces, contracts, and SOLID principles
🎨 PHP 8.1+ ready: Modern syntax with match expressions and typed properties

Installation

1. Install the package

composer require madarlan/pdf-bridge-php

2. Publish configuration (optional)

php artisan vendor:publish --provider="MadArlan\PDFBridge\Laravel\PDFBridgeServiceProvider"

3. Install converters

TCPDF (installed automatically)

# Already included in the package

mPDF

composer require mpdf/mpdf

LibreOffice (for DOC/DOCX/XLS/XLSX)

# Install LibreOffice
# Ubuntu/Debian:
sudo apt-get install libreoffice

# CentOS/RHEL:
sudo yum install libreoffice

# Windows: Download from https://www.libreoffice.org/
# macOS: brew install --cask libreoffice

# Install PHP package
composer require ncjoes/office-converter

Advanced Features

Conversion Parameter Configuration

$options = [
    'converter' => 'tcpdf',           // Force converter selection
    'format' => 'A3',                // Page format
    'orientation' => 'L',            // Orientation (P/L)
    'font_size' => 14,               // Font size
    'font_family' => 'helvetica',    // Font family
    'title' => 'Document Title',
    'author' => 'Document Author',
    'subject' => 'Document Subject',
    'keywords' => 'key, words',
    'margins' => [
        'left' => 20,
        'right' => 20,
        'top' => 30,
        'bottom' => 30,
    ],
];

$pdf = PDFBridge::convertHTML($html, null, $options);

Working with CSV

$csvContent = "Name,Age,City\nJohn,25,New York\nMary,30,Los Angeles";

$options = [
    'csv_delimiter' => ',',
    'csv_has_header' => true,
    'font_size' => 10,
];

$pdf = PDFBridge::convertCSV($csvContent, 'table.pdf', $options);

Checking Converter Availability

Getting Information About All Converters

$converters = PDFBridge::getAvailableConverters();

foreach ($converters as $name => $info) {
    if ($info['available']) {
        echo "✓ {$name}: " . implode(', ', $info['formats']) . "\n";
        if (isset($info['version'])) {
            echo "  Version: {$info['version']}\n";
        }
    } else {
        echo "✗ {$name}: {$info['error']}\n";
    }
}

// Example output:
// ✓ tcpdf: text, html, csv
// ✓ mpdf: text, html, csv
// ✓ libreoffice: doc, docx, xls, xlsx
//   Version: LibreOffice 7.4.7.2 40(Build:2)

Checking Specific Converter

// Check TCPDF availability
try {
    $tcpdfConverter = new \MadArlan\PDFBridge\Converters\TCPDFConverter();
    if ($tcpdfConverter->isAvailable()) {
        echo "TCPDF is available\n";
    }
} catch (\MadArlan\PDFBridge\Exceptions\ConverterNotAvailableException $e) {
    echo "TCPDF unavailable: " . $e->getMessage() . "\n";
}

// Check mPDF availability
try {
    $mpdfConverter = new \MadArlan\PDFBridge\Converters\MPDFConverter();
    if ($mpdfConverter->isAvailable()) {
        echo "mPDF is available\n";
    }
} catch (\MadArlan\PDFBridge\Exceptions\ConverterNotAvailableException $e) {
    echo "mPDF unavailable: " . $e->getMessage() . "\n";
}

Special LibreOffice Check

use MadArlan\PDFBridge\Converters\OfficeConverter;
use MadArlan\PDFBridge\Exceptions\ConverterNotAvailableException;

// Check with automatic LibreOffice detection
try {
    $officeConverter = new OfficeConverter();
    
    if ($officeConverter->isAvailable()) {
        echo "✓ LibreOffice is available\n";
        
        // Get LibreOffice version
        $version = $officeConverter->getVersion();
        if ($version) {
            echo "  Version: {$version}\n";
        }
        
        // Supported formats
        $formats = $officeConverter->getSupportedFormats();
        echo "  Formats: " . implode(', ', $formats) . "\n";
    }
    
} catch (ConverterNotAvailableException $e) {
    echo "✗ LibreOffice unavailable: " . $e->getMessage() . "\n";
    
    // Possible reasons:
    // - LibreOffice not installed
    // - Incorrect LibreOffice path
    // - Missing ncjoes/office-converter package
}

// Check with specified LibreOffice path
$config = [
    'libreoffice_path' => '/usr/bin/libreoffice', // Specify correct path
    'temp_dir' => '/tmp',
    'timeout' => 120
];

try {
    $officeConverter = new OfficeConverter($config);
    echo "LibreOffice found at specified path\n";
} catch (ConverterNotAvailableException $e) {
    echo "LibreOffice not found: " . $e->getMessage() . "\n";
}

// Check via main PDFBridge class
$pdfBridge = new \MadArlan\PDFBridge\PDFBridge();
$converters = $pdfBridge->getAvailableConverters();

if ($converters['libreoffice']['available']) {
    echo "LibreOffice ready to work\n";
    echo "Version: " . ($converters['libreoffice']['version'] ?? 'unknown') . "\n";
} else {
    echo "LibreOffice problem: " . $converters['libreoffice']['error'] . "\n";
}

Usage

Artisan Command for Quick Conversion

The package includes a convenient Artisan command for quick file conversion from the command line:

# Basic command
php artisan pdf:convert {input} [options]

# Usage examples:

# Convert text file
php artisan pdf:convert document.txt

# Convert HTML file with output specification
php artisan pdf:convert index.html --output=result.pdf

# Convert Word document with specific converter
php artisan pdf:convert document.docx --converter=libreoffice

# Convert CSV with settings
php artisan pdf:convert data.csv --config='{"delimiter":";""encoding":"utf-8"}'

# Convert text directly (without file)
php artisan pdf:convert "Hello, World!" --type=text

# Convert HTML code
php artisan pdf:convert "<h1>Title</h1><p>Content</p>" --type=html

Available Command Options:

--output - Output PDF file (default: input.pdf)
--type - Input data type (auto|text|html|csv|doc|docx|xls|xlsx)
--converter - Preferred converter (tcpdf|mpdf|libreoffice)
--config - JSON configuration for converter
--check - Check converter availability
--diagnose - LibreOffice diagnostics
--list-formats - Show supported formats
--list-converters - Show available converters

Diagnostics and Checking Examples:

# Check all converter availability
php artisan pdf:convert --check

# LibreOffice diagnostics
php artisan pdf:convert --diagnose

# List supported formats
php artisan pdf:convert --list-formats

# List available converters
php artisan pdf:convert --list-converters

Automatic Type Detection:

The command automatically detects input data type:

By file extension (.txt, .html, .csv, .doc, .docx, .xls, .xlsx)
By content (HTML tags, CSV delimiters)
Defaults to text

Configuration Examples:

# TCPDF with settings
php artisan pdf:convert document.html --converter=tcpdf --config='{"orientation":"L","format":"A4"}'

# mPDF with settings
php artisan pdf:convert document.html --converter=mpdf --config='{"margin_left":15,"margin_right":15}'

# LibreOffice with timeout
php artisan pdf:convert document.docx --converter=libreoffice --config='{"timeout":300}'

In Laravel (via Facade)

<?php

use MadArlan\PDFBridge\Laravel\PDFBridge;

class DocumentController extends Controller
{
    public function convertText()
    {
        $text = "Hello, World!\nThis is a test document.";
        
        // Convert to string
        $pdfContent = PDFBridge::convertText($text);
        
        // Save to file
        $filePath = PDFBridge::convertText($text, storage_path('app/document.pdf'));
        
        return response($pdfContent)
            ->header('Content-Type', 'application/pdf')
            ->header('Content-Disposition', 'attachment; filename="document.pdf"');
    }
    
    public function convertHTML()
    {
        $html = '<h1>Title</h1><p>This is <strong>HTML</strong> document.</p>';
        
        $options = [
            'converter' => 'mpdf', // Force mPDF usage
            'title' => 'My Document',
            'author' => 'Author',
        ];
        
        return PDFBridge::convertHTML($html, null, $options);
    }
    
    public function convertDocument(Request $request)
    {
        $file = $request->file('document');
        $inputPath = $file->store('temp');
        
        try {
            $pdfPath = PDFBridge::convertFile(storage_path('app/' . $inputPath));
            
            return response()->download($pdfPath)->deleteFileAfterSend();
        } catch (\Exception $e) {
            return response()->json(['error' => $e->getMessage()], 400);
        }
    }
}

In Laravel (via Dependency Injection)

<?php

use MadArlan\PDFBridge\PDFBridge;

class DocumentService
{
    protected PDFBridge $pdfBridge;
    
    public function __construct(PDFBridge $pdfBridge)
    {
        $this->pdfBridge = $pdfBridge;
    }
    
    public function processDocument(string $content, string $type): string
    {
        switch ($type) {
            case 'text':
                return $this->pdfBridge->convertText($content);
            case 'html':
                return $this->pdfBridge->convertHTML($content);
            case 'csv':
                return $this->pdfBridge->convertCSV($content);
            default:
                throw new \InvalidArgumentException("Unsupported type: {$type}");
        }
    }
}

Standalone Usage (without Laravel)

<?php

require_once 'vendor/autoload.php';

use MadArlan\PDFBridge\PDFBridge;

// Create instance with configuration
$config = [
    'default_converter' => 'mpdf',
    'mpdf' => [
        'format' => 'A4',
        'default_font_size' => 14,
    ],
];

$pdfBridge = new PDFBridge($config);

// Convert text
$text = "Sample text for PDF conversion";
$pdfContent = $pdfBridge->convertText($text);
file_put_contents('output.pdf', $pdfContent);

// Convert HTML
$html = '<h1>Title</h1><p>HTML content</p>';
$pdfBridge->convertHTML($html, 'output.pdf');

// Convert file
$pdfBridge->convertFile('document.docx', 'converted.pdf');

// Get available converters info
$converters = $pdfBridge->getAvailableConverters();
print_r($converters);

📚 Detailed Usage Examples

Basic Conversions

Text to PDF

use MadArlan\PDFBridge\PDFBridge;

$pdfBridge = new PDFBridge();

// Simple text conversion
$text = "Hello World!\nThis is a multi-line text document.";
$pdfPath = $pdfBridge->convertText($text, 'hello.pdf');

// Return PDF as string (for download)
$pdfContent = $pdfBridge->convertText($text);
return response($pdfContent, 200, [
    'Content-Type' => 'application/pdf',
    'Content-Disposition' => 'attachment; filename="document.pdf"'
]);

HTML to PDF with Advanced Styling

// Complex HTML with CSS
$html = '
<!DOCTYPE html>
<html>
<head>
    <style>
        body { font-family: Arial, sans-serif; }
        .header { background-color: #f0f0f0; padding: 20px; }
        .content { margin: 20px; }
        table { width: 100%; border-collapse: collapse; }
        th, td { border: 1px solid #ddd; padding: 8px; text-align: left; }
    </style>
</head>
<body>
    <div class="header">
        <h1>Company Report</h1>
    </div>
    <div class="content">
        <table>
            <tr><th>Product</th><th>Price</th></tr>
            <tr><td>Widget A</td><td>$10.00</td></tr>
            <tr><td>Widget B</td><td>$15.00</td></tr>
        </table>
    </div>
</body>
</html>';

$pdfBridge->convertHTML($html, 'report.pdf');

CSV to PDF with Custom Options

// CSV data
$csvData = "Name,Age,City,Salary\n";
$csvData .= "John Doe,30,New York,$50000\n";
$csvData .= "Jane Smith,25,Los Angeles,$45000\n";
$csvData .= "Bob Johnson,35,Chicago,$55000\n";

// Convert with custom options
$options = [
    'csv_delimiter' => ',',
    'csv_has_header' => true,
    'font_size' => 10
];

$pdfBridge->convertCSV($csvData, 'employees.pdf', $options);

Office Documents to PDF

// Microsoft Word Documents
$pdfBridge->convertFile('contract.doc', 'contract.pdf');
$pdfBridge->convertFile('report.docx', 'report.pdf');

// Microsoft Excel Spreadsheets
$pdfBridge->convertFile('budget.xls', 'budget.pdf');
$pdfBridge->convertFile('data.xlsx', 'data.pdf');

// Microsoft PowerPoint Presentations
$pdfBridge->convertFile('presentation.ppt', 'presentation.pdf');
$pdfBridge->convertFile('slides.pptx', 'slides.pdf');

// OpenOffice/LibreOffice Documents
$pdfBridge->convertFile('document.odt', 'document.pdf');     // Writer
$pdfBridge->convertFile('spreadsheet.ods', 'spreadsheet.pdf'); // Calc
$pdfBridge->convertFile('presentation.odp', 'presentation.pdf'); // Impress

// Rich Text Format
$pdfBridge->convertFile('document.rtf', 'document.pdf');

// With custom options for Office documents
$options = [
    'converter' => 'libreoffice',
    'timeout' => 300,           // 5 minutes for large documents
    'temp_dir' => '/tmp/pdf',   // Custom temporary directory
    'format' => 'A4',
    'orientation' => 'P'
];

$pdfBridge->convertFile('large-document.docx', 'output.pdf', $options);

Batch Office Document Processing

// Process multiple Office documents
$officeFiles = [
    'documents/contract.docx',
    'documents/budget.xlsx', 
    'documents/presentation.pptx',
    'documents/report.odt',
    'documents/data.ods'
];

foreach ($officeFiles as $file) {
    try {
        $outputFile = pathinfo($file, PATHINFO_FILENAME) . '.pdf';
        $outputPath = 'converted/' . $outputFile;
        
        echo "Converting {$file}...\n";
        $pdfBridge->convertFile($file, $outputPath);
        echo "✓ Converted to {$outputPath}\n";
        
    } catch (\Exception $e) {
        echo "✗ Failed to convert {$file}: " . $e->getMessage() . "\n";
    }
}

Advanced Office Document Conversion

// Convert with specific LibreOffice settings
$config = [
    'default' => 'libreoffice',
    'libreoffice' => [
        'libreoffice_path' => '/usr/bin/libreoffice',
        'temp_dir' => storage_path('app/temp'),
        'timeout' => 600,  // 10 minutes for very large files
        'format' => 'pdf',
        'options' => [
            '--headless',
            '--invisible',
            '--nodefault',
            '--nolockcheck'
        ]
    ]
];

$pdfBridge = new PDFBridge($config);

// Convert complex documents with formatting preservation
$complexDocs = [
    'financial-report.docx' => ['format' => 'A4', 'orientation' => 'P'],
    'wide-spreadsheet.xlsx' => ['format' => 'A3', 'orientation' => 'L'],
    'presentation.pptx' => ['format' => 'A4', 'orientation' => 'L']
];

foreach ($complexDocs as $file => $settings) {
    $pdfBridge->convertFile($file, str_replace(pathinfo($file, PATHINFO_EXTENSION), 'pdf', $file), $settings);
}

Error Handling for Office Documents

use MadArlan\PDFBridge\Exceptions\ConverterNotAvailableException;
use MadArlan\PDFBridge\Exceptions\ConversionException;

try {
    $pdfBridge->convertFile('document.docx', 'output.pdf');
    
} catch (ConverterNotAvailableException $e) {
    // LibreOffice not installed or not found
    echo "LibreOffice is required for Office document conversion.\n";
    echo "Error: " . $e->getMessage() . "\n";
    echo "Please install LibreOffice or check the installation path.\n";
    
} catch (ConversionException $e) {
    // Conversion failed (corrupted file, unsupported features, etc.)
    echo "Document conversion failed: " . $e->getMessage() . "\n";
    
    // Check if file exists and is readable
    if (!file_exists('document.docx')) {
        echo "File does not exist.\n";
    } elseif (!is_readable('document.docx')) {
        echo "File is not readable.\n";
    } else {
        echo "File may be corrupted or contain unsupported features.\n";
    }
}

Advanced Configuration

Custom Converter Settings

$config = [
    'default' => 'mpdf',
    'mpdf' => [
        'format' => 'A4',
        'orientation' => 'L', // Landscape
        'margin_left' => 20,
        'margin_right' => 20,
        'margin_top' => 25,
        'margin_bottom' => 25,
        'default_font' => 'Arial',
        'default_font_size' => 12
    ],
    'tcpdf' => [
        'format' => 'A3',
        'orientation' => 'P', // Portrait
        'font' => [
            'family' => 'helvetica',
            'size' => 14
        ]
    ]
];

$pdfBridge = new PDFBridge($config);

With Custom Logger

use Psr\Log\LoggerInterface;
use Monolog\Logger;
use Monolog\Handler\StreamHandler;

// Create custom logger
$logger = new Logger('pdf-bridge');
$logger->pushHandler(new StreamHandler('pdf-conversions.log', Logger::INFO));

$pdfBridge = new PDFBridge($config, $logger);

// All operations will be logged to pdf-conversions.log
$pdfBridge->convertText('Hello World!', 'output.pdf');

Real-World Laravel Examples

E-commerce Invoice Generation

class InvoiceService
{
    public function __construct(private PDFBridge $pdfBridge)
    {
    }
    
    public function generateInvoice(Order $order): string
    {
        $html = view('invoices.template', [
            'order' => $order,
            'customer' => $order->customer,
            'items' => $order->items,
            'total' => $order->total
        ])->render();
        
        $filename = "invoice-{$order->id}.pdf";
        $path = storage_path("app/invoices/{$filename}");
        
        try {
            $this->pdfBridge->convertHTML($html, $path, [
                'format' => 'A4',
                'orientation' => 'P',
                'margin_left' => 15,
                'margin_right' => 15
            ]);
            
            return $path;
            
        } catch (ConversionException $e) {
            Log::error('Invoice generation failed', [
                'order_id' => $order->id,
                'error' => $e->getMessage()
            ]);
            
            throw new \Exception('Failed to generate invoice PDF');
        }
    }
}

Queue Jobs for Large Documents

use Illuminate\Bus\Queueable;
use Illuminate\Queue\SerializesModels;
use Illuminate\Queue\InteractsWithQueue;
use Illuminate\Contracts\Queue\ShouldQueue;
use MadArlan\PDFBridge\PDFBridge;

class GeneratePDFJob implements ShouldQueue
{
    use InteractsWithQueue, Queueable, SerializesModels;
    
    public function __construct(
        private string $htmlContent,
        private string $outputPath
    ) {}
    
    public function handle(PDFBridge $pdfBridge): void
    {
        $pdfBridge->convertHTML($this->htmlContent, $this->outputPath);
        
        // Notify user or perform additional actions
    }
}

// Dispatch the job
GeneratePDFJob::dispatch($htmlContent, $outputPath);

Bulk Document Processing

class DocumentProcessor
{
    public function __construct(private PDFBridge $pdfBridge)
    {
    }
    
    public function processBatch(array $files): array
    {
        $results = [];
        
        foreach ($files as $file) {
            try {
                $outputPath = $this->getOutputPath($file);
                $this->pdfBridge->convertFile($file, $outputPath);
                
                $results[] = [
                    'file' => $file,
                    'status' => 'success',
                    'output' => $outputPath
                ];
                
            } catch (\Exception $e) {
                $results[] = [
                    'file' => $file,
                    'status' => 'error',
                    'error' => $e->getMessage()
                ];
            }
        }
        
        return $results;
    }
    
    private function getOutputPath(string $inputFile): string
    {
        $pathInfo = pathinfo($inputFile);
        return $pathInfo['dirname'] . '/' . $pathInfo['filename'] . '.pdf';
    }
}

Error Handling

use MadArlan\PDFBridge\Exceptions\ConversionException;
use MadArlan\PDFBridge\Exceptions\UnsupportedFormatException;
use MadArlan\PDFBridge\Exceptions\ConverterNotAvailableException;

try {
    $pdf = PDFBridge::convertFile('document.unknown');
} catch (UnsupportedFormatException $e) {
    echo "Unsupported format: " . $e->getMessage();
    echo "Supported formats: " . implode(', ', $e->getSupportedFormats());
} catch (ConverterNotAvailableException $e) {
    echo "Converter unavailable: " . $e->getMessage();
} catch (ConversionException $e) {
    echo "Conversion failed: " . $e->getMessage();
    echo "Converter: " . $e->getConverterName();
}

Used Libraries

TCPDF

Version: ^6.6
Purpose: PDF generation from text, HTML, CSV
Features: Lightweight, good Unicode support
Website: https://tcpdf.org/

mPDF

Version: ^8.2
Purpose: Advanced HTML and CSS processing
Features: Better CSS support, fonts, images
Website: https://mpdf.github.io/

ncjoes/office-converter

Version: ^1.0
Purpose: Office document conversion via LibreOffice
Requirements: LibreOffice must be installed on server
GitHub: https://github.com/ncjoes/office-converter

Performance and Recommendations

Converter Selection

TCPDF: Better for simple documents, faster performance
mPDF: Better for complex HTML with CSS, images
LibreOffice: Only option for DOC/DOCX/XLS/XLSX

Optimization

// Reuse instance
$pdfBridge = app('pdf-bridge');

// Configure temp directory for large files
$config = [
    'libreoffice' => [
        'temp_dir' => '/tmp/pdf-bridge',
        'timeout' => 300, // Increase for large files
    ],
];

$pdfBridge->setConfig($config);

Testing

# Install development dependencies
composer install --dev

# Run tests
vendor/bin/phpunit

📋 Requirements

PHP: 8.1 or higher
Laravel: 8.0+ (supports Laravel 8, 9, 10, 11, 12)
TCPDF: Included automatically
mPDF: composer require mpdf/mpdf (recommended)
LibreOffice: For office document support (DOC/DOCX/XLS/XLSX/PPT/PPTX/ODT/ODS/ODP)
- Install: sudo apt-get install libreoffice (Ubuntu/Debian)
- Package: composer require ncjoes/office-converter

📊 Supported Formats

Format	Extension	Converter	Description
Text	`.txt`	TCPDF, mPDF	Plain text files
HTML	`.html`, `.htm`	mPDF, TCPDF	Web pages and HTML content
CSV	`.csv`	TCPDF, mPDF, LibreOffice	Comma-separated values
Word	`.doc`, `.docx`	LibreOffice	Microsoft Word documents
Excel	`.xls`, `.xlsx`	LibreOffice	Microsoft Excel spreadsheets
PowerPoint	`.ppt`, `.pptx`	LibreOffice	Microsoft PowerPoint presentations
OpenDocument	`.odt`, `.ods`, `.odp`	LibreOffice	OpenDocument formats
Rich Text	`.rtf`	LibreOffice	Rich Text Format

🧪 Testing

# Run tests
composer test

# Run tests with coverage
composer test-coverage

# Run static analysis
composer analyse

🤝 Contributing

Fork the repository
Create your feature branch (git checkout -b feature/amazing-feature)
Make your changes
Add tests for your changes
Ensure tests pass (composer test)
Commit your changes (git commit -m 'Add amazing feature')
Push to the branch (git push origin feature/amazing-feature)
Open a Pull Request

📝 Changelog

Please see CHANGELOG for more information on what has changed recently.

🔒 Security

If you discover any security-related issues, please email madinovarlan@gmail.com instead of using the issue tracker.

📄 License

The MIT License (MIT). Please see License File for more information.

🆘 Support & Troubleshooting

If you encounter issues:

Check converter availability: php artisan pdf:convert --check
Diagnose LibreOffice: php artisan pdf:convert --diagnose
List supported formats: php artisan pdf:convert --formats
Check logs: Review Laravel logs for detailed error information
Validate input: Ensure files meet size and format requirements
Create an issue: GitHub Issues with:
- PHP version
- Laravel version
- Error messages
- Sample code
- Input file details

Common Issues

LibreOffice not found: Install LibreOffice and ensure it's in PATH
File too large: Check validation.max_file_size setting
Permission denied: Ensure output directory is writable
Memory limit: Increase PHP memory limit for large files

License

MIT License. See LICENSE file for details.

Author

GitHub: madarlan
Email: madinovarlan@gmail.com

Support

If you encounter problems or have questions:

Check Issues
Create a new Issue with detailed problem description
Include PHP, Laravel and library versions

Changelog

v1.0.0

Initial release
TCPDF, mPDF, LibreOffice support
Laravel 8-12 integration
Text, HTML, CSV, DOC/DOCX, XLS/XLSX to PDF conversion

🏆 Credits

Author: MadArlan
Contributors: All Contributors
**Powered by **: TCPDF, mPDF, LibreOffice

madarlan / pdf-bridge-php

Maintainers

Details

README

Description

Supported Formats

Input formats:

Output format:

✨ Features

Installation

1. Install the package

2. Publish configuration (optional)

3. Install converters

TCPDF (installed automatically)

mPDF

LibreOffice (for DOC/DOCX/XLS/XLSX)

Advanced Features

Conversion Parameter Configuration

Working with CSV

Checking Converter Availability

Getting Information About All Converters

Checking Specific Converter

Special LibreOffice Check

Usage

Artisan Command for Quick Conversion

Available Command Options:

Diagnostics and Checking Examples:

Automatic Type Detection:

Configuration Examples:

In Laravel (via Facade)

In Laravel (via Dependency Injection)

Standalone Usage (without Laravel)

📚 Detailed Usage Examples

Basic Conversions

Text to PDF

HTML to PDF with Advanced Styling

CSV to PDF with Custom Options

Office Documents to PDF

Batch Office Document Processing

Advanced Office Document Conversion

Error Handling for Office Documents

Advanced Configuration

Custom Converter Settings

With Custom Logger

Real-World Laravel Examples

E-commerce Invoice Generation

Queue Jobs for Large Documents

Bulk Document Processing

Error Handling

Used Libraries

TCPDF

mPDF

ncjoes/office-converter

Performance and Recommendations

Converter Selection

Optimization

Testing

📋 Requirements

📊 Supported Formats

🧪 Testing

🤝 Contributing

📝 Changelog

🔒 Security

📄 License

🆘 Support & Troubleshooting

Common Issues

License

Author

Support

Changelog

v1.0.0

🏆 Credits