[11.x] Change phpdoc for typed config getters

[Jubeki]

Follow up from #50140

You can only provide the correct typed parameter, otherwise it will always throw an InvalidArgumentException

Since this is for Laravel 11, you could also add a php type instead of phpdoc.

[taylorotwell]

Could be a closure which returns these types.

[Jubeki]

@crynobone should the null type als be added as as a valid return type? Because currently the integer only can return integer.

Otherwise I would make these changes with Closures, which only return a string/integer/... and not allow a null value.

[crynobone]

that's the correct value of $default if you want to not use mixed. Returning null would throw an exception, which can be handled by @throws phpdoc.

[AlexandreGerault]

?int, ?string, ?bool should be the return types or change default to 0, '', and false

I believe the return type are correct. When using these typed getters you should except the value to be in a correct format. If the configuration is not, then it's because it's not correct. Thus expecting an exception is, for me, the right way.
null is not a valid value for me if you do:

Config::integer('key');

The default value should also be null by default as it is right now, as it is an optional argument. If you want 0, '' or similar just pass the default value then.

Config::integer('int-key', 0);
Config::string('str-key', '');

[ghost]

?int, ?string, ?bool should be the return types or change default to 0, '', and false

I believe the return type are correct. When using these typed getters you should except the value to be in a correct format. If the configuration is not, then it's because it's not correct. Thus expecting an exception is, for me, the right way. null is not a valid value for me if you do:

Config::integer('key');

The default value should also be null by default as it is right now, as it is an optional argument. If you want 0, '' or similar just pass the default value then.

Config::integer('int-key', 0);
Config::string('str-key', '');

I saw after I expanded the lines. That is why i removed the comment. Thanks.

EDIT.
Still the dockblock should be updated with @throws