PHPackages bitdreamit/qz-tray-enterprise - PHPackages - PHPackages [Skip to content](#main-content)[PHPackages](/)[Directory](/)[Categories](/categories)[Trending](/trending)[Leaderboard](/leaderboard)[Changelog](/changelog)[Analyze](/analyze)[Collections](/collections)[Log in](/login)[Sign up](/register) 1. [Directory](/) 2. / 3. [Utility & Helpers](/categories/utility) 4. / 5. bitdreamit/qz-tray-enterprise ActiveLibrary[Utility & Helpers](/categories/utility) bitdreamit/qz-tray-enterprise ============================= Complete QZ Tray integration package for Laravel - Enterprise printing solution v0.1.1(4mo ago)03MITPHPPHP ^8.1 Since Jan 11Pushed 4mo agoCompare [ Source](https://github.com/bitdreamit/qz-tray-enterprise)[ Packagist](https://packagist.org/packages/bitdreamit/qz-tray-enterprise)[ RSS](/packages/bitdreamit-qz-tray-enterprise/feed)WikiDiscussions main Synced 1mo ago READMEChangelog (2)Dependencies (2)Versions (3)Used By (0) QZ Tray Enterprise for Laravel ============================== [](#qz-tray-enterprise-for-laravel) [![Latest Version](https://camo.githubusercontent.com/432b5535077b13963dfc9647e0160bfa9afde9c1c9813feaef515d2e346d0619/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f762f626974647265616d69742f717a2d747261792d656e74657270726973652e737667)](https://packagist.org/packages/bitdreamit/qz-tray-enterprise)[![Total Downloads](https://camo.githubusercontent.com/b2a6588a227041165e6c53cbf0ededdfed42680d4d3e290f070693c212d51a61/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f64742f626974647265616d69742f717a2d747261792d656e74657270726973652e737667)](https://packagist.org/packages/bitdreamit/qz-tray-enterprise)[![License](https://camo.githubusercontent.com/d751aa3ad12cb20cf545313329dff77f74ce72ecbe2280de268eb0b96788ad14/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f6c2f626974647265616d69742f717a2d747261792d656e74657270726973652e737667)](https://packagist.org/packages/bitdreamit/qz-tray-enterprise)[![PHP Version](https://camo.githubusercontent.com/632374bebddddab74a496fe79def1b7a1dfe246b46fc8ddd0f11f18c4c20bb42/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f7068702d762f626974647265616d69742f717a2d747261792d656e74657270726973652e737667)](https://packagist.org/packages/bitdreamit/qz-tray-enterprise)[![Laravel Version](https://camo.githubusercontent.com/60cb6cc74373766da500ad7c9f54b8bc2e5186f33cef38f4a326f1efaf50b327/68747470733a2f2f696d672e736869656c64732e696f2f62616467652f4c61726176656c2d392e7825374331302e7825374331312e7825374331322e782d627269676874677265656e2e737667)](https://laravel.com) Complete QZ Tray integration package for Laravel - The definitive enterprise printing solution for POS systems, laboratories, ERPs, and any application requiring reliable, professional printing capabilities. 🚀 Why Choose QZ Tray Enterprise? -------------------------------- [](#-why-choose-qz-tray-enterprise) **QZ Tray Enterprise** is not just another printing package - it's a **complete printing management system** that brings enterprise-grade printing capabilities to your Laravel application with zero configuration hassles. ### ✨ Key Benefits: [](#-key-benefits) - **🚀 One-command installation** - Get started in under 5 minutes - **🎯 Zero configuration required** for basic usage - **🏢 Enterprise-ready** out of the box - **🔒 Military-grade security** with certificate signing - **📱 Responsive dashboard** with real-time monitoring - **🔄 Smart fallback system** - Never lose a print job - **📊 Comprehensive analytics** and job tracking - **🛡️ Production-ready error handling** 📋 Features Overview ------------------- [](#-features-overview) ### 🖨️ **Core Printing Features** [](#️-core-printing-features) - ✅ **Complete QZ Tray Integration** - Full API coverage - ✅ **Multi-Format Support** - Raw, HTML, PDF, Images, ZPL, ESC/POS - ✅ **Barcode Generation** - CODE128, CODE39, EAN13, QR codes, and more - ✅ **Thermal Printer Support** - Epson, Zebra, Citizen, Bixolon - ✅ **Label Printing** - ZPL (Zebra Programming Language) - ✅ **Receipt Printing** - ESC/POS commands - ✅ **Virtual Printers** - PDF, XPS, OneNote - ✅ **Network Printers** - TCP/IP, Shared, LPD ### 🛠️ **Management Features** [](#️-management-features) - ✅ **Auto-Discovery** - Automatic printer detection - ✅ **User Preferences** - Per-user, per-module printer selection - ✅ **Print Queue Management** - Job queuing with retry logic - ✅ **Job History** - Complete audit trail of all print jobs - ✅ **Real-time Monitoring** - Live status updates - ✅ **Smart Fallback System** - Browser print, PDF download, preview - ✅ **Module-Specific Printers** - Different printers for different tasks ### 🛡️ **Security Features** [](#️-security-features) - ✅ **HTTPS Enforcement** - Secure connections only - ✅ **Certificate Signing** - Military-grade security - ✅ **User Authentication** - Role-based access control - ✅ **IP Restriction** - Control access by IP - ✅ **Request Validation** - Input sanitization and validation - ✅ **Secure WebSocket** - Encrypted communication ### 📊 **Diagnostics & Monitoring** [](#-diagnostics--monitoring) - ✅ **System Health Checks** - Comprehensive diagnostics - ✅ **Performance Metrics** - Memory usage, connection speed - ✅ **Error Tracking** - Detailed error logging - ✅ **Export Reports** - JSON export for debugging - ✅ **Real-time Dashboard** - Live monitoring interface - ✅ **Historical Data** - 30-day diagnostic history 🏗️ Architecture --------------- [](#️-architecture) ``` ┌─────────────────────────────────────────────────────────┐ │ Laravel Application │ ├─────────────────────────────────────────────────────────┤ │ QZ Tray Enterprise Package │ │ ├── Dashboard (/qz-tray/dashboard) │ │ ├── API Endpoints (/api/qz-tray/*) │ │ ├── Real-time WebSocket │ │ └── Background Jobs │ ├─────────────────────────────────────────────────────────┤ │ QZ Tray Desktop Application │ │ (Installed on client machines) │ ├─────────────────────────────────────────────────────────┤ │ Physical Printers │ │ ├── Thermal (Epson, Zebra) │ │ ├── Label (Zebra, SATO) │ │ ├── Network Printers │ │ └── Virtual Printers │ └─────────────────────────────────────────────────────────┘ ``` 🚀 Quick Installation -------------------- [](#-quick-installation) ### 1. Install via Composer [](#1-install-via-composer) ``` composer require bitdreamit/qz-tray-enterprise ``` ### 2. Run the Installation Command [](#2-run-the-installation-command) ``` php artisan qz-tray:install ``` ### 3. Install QZ Tray Desktop Application [](#3-install-qz-tray-desktop-application) Download and install QZ Tray on client machines from ### 4. Configure HTTPS [](#4-configure-https) Ensure your application is served over HTTPS for security. For local development, you can use Laravel Valet or Ngrok. ### 5. Generate Security Certificate [](#5-generate-security-certificate) ``` php artisan qz-tray:generate-certificate ``` ### 6. Run Migrations [](#6-run-migrations) ``` php artisan migrate ``` ### 7. Access the Dashboard [](#7-access-the-dashboard) Visit `/qz-tray/dashboard` in your browser. ⚙️ Configuration ---------------- [](#️-configuration) ### Environment Variables (.env) [](#environment-variables-env) ``` # QZ Tray Configuration QZ_TRAY_ENABLED=true QZ_REQUIRE_HTTPS=true QZ_ALLOW_LOCALHOST=true QZ_AUTO_CONNECT=true QZ_AUTO_DISCOVERY=true QZ_FALLBACK_STRATEGY=browser-print QZ_DEFAULT_PAPER_SIZE=A4 QZ_LOGGING_ENABLED=true QZ_PRIVATE_KEY=storage/app/certs/private-key.pem QZ_SIGNATURE_ALGORITHM=SHA512 QZ_RETRY_ATTEMPTS=3 QZ_RETRY_DELAY=1000 QZ_DISCOVERY_INTERVAL=30000 QZ_DEBUG_MODE=false ``` ### Publish Configuration File [](#publish-configuration-file) ``` php artisan vendor:publish --tag=qz-tray-config ``` This creates `config/qz-tray.php` with complete configuration options. 📖 Usage Examples ---------------- [](#-usage-examples) ### Blade Integration [](#blade-integration) Include QZ Tray assets in your layout: ``` @include('qz-tray::partials.qz-assets') @yield('content') ``` ### Print from Controller [](#print-from-controller) ```