PHPでファイルの存在を確認する関数の使い方を現役エンジニアが解説【初心者向け】

初心者向けにPHPでファイルの存在を確認する関数の使い方について解説しています。ファイルの存在を確認するにはfile_existsメソッドを使います。引数に指定したファイルパスやファイル名のファイルがあるかどうか判定することが出来ます。

TechAcademyマガジンはオンラインのプログラミングスクールTechAcademy [テックアカデミー]が運営する教育×テクノロジーのWebメディアです。初心者でもすぐ勉強できる記事が2,000以上あります。

今回は、PHPでファイルの存在を確認する関数の使い方について解説します。

 

なお本記事は、TechAcademyのPHP/Laravel講座の内容をもとに紹介しています。

 

田島悠介

今回は、PHPに関する内容だね!

大石ゆかり

どういう内容でしょうか?

田島悠介

PHPでファイルの存在を確認する関数の使い方について詳しく説明していくね!

大石ゆかり

お願いします!

 

file_existsとは

file_existsは、PHPでファイルまたはディレクトリの存在を確認する関数です。

ファイルとは、index.phpなどのプログラムファイルや、test.jpgなどの画像ファイルなどがあります。ディレクトリとは、フォルダと同じような意味です。サーバ上でフォルダを扱う場合、ディレクトリと呼ぶというイメージで覚えておくと良いですよ。

file_existsとは、php4系、php5系、php7系で利用することができます。

file_exitsについての公式ページ

 

どんな時に必要?

ファイルやディレクトリの存在を確認する場合としては、ファイルをアップロードする場合です。ファイルをアップロードする場合には次のような確認が必要です。

①アップロードしようとするファイルが存在するか

アップロードしようとしたファイルが、プログラムの途中で無くなった場合、アップロード自体が失敗します。

そのため、アップロード処理の途中で、一度アップロードしようとしているファイルが存在しているかの確認処理をしながら、処理を進めていくと確実です。

 

②アップロードしようとした先のディレクトリが存在するか

アップロードファイルが存在しても、アップロード先のディレクトリが存在しない場合は、アップロードが完了しません。

アップロード先のディレクトリの存在は必ず確認する必要があります。

 

[PR] PHPのプログラミングで挫折しない学習方法を動画で公開中

実際に書いてみよう

今回は画像ファイルが存在するかどうかを書いてみます。

サンプルプログラム

<?php
$filename = '/path/techacademy.jpg';
if (file_exists($filename)) {
  echo "$filename が存在します";
  } else {
  echo "$filename は存在しません";
  }
?>

 

解説

1行目の<?phpでは、このプログラムがphpプログラムであることを意味します。

2行目の$filename = ‘/path/techacademy.jpg’;では、pathというディレクトリの中にある、techacademy.jpgという写真のパスを変数$filenameに代入しています。

パスとは、ファイルやディレクトリの場所を示す住所のようなものです。変数とは、値を入れる箱のようなものです。

3行目のif (file_exists($filename)) {では、file_exists関数を利用して変数$filenameに入っているパスの画像が存在しているかを判断しています。存在している場合は、trueを返します。存在していない場合は、falseを返します。

4行目のecho “$filename が存在します”;では、ファイルが存在した場合、存在した旨を表示するecho処理を行っています。

5行目の} else {では、3行目のif文条件式に合致しない、ファイルが存在していない場合の条件を意味します。

6行目のecho “$filename は存在しません”;では、ファイルが存在しない旨を表示しています。

7行目の}では、3行目のif文が終了したことを意味します。

8行目の?>では、phpプログラムが終了したことを意味します。

今回は、PHPでファイルの存在を確認する関数の使い方を解説しました。

 

筆者プロフィール

中本賢吾(なかもとけんご)

アジマッチ有限会社 代表取締役社長

開発実績:PHPフレームワークを利用した会員制SNS・ネットショップ構築、AWSや専用サーバー下でLinuxを使用したセキュアな環境構築、人工知能を利用したシステム開発、店舗検索スマホアプリ開発など。

地域の職業プログラマー育成活動では、小学生がオリジナルAndroidアプリをGooglePlayでリリース、NHK Whyプログラミング入賞、全国Programing Festival入賞。ゲームで遊ぶより作ろうぜ!を合言葉に、小学生でも起業できる技術力を育成可能で有ることを証明し続けている。

 

大石ゆかり

内容分かりやすくて良かったです!

田島悠介

ゆかりちゃんも分からないことがあったら質問してね!

大石ゆかり

分かりました。ありがとうございます!

オンラインのプログラミングスクールTechAcademyではオンラインブートキャンプPHP/Laravelコースを提供しています。

PHPやフレームワークのLaravelを使ってWebアプリケーションの開発を学ぶことができます。

現役エンジニアがパーソナルメンターとして受講生に1人ずつつき、マンツーマンのメンタリングで学習をサポートし、最短4週間で習得することが可能です。

また、現役エンジニアから学べる無料のプログラミング体験会も実施しているので、ぜひ参加してみてください。