Excluded path: include example for optional path

[thePanz]

Make more clear how to mark an excluded path optional, with the use of (?) suffix

[ondrejmirtes]

Would be great to show the full example including excludePaths: and to use the actual path in question, not just path/something. Thanks.

[thePanz]

I tried to achieve that as my first contribution to PHPStan :)
I proposed a first change to be able to track which paths should be suggested.

from my understanding: paths adhering to FileExcluder::isFnmatchPattern() are not evaluated, thus I opted to not suggest those as Optional. Let me know if those should be added too as suggestions.

[ondrejmirtes]

I've just added a single entry that does not exist like this:

parameters:
	excludePaths:
		- foo

But your code results in the following output:

Please fix that.

[ondrejmirtes]

Also I just noticed there's a typo: analyseAndScan is missing a colon.

[gharlan]

The example should use relative paths.

[ondrejmirtes]

It should but right now it's impossible to get the correct relative path.

Because relative path depends on the location of the config file, but at this point we have the whole parameters array decoded from all the config files at once.

I don't need OP to tackle this. I can look at it myself once the PR works.

[thePanz]

Some brain dump while trying to implement the feature:

1. in ValidateExcludePathsExtension::loadConfiguration() we get the paths resolved and absolute, we would need a way to figure out the original value passed in the configuration
2. the $this->getContainerBuilder() returns what I call "fully qualified configuration" where the shortcut mentioned here https://phpstan.org/user-guide/ignoring-errors#excluding-whole-file is already resolved to the full configuration

[thePanz]

Got this result:

By using the following configuration:

includes: [ build/phpstan.neon ]
parameters:
	excludePaths:
		- foo

[ondrejmirtes]

Please mark it as ready for review if it's done from your side.

[phpstan-bot]

This pull request has been marked as ready for review.

[ondrejmirtes]

I've pushed two commits, feel free to inspect them 😊

[ondrejmirtes]

Thank you!