Download the PHP package jerome/matrix without Composer
On this page you can find all versions of the php package jerome/matrix. It is possible to download/install these versions without Composer. Possible dependencies are resolved automatically.
Download jerome/matrix
More information about jerome/matrix
Files in jerome/matrix
Package matrix
Short Description An unparalleled PHP asynchronous experience, offering genuine concurrency and fiber-based task management.
License MIT
Homepage https://thavarshan.com
FAQ
Example:
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 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.
Informations about the package matrix
Matrix
Matrix is a cutting-edge PHP library for asynchronous task management, inspired by JavaScript’s async/await paradigm but leveraging PHP's native Fibers. Matrix provides a streamlined, non-blocking API to run tasks, manage errors, and handle results—all without the need for explicit task starting.
Matrix also supports manual task management through the Task class and robust error handling through a customizable ErrorHandler.
Why Matrix?
Matrix brings a JavaScript-like async experience to PHP, providing developers with the simplicity and power of managing asynchronous tasks without complexity.
- JavaScript-like async API: Matrix introduces a simple and elegant API inspired by JavaScript’s async functions.
- Built on PHP Fibers: Using PHP 8.1+ Fibers, Matrix delivers true non-blocking concurrency.
- Customizable Error Handling: Handle task failures gracefully with an extensible error handler.
- Manage Task Lifecycles: Direct control over task status with methods for pausing, resuming, and canceling tasks.
Key Features
- JavaScript-like async/await API for seamless asynchronous task execution.
- Non-blocking concurrency: Built on top of PHP 8.1+ Fibers.
- Error handling with custom error recovery using the
Handlerclass. - Task lifecycle management: Start, pause, resume, cancel, or retry tasks.
Installation
Install Matrix via Composer:
Matrix requires PHP 8.1 or above.
JavaScript-like Async API
Matrix brings the familiarity of JavaScript's async/await into PHP, making it incredibly easy to work with asynchronous tasks. Here's how you can use it:
This JavaScript-like API allows you to define tasks, handle success, and catch errors seamlessly—without needing to call a start method explicitly.
Handling Errors in Async Tasks
Matrix also makes it easy to handle errors in asynchronous tasks:
The catch() method allows you to define an error handler, making it straightforward to manage exceptions during task execution.
Task Management with the Task Class
If you prefer more manual control over your tasks, Matrix provides the Task class, allowing you to directly manage task lifecycles.
Creating and Managing Tasks
Pausing and Resuming Tasks
Matrix allows you to pause and resume tasks at will:
Task Status Management
Each task has a status (PENDING, RUNNING, PAUSED, COMPLETED, FAILED, CANCELED) that can be queried using the getStatus() method.
Error Handling with the Handler Class
Matrix provides robust error handling through the Handler class. This class allows you to define retry logic, error logging, and final failure handling.
Example of Error Handling with Task
The Handler class can automatically retry tasks or log errors, making it highly customizable.
API Reference
Matrix\AsyncHelper
then(callable $callback): Registers a success callback and starts the task.catch(callable $callback): Registers an error callback and starts the task.start(): Manually starts the task (called automatically when usingthenorcatch).
Matrix\Task
start(): Starts the task execution.pause(): Pauses the task if it’s running.resume(): Resumes a paused task.cancel(): Cancels the task.retry(): Retries a task if it has failed or completed.getStatus(): Returns the task status (PENDING,RUNNING,PAUSED,COMPLETED, etc.).getResult(): Retrieves the result of the task once completed.
Matrix\Exceptions\Handler
handle($contextId, $context, Throwable $e): Handles task errors.retryTask($taskId, Task $task): Retries a task.handleFinalFailure($taskId, Task $task): Handles a task’s final failure after all retries are exhausted.
Contributing
We welcome contributions! To contribute:
- Fork the repository.
- Create a new branch (
git checkout -b feature/new-feature). - Make your changes and commit (
git commit -m 'Add new feature'). - Push your branch (
git push origin feature/new-feature). - Open a pull request!
License
Matrix is licensed under the MIT License. See the LICENSE file for more information.
Authors
- [Jerome Thayananthajothy] - Initial work - Thavarshan
See also the list of contributors who participated in this project.
Acknowledgments
- Special thanks to the PHP community for their support and inspiration for this project.
Get Involved
Matrix offers a unique PHP async experience, bringing true concurrency and fiber-based task management to PHP developers. Star the repository on GitHub to help Matrix grow and to stay updated on new features.
