[v2] Intersection types not recognized in docblocks

[weierophinney]

2.0.0-alpha.3 standard does not recognize and improperly reformats intersect types(&) in phpdoc:

     /**
      * Inject a service into the container mock.
      *
      * Adjust `has('service')` and `get('service')` returns.
      *
-     * @param ContainerInterface&ObjectProphecy $container
+     * @param ContainerInterface &ObjectProphecy $container
      * @param mixed              $service
      */
     protected function injectServiceInContainer(ObjectProphecy $container, string $serviceName, $service) : void
     {
         $container->has($serviceName)->willReturn(true);
         $container->get($serviceName)->willReturn($service);
     }

Intersections types are supported by PhpStorm, phpstan and present in the draft for phpdoc PSR
https://github.com/php-fig/fig-standards/blob/master/proposed/phpdoc.md#details

---

Originally posted by @Xerkus at zendframework/zend-coding-standard#16

[weierophinney]

For reference, please see: squizlabs/PHP_CodeSniffer#2410

---

Originally posted by @michalbundyra at zendframework/zend-coding-standard#16 (comment)

[geerteltink]

There is no sniff for this yet.

[Xerkus]

I would rather classify this as a bug as reformatted intersect types become invalid.

Intersection types are fairly new (eg PhpStorm added support for them in 2018, phpstan in 2017 with 0.9 release, PSR-5 is still in draft however). We won't see them often and when they are used cs ignore rules can be used until support added in upstream

[geerteltink]

There are 2 phpcs issues open for this:

• FunctionComment.SpacingAfterParamType not working with intersection types squizlabs/PHP_CodeSniffer#2887
• Error while using "&" and "|" at the same time squizlabs/PHP_CodeSniffer#2806

[geerteltink]

Fixed by squizlabs/PHP_CodeSniffer#2919

[geerteltink]

Fixed in #49