【PHP8.x】RecursiveDirectoryIterator::getExtension()メソッドの使い方

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

作成日: 2025年09月11日更新日: 2026年01月02日

基本的な使い方

getExtensionメソッドは、RecursiveDirectoryIteratorクラスのインスタンスが現在指し示しているファイルやディレクトリの拡張子を取得するメソッドです。

RecursiveDirectoryIteratorは、指定されたディレクトリとその配下のすべてのサブディレクトリを順番に走査し、ファイルやディレクトリの情報を効率的に取得するための強力なツールです。このメソッドは、その走査中に現在処理対象となっている要素がファイルである場合に、そのファイル名から拡張子の部分を抽出して文字列として返します。

例えば、「report.pdf」というファイルに対してこのメソッドを呼び出すと、「pdf」という文字列が戻り値として得られます。また、「photo.jpeg」であれば「jpeg」を返します。

もし現在処理中のファイルに拡張子が含まれていない場合や、現在指し示している要素がファイルではなくディレクトリであった場合には、空の文字列が戻り値となります。

このメソッドは特別な引数を必要とせず、RecursiveDirectoryIteratorオブジェクトが持つ内部の状態（現在どのファイルやディレクトリを指しているか）に基づいて拡張子を自動的に判断します。

プログラムがディレクトリ内の多種多様なファイルを分類したり、特定の拡張子を持つファイルだけを選別して処理を実行したりする場面で非常に役立ちます。例えば、画像ファイルだけを別の場所に移動するスクリプトや、ログファイルだけを解析するツールなどを作成する際に、ファイルの種別を判別する重要な手段となります。

構文(syntax)


1<?php
2// RecursiveDirectoryIterator のインスタンスを作成します。
3// 例として、現在のスクリプトが実行されているディレクトリを指定します。
4$directoryIterator = new RecursiveDirectoryIterator(__DIR__);
5
6// イテレータが現在指している要素（初期状態では指定されたディレクトリ自身）の拡張子を取得します。
7// ディレクトリの場合、通常は拡張子がないため空文字列が返されます。
8// もしイテレータが特定のファイルを指すように進められていれば、そのファイルの拡張子が返されます。
9$extension = $directoryIterator->getExtension();
10
11echo "取得された拡張子: " . $extension . "\n";
12?>

引数(parameters)

引数なし

引数はありません

戻り値(return)

string

このメソッドは、現在のファイルシステムのパスから拡張子部分を文字列として返します。例えば、example.txt というファイルであれば、txt という文字列が返されます。

サンプルコード

PHP: RecursiveDirectoryIteratorでファイル拡張子を取得する


