読み込み中...

PHPで簡単! 存在チェックの方法10選

PHPで簡単に存在チェックを行う方法を紹介する記事のサムネイル PHP
2023.05.15
この記事は約5分で読めます。

【サイト内のコードはご自由に個人利用・商用利用いただけます】

この記事では、プログラムの基礎知識を前提に話を進めています。

説明のためのコードや、サンプルコードもありますので、もちろん初心者でも理解できるように表現してあります。

本記事のサンプルコードを活用して機能追加、目的を達成できるように作ってありますので、是非ご活用ください。

※この記事は、一般的にプロフェッショナルの指標とされる『実務経験10,000時間以上』を満たす現役のプログラマチームによって監修されています。

※Japanシーモアは、常に解説内容のわかりやすさや記事の品質に注力しております。不具合、分かりにくい説明や不適切な表現、動かないコードなど気になることがございましたら、記事の品質向上の為にお問い合わせフォームにてご共有いただけますと幸いです。
(送信された情報は、プライバシーポリシーのもと、厳正に取扱い、処分させていただきます。)

はじめに

この記事を読めば、PHPで存在チェックを行う方法が簡単にできるようになります。

これからPHPを学びたいと考えている初心者の方や、存在チェックの方法を知りたい方向けに、10の実用的な方法を徹底解説していきます。

●存在チェックの基本

PHPで存在チェックを行う方法はいくつかあります。

ここでは、よく使われる存在チェックの方法を紹介していきます。

○変数の存在チェック

isset()関数を使って変数の存在チェックを行います。

$variable = "Hello, World!";
if (isset($variable)) {
  echo "変数が存在します。";
} else {
  echo "変数が存在しません。";
}

○配列のキーの存在チェック

array_key_exists()関数を使って配列のキーの存在チェックを行います。

$array = ["apple" => 1, "banana" => 2, "orange" => 3];
if (array_key_exists("apple", $array)) {
  echo "キーが存在します。";
} else {
  echo "キーが存在しません。";
}

○ファイルの存在チェック

file_exists()関数を使ってファイルの存在チェックを行います。

このコードでは、ファイルが存在するかどうかを確認しています。

$filename = "sample.txt";
if (file_exists($filename)) {
  echo "ファイルが存在します。";
} else {
  echo "ファイルが存在しません。";
}

○ディレクトリの存在チェック

is_dir()関数を使ってディレクトリの存在チェックを行います。

このコードでは、ディレクトリが存在するかどうかを確認しています。

$directory = "sample_directory";
if (is_dir($directory)) {
  echo "ディレクトリが存在します。";
} else {
  echo "ディレクトリが存在しません。";
}

○関数の存在チェック

function_exists()関数を使って関数の存在チェックを行います。

このコードでは、関数が存在するかどうかを確認しています。

if (function_exists('array_key_exists')) {
  echo "関数が存在します。";
} else {
  echo "関数が存在しません。";
}

○クラスの存在チェック

class_exists()関数を使ってクラスの存在チェックを行います。

このコードでは、クラスが存在するかどうかを確認しています。

if (class_exists('DateTime')) {
  echo "クラスが存在します。";
} else {
  echo "クラスが存在しません。";
}

○プロパティの存在チェック

property_exists()関数を使ってプロパティの存在チェックを行います。

このコードでは、プロパティが存在するかどうかを確認しています。

class SampleClass {
  public $property1;
  private $property2;
}

$sample_object = new SampleClass();
if (property_exists($sample_object, 'property1')) {
  echo "プロパティが存在します。";
} else {
  echo "プロパティが存在しません。";
}

○メソッドの存在チェック

method_exists()関数を使ってメソッドの存在チェックを行います。

このコードでは、メソッドが存在するかどうかを確認しています。

class SampleClass {
  public function method1() {}
  private function method2() {}
}

$sample_object = new SampleClass();
if (method_exists($sample_object, 'method1')) {
  echo "メソッドが存在します。";
} else {
  echo "メソッドが存在しません。";
}

●注意点と対処法

存在チェックを行う際には、関数やクラス名を正確に入力することが重要です。

また、存在チェックが失敗した場合の処理も適切に行いましょう。

●応用例とサンプルコード

各存在チェックの応用例を確認していきましょう。

ここでは、ユーザーからのフォーム入力値やAPIのレスポンスに対する存在チェックの方法について説明します。

○フォーム入力値の存在チェック

フォームからの入力が存在するかどうかを確認するためには、isset()関数またはempty()関数を使用します。

このコードでは、POSTメソッドで送られてきたフォームの入力値が存在するかどうかを確認しています。

if (isset($_POST['input_name'])) {
    echo "入力値が存在します。";
} else {
    echo "入力値が存在しません。";
}

○APIレスポンスの存在チェック

APIからのレスポンスに特定のキーが存在するかどうかを確認するためには、array_key_exists()関数を使用します。

このコードでは、APIから取得した配列に特定のキーが存在するかどうかを確認しています。

$response = api_call(); // 何らかのAPI呼び出しを行い、そのレスポンスを取得する想定

if (array_key_exists('target_key', $response)) {
    echo "キーが存在します。";
} else {
    echo "キーが存在しません。";
}

まとめ

存在チェックは、プログラムを安全に運用するために重要な手段です。

これを適切に行うことで、エラーを未然に防ぐことが可能になります。

また、存在チェックは多くの場合、関数やメソッドの引数が期待する形式であることを保証するためにも用いられます。

さまざまな存在チェックの方法を理解し、適切に使用しましょう。