MENU
  1. ホーム
  2. PHP
  3. PHPでファイルの更新日時を取得する方法（filemtime関数の使い方を徹底解説）

PHPでファイルの更新日時を取得する方法（filemtime関数の使い方を徹底解説）

PHP

PHPでファイルの更新日時を取得する際に便利な関数の一つがfilemtimeです。この関数は、特定のファイルが最後に変更された日時を取得するために使用されます。例えば、ウェブサイトのキャッシュを管理したり、定期的にファイルを更新する自動化スクリプトで活用できます。filemtimeを使うことで、ファイルがいつ更新されたかを簡単に把握し、それに応じた処理を行うことが可能です。本記事では、filemtime関数の基本的な使い方から、応用例や注意点に至るまでを解説し、効率的なファイル管理方法を習得できる内容をお届けします。

目次

filemtime関数の基本的な使い方


filemtime関数は、指定したファイルの更新日時を取得するためのPHP関数です。使い方は非常にシンプルで、ファイルのパスを引数に渡すだけで、更新日時がUNIXタイムスタンプ形式で返されます。このタイムスタンプは、1970年1月1日からの経過秒数で表されており、後で読みやすい日付形式に変換して利用できます。

構文


filemtime関数の基本的な構文は以下の通りです。

filemtime(string $filename): int|false

引数として指定する$filenameには、更新日時を取得したいファイルのパスを入力します。関数が正常に実行されると、そのファイルの更新日時がタイムスタンプとして返され、ファイルが存在しない場合はfalseが返されます。

実行例：filemtime関数での日時取得


ここでは、filemtime関数を使ってファイルの更新日時を取得する具体的な例を紹介します。実行例を見ることで、関数の動作や出力がどのようなものか理解しやすくなります。

サンプルコード

以下のコードは、example.txtというファイルの更新日時を取得し、出力するものです。

<?php
$filename = 'example.txt';

if (file_exists($filename)) {
    $lastModified = filemtime($filename);
    echo "ファイルの更新日時 (UNIXタイムスタンプ): " . $lastModified . "\n";
    echo "人間が読める形式の更新日時: " . date("Y-m-d H:i:s", $lastModified) . "\n";
} else {
    echo "ファイルが存在しません。";
}
?>

コードの解説

  1. まず、変数$filenameに対象ファイル名を代入します。
  2. file_exists関数でファイルの存在を確認し、存在する場合はfilemtimeで更新日時を取得します。
  3. filemtime関数で得られたタイムスタンプは、date関数を使って「YYYY-MM-DD HH:MM:SS」の形式に変換しています。

出力例

このコードを実行すると、例えば以下のような出力が得られます。

ファイルの更新日時 (UNIXタイムスタンプ): 1672505600
人間が読める形式の更新日時: 2023-01-01 12:00:00

このように、filemtime関数を使用することで、簡単にファイルの更新日時を取得でき、人間が読める形式にも変換できるため、幅広いシーンで活用できます。

filemtimeの返り値の扱い方


filemtime関数の返り値は、ファイルの更新日時をUNIXタイムスタンプ形式で返します。このタイムスタンプは、1970年1月1日からの経過秒数を示しており、直接では人間が読みやすい形式ではありません。ファイル更新の正確な日時や日付として表示するには、返り値のタイムスタンプを変換して扱う必要があります。

UNIXタイムスタンプの用途


UNIXタイムスタンプは、特定の日付や時刻と比較したり、時間間隔を計算したりする場合に非常に便利です。例えば、ファイルがある時点以降に更新されたかどうかを確認したり、一定期間内に更新されたファイルを絞り込むなどの操作に利用できます。

返り値の変換


タイムスタンプを人間が読める形式に変換するには、PHPのdate関数を使います。例えば、Y-m-d H:i:sのフォーマットを使えば、「年-月-日 時:分:秒」の形式で日時を表示できます。

$lastModified = filemtime($filename);
echo "更新日時: " . date("Y-m-d H:i:s", $lastModified);

このコードにより、更新日時が「2023-01-01 12:00:00」のような形式で表示され、よりわかりやすくなります。

