可変長引数を使用した際にphp_codesnifferがエラーを出す。

Question

php_codesnifferを使って一定の規約に沿って書いているのですが、可変長引数を使用した際にエラーが出てしまいます。
...$fileNames←こういうのです。

# エラー内容
Doc comment for parameter "...$fileNames" missing
Doc comment for parameter $fileNames does not match actual variable name ...$fileNames

今、phpcs:ignoreを使って一時対応しています。
つまりphpcs:ignoreの次の行がエラーが出ている所となります。
以下のようなmixedを書いてもだめでした。

// phpcs:ignore
/**
 * View File
 *
 * // phpcs:ignore
 * @param mixed $fileNames Fiename
 *
 * @return response
 */
public function show(...$fileNames)
{
  $fileName = implode('/', $fileNames);
  :
}

開発にはVSCodeを使用しており以下のように定義しています。

• .vscode/settigns.json

{
  "phpsab.fixerEnable": true,
    "phpsab.snifferEnable": true,
    "phpsab.snifferMode": "onSave",
    "phpsab.standard": "./php-coding-ruleset.xml",
    "phpsab.executablePathCS": "./vendor/squizlabs/php_codesniffer/bin/phpcs",
    "phpsab.executablePathCBF": "./vendor/squizlabs/php_codesniffer/bin/phpcbf",
    "[php]": {
      "editor.formatOnSave": true,
      "editor.defaultFormatter": null
    },
  :
}

• php-coding-ruleset.xml

<?xml version="1.0" encoding="utf-8" ?>
<rulset name="My Project">
  <config name="installed_paths" value="vendor/codeigniter4/codeigniter4-standard/CodeIgniter4"/>
  <rule ref="vendor/codeigniter4/codeigniter4-standard/CodeIgniter4/ruleset.xml"/>
  <exclude-pattern>*/vendor/*</exclude-pattern>
  <exclude-pattern>*/vendors/*</exclude-pattern>
  <exclude-pattern>writable/**/*</exclude-pattern>
</rulset>

何か書き方が悪いのか、ルールが足りない（書いて回避できる）のか...。

ご教示いただけないでしょうか。
よろしくお願いします。

Answer 1

解決しました。

...も@paramに加えることにより、エラーにはならなくなるようです。
@param mixed $fileNames FileNames
↓
@param mixed ...$fileNames FileNames

Answer 2

show('foo.txt', 'bar.txt', 'baz.txt');
みたいにして呼びたいのだと察しますが、それ
show(['foo.txt', 'bar.txt', 'baz.txt']);
でも良くないですか？

であれば、

public function show($fileNames)
{

で受け取れるんですが。

public function show(array $fileNames)
{

って意味で。

Comments

[tomomo]

解答ありがとうございます。
該当の記述、フレームワークのルーティングに沿ってる節があります。

$routes->get('file/show/(.+)', 'File::show/$1');

(.+)は a.jpgでもあり、b/a.jpgでもあり、c/b/a.jpgでもあり。
で、$1が可変長の配列が入ってくるのです。
例えば先述した最後のであれば [ 0 => 'c', 1 => 'b', 2 => 'a.jpg'] みたいな感じです。
勿論上記のルーティングを弄れば（'File::show/$1'をfunctionとか）とも思ったのですが、そもそもphp_codesnifferの其れで、可変長引数を受け入れてくれる書き方とか回避方法とかないのかなと思ったのです。