1<?php
2
3/**
4 * RecursiveDirectoryIterator::getExtension() メソッドの使用例。
5 * このスクリプトは、実行されているディレクトリとそのサブディレクトリ内の
6 * すべてのファイルおよびディレクトリを走査し、それぞれの拡張子を表示します。
7 *
8 * このスクリプトを実行する前に、以下のようなファイルやディレクトリを
9 * 作成してテストすると、様々なケースを確認できます。
10 * - index.php
11 * - README.md
12 * - .gitignore (拡張子がないファイルの例)
13 * - data/
14 *   - config.json
15 *   - images/
16 *     - logo.png
17 */
18
19// このスクリプトが実行されているディレクトリを対象とします。
20$directoryPath = __DIR__;
21
22try {
23    // RecursiveDirectoryIterator を初期化します。
24    // これにより、指定されたディレクトリを再帰的に走査するための準備をします。
25    // RecursiveDirectoryIterator::SKIP_DOTS フラグは、'.' (現在のディレクトリ) と '..' (親ディレクトリ) の
26    // 特殊なエントリをスキップするために使用されます。
27    $directoryIterator = new RecursiveDirectoryIterator(
28        $directoryPath,
29        RecursiveDirectoryIterator::SKIP_DOTS
30    );
31
32    // RecursiveIteratorIterator は、RecursiveDirectoryIterator をラップして、
33    // サブディレクトリ内まで深く走査できるようにします。
34    // デフォルトでは RecursiveIteratorIterator::SELF_FIRST となり、
35    // ディレクトリ自体とその中のファイル・ディレクトリが順に処理されます。
36    $iterator = new RecursiveIteratorIterator($directoryIterator);
37
38    echo "--- ディレクトリ '{$directoryPath}' 内の要素の拡張子 ---\n";
39
40    // イテレータをループして、各ファイルまたはディレクトリの情報 ($fileInfo) を取得します。
41    foreach ($iterator as $fileInfo) {
42        // getFilename() メソッドで、ファイルまたはディレクトリの名前を取得します。
43        $name = $fileInfo->getFilename();
44
45        // getExtension() メソッドで、要素の拡張子を取得します。
46        // - 通常のファイルの場合、その拡張子（例: "php", "txt", "png"）を返します。
47        // - 拡張子を持たないファイルやディレクトリの場合、空文字列を返します。
48        $extension = $fileInfo->getExtension();
49
50        // 拡張子が空文字列の場合は「なし」と表示します。
51        $displayExtension = empty($extension) ? 'なし' : $extension;
52
53        if ($fileInfo->isDir()) {
54            // 要素がディレクトリの場合
55            echo "  [D] {$name} (拡張子: {$displayExtension})\n";
56        } else {
57            // 要素がファイルの場合
58            echo "  [F] {$name} (拡張子: {$displayExtension})\n";
59        }
60    }
61    echo "--------------------------------------------------\n";
62
63} catch (UnexpectedValueException $e) {
64    // 指定されたパスが存在しない、ディレクトリではない、またはアクセス権がない場合に発生します。
65    echo "エラー: 指定されたパス '{$directoryPath}' は有効なディレクトリではないか、アクセスできません。\n";
66} catch (Exception $e) {
67    // その他の予期せぬエラーが発生した場合。
68    echo "予期せぬエラーが発生しました: " . $e->getMessage() . "\n";
69}

このサンプルコードは、PHPのRecursiveDirectoryIteratorクラスが提供するgetExtension()メソッドの使用例を示しています。このメソッドは、ファイルやディレクトリの拡張子を効率的に取得するために利用されます。

getExtension()メソッドは引数を必要とせず、呼び出されたファイルまたはディレクトリの拡張子を文字列として返します。たとえば、「document.pdf」というファイルからは「pdf」という文字列が返されます。もし拡張子が存在しない場合（例: .gitignoreファイルやディレクトリ自体）、このメソッドは空文字列を返します。

サンプルコードでは、RecursiveDirectoryIteratorとRecursiveIteratorIteratorを組み合わせて、現在のディレクトリとそのサブディレクトリ内にあるすべてのファイルおよびディレクトリを再帰的に走査しています。ループ処理の中で、各要素に対してgetExtension()を呼び出し、その戻り値である拡張子を取得して表示しています。拡張子が空文字列の場合は「なし」と表示することで、初心者の方にも拡張子の有無が分かりやすくなっています。これにより、指定されたディレクトリ構造内の各要素がどのような拡張子を持っているかを一覧で確認することができます。

RecursiveDirectoryIterator::getExtension()は、ファイル名から最後のドット以降の文字列を拡張子として返します。拡張子がないファイル（例：.gitignore）やディレクトリに対しては空文字列を返しますので、結果が空文字列である場合の処理を必ず考慮してください。例えば「.tar.gz」のようなファイルでは「gz」が返される点に注意が必要です。

RecursiveDirectoryIteratorおよびRecursiveIteratorIteratorは、指定されたディレクトリを再帰的に深く走査するため、非常に多数のファイルや深い階層を扱う場合はパフォーマンスへの影響を考慮することが大切です。サンプルコードは__DIR__を使っており、実行する場所によって対象ディレクトリが変わりますのでご注意ください。また、try-catchによるエラーハンドリングは、パスの不正やアクセス権の問題に備え、安全なコードには不可欠です。