Webエンジニア向けプログラミング解説動画をYouTubeで配信中!
▶ チャンネル登録はこちら

【PHP8.x】isReadableメソッドの使い方

isReadableメソッドの使い方について、初心者にもわかりやすく解説します。

作成日: 更新日:

基本的な使い方

isReadableメソッドは、RecursiveDirectoryIteratorクラスに属し、現在指し示しているファイルまたはディレクトリが読み取り可能であるかを確認するメソッドです。このメソッドは、ファイルシステム上の特定のパスに対して、PHPスクリプトがその内容を読み取る権限を持っているかどうかを判定するために使用されます。

RecursiveDirectoryIteratorクラスは、ディレクトリとそのサブディレクトリを再帰的に走査する際に利用され、isReadableメソッドは、イテレータが現在指している要素(ファイルやディレクトリ)が読み取り可能かどうかをチェックする役割を担います。例えば、あるファイルを開いてその内容を読み取ろうとする前に、事前にこのメソッドで読み取り権限の有無を確認することができます。これにより、読み取り権限がないファイルに対して不必要な処理を試みたり、エラーが発生したりするのを防ぐことが可能です。

このメソッドは、対象のファイルまたはディレクトリが読み取り可能であればブール値のtrueを返し、そうでない場合はfalseを返します。このチェックは、ファイル処理の信頼性を高め、予期せぬ権限エラーによるプログラムの中断を防ぐ上で非常に有効です。特に、サーバー上で動くWebアプリケーションなど、様々な環境でファイルアクセスを行うシステムを構築する際に、安全なファイル操作を実現するための基礎的な確認として活用されます。

構文(syntax)

1<?php
2$iterator = new RecursiveDirectoryIterator('.');
3$isReadable = $iterator->isReadable();
4
5if ($isReadable) {
6    echo "Readable.\n";
7} else {
8    echo "Not readable.\n";
9}

引数(parameters)

引数なし

引数はありません

戻り値(return)

bool

指定されたディレクトリまたはファイルが読み取り可能である場合に true を返します。読み取り不可能な場合は false を返します。