Download the PHP package saeedvir/laravel-gist-storage without Composer
On this page you can find all versions of the php package saeedvir/laravel-gist-storage. It is possible to download/install these versions without Composer. Possible dependencies are resolved automatically.
Informations about the package laravel-gist-storage
Laravel Gist Storage
A powerful Laravel storage driver that enables you to store and manage files on GitHub Gist using Laravel's familiar Storage facade. Turn GitHub Gist into a free, reliable cloud storage solution for your Laravel applications.
📦 Package Summary
This package provides a Flysystem v3 adapter for GitHub Gist, seamlessly integrating with Laravel's filesystem. Store files, images, JSON data, or any text-based content directly to GitHub Gist using the same Storage API you already know.
What is GitHub Gist Storage?
GitHub Gist is a service that allows you to share code snippets and files. This package transforms Gist into a fully-functional storage backend for Laravel applications, giving you:
- Free cloud storage backed by GitHub's infrastructure
- Version control for all your stored files
- Public or private file storage options
- CDN-ready URLs for direct file access
- No additional infrastructure costs or setup
Core Features
✅ Laravel Storage Facade Integration - Use Storage::disk('gist') just like any other disk
✅ Auto-Create Gists - Automatically create new gists without pre-configuring a GIST_ID
✅ Flysystem v3 Compatible - Modern, PSR-compliant filesystem adapter
✅ Full CRUD Operations - Read, write, update, delete, list, and manage files
✅ Stream Support - Handle large files with PHP streams
✅ Livewire Compatible - Upload files directly from Livewire components
✅ Zero Dependencies - Pure PHP implementation using only cURL
✅ Smart Caching - Reduces API calls with intelligent metadata caching
✅ Laravel 11 & 12 - Full support for the latest Laravel versions
✅ PHP 8.1+ - Modern PHP features and type safety
🚀 Key Benefits
1. Zero Infrastructure Costs
No need for AWS S3, DigitalOcean Spaces, or other paid storage services. GitHub Gist is completely free and reliable.
2. Instant Setup
Just add your GitHub token, and you're ready to go. No complex configurations or third-party accounts.
3. Developer-Friendly
Use the same Laravel Storage API you already know:
4. Version Control Built-In
Every change to your files is tracked by GitHub. View file history, rollback changes, and audit modifications.
5. Public URL Access
Get direct CDN-backed URLs for your files, perfect for sharing images, JSON APIs, or configuration files.
6. Automatic Gist Creation
Don't have a Gist ID? Enable auto_create and the package will create one for you on first upload.
7. Production-Ready
- Comprehensive error handling with Laravel exceptions
- Token format validation to catch configuration errors early
- Smart cache invalidation to keep metadata synchronized
- Stream position handling for reliable large file uploads
8. Multiple Use Cases
- Configuration Storage - Store app configs, feature flags, or environment settings
- Static Content - Host JSON data, CSV files, or text documents
- User Uploads - Handle file uploads from Livewire or controller forms
- Public APIs - Share data files with public gist URLs
- Backup Storage - Store database dumps, logs, or backup files
- CDN Alternative - Serve small assets without CDN costs
📥 Installation
⚡ Quick Start
1. Configure Your Environment
Add to your .env file:
Get your token: https://github.com/settings/tokens (requires gist scope)
2. Add Disk Configuration
In config/filesystems.php:
3. Start Using It!
📚 Documentation
- INSTALLATION.md - Detailed setup and configuration guide
- QUICKSTART.md - 5-minute quick start tutorial
- PACKAGE-SUMMARY.md - Complete technical documentation
- examples/ - Ready-to-use code examples for common scenarios
🔧 Usage Examples
Upload from Livewire Component
Store JSON Data
Handle Streams
🎯 Requirements
- PHP: 8.1, 8.2, or 8.3
- Laravel: 11.x or 12.x
- Extensions:
ext-curl,ext-json - GitHub: Personal Access Token with
gistscope
🛡️ Security
- Store your
GIST_TOKENsecurely in.env- never commit it - Use private gists for sensitive data
- Token format validation prevents invalid credentials
- All API requests use HTTPS with SSL verification
See SECURITY.md for security policy and reporting vulnerabilities.
🤝 Contributing
Contributions are welcome! See CONTRIBUTING.md for guidelines.
📝 License
MIT License - see LICENSE.md for details.
👤 Author
Saeedvir
GitHub: @saeedvir
Email: [email protected]
⭐ Support
If this package helps your project, please consider giving it a star on GitHub!
Made with ❤️ for the Laravel community
All versions of laravel-gist-storage with dependencies
illuminate/support Version ^11.0|^12.0
illuminate/filesystem Version ^11.0|^12.0
league/flysystem Version ^3.0
ext-curl Version *
ext-json Version *