support @param number

[mathroc]

PhanTypeMismatchArgument Argument 1 (value) is float|int but \NumberFormatter::format() takes \Symfony\Component\Intl\NumberFormatter\number defined at /scripts/vendor/symfony/intl/NumberFormatter/NumberFormatter.php:371

/** @param number */ is some times used to describe int|float, eg:
https://github.com/symfony/intl/blob/master/NumberFormatter/NumberFormatter.php#L360
it's also used in the documentation : http://php.net/manual/en/numberformatter.format.php and I think I read discussion in php internals about adding it to PHP so it might be a good idea to support it as an alias to int|float

[TysonAndre]

https://github.com/TysonAndre/phan/pull/4/files is one way of doing this (handle immediately after parsing doc comment)
(Not in etsy/phan, but could be redone as a PR against etsy/phan if this is useful to have. Emitting a issue if a key of 'experimental_invalid_phpdoc_types' exists as a class/builtin would be a TODO)
number isn't a reserved name in php yet.

(It's mostly meant for old invalid phpdoc, so it doesn't bother to expand number|null or number[] (to int[]|float[]). It would replace those vars, params, and return types which are exactly "number" with int|float.

'experimental_invalid_phpdoc_types' => ['number' => 'int|float'],

[TysonAndre]

See PR #1112, the phpdoc_type_mapping setting will be in the next Phan release. This may be expanded to individual parts of phpdoc types (including the inside of nullable types), but currently acts on the string as a whole.

In order to avoid unintuitive issues similar to #781 , I'd rather be conservative about adding types that aren't in phpdoc2 or other standards