【PHP】ファイルやディレクトリが存在するかどうかを確認できるfile_exists関数を解説します

こんにちは。たいら(@tairaengineer2)です。
転職を繰り返し現在5社経験している、12年目エンジニアです。

この記事では、 PHPでファイルやディレクトリが存在するかどうかを確認できるfile_exists関数について

file_exists関数とは
file_exists関数を使ったサンプルプログラム

と、丁寧に解説していきます。

前提条件：実行環境について
file_exists関数とは
file_exists関数を解説するプログラムの概要
PHPサンプルプログラム
実行結果
まとめ：file_exists関数を使ってみよう！

前提条件：実行環境について

実行環境は以下の通りです。

OS	Windows11
PHPのバージョン	8.2.4
XAMPPのバージョン	8.2.4

PHPを動かすためにXAMPPを使っています。
XAMPPのインストールは、下の記事をご参考ください。

【XAMPP】インストールするやり方を解説します（Windows11向け）

file_exists関数とは

file_exists関数とは、引数に指定されたパスのファイルまたはディレクトリが存在したらtrue、なければfalseを返す関数です。

確認したいファイルのパスは、相対パス絶対パス両方で指定することができます。
それぞれのパスについては、こちらの記事をご参考ください。

絶対パス
絶対パスについて解説します

相対パス
相対パスについて解説します

使い方サンプルは以下になります。

// 絶対パスで指定した場合
$sample = 'C:\sample.txt';
$result = file_exists($sample);

// 相対パスで指定した場合
$sample = '.sample.txt';
$result = file_exists($sample);

// 絶対パスで指定した場合

$sample = 'C:\sample.txt';

$result = file_exists($sample);

// 相対パスで指定した場合

$sample = '.sample.txt';

$result = file_exists($sample);

上記を実行すると、resultには引数で指定されているsample.txtが存在していればtrue、なければfalseが返ります。

では、次の章で実際に使ってみます。

file_exists関数を解説するプログラムの概要

file_exists関数を解説するプログラムでは、引数に与えたパスが存在する、しないのケース（2パターン）、与えるパスも

絶対パス
相対パス

でそれぞれ2パターン、合計4パターンでfile_exists関数に与えて、結果を表示させて確認します。
これをファイルとディレクトリの両方で確認します。

phpプログラムは

C:\xampp\htdocs

配下に、【sample.php】というファイル名で格納しています。
PHPのgettype関数を解説

PHPサンプルプログラム

<?php
	print('■file_exists確認<br >');

	print('①ファイルが存在する場合<br >');
	print('・絶対パスで確認<br >');
	$exists_file_absolute_path = 'C:\xampp\htdocs\sample\sample.txt';
	if (file_exists($exists_file_absolute_path)) {
		print($exists_file_absolute_path.'は存在する');
	} else {
		print($exists_file_absolute_path.'は存在しない');
	}
	print('<br >');
	print('・相対パスで確認<br >');
	$exists_file_relative_path = '.\sample\sample.txt';
	if (file_exists($exists_file_relative_path)) {
		print($exists_file_relative_path.'は存在する');
	} else {
		print($exists_file_relative_path.'は存在しない');
	}
	print('<br >');

	print('②ファイルが存在しない場合<br >');
	print('・絶対パスで確認<br >');
	$not_exists_file_absolute_path = 'C:\xampp\htdocs\sample\aaa.txt';
	if (file_exists($not_exists_file_absolute_path)) {
		print($not_exists_file_absolute_path.'は存在する');
	} else {
		print($not_exists_file_absolute_path.'は存在しない');
	}
	print('<br >');
	print('・相対パスで確認<br >');
	$not_exists_file_relative_path = '.\sample\aaa.txt';
	if (file_exists($not_exists_file_relative_path)) {
		print($not_exists_file_relative_path.'は存在する');
	} else {
		print($not_exists_file_relative_path.'は存在しない');
	}
	print('<br >');

	print('③ディレクトリが存在する場合<br >');
	print('・絶対パスで確認<br >');
	$exists_directory_absolute_path = 'C:\xampp\htdocs\sample';
	if (file_exists($exists_directory_absolute_path)) {
		print($exists_directory_absolute_path.'は存在する');
	} else {
		print($exists_directory_absolute_path.'は存在しない');
	}
	print('<br >');
	print('・相対パスで確認<br >');
	$exists_directory_relative_path = '.\sample';
	if (file_exists($exists_directory_relative_path)) {
		print($exists_directory_relative_path.'は存在する');
	} else {
		print($exists_directory_relative_path.'は存在しない');
	}
	print('<br >');

	print('②ディレクトリが存在しない場合<br >');
	print('・絶対パスで確認<br >');
	$not_exists_directory_absolute_path = 'C:\xampp\htdocs\aaa';
	if (file_exists($not_exists_directory_absolute_path)) {
		print($not_exists_directory_absolute_path.'は存在する');
	} else {
		print($not_exists_directory_absolute_path.'は存在しない');
	}
	print('<br >');
	print('・相対パスで確認<br >');
	$not_exists_directory_relative_path = '.\aaa';
	if (file_exists($not_exists_directory_relative_path)) {
		print($not_exists_directory_relative_path.'は存在する');
	} else {
		print($not_exists_directory_relative_path.'は存在しない');
	}