エラー処理について


filemtime関数が失敗すると、falseが返されます。これにより、ファイルが存在しない場合や読み取りエラーが発生した際に通知が得られます。返り値を利用する際には、必ずfalseかどうかを確認することが推奨されます。

if ($lastModified === false) {
    echo "ファイルの更新日時を取得できませんでした。";
}

このように、返り値を確認することで、確実かつ安全にファイルの更新日時を取得し利用できるようになります。

UNIXタイムスタンプを人間が読める形式に変換する方法


filemtime関数で取得したUNIXタイムスタンプは、通常の日時形式に変換しなければ、人間には解読しにくい数値です。PHPでは、date関数を使用して、タイムスタンプを簡単に可読な形式に変換することができます。

date関数を用いた変換


PHPのdate関数を利用することで、タイムスタンプを様々なフォーマットで表示可能です。以下のように、date関数でタイムスタンプを指定することで、必要な形式に変換できます。

$timestamp = filemtime($filename);
$formattedDate = date("Y-m-d H:i:s", $timestamp);
echo "更新日時: " . $formattedDate;

上記の例では、Y-m-d H:i:sを指定することで「年-月-日 時:分:秒」の形式で出力しています。

主な日付フォーマットの例


date関数はフォーマット指定子を用いて、さまざまな形式に変換できます。以下は、よく使用されるフォーマットの例です。

  • Y-m-d H:i:s ： 2023-01-01 12:00:00
  • d/m/Y H:i ： 01/01/2023 12:00
  • l, F j, Y ： Monday, January 1, 2023
  • D, M j Y H:i:s ： Mon, Jan 1 2023 12:00:00

date関数の応用：ロケール設定


場合によっては、日付を日本語表記や他の言語にする必要があります。その場合、setlocaleとstrftime関数を組み合わせることで、タイムスタンプをローカライズされた形式で出力できます。

setlocale(LC_TIME, 'ja_JP.UTF-8');
echo strftime("%Y年%m月%d日 %H時%M分%S秒", $timestamp);

このコードを使用すると、例えば「2023年01月01日 12時00分00秒」といった形式で日本語表示されます。

注意点


サーバーのタイムゾーン設定に依存するため、日時が異なる場合はdate_default_timezone_setを使用して、目的のタイムゾーンを設定すると良いでしょう。例えば、日本標準時に設定するには以下のコードを使用します。

date_default_timezone_set('Asia/Tokyo');

このようにして、タイムスタンプを容易に読みやすい日時に変換し、ファイルの更新状況を把握しやすくすることができます。

ファイルの存在確認とエラーハンドリング


filemtime関数は、指定したファイルの更新日時を取得しますが、ファイルが存在しない場合にはfalseを返します。このような状況に備えて、ファイルの存在確認とエラーハンドリングを適切に行うことで、エラーの回避とユーザーへの適切なフィードバックが可能になります。

ファイルの存在確認


PHPのfile_exists関数を使うと、ファイルが存在するかどうかを事前に確認できます。filemtimeを使用する前に、file_existsを用いることで、ファイルがない場合のエラーを未然に防げます。

$filename = 'example.txt';

if (file_exists($filename)) {
    $lastModified = filemtime($filename);
    echo "更新日時: " . date("Y-m-d H:i:s", $lastModified);
} else {
    echo "指定したファイルが存在しません。";
}

このコードでは、file_existsがfalseを返した場合に「指定したファイルが存在しません」と表示され、filemtimeのエラー発生を防ぎます。

filemtimeのエラーハンドリング


filemtime関数自体がfalseを返すケースに備え、返り値をチェックする方法も重要です。file_existsでの確認後、万が一filemtimeが失敗した場合にも対応できるように、以下のコードのようにエラーハンドリングを追加できます。

$lastModified = filemtime($filename);

if ($lastModified !== false) {
    echo "更新日時: " . date("Y-m-d H:i:s", $lastModified);
} else {
    echo "ファイルの更新日時を取得できませんでした。";
}

