Download the PHP package superrb/async without Composer
On this page you can find all versions of the php package superrb/async. It is possible to download/install these versions without Composer. Possible dependencies are resolved automatically.
Download superrb/async
More information about superrb/async
Files in superrb/async
Package async
Short Description A PHP library for handling asynchronous processes and inter-process communication via sockets
License MIT
Homepage https://github.com/superrbstudio/async
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 async
Async
A simple PHP library for creating asynchronous processes, and handling inter-process communication via sockets.
Installation
Usage
Getting Started
The easiest way to use this package is to use the async helper. This simply runs the supplied closure asynchronously within a forked process. The closure must return a boolean to indicate success/failure of the subprocess, and have the return type bool, as this is used to set the exit state of the process.
Any arguments passed to async will be passed straight to the forked process.
Reusable closures
You can reuse a closure, by manually constructing an instance of Superrb\Async\Handler
You can run synchronous code within forked processes by passing false as the second argument to the Handler constructor. This is useful for running long processes such as imports, as any memory consumed within the loop is dumped at the end of the process.
Inter-process communication
Sending messages to the parent
async uses channels and socket pairs to allow for communication between the child and parent process. Communication is one way - you can pass messages from the child process back to the main process using $this->send() within your closure. Messages can be strings, objects or arrays.
Reading messages
Messages can then be read by calling the generator $handler->getMessages() once processing has completed. For asynchronous processes, the messages will always be received in the order the handlers were run regardless of which process finished first.
For synchronous processes, you can read messages at the end of each process. If you do this, you'll need to clear the message pool manually after reading them.
Increasing the communication buffer
By default messages are sent within a 1024-byte message buffer, and attempting to send data larger than this will result in an exception. You can increase/decrease the buffer by calling setMessageBuffer on the handler.
Contributing
All contributions are welcome, and encouraged. Please read our code of conduct for more information.
License
Copyright (c) 2017 Superrb Studio [email protected]
Async is licensed under The MIT License (MIT)
Team
- James Dinsdale (@molovo)
