PHPで、ディレクトリ内のファイルを取得する関数を外部ファイルにしたい

Question

前提・実現したいこと

wordpressでテーマ作成中です。
functions.phpに記載する内容を分割し、"functions"というディレクトリ内に保存しています。
そして下記関数をfunctions.phpで実行すると同名の"functions"ディレクトリ内のファイル名を取得し
get_template_part()にて読み込むという処理をしております。

問題は、
直接functions.phpに下記関数を記載すれば動作するのですが、
別ファイル(仮にdev/test.php)に記述して読み込むと
__FILE__や__DIR__等がfunctions.phpの場所ではなくdev/test.phpの場所を取得してしまいます。

function.php側でfileScan();に__FILE__等を引数に渡してあげればいいのですが、
なるべく記述を少なくしたく、何か良い手はないかと思い質問させていただきました。

###外部関数

function fileScan() {
  $thisFile = basename(__FILE__, ".php");
  $dir = scandir(__DIR__ .'/'. $thisFile);

  foreach( $dir as $fileName ) {
    if( !preg_match( '/^(.|..)$/', $fileName) && $fileName !== '.DS_Store' ) {
      $fileName = basename($fileName, ".php");
      get_template_part($thisFile .'/'. $fileName);
    }
  }
}

###追記
現在は下記のようにするのが一番記述が少ないかなと思っているのですが他に良い方法がありましたらお願いいたします。
fileScan(__FILE__);

function fileScan($path) {
  $thisFile = basename($path, ".php");
  $dir = scandir(dirname($path) .'/'. $thisFile);

  foreach( $dir as $fileName ) {
    if( !preg_match( '/^(.|..)$/', $fileName) && $fileName !== '.DS_Store' ) {
      $fileName = basename($fileName, ".php");
      get_template_part($thisFile .'/'. $fileName);
    }
  }
}

Answer 1

WordPressならテーマ内のファイルのパスを取得するなら
__DIR__とか__FILE__とかを使うんじゃなく
get_template_directoryやget_stylesheet_directoryを使うべきです

function get_template_parts_in_dir($path='functions') {
  $dir = scandir(get_stylesheet_directory().'/'.$path);

  foreach( $dir as $fileName ) {
    if( substr($fileName,-4)==='.php' ) {
      $fileName = basename($fileName, ".php");
      get_template_part($path.'/'. $fileName);
    }
  }
}

関数名もfileScanって名前だと正直file関数のラッパー？
って感じなのでもうちょっと素直なものに

関数を実行したファイルのパスを取得したいなら
debug_backtraceでできないことはないですが
どこで実行したかで結果が変わる関数なんてのは
問題の種なのであまりお勧めはしません

Comments

[pdev]

ありがとうございました。大変参考になりました。

試したところ$dirがarrayでget_template_part()で動かなかったので、
引数の$dirを$dirName（scandir内の$dirも）にして$dirNameをget_template_part()に入れて動作しました。

現在のファイルの場所を取得ということばかり考えていたので、
get_template_directoryやget_stylesheet_directoryの存在が抜け落ちておりました。
自分の使い方では２つで問題なさそうです。
そのほかifの部分も最適なものに修正していただきありがとうございます。
php以外が紛れ込んだときを考えるとこの方がいいですね。

ファイル名のご指摘もありがとうございました。悩んでおりました；
長めの命名は苦手意識があったのですが、後からみたときこちらの方がわかりやすそうなので考えを改めます。

[KazuhiroHatano]

変数名被ってましたね、ちょっと修正しました