包简介

Direct printing for Laravel apps

README 文档

README

This Laravel package provides comprehensive printing capabilities including PDF generation, Excel/CSV import/export, download management, view printing, and direct hardware printing via network and USB connections.

Key Features

Multiple Print Drivers: PrintNode, CUPS, Network, USB, Raw
PDF Generation: Convert HTML to PDF and print directly
View Printing: Print Blade templates as PDFs or raw output
Network Printing: Direct TCP/IP printing to network printers
USB Printing: Direct communication with USB printers
Raw Printing: Support for multiple connection types (network, USB, parallel, serial)
Excel/CSV Operations: Import and export spreadsheet data
Download Management: Create and manage file downloads
ESC/POS Support: Thermal printer command support

// Network printing
$printJob = Printing::driver('network')
    ->newPrintTask()
    ->content('Hello Network Printer!')
    ->send();

// USB printing
$printJob = Printing::driver('usb')
    ->newPrintTask()
    ->content('Hello USB Printer!')
    ->send();

// View printing
$printJob = Printing::newPrintTask()
    ->view('printing.invoice', ['data' => $invoiceData])
    ->pdf(['format' => 'A4'])
    ->send();

Installation

Install the package via Composer:

composer require xslain/laravel-printing

Publish the configuration file:

php artisan vendor:publish --tag="printing-config"

Publish the view templates (optional):

php artisan vendor:publish --tag="printing-views"

Quick Start

Environment Configuration

Add to your .env file:

# Default driver
PRINTING_DRIVER=printnode

# PrintNode (cloud printing)
PRINTING_PRINTNODE_KEY=your_printnode_api_key

# Network printing
PRINTING_NETWORK_IP=192.168.1.100
PRINTING_NETWORK_PORT=9100

# USB printing
PRINTING_USB_DEVICE_PATH=/dev/usb/lp0
# OR
PRINTING_USB_VENDOR_ID=04b8
PRINTING_USB_PRODUCT_ID=0202

Basic Usage

use Xslain\Printing\Facades\Printing;
use Xslain\Printing\Enums\PrintDriver;

// Print to default printer
$task = Printing::newPrintTask()
    ->content('Hello World!')
    ->send();

// Print via network
$task = Printing::driver(PrintDriver::Network)
    ->newPrintTask()
    ->content('Hello Network Printer!')
    ->send();

// Print via USB
$task = Printing::driver(PrintDriver::Usb)
    ->newPrintTask()
    ->content('Hello USB Printer!')
    ->send();

// Print a view as PDF
$task = Printing::newPrintTask()
    ->view('printing.invoice', ['data' => $invoiceData])
    ->pdf(['format' => 'A4'])
    ->send();

Supported Drivers

1. PrintNode (Cloud)

$task = Printing::driver(PrintDriver::PrintNode)->newPrintTask();

2. CUPS (Local Server)

$task = Printing::driver(PrintDriver::Cups)->newPrintTask();

3. Network (TCP/IP)

$task = Printing::driver(PrintDriver::Network)->newPrintTask();

4. USB (Direct Device)

$task = Printing::driver(PrintDriver::Usb)->newPrintTask();

5. Raw (Multi-Connection)

$task = Printing::driver(PrintDriver::Raw)->newPrintTask();

Advanced Features

PDF Generation

// HTML to PDF
$task = Printing::newPrintTask()
    ->content('<h1>Invoice</h1><p>Amount: $100</p>')
    ->pdf(['format' => 'A4', 'orientation' => 'portrait'])
    ->send();

// Save PDF
$pdfPath = Printing::newPrintTask()
    ->content('<h1>Document</h1>')
    ->pdf(['format' => 'A4'])
    ->save('document.pdf');

View Printing

Create a Blade view resources/views/printing/receipt.blade.php:

<!DOCTYPE html>
<html>
<head>
    <title>Receipt</title>
    <style>
        body { font-family: monospace; }
        .center { text-align: center; }
    </style>
</head>
<body>
    <div class="center">
        <h2>{{ $store_name }}</h2>
        <p>Receipt #{{ $receipt_number }}</p>
    </div>
    
    @foreach($items as $item)
        <div>{{ $item['name'] }} .................. ${{ $item['price'] }}</div>
    @endforeach
    
    <hr>
    <div><strong>Total: ${{ $total }}</strong></div>
    
    <div class="center">
        <p>Thank you for your purchase!</p>
    </div>
</body>
</html>

Print the view:

$receiptData = [
    'store_name' => 'My Store',
    'receipt_number' => '12345',
    'items' => [
        ['name' => 'Product 1', 'price' => '10.00'],
        ['name' => 'Product 2', 'price' => '15.00'],
    ],
    'total' => '25.00'
];

$task = Printing::newPrintTask()
    ->view('printing.receipt', $receiptData)
    ->pdf(['format' => 'A4'])
    ->send();

Network Printing

// Basic network printing
$task = Printing::driver(PrintDriver::Network)
    ->newPrintTask()
    ->content('Hello Network!')
    ->send();

