Download the PHP package gflaminio3/telara without Composer
On this page you can find all versions of the php package gflaminio3/telara. It is possible to download/install these versions without Composer. Possible dependencies are resolved automatically.
Download gflaminio3/telara
More information about gflaminio3/telara
Files in gflaminio3/telara
Package telara
Short Description A custom Laravel package that provides a storage disk for uploading files to Telegram and retrieving them seamlessly
License MIT
Informations about the package telara
Laravel Telegram Storage (Telara)
A custom Laravel package that provides a storage disk for uploading files to Telegram and retrieving them seamlessly. It integrates effortlessly with Laravel's Filesystem to let you store files through Telegram's API just like you would use S3, local, or any other disk.
Features:
- Automatic file chunking for large files (bypasses Telegram's 20MB limit)
- Optional AES-256 encryption for secure storage
- Multiple tracking drivers (database, JSON, array)
- Seamless Laravel Storage integration
Table of Contents
- Requirements
- Installation
- Configuration
- Usage
- Chunking & Encryption
- Advanced Usage
- Testing
- License
Requirements
- PHP 8.3+
- Laravel 11+
- A Telegram bot token from BotFather
Installation
Publish configuration (optional):
Run migrations:
Configuration
Interactive Setup
This command will verify your bot token, fetch available chats, and update your .env automatically.
Manual Setup
1. Add disk in config/filesystems.php:
2. Configure .env:
Usage
Chunking & Encryption
Automatic Chunking
Files larger than 19MB are automatically split into chunks and uploaded separately. They are reassembled transparently when downloaded.
Encryption
Enable encryption to secure your files with AES-256:
Files are encrypted before upload and decrypted on download automatically:
Note: Encryption works with both chunked and non-chunked files. Each chunk is encrypted individually.
How It Works
- Chunking: Large files are split into 19MB chunks. Metadata tracks all chunk file_ids for reassembly.
- Encryption: Uses AES-256-CBC with a random IV per file/chunk. Key is derived from
APP_KEY. - Tracking: Database stores chunked/encrypted flags for proper retrieval.
Advanced Usage
Database Tracking
Check tracked files:
Disable Chunking
To disable chunking (files > 20MB will fail):
Custom Chunk Size
Channels
To use a Telegram channel, add your bot as admin and use the channel ID:
Testing
Individual commands:
Limitations
- Telegram's download limit: 20MB per chunk (chunking bypasses upload limit)
- Files cannot be deleted from Telegram via API
- No directory structure support
Troubleshooting
Files upload but return false: Enable logging to verify operations.
Encryption not working:
Ensure TELARA_ENCRYPTION_ENABLED=true and run php artisan config:clear.
Chunks not working:
Check logs with TELARA_LOGGING_ENABLED=true to see chunking operations.
License
MIT License. See LICENSE for details.
Enjoy building with Telara!
All versions of telara with dependencies
illuminate/support Version ^11.0|^12.0
illuminate/filesystem Version ^11.0|^12.0
illuminate/http Version ^11.0|^12.0
illuminate/database Version ^11.0|^12.0
league/flysystem Version ^3.0