UnsplashのNEOMが撮影した写真

はじめに

別ファイルのPHPファイルを読み込むにはrequireとincludeを使うのですが、その使い方をこの記事でご紹介します。

動作確認した環境

OS：Windows11 Home / WSL(Ubuntu20.04)
php：v7.4.33

requireとincludeの使い方＆使い分け

requireとincludeは以下のように使います。

コード	内容
require [ファイルパス]	読み込みに失敗したら処理を中断する。 基本的に使わない。
require_once [ファイルパス]	まだ読み込んでなければrequireを実行する。 処理に関わるファイルの読み込みに使う。
include [ファイルパス]	読み込めなくても処理を続行する。 バナーなど処理に不要なファイルの読み込みに使う。
include_once [ファイルパス]	まだ読み込んでなければincludeを実行する。 基本的に使わない。

外部ファイルを読み込んでみる

使い方が分かったところで、例としてrequire_onceを使って外部ファイルを読み込んでみます。

まず読み込まれる側として以下のようにファイルを作成してください。

ファイル名：file1.php

<?php
echo 'Helloworld';

次に読み込む側として以下のようにファイルを作成してください。

※file1.phpとmain.phpは同じフォルダに作成してください。

ファイル名：main.php

<?php
require_once dirname(__FILE__) . '/file1.php';

file1.phpとmain.phpを作成したら、動作確認してみます。

以下コマンドで簡易にPHPを動かせるので、

コマンドラインにコマンドを打ち込んでブラウザでlocalhost:8000にアクセスし、表示を確認してください。

$ php -S localhost:8000 ./main.php

※↑コマンドを打ち込む前にcdコマンドでmain.phpのあるフォルダに移動しておいてください。

真っ白な画面の左上に「HelloWorld」と表示されたらOKです！