このように、filemtimeの返り値を確認することで、ファイルが存在しない場合やファイルアクセスに問題がある場合に対応可能です。

例外的なケースの考慮


特定のアクセス権限やファイルの状態によっては、ファイルが存在してもfilemtimeでエラーが発生することがあります。例えば、サーバー設定やユーザーのアクセス権限により、読み取り権限が制限されている場合です。このような状況では、filemtimeが失敗する可能性があるため、関数の結果をしっかりと確認し、適切なメッセージを表示することが望ましいです。

エラーハンドリングを効果的に行うポイント


ファイルの存在確認とfilemtimeの返り値チェックの両方を組み合わせることで、信頼性の高いエラーハンドリングが実現します。こうすることで、ユーザーは問題が発生した場合でも原因を把握しやすくなり、プログラムの利用がスムーズになります。

更新日時を条件としたファイル操作の応用例


filemtime関数を活用することで、ファイルの更新日時に基づいたさまざまな操作が可能になります。特に、ファイル管理や自動化スクリプトにおいて、更新日時を条件にした処理を行うことは非常に有用です。以下では、具体的な応用例をいくつか紹介します。

1. 一定期間内に更新されたファイルの抽出


特定の期間内に更新されたファイルを抽出することで、例えばバックアップやログ管理を効率化できます。以下のコードでは、指定したディレクトリ内のファイルをスキャンし、過去7日以内に更新されたファイルをリストアップします。

$directory = 'path/to/directory/';
$files = scandir($directory);
$recentFiles = [];

foreach ($files as $file) {
    $fullPath = $directory . $file;
    if (is_file($fullPath) && (filemtime($fullPath) > (time() - 7 * 24 * 60 * 60))) {
        $recentFiles[] = $file;
    }
}

echo "過去7日以内に更新されたファイル:\n";
foreach ($recentFiles as $recentFile) {
    echo $recentFile . "\n";
}

このスクリプトは、指定したディレクトリ内のファイルを確認し、filemtimeを使用して過去7日以内に更新されたファイルの名前を表示します。

2. 更新日時に基づくファイルの削除


特定の条件を満たさないファイルを削除することで、ディスクスペースを節約したり、不要なデータを整理することができます。例えば、90日以上更新されていないファイルを削除する場合のコードは以下の通りです。

$directory = 'path/to/directory/';
$files = scandir($directory);

foreach ($files as $file) {
    $fullPath = $directory . $file;
    if (is_file($fullPath) && (filemtime($fullPath) < (time() - 90 * 24 * 60 * 60))) {
        unlink($fullPath); // ファイルを削除
        echo $file . "を削除しました。\n";
    }
}

このスクリプトは、指定したディレクトリ内のファイルを確認し、filemtimeを使用して90日以上更新されていないファイルを削除します。

3. 更新日時を記録したログファイルの管理


ファイルの更新履歴をログに記録することも有用です。以下のコードは、更新日時を記録したログファイルを生成する例です。

$logFile = 'update_log.txt';
$directory = 'path/to/directory/';
$files = scandir($directory);

foreach ($files as $file) {
    $fullPath = $directory . $file;
    if (is_file($fullPath)) {
        $lastModified = filemtime($fullPath);
        $logEntry = $file . " - " . date("Y-m-d H:i:s", $lastModified) . "\n";
        file_put_contents($logFile, $logEntry, FILE_APPEND);
    }
}

echo "更新履歴がログファイルに記録されました。";

このスクリプトは、指定したディレクトリ内の各ファイルの更新日時を取得し、update_log.txtに記録します。

まとめ


filemtime関数を活用することで、ファイルの更新日時に基づいた様々な操作が可能になります。これにより、ファイル管理の効率化や不要データの整理、自動化スクリプトの構築が容易になります。特に、大量のファイルを扱う環境では、更新日時の管理が非常に重要です。

filemtimeと他のファイル操作関数との違い


PHPにはファイルの管理や情報取得のための多くの関数が用意されていますが、filemtimeはその中でも特にファイルの更新日時を取得するために特化した関数です。他の関連する関数との違いや使い方を理解することで、より効果的にファイル操作を行うことができます。

