Download the PHP package cmatosbc/penelope without Composer
On this page you can find all versions of the php package cmatosbc/penelope. It is possible to download/install these versions without Composer. Possible dependencies are resolved automatically.
Table of contents
Download cmatosbc/penelope
More information about cmatosbc/penelope
Files in cmatosbc/penelope
Download cmatosbc/penelope
More information about cmatosbc/penelope
Files in cmatosbc/penelope
Vendor cmatosbc
Package penelope
Short Description Tentative implementation of asynchronous file handling for PHP.
License gpl-3.0-or-later
Package penelope
Short Description Tentative implementation of asynchronous file handling for PHP.
License gpl-3.0-or-later
FAQ
After the download, you have to make one include require_once('vendor/autoload.php');. After that you have to import the classes with use statements.
Example:
Example:
If you use only one package a project is not needed. But if you use more then one package, without a project it is not possible to import the classes with use statements.
In general, it is recommended to use always a project to download your libraries. In an application normally there is more than one library needed.
In general, it is recommended to use always a project to download your libraries. In an application normally there is more than one library needed.
Some PHP packages are not free to download and because of that hosted in private repositories.
In this case some credentials are needed to access such packages.
Please use the auth.json textarea to insert credentials, if a package is coming from a private repository.
You can look here for more information.
- Some hosting areas are not accessible by a terminal or SSH. Then it is not possible to use Composer.
- To use Composer is sometimes complicated. Especially for beginners.
- Composer needs much resources. Sometimes they are not available on a simple webspace.
- If you are using private repositories you don't need to share your credentials. You can set up everything on our site and then you provide a simple download link to your team member.
- Simplify your Composer build process. Use our own command line tool to download the vendor folder as binary. This makes your build process faster and you don't need to expose your credentials for private repositories.
Please rate this library. Is it a good library?
Informations about the package penelope
Penelope 🧵
A high-performance asynchronous file handling library for PHP, leveraging Fibers for non-blocking I/O operations.
🚀 Overview
Penelope is designed to handle large file operations efficiently by utilizing PHP's Fiber feature for asynchronous processing. It breaks down file operations into manageable chunks, allowing for better memory management and improved performance, especially for large files.
Why Penelope?
- Memory Efficient: Process large files without loading them entirely into memory
- Non-Blocking: Leverage PHP Fibers for asynchronous operations
- Flexible: Support for both synchronous and asynchronous operations
- Transformable: Apply custom transformations during read/write operations
- Progress Tracking: Monitor write progress in real-time
- Compression Support: Built-in support for gzip, bzip2, and deflate compression
- Error Resilience: Robust error handling with retry mechanisms and logging
📋 Requirements
- PHP 8.1 or higher (Fiber support required)
- Composer for dependency management
- PHP Extensions:
zlibfor gzip/deflate compressionbz2for bzip2 compression (optional)
🛠 Installation
📖 Usage
Basic File Reading
Compression Support
Error Handling with Retries
Combining Features
🎯 Use Cases
1. Large File Processing
Perfect for processing large log files, data exports, or any situation where memory efficiency is crucial:
2. File Compression and Archiving
- Compress large log files for archival
- Create compressed backups of data files
- Stream compressed data to remote storage
- Process and compress multiple files in parallel
3. Error-Resilient Operations
- Retry failed network file transfers
- Handle intermittent I/O errors gracefully
- Log detailed error information for debugging
- Implement progressive backoff for rate-limited operations
🔍 Performance
Based on our benchmarks with a 100MB file:
- Async Read: ~3.4x faster than synchronous read
- Async Write: Comparable to synchronous write
- Memory Usage: Consistent across operations
- Chunk Size: Default 8KB (configurable)
🧪 Testing
🤝 Contributing
Contributions are welcome! Please feel free to submit a Pull Request.
📝 License
This project is licensed under the GNU General Public License v3.0 - see the LICENSE file for details. This means:
- You can freely use, modify, and distribute this software
- If you modify and distribute this software, you must:
- Make your modifications available under GPL-3.0
- Include the original copyright notice
- Include the full text of the GPL-3.0 license
- Make your source code available
⚠️ Important Notes
- Requires PHP 8.1+ for Fiber support
- Performance may vary based on file size and system configuration
- For optimal performance, adjust chunk size based on your use case
🔗 Links
- PHP Fibers Documentation
- Issue Tracker
- Contributing Guidelines
All versions of penelope with dependencies
PHP Build Version
Package Version
The package cmatosbc/penelope contains the following files
Loading the files please wait ....