2024.06.18

【WordPress】他のPHPを読み込んで使い回す方法

今回は、共通するコードを1つのファイルにまとめる時に役立つPHPファイルのインクルード（include）方法をご紹介します。

PHPファイルのインクルードを活用できる場面

WordPressでサイト制作を行なっていると、以下のようなことはよくあります。

このような場合、複数箇所に同じような記述を書くことで対応はできますが、何度も記述するのが大変です。

また、文言修正などが起きた場合に全ての箇所を更新する必要がでてきてしまいます。

サイトのボリュームが多くなってくるとどこに何が書かれているのか把握できづらく、アーカイブページは修正されたけどタクソノミーページの表示は変わってないということになりかねません。

今回ご紹介するPHPファイルのインクルードは、このような場面で非常に役立ちます。

まずは、CVエリアや記事一覧表示など使い回す部分のみを記述したPHPファイルを作成します。

<!--使い回すパーツのみを記述する-->
<?php if (have_posts()) : ?>
　〜略〜
<?php endif; ?>

どこに配置しても良いのですが、把握しやすくするために、読み込み専用のディレクトリを作成するのがおすすめです。

今回はincludeというディレクトリを作成して、先ほど作成したtest.phpを入れました。

では、archive.php内にtest.phpを読み込みたいと思います。

<!--呼び出したい場所に以下を記述-->
<?php include(get_template_directory() . '/include/test.php'); ?>

読み込み記述はこれだけです。

これで、test.php内の記述に変更があったとき、test.phpのみを修正すれば読み込んでいる全てのページに反映されるようになります。

たった1つの変更なのに、いくつものphpファイルを修正しなければならない、修正漏れが発生してしまった・・などはよく起こりがちですよね。

インクルードを使いこなすことでそのようなことはなくなります！

自分で作成したサイトでも、どこに何があったのかだんだん忘れていってしまうので、最初から忘れても大丈夫な仕組みにしておくのが良いですね！