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

getPathnameメソッドは、DirectoryIteratorオブジェクトが現在指し示しているファイルまたはディレクトリの完全なパス名を取得するメソッドです。このメソッドは、ファイルシステム上でのその要素の正確な位置を文字列として返します。

DirectoryIteratorクラスは、特定のディレクトリ内のファイルやサブディレクトリといったエントリを一つずつ繰り返し処理する際に使用されます。その際、各エントリが具体的にどの場所に存在するのか、つまりそのファイルシステム上のフルパスを知りたい場合に、このgetPathnameメソッドが非常に役立ちます。

getPathnameメソッドは引数を一切取りません。戻り値は常に文字列型で、例えば「/path/to/directory/filename.txt」のような形式で、ディレクトリ構造を含んだ完全なパスが提供されます。

DirectoryIteratorクラスには、ファイル名やディレクトリ名のみを返すgetName()メソッドも存在しますが、getPathname()メソッドはディレクトリパスを含めた完全なパスを返す点が異なります。これにより、取得したパス情報を基に、ファイルの読み書きや、特定のファイルに対する移動・削除といった操作を正確に行うことが可能になります。システムエンジニアを目指す方にとって、ファイルシステムの操作は基本的なスキルであり、このメソッドはファイルの場所を正確に把握し、プログラムで利用するために不可欠なツールとなります。

Copy
1<?php
2$directoryIterator = new DirectoryIterator('.');
3echo $directoryIterator->getPathname();
4?>

引数なし

引数はありません

string

DirectoryIterator::getPathname() は、現在のファイルまたはディレクトリの絶対パスを文字列で返します。