1. filectime関数との違い


filectime関数はファイルの「変更日時」を取得しますが、filemtimeが取得するのは「最終更新日時」です。これらの違いは重要であり、次のような状況で使い分ける必要があります。

  • filemtime：ファイルが最後に書き込まれた日時を取得。ファイル内容の変更を反映。
  • filectime：ファイルのメタデータ（アクセス権の変更、名前の変更など）を含む最終変更日時を取得。
$filename = 'example.txt';

$lastModified = filemtime($filename);
$lastChanged = filectime($filename);

echo "最終更新日時: " . date("Y-m-d H:i:s", $lastModified) . "\n";
echo "変更日時: " . date("Y-m-d H:i:s", $lastChanged) . "\n";

2. filesize関数との違い


filesize関数は、指定したファイルのサイズをバイト単位で取得します。これに対して、filemtimeはファイルの更新日時を取得するため、異なる情報を提供します。ファイルのサイズが重要な場合にはfilesizeを使用し、更新日時が重要な場合にはfilemtimeを使用します。

$fileSize = filesize($filename);
echo "ファイルサイズ: " . $fileSize . " バイト\n";

3. fopen関数との違い


fopen関数はファイルを開くための関数で、ファイルの読み取りや書き込みを行うために使用されます。一方、filemtimeはファイルを開かずに、その情報を取得します。ファイルの操作を行う前に、その状態を確認するためにfilemtimeを使用することが一般的です。

$handle = fopen($filename, 'r');
// ファイル操作
fclose($handle);

4. stat関数との違い


stat関数は、指定したファイルに関する多くの情報（サイズ、更新日時、アクセス日時など）を取得することができます。filemtimeはその中の一部で、最終更新日時だけを返します。複数の情報を取得したい場合はstatを使い、特定の情報だけを取得したい場合はfilemtimeを使用すると良いでしょう。

$fileStats = stat($filename);
echo "最終更新日時: " . date("Y-m-d H:i:s", $fileStats['mtime']) . "\n";

まとめ


filemtimeはファイルの更新日時を取得するための便利な関数ですが、他のファイル操作関数との違いを理解することで、より効果的にファイル管理を行うことができます。必要な情報に応じて適切な関数を選択することで、プログラムの効率と可読性を向上させることができます。

自動化スクリプトでのfilemtimeの活用法


filemtime関数は、自動化スクリプトにおいてファイルの管理やメンテナンスを効率化するために非常に便利です。ここでは、定期的に実行されるスクリプト内での具体的な活用方法をいくつか紹介します。

1. 定期的なバックアップスクリプトの作成


特定のディレクトリ内のファイルを定期的にバックアップするスクリプトにおいて、filemtimeを利用して更新日時を確認することで、必要なファイルだけをバックアップ対象にすることができます。以下は、更新されたファイルのみをバックアップするサンプルコードです。

$sourceDir = 'path/to/source/';
$backupDir = 'path/to/backup/';
$files = scandir($sourceDir);

foreach ($files as $file) {
    $fullPath = $sourceDir . $file;
    if (is_file($fullPath) && (filemtime($fullPath) > (time() - 7 * 24 * 60 * 60))) {
        copy($fullPath, $backupDir . $file); // 更新されたファイルをバックアップ
        echo $file . "をバックアップしました。\n";
    }
}

このスクリプトは、過去7日以内に更新されたファイルのみをバックアップディレクトリにコピーします。

2. 定期的なログファイルのローテーション


サーバーやアプリケーションのログファイルを定期的にローテーション（古いログをアーカイブして新しいログを開始すること）するためのスクリプトも、filemtimeを利用して実装できます。

$logFile = 'path/to/logfile.log';
$archiveDir = 'path/to/archive/';
$maxAgeDays = 30;

if (file_exists($logFile) && (filemtime($logFile) < (time() - $maxAgeDays * 24 * 60 * 60))) {
    rename($logFile, $archiveDir . 'logfile_' . date("Ymd_His") . '.log'); // 古いログをアーカイブ
    echo "古いログファイルをアーカイブしました。\n";
}

