mak/phing-foreach-parallel-task

phing task to run sub-tasks in a foreach-loop in separate, parallel processes

ForeachParallel-Task for Phing

, _(*1)

Maintainer Contact

Matthias Krauser mail: matthias@krauser.eu twitter: @mat_krauser, _(*2)

Changelog

1.0.0 (2014-10-27)

• initial release

Documentation

The foreach-parallel-task for phing behaves exactly like the normal foreach-task. From the documentation of the foreach-task:, _(*3)

The foreach task iterates over a list, a list of filesets, or both. If both, list and filesets, are specified, the list will be evaluated first. Nested filesets are evaluated in the order they appear in the task., _(*4)

The only difference is, that the iterations are not executed sequentially but parallel. It like a foreach-version of phing's ParallelTask., _(*5)

This only works on *nix machines with pcntl-extension installed. If the requirements are not fullfilled, the foreach-parallel-task will behave like a regular foreach-task., _(*6)

Installation

The suggested installation method is via composer:, _(*7)

php composer.phar require "doctrine/instantiator:~1.0.3"

Usage

• Load the task in your phing build-file

<taskdef name="foreach_parallel" classname="MaK\Phing\Task\ForeachParallelTask" />

• Call the task: The syntax is exactly the same as the original task. The only difference is the optional threadCount-Attribute, to specify the maximum number of threads / processes to use. If not specified, the library will try to guess the best number.

<foreach_parallel list="..." param="some_param" target="target-task" threadCount="4"/>

Credits

This library task was heavily inspired by ParallelTask from Michiel Rook (mrook@php.net), which is part of the Phing-Core., _(*8)