// Specify different printer
$task = Printing::driver(PrintDriver::Network)
    ->newPrintTask()
    ->printer('192.168.1.101:9100')
    ->content('Different printer')
    ->send();

// Send raw data
$driver = Printing::driver(PrintDriver::Network);
$success = $driver->sendRawData('Raw commands', '192.168.1.100', 9100);

// Discover network printers
$printers = Printing::driver(PrintDriver::Network)
    ->printers(null, null, null, 'scan');

USB Printing

// Basic USB printing
$task = Printing::driver(PrintDriver::Usb)
    ->newPrintTask()
    ->content('Hello USB!')
    ->send();

// ESC/POS commands for thermal printers
$escPos = "\x1B\x40"; // Initialize
$escPos .= "\x1B\x61\x01"; // Center align
$escPos .= "STORE RECEIPT\n";
$escPos .= "\x1B\x61\x00"; // Left align
$escPos .= "Item 1................$10.00\n";
$escPos .= "Total................$10.00\n";
$escPos .= "\x1D\x56\x41\x10"; // Cut paper

$task = Printing::driver(PrintDriver::Usb)
    ->newPrintTask()
    ->content($escPos)
    ->send();

// Discover USB printers
$printers = Printing::driver(PrintDriver::Usb)->printers();

Raw Printing

Configure different connection types:

# Network raw printing
PRINTING_RAW_CONNECTION_TYPE=network
PRINTING_RAW_NETWORK_IP=192.168.1.100
PRINTING_RAW_NETWORK_PORT=9100

# USB raw printing
PRINTING_RAW_CONNECTION_TYPE=usb
PRINTING_RAW_USB_DEVICE_PATH=/dev/usb/lp0

# Parallel port printing
PRINTING_RAW_CONNECTION_TYPE=parallel
PRINTING_RAW_PARALLEL_PORT=LPT1

# Serial port printing
PRINTING_RAW_CONNECTION_TYPE=serial
PRINTING_RAW_SERIAL_PORT=COM1
PRINTING_RAW_SERIAL_BAUD_RATE=9600

$task = Printing::driver(PrintDriver::Raw)
    ->newPrintTask()
    ->content('Raw printing works with any connection type!')
    ->send();

Excel/CSV Operations

// Export to Excel
$excel = Printing::newPrintTask()
    ->export()
    ->excel($data, 'users.xlsx');

// Export to CSV
$csv = Printing::newPrintTask()
    ->export()
    ->csv($data, 'users.csv');

// Import from Excel
$data = Printing::newPrintTask()
    ->import()
    ->excel('users.xlsx');

// Import from CSV
$data = Printing::newPrintTask()
    ->import()
    ->csv('users.csv');

Download Management

// Create downloadable file
$download = Printing::newPrintTask()
    ->content('File content')
    ->download('filename.txt');

// Force download
return $download->forceDownload();

// Stream download
return $download->stream();

Configuration Reference

The complete configuration file config/printing.php:

return [
    'driver' => env('PRINTING_DRIVER', 'printnode'),
    
    'drivers' => [
        'printnode' => [
            'key' => env('PRINTING_PRINTNODE_KEY'),
        ],
        
        'cups' => [
            'ip' => env('PRINTING_CUPS_IP', '127.0.0.1'),
            'port' => env('PRINTING_CUPS_PORT', 631),
            'username' => env('PRINTING_CUPS_USERNAME'),
            'password' => env('PRINTING_CUPS_PASSWORD'),
        ],
        
        'network' => [
            'ip' => env('PRINTING_NETWORK_IP'),
            'port' => env('PRINTING_NETWORK_PORT', 9100),
            'timeout' => env('PRINTING_NETWORK_TIMEOUT', 30),
        ],
        
        'usb' => [
            'device_path' => env('PRINTING_USB_DEVICE_PATH'),
            'vendor_id' => env('PRINTING_USB_VENDOR_ID'),
            'product_id' => env('PRINTING_USB_PRODUCT_ID'),
            'timeout' => env('PRINTING_USB_TIMEOUT', 30),
        ],
        
        'raw' => [
            'connection_type' => env('PRINTING_RAW_CONNECTION_TYPE', 'network'),
            'network' => [
                'ip' => env('PRINTING_RAW_NETWORK_IP'),
                'port' => env('PRINTING_RAW_NETWORK_PORT', 9100),
                'timeout' => env('PRINTING_RAW_NETWORK_TIMEOUT', 30),
            ],
            'usb' => [
                'device_path' => env('PRINTING_RAW_USB_DEVICE_PATH'),
            ],
            'parallel' => [
                'port' => env('PRINTING_RAW_PARALLEL_PORT', 'LPT1'),
            ],
            'serial' => [
                'port' => env('PRINTING_RAW_SERIAL_PORT', 'COM1'),
                'baud_rate' => env('PRINTING_RAW_SERIAL_BAUD_RATE', 9600),
                'data_bits' => env('PRINTING_RAW_SERIAL_DATA_BITS', 8),
                'stop_bits' => env('PRINTING_RAW_SERIAL_STOP_BITS', 1),
                'parity' => env('PRINTING_RAW_SERIAL_PARITY', 'none'),
            ],
        ],
    ],
];