このコードは、ログファイルが30日以上古い場合に、そのファイルをアーカイブします。

3. ファイル変更監視スクリプト


filemtimeを用いて、特定のファイルの変更を監視し、変更があった場合に通知を行うスクリプトを作成することも可能です。以下は、指定したファイルの更新をチェックし、変更があった場合にメール通知を送信する例です。

$watchedFile = 'path/to/watchedfile.txt';
$lastModifiedTime = filemtime($watchedFile);

while (true) {
    sleep(60); // 1分毎にチェック
    if (filemtime($watchedFile) > $lastModifiedTime) {
        mail('user@example.com', 'ファイルが変更されました', 'ファイルが更新されました: ' . $watchedFile);
        $lastModifiedTime = filemtime($watchedFile);
        echo "変更を通知しました。\n";
    }
}

このスクリプトは、1分ごとに指定されたファイルを監視し、変更があった場合にメール通知を送信します。

まとめ


filemtime関数を利用することで、自動化スクリプト内でのファイル管理が大幅に効率化されます。バックアップ、ログのローテーション、ファイルの監視など、様々な場面で活用することで、システムの運用がスムーズになります。これにより、手動での管理が必要なくなり、作業の負担を軽減できます。

実践演習：特定の期間内に更新されたファイルを一覧表示


filemtime関数を使用して、特定の期間内に更新されたファイルを一覧表示する実践的な演習を行います。この演習を通じて、ファイルの管理やメンテナンスを効率化するスクリプトの作成を学ぶことができます。

演習の目的

  • 指定したディレクトリ内のファイルの更新日時を取得する。
  • 一定の期間（例えば、過去7日間）内に更新されたファイルをリストアップする。
  • 結果を画面に表示する。

ステップ1: スクリプトの準備


まず、PHPのスクリプトを作成するためのファイルを用意します。ファイル名をlist_recent_files.phpとしましょう。

<?php
// スクリプトの内容はここに記載します。
?>

ステップ2: ディレクトリの指定


次に、ファイルを検索するディレクトリを指定します。この例では/path/to/directory/というディレクトリを使用します。

$directory = '/path/to/directory/';

ステップ3: ファイルのスキャンと更新日時の確認


指定したディレクトリ内のファイルをスキャンし、各ファイルの更新日時を確認します。過去7日以内に更新されたファイルをリストアップするために、scandir関数とfilemtimeを使用します。

$files = scandir($directory);
$recentFiles = [];
$timeLimit = time() - (7 * 24 * 60 * 60); // 過去7日間のタイムスタンプ

foreach ($files as $file) {
    $fullPath = $directory . $file;
    if (is_file($fullPath) && filemtime($fullPath) > $timeLimit) {
        $recentFiles[] = $file; // 更新されたファイルを配列に追加
    }
}

ステップ4: 結果の表示


最後に、過去7日以内に更新されたファイルのリストを表示します。

if (!empty($recentFiles)) {
    echo "過去7日以内に更新されたファイル:\n";
    foreach ($recentFiles as $recentFile) {
        echo $recentFile . "\n";
    }
} else {
    echo "過去7日以内に更新されたファイルはありません。";
}

ステップ5: 完成したスクリプト


全てのステップを組み合わせると、以下のような完成したスクリプトになります。

<?php
$directory = '/path/to/directory/';
$files = scandir($directory);
$recentFiles = [];
$timeLimit = time() - (7 * 24 * 60 * 60); // 過去7日間のタイムスタンプ

foreach ($files as $file) {
    $fullPath = $directory . $file;
    if (is_file($fullPath) && filemtime($fullPath) > $timeLimit) {
        $recentFiles[] = $file; // 更新されたファイルを配列に追加
    }
}

if (!empty($recentFiles)) {
    echo "過去7日以内に更新されたファイル:\n";
    foreach ($recentFiles as $recentFile) {
        echo $recentFile . "\n";
    }
} else {
    echo "過去7日以内に更新されたファイルはありません。";
}
?>

ステップ6: 実行


