【PHP8.x】filectime関数の使い方

Copy
1<?php
2
3/**
4 * filectime と filemtime の違いを示すサンプルコード.
5 *
6 * filectime: ファイルの最終状態変更時刻 (inode の変更).
7 * filemtime: ファイルの内容の最終更新時刻.
8 */
9
10$filename = 'example.txt';
11
12// ファイルが存在しない場合は作成
13if (!file_exists($filename)) {
14    touch($filename);
15}
16
17// 現在時刻を取得
18$now = time();
19
20// ファイルの最終状態変更時刻 (filectime) を取得
21$ctime = filectime($filename);
22
23// ファイルの内容の最終更新時刻 (filemtime) を取得
24$mtime = filemtime($filename);
25
26echo "ファイル名: " . $filename . PHP_EOL;
27echo "現在のタイムスタンプ: " . $now . PHP_EOL;
28echo "最終状態変更時刻 (ctime): " . $ctime . PHP_EOL;
29echo "最終更新時刻 (mtime): " . $mtime . PHP_EOL;
30
31// ファイルを更新する (mtime を変更)
32touch($filename);
33
34// 更新後の時刻を取得
35$new_mtime = filemtime($filename);
36
37echo "ファイルを更新しました." . PHP_EOL;
38echo "新しい最終更新時刻 (mtime): " . $new_mtime . PHP_EOL;
39echo "最終状態変更時刻 (ctime) はtouch()によって更新される可能性がある: " . filectime($filename) . PHP_EOL;
40
41// ファイルの属性を変更する (ctime を変更)
42chmod($filename, 0777);
43
44// 更新後の時刻を取得
45$new_ctime = filectime($filename);
46
47echo "ファイルの属性を変更しました." . PHP_EOL;
48echo "新しい最終状態変更時刻 (ctime): " . $new_ctime . PHP_EOL;
49echo "最終更新時刻 (mtime)は変更されていない: " . filemtime($filename) . PHP_EOL;
50

このサンプルコードは、PHPの filectime 関数と filemtime 関数の違いを理解するためのものです。filectime 関数は、指定されたファイルの最終状態変更時刻（inodeの変更時刻）をUnixタイムスタンプとして返します。一方、filemtime 関数は、ファイルの内容が最後に更新された時刻をUnixタイムスタンプとして返します。

コードではまず、example.txt というファイルが存在しない場合に作成します。次に、filectime 関数と filemtime 関数を使って、それぞれの時刻を取得し表示します。

touch 関数を使ってファイルの内容を更新すると、filemtime の値が更新されます。また、touch 関数は filectime の値も更新する可能性があります。

次に、chmod 関数を使ってファイルの属性を変更すると、filectime の値が更新されますが、filemtime の値は変更されません。

このように、filectime はファイルの属性（パーミッションなど）が変更された場合にも更新されるのに対し、filemtime はファイルの内容が変更された場合にのみ更新される点が異なります。システム開発においては、これらの違いを理解し、目的に応じて適切な関数を使用することが重要です。filectime 関数は、ファイルが存在しない場合やエラーが発生した場合は false を返します。

Copy
1<?php
2
3/**
4 * ファイルの作成時刻を取得するサンプルコード
5 */
6$filename = 'example.txt';
7
8// ファイルが存在しない場合は作成する
9if (!file_exists($filename)) {
10    touch($filename);
11}
12
13// ファイルの作成時刻を取得する
14$creationTime = filectime($filename);
15
16// 取得に成功した場合
17if ($creationTime !== false) {
18    echo "ファイルの作成時刻: " . date("Y-m-d H:i:s", $creationTime) . PHP_EOL;
19} else {
20    echo "ファイルの作成時刻の取得に失敗しました。" . PHP_EOL;
21}
22
23// ファイルの最終更新時刻を取得する
24$modificationTime = filemtime($filename);
25
26// 取得に成功した場合
27if ($modificationTime !== false) {
28    echo "ファイルの最終更新時刻: " . date("Y-m-d H:i:s", $modificationTime) . PHP_EOL;
29} else {
30    echo "ファイルの最終更新時刻の取得に失敗しました。" . PHP_EOL;
31}

このPHPサンプルコードは、filectime関数を使用してファイルの作成時刻を取得する方法を示しています。filectime関数は、引数に指定されたファイル $filename の作成時刻をUnixタイムスタンプ（整数値）として返します。ファイルが存在しない場合や、アクセスできない場合は false を返します。

まず、example.txtという名前のファイルが存在するか確認し、存在しない場合は touch 関数で新規作成します。次に、filectime関数にファイル名を渡し、ファイルの作成時刻を取得します。

取得した作成時刻が false でない場合、date関数を使用してUnixタイムスタンプを人間が読みやすい日付と時刻の形式に変換し、画面に出力します。もし false が返された場合は、作成時刻の取得に失敗した旨を表示します。

また、参考としてfilemtime関数を用いてファイルの最終更新時刻を取得する例も記載しています。filemtime関数は、ファイルの最終更新時刻をUnixタイムスタンプで返します。filectimeとfilemtimeの違いを理解することで、ファイルに関する情報をより深く扱えるようになります。ファイル操作を行う上で、これらの関数は非常に役立ちますので、ぜひ活用してください。