?>

<?php

print('■file_exists確認 ');

print('①ファイルが存在する場合 ');

print('・絶対パスで確認 ');

$exists_file_absolute_path = 'C:\xampp\htdocs\sample\sample.txt';

if (file_exists($exists_file_absolute_path)) {

print($exists_file_absolute_path.'は存在する');

} else {

print($exists_file_absolute_path.'は存在しない');

}

print(' ');

print('・相対パスで確認 ');

$exists_file_relative_path = '.\sample\sample.txt';

if (file_exists($exists_file_relative_path)) {

print($exists_file_relative_path.'は存在する');

} else {

print($exists_file_relative_path.'は存在しない');

}

print(' ');

print('②ファイルが存在しない場合 ');

print('・絶対パスで確認 ');

$not_exists_file_absolute_path = 'C:\xampp\htdocs\sample\aaa.txt';

if (file_exists($not_exists_file_absolute_path)) {

print($not_exists_file_absolute_path.'は存在する');

} else {

print($not_exists_file_absolute_path.'は存在しない');

}

print(' ');

print('・相対パスで確認 ');

$not_exists_file_relative_path = '.\sample\aaa.txt';

if (file_exists($not_exists_file_relative_path)) {

print($not_exists_file_relative_path.'は存在する');

} else {

print($not_exists_file_relative_path.'は存在しない');

}

print(' ');

print('③ディレクトリが存在する場合 ');

print('・絶対パスで確認 ');

$exists_directory_absolute_path = 'C:\xampp\htdocs\sample';

if (file_exists($exists_directory_absolute_path)) {

print($exists_directory_absolute_path.'は存在する');

} else {

print($exists_directory_absolute_path.'は存在しない');

}

print(' ');

print('・相対パスで確認 ');

$exists_directory_relative_path = '.\sample';

if (file_exists($exists_directory_relative_path)) {

print($exists_directory_relative_path.'は存在する');

} else {

print($exists_directory_relative_path.'は存在しない');

}

print(' ');

print('②ディレクトリが存在しない場合 ');

print('・絶対パスで確認 ');

$not_exists_directory_absolute_path = 'C:\xampp\htdocs\aaa';

if (file_exists($not_exists_directory_absolute_path)) {

print($not_exists_directory_absolute_path.'は存在する');

} else {

print($not_exists_directory_absolute_path.'は存在しない');

}

print(' ');

print('・相対パスで確認 ');

$not_exists_directory_relative_path = '.\aaa';

if (file_exists($not_exists_directory_relative_path)) {

print($not_exists_directory_relative_path.'は存在する');

} else {

print($not_exists_directory_relative_path.'は存在しない');

}

実行結果

実行する前の状態を確認します。
PHPのfile_exists関数を解説
sampleディレクトリ配下には、sample.txtは存在し、aaa.txtは存在しないことが確認できました。

PHPのfile_exists関数を解説
sampleディレクトリは存在し、aaaディレクトリは存在しないことが確認できました。

では、実行してファイルまたはディレクトリが存在しているかのを確認します。
XAMPPを起動して、【http://localhost/sample.php】のURLにアクセスします。

XAMPPでPHPの動かし方については、こちらの記事をご参考ください。

XAMPPでApacheの動かし方を解説します（Windows11向け）

PHPのfile_exists関数を解説
相対パス絶対パスともに、ファイルもディレクトリの存在チェックができていることが確認できました。

まとめ：file_exists関数を使ってみよう！

以上がfile_exists関数についての解説でした！

あなたのご参考になったのなら、とても嬉しいです(*´▽｀*)
ではでは～(・ω・)ﾉｼ