このスクリプトをウェブサーバー上で実行するか、CLI環境で実行することで、指定したディレクトリ内の過去7日間に更新されたファイルの一覧を確認できます。

まとめ


この演習を通じて、filemtimeを用いたファイルの更新日時の取得方法や、条件に基づいたファイルの管理方法を学ぶことができました。自動化スクリプトに組み込むことで、ファイル管理を効率化し、業務の生産性を向上させることができます。

注意点：OSによる動作の違いとその対処


filemtime関数は、ファイルの更新日時を取得するための便利なツールですが、使用する環境によって動作に違いが出ることがあります。特に、異なるオペレーティングシステム（OS）での動作やファイルシステムによる影響を理解し、適切な対処を行うことが重要です。

1. ファイルシステムの違い


ファイルの更新日時は、使用されるファイルシステムによって異なる場合があります。例えば、NTFS（Windows）やEXT4（Linux）など、各ファイルシステムがファイルのメタデータを管理する方法が異なるため、filemtimeで取得する情報に影響を与えることがあります。特に、ファイルが移動されたりコピーされたりすると、更新日時が変わることがあります。

2. タイムゾーンの設定


サーバーのタイムゾーン設定によって、取得される日時の表示形式や内容が異なる場合があります。特に、date関数を使用してタイムスタンプをフォーマットする際に、タイムゾーンが考慮されるため、設定に注意が必要です。PHPでは、以下のようにタイムゾーンを設定できます。

date_default_timezone_set('Asia/Tokyo');

これにより、特定の地域のタイムゾーンに基づいた正確な日時を表示できます。

3. パーミッションの影響


ファイルのアクセス権限が不足している場合、filemtimeが正しく動作しないことがあります。特に、PHPスクリプトが実行されるユーザーに対して、ファイルの読み取り権限がない場合、filemtimeはfalseを返します。ファイルのパーミッション設定を確認し、必要に応じて調整することが重要です。

if (!is_readable($filename)) {
    echo "ファイルにアクセスできません。パーミッションを確認してください。";
}

4. エラーハンドリングの実装


filemtimeが失敗した場合のエラーハンドリングを実装することは、トラブルシューティングのために重要です。返り値がfalseである場合の処理をしっかりと組み込むことで、原因を迅速に特定し、適切な対処を行うことができます。

$lastModified = filemtime($filename);
if ($lastModified === false) {
    echo "ファイルの更新日時を取得できませんでした。";
}

まとめ


filemtimeを使用する際には、OSやファイルシステム、タイムゾーン、パーミッションなどの要因によって動作が変わることを理解することが重要です。これらの注意点を考慮することで、スクリプトの信頼性が向上し、予期しないエラーを未然に防ぐことができます。適切なエラーハンドリングを実装し、必要に応じてパーミッションや設定を見直すことで、filemtimeを効果的に活用できるようになります。

まとめ


本記事では、PHPにおけるfilemtime関数を用いてファイルの更新日時を取得する方法について詳しく解説しました。filemtimeは特定のファイルの更新日時を簡単に取得できるため、ファイル管理やメンテナンスにおいて非常に便利なツールです。

まず、filemtime関数の基本的な使い方から始まり、実行例を通じてその返り値の扱い方や人間が読める形式への変換方法を学びました。また、ファイルの存在確認やエラーハンドリングの重要性についても触れ、スクリプト内での信頼性向上を図りました。

さらに、特定の期間内に更新されたファイルを一覧表示する実践演習を通じて、実用的なスクリプトの作成方法を体験しました。filemtimeを利用したさまざまな応用例を紹介し、自動化スクリプトでの活用法についても考察しました。

最後に、OSによる動作の違いやパーミッション設定、タイムゾーンの影響など、filemtimeを利用する際の注意点をまとめ、信頼性の高いファイル操作を行うためのヒントを提供しました。

これらの知識を活用することで、PHPを用いた効率的なファイル管理が実現できるようになります。今後のプロジェクトでぜひfilemtime関数を活用し、効果的なファイル操作を行ってください。

PHP
ファイル操作 PHP filemtime

コメント

コメントする

目次