Error Handling

use Xslain\Printing\Exceptions\PrintingException;

try {
    $task = Printing::driver(PrintDriver::Network)
        ->newPrintTask()
        ->content('Test print')
        ->send();
        
    echo "Print successful!";
} catch (PrintingException $e) {
    echo "Print failed: " . $e->getMessage();
}

Platform Support

Platform	Network	USB	Parallel	Serial
Linux	✅	✅	✅	✅
Windows	✅	⚠️	✅	✅
macOS	✅	⚠️	⚠️	⚠️

✅ Full support
⚠️ Limited support
❌ Not supported

Requirements

PHP 8.1+
Laravel 10.0+
For PDF: DomPDF or mPDF
For Excel: PhpSpreadsheet
For USB on Linux: lsusb command
Network access for network printing

Testing

composer test

Examples

Check the examples/ directory for comprehensive usage examples:

examples/network-usb-printing.php - Network and USB printing examples
More examples coming soon...

Custom Drivers

Extend with custom drivers:

use Xslain\Printing\Facades\Printing;

Printing::extend('custom', function ($config) {
    return new CustomDriver($config);
});

$task = Printing::driver('custom')
    ->newPrintTask()
    ->content('Custom driver')
    ->send();

Changelog

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

Contributing

Please see CONTRIBUTING for details.

Security

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

Credits

Randall Wilk - Original package author
All Contributors
Mike42 for the PHP ESC/POS Print Driver library

License

This package is open-sourced software licensed under the MIT license.

Additional Resources

For more detailed documentation and advanced usage examples, visit: https://randallwilk.dev/docs/laravel-printing

Inspiration for certain aspects of the API implementations comes from:

stripe-php

Disclaimer

This package is not affiliated with, maintained, authorized, endorsed or sponsored by Laravel or any of its affiliates.

License

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

xslain/laravel-printing 适用场景与选型建议

xslain/laravel-printing 是一款基于 PHP 开发的 Composer 扩展包，目前已累计 59 次下载、GitHub Stars 达 0，最近一次更新时间为 2025 年 09 月 23 日，在 PHP 生态内属于活跃度较高的组件。

它主要适用于以下技术方向：「PrintNode」「CUPS」「laravel-printing」「Receipt printing」「Direct printing」「Raw printing」等业务场景。在实际项目中，围绕这些方向常见需要落地的问题包括：接口对接、性能调优、并发安全、与既有框架（Laravel / ThinkPHP / Yii / Webman 等）的兼容适配，以及生产环境的日志埋点与稳定性保障。

我们在过去多个企业项目中使用过 xslain/laravel-printing 或与其功能相近的方案，如果你在选型或落地过程中遇到问题，例如 版本兼容、二次改造、私有化封装、与内部系统对接、生产 BUG 排查，欢迎联系我们协助评估。

围绕 xslain/laravel-printing 我们能提供哪些服务？

定制开发 / 二次开发

基于 xslain/laravel-printing 在你已有业务上做功能扩展、字段裁剪、UI 适配、与内部账号 / 权限 / 日志系统的深度对接。

BUG 修复 & 性能优化

线上偶发问题、内存泄漏、慢查询、并发异常等排查修复；针对高流量场景做缓存、队列、索引层面的调优。

项目外包 & 长期维护

承接完整的项目从需求 → 设计 → 开发 → 上线 → 长期运维；也可按月提供技术保姆服务。

yvsm@zunyunkeji.com QQ：316430983 微信：yvsm316 西安尊云信息科技 · 专注 PHP / Go / 分布式系统研发

与 xslain/laravel-printing 相关的其它包

同方向 / 同关键字的高下载量 PHP Composer 包推荐，方便对比选型：

printnode/printnode-php 90

Connect any printer to your application with PrintNode Client and easy to use JSON API

rawilk/laravel-printing 565

Direct printing for Laravel apps

goedgepickt/printnode-php 0

Connect any printer to your application with PrintNode Client and easy to use JSON API

josh-gaby/cups-ipp 1

CUPS Implementation of IPP - PHP Client API (PHP >= 7.2.5)

niceshops/cups-ipp 0

CUPS Implementation of IPP - PHP Client API (PHP >= 8.3)

thanhlyvan/laravel-printing 0

Direct printing for Laravel apps

xslain/laravel-printing

包简介

关键字：

README 文档

README

Key Features

Installation

Quick Start

Environment Configuration

Basic Usage

Supported Drivers

1. PrintNode (Cloud)

2. CUPS (Local Server)

3. Network (TCP/IP)

4. USB (Direct Device)

5. Raw (Multi-Connection)

Advanced Features

PDF Generation

View Printing

Network Printing

USB Printing

Raw Printing

Excel/CSV Operations

Download Management

Configuration Reference

Error Handling

Platform Support

Requirements

Testing

Examples

Custom Drivers

Changelog

Contributing

Security

Credits

License

Additional Resources

Disclaimer

License

xslain/laravel-printing 适用场景与选型建议

与 xslain/laravel-printing 相关的其它包

统计信息

GitHub 信息

其他信息