【PHP8.x】getPathnameメソッドの使い方
getPathnameメソッドの使い方について、初心者にもわかりやすく解説します。
基本的な使い方
getPathnameメソッドは、FilesystemIteratorクラスにおいて、現在のイテレータ位置にある要素(ファイルまたはディレクトリ)の完全なパス名を取得するメソッドです。FilesystemIteratorは、指定されたディレクトリ内のファイルやサブディレクトリを繰り返し処理する(イテレートする)ためのPHPの組み込みクラスです。このメソッドは、イテレータがディレクトリを巡回する過程で、現在フォーカスしているファイルやディレクトリの、ルートからその項目までの絶対的な経路(パス名)を文字列として提供します。
返されるパス名は、例えば「/var/www/html/index.php」のように、ディレクトリ名とファイル名を結合した完全な形式になります。これにより、アプリケーションは特定のファイルやディレクトリがファイルシステム上のどこに存在するかを正確に把握し、その情報に基づいてファイルの読み書き、移動、削除といった操作を簡単に行うことができます。例えば、Webサーバーのログファイルを処理するスクリプトや、特定のディレクトリ以下にある画像ファイルを一括でリサイズするようなシステムを構築する際に、各ファイルの正確なパス名が必要となります。getPathnameメソッドは、このようなファイルパスに基づく処理を効率的かつ正確に実装するための重要な手段となります。このメソッドは、イテレータの現在位置が有効である場合にのみ、意味のあるパス名を返します。
構文(syntax)
1<?php 2$iterator = new FilesystemIterator(__DIR__); 3foreach ($iterator as $fileInfo) { 4 echo $fileInfo->getPathname() . "\n"; 5} 6?>
引数(parameters)
引数なし
引数はありません
戻り値(return)
string
FilesystemIterator::getPathname は、現在のファイルまたはディレクトリの絶対パスを文字列で返します。