Pass any variables between stages

[roquie]

Work example:

require __DIR__ . '/vendor/autoload.php';

use League\Pipeline\Pipeline;

$pipeline = (new Pipeline)
    ->pipe(function ($payload, $dto) {
        $dto['ten'] = 10;
        return $payload * 2;
    })
    ->pipe(function ($payload, $dto) {
        return $payload + $dto['ten'];
    });

echo $pipeline->process(5, new ArrayObject());
// 20

Also I added docblocks for better IDE autocomplete. Full backward compatibility.

[shadowhand]

Not needed, PipelineInterface already provides all the docblocks. Same for other docblocks added in this PR.

[roquie]

For others -- ok. But for this docblock for PipelineInterface returns only interface without $this. IDE autocompletion works only within interface scope and not touch process method which should be there.

[shadowhand]

Hmm I forgot about this signature, makes it significantly trickier to handle. It's pretty straight forward for the Pipeline:

function process(...$parameters) { ... }

But the processor is different because it receives the stages:

function process($payload, callable ...$stages) { ... }

[shadowhand]

It might make more sense for this to be:

return $this->processor->withParameters($params)->process(...$this->stages);

Doing so will change the signatures significantly though, and cause a major version bump.

Let me think about this for a couple of days.

[roquie]

Yes, your variant is more elegant, but needs to bump the major version.

Let me think about this for a couple of days.

ok.