Added proc_open() stub for param-out

[staabm]

closes phpstan/phpstan#13197

[phpstan-bot]

This pull request has been marked as ready for review.

[mvorisek]

Suggested change

	* @param string|array<string> $command
	* @param list<list<string>|resource> $descriptor_spec
	* @param array<resource> $pipes
	* @param array<mixed> $env_vars
	* @param array<string, bool> $options
	*
	* @param-out list<resource> $pipes
	* @template P of int = int
	*
	* @param string|list<string> $command
	* @param array<P, <list<string>|resource> $descriptor_spec
	* @param array<string, mixed> $env_vars
	* @param array<string, bool> $options
	*
	* @param-out array<P, resource> $pipes

reasoning:

@template / $descriptor_spec / $pipes

$descriptor_spec describes the pipes returned in $pipes and in my understanding the keys always match.

$pipes param-in type is not wanted as it can be anything, not only array, but also null/uninitialized variable. Like $matches in preg_match.

$env_vars

Only string keys should be allowed, as at least in bash keys cannot start with number.

[ondrejmirtes]

You're closing an issue, please add a regression test for https://phpstan.org/r/dc1d4f91-b22d-4eaa-b796-34a353062477

[ondrejmirtes]

(I don't think the issue is solved so that's why I'm asking for a test for the new behaviour)

[staabm]

@ondrejmirtes test added. I think it works.