Download the PHP package lucinda/process without Composer
On this page you can find all versions of the php package lucinda/process. It is possible to download/install these versions without Composer. Possible dependencies are resolved automatically.
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 process
Lucinda Shell Process & Pooling API
This API is a light weight wrapper over PHP proc_* functions, able to execute shell processes individually, pool them or handle streams that traverse them. Its design goals were:
- platform agnosticity: API doesn't take any assumptions on the operating system process runs into
- least assumption principle: API doesn't take any assumption how you will handle process streams, so provides a skeleton instead
- elegance and simplicity: API is written on less is more principle so it's easy to understand and flexible to extend
API is 100% unit tested, fully PSR-4 compliant and only requiring PHP 8.1+ interpreter. For installation, you just need to write this in console:
Then use one of main classes provided (using use Lucinda\Shell namespace):
- Stream: encapsulates an abstract data stream to be used by process (eg: STDIN/STDOUT/STDER). Extended by:
- Stream\Pipe: encapsulates a stream of un-named pipes to be processed immediately
- Stream\File: encapsulates a stream of that delegates to a file on disk
- Stream\Resource: encapsulates a stream of that delegates to a resource (eg: socket)
- Process: encapsulates a single process using Stream instances above
- Pool: encapsulates a pool of processes to be executed in paralel queue-ing Process instances above and using Process\Multiplexer implementation for processing
Each of above classes branches through its methods to deeper classes that become relevant depending on the complexity of process execution logic. To make things simple following drivers were provided (using Lucinda\Shell\Driver namespace):
- SingleCommandRunner: executes a single Process and returns Process\Result
- MultiCommandRunner: executes list of Process-es and returns list of Process\Result-s
Both classes make use of I/O multiplexing that uses SELECT command underneath.
Executing Single Processes
To execute a single shell command you can use Lucinda\Shell\Process for minute control or Lucinda\Shell\Driver\SingleCommandRunner driver provided:
This is superior to shell_exec because it will:
- terminate if shell command execution exceeds 5 seconds
- process STDOUT/STDERR streams separately using IO multiplexing
- read streams in parallel using chunks
- automatically escape shell command
Executing Multiple Processes
To execute multiple shell commands at once you can implement your own Lucinda\Shell\Process\Multiplexer for minute control or Lucinda\Shell\Driver\MultiCommandRunner driver provided:
This will:
- open processes simultaneously
- terminate if ANY of processes exceeds 5 seconds
- use non-blocking approach, allowing streams processing to be done in parallel
- automatically escape shell commands
Pooling Multiplexed Processes
To run multiplexed processes in pools of fixed size (5 in this example):
This will:
- execute N processes at same time (5 in above example)
- when they all end, proceed to next batch
All versions of process with dependencies
ext-curl Version *