docs: add correct array signatures for Modules

[paulbalandan]

Description
See #7731

Checklist:

• Securely signed commits
• Component(s) with PHPDoc blocks, only if necessary or adds value
• Unit testing, with >80% coverage
• User guide updated
• Conforms to style guide

[kenjis]

If list is okay with @var, we can remove @phpstan-var tags like:

     * @var array<int, string>
     * @phpstan-var list<string>

[paulbalandan]

Interesting. I think vscode intelephense has now support for this type, as well as Closure signatures.

[kenjis]

Okay, then let's remove @phpstan-var from now on.

[MGatner]

I'm all for this; I can confirm that Intelephense (in BBEdit) supports list as well.

[MGatner]

I know I always ask this... these are different, right?

list<string>
string[]

I think the latter just means "values are all strings" without any indication of keys. But I can't find the answer explicitly.

• https://phpstan.org/writing-php-code/phpdoc-types#general-arrays
• https://docs.phpdoc.org/2.9/guides/types.html#arrays

[kenjis]

Yes.

/** @return ValueType[] */
In Psalm this annotation is equivalent to @psalm-return array<array-key, ValueType>.
https://psalm.dev/docs/annotating_code/type_syntax/array_types/#phpdoc-syntax

[paulbalandan]

same for phpstan

[paulbalandan]

Sent PR: #8114

[kenjis]

I changed fix: in the subject to docs: because when checking the changelog generated at release time, we need to think a bit whether the item is a bug fix or an item that should be removed from the changelog.
I would like to limit fix: to product code fixes only.

[MGatner]

@paulbalandan Since it's vaguely related could you roll in the CS Fixer change to this PR?

+++ /home/runner/work/CodeIgniter4/CodeIgniter4/system/Exceptions/FrameworkException.php