LSTAT関数を使用して、パスがシンボリックリンクであるかどうかを判断する方法は？特定の手順の分析

gitbox 2025-06-22

PHPでは、 LSTATは非常に実用的なファイルシステム機能であり、開発者がファイルまたはディレクトリのメタデータを取得できるようにします。統計関数とは異なり、 LSTATは、シンボリックリンクで指摘されたターゲットのメタデータではなく、シンボリックリンク自体のメタデータを返します。この機能により、パスが象徴的なリンクであるかどうかを判断する際に、 LSTATが特に重要になります。この記事では、 LSTAT関数を使用して、パスがシンボリックリンクであるかどうか、および実装の特定の手順を判断する方法を詳細に分析します。

1。LSTAT関数の紹介

PHPのLSTAT関数は、指定されたパスファイルまたはディレクトリのステータス情報を取得し、連想配列を返すために使用されます。この配列には、ファイルのサイズ、許可、ファイルタイプなど、ファイルに関するさまざまな情報が含まれています。

関数プロトタイプ：

 <span><span><span class="hljs-title function_ invoke__">lstat</span></span><span>(</span><span><span class="hljs-keyword">string</span></span><span> </span><span><span class="hljs-variable">$filename</span></span><span>): </span><span><span class="hljs-keyword">array</span></span><span>|</span><span><span class="hljs-literal">false</span></span><span>
</span></span>

パラメーター：

$ filename ：ファイルまたはディレクトリへのパスをクエリするパスを指定します。

返品値：

成功した場合、 LSTATはファイルステータス情報を含む連想配列を返します。
失敗した場合は、 falseを返します。

LSTATはシンボリックリンクを追跡せず、象徴的なリンク自体の状態を指し示すのではなく、象徴的なリンク自体を返すことに注意する必要があります。

2。パスがシンボリックリンクであるかどうかを判断する手順

パスがシンボリックリンクであるかどうかを判断するには、最初にパスのステータス情報を取得し、次に返されたステータス配列のモードフィールドを確認します。モードフィールドの値は、通常のファイル、ディレクトリ、シンボリックリンクなどを含むファイルのタイプを決定します。

以下は、パスが象徴的なリンクであるかどうかを判断するための特定の手順です。

LSTATを使用して、ファイルまたはディレクトリのステータス情報を取得します。
Return Arrayのモードフィールドを確認します。
S_IFLNK定数によるシンボリックリンクかどうかを判断します。

3。サンプルコード

<span><span><span class="hljs-meta">&lt;?php</span></span><span>
</span><span><span class="hljs-function"><span class="hljs-keyword">function</span></span></span><span> </span><span><span class="hljs-title">isSymbolicLink</span></span><span>(</span><span><span class="hljs-params"><span class="hljs-variable">$path</span></span></span><span>) {
    </span><span><span class="hljs-comment">// ファイルステータス情報を取得します</span></span><span>
    </span><span><span class="hljs-variable">$stat</span></span><span> = </span><span><span class="hljs-title function_ invoke__">lstat</span></span><span>(</span><span><span class="hljs-variable">$path</span></span><span>);

    </span><span><span class="hljs-comment">// 判断 lstat 成功</span></span><span>
    </span><span><span class="hljs-keyword">if</span></span><span> (</span><span><span class="hljs-variable">$stat</span></span><span> === </span><span><span class="hljs-literal">false</span></span><span>) {
        </span><span><span class="hljs-keyword">echo</span></span><span> </span><span><span class="hljs-string">"无法ファイルステータス情報を取得します。\n"</span></span><span>;
        </span><span><span class="hljs-keyword">return</span></span><span> </span><span><span class="hljs-literal">false</span></span><span>;
    }

    </span><span><span class="hljs-comment">// ファイルがシンボリックリンクであるかどうかを判断します</span></span><span>
    </span><span><span class="hljs-keyword">if</span></span><span> ((</span><span><span class="hljs-variable">$stat</span></span><span>[</span><span><span class="hljs-string">'mode'</span></span><span>] &amp; </span><span><span class="hljs-number">0170000</span></span><span>) === </span><span><span class="hljs-number">0120000</span></span><span>) {
        </span><span><span class="hljs-keyword">return</span></span><span> </span><span><span class="hljs-literal">true</span></span><span>; </span><span><span class="hljs-comment">// それは象徴的なリンクです</span></span><span>
    }
    </span><span><span class="hljs-keyword">return</span></span><span> </span><span><span class="hljs-literal">false</span></span><span>; </span><span><span class="hljs-comment">// 不それは象徴的なリンクです</span></span><span>
}

</span><span><span class="hljs-comment">// テスト</span></span><span>
</span><span><span class="hljs-variable">$path</span></span><span> = </span><span><span class="hljs-string">'/path/to/your/file_or_symlink'</span></span><span>;
</span><span><span class="hljs-keyword">if</span></span><span> (</span><span><span class="hljs-title function_ invoke__">isSymbolicLink</span></span><span>(</span><span><span class="hljs-variable">$path</span></span><span>)) {
    </span><span><span class="hljs-keyword">echo</span></span><span> </span><span><span class="hljs-string">"<span class="hljs-subst">$path</span></span></span><span> それは象徴的なリンクです。\n";
} </span><span><span class="hljs-keyword">else</span></span><span> {
    </span><span><span class="hljs-keyword">echo</span></span><span> </span><span><span class="hljs-string">"<span class="hljs-subst">$path</span></span></span><span> 不それは象徴的なリンクです。\n";
}
</span><span><span class="hljs-meta">?&gt;</span></span><span>
</span></span>

4。コード分析

LSTAT（$ PATH） ： LSTAT関数を呼び出して、ファイルステータス情報を取得します。
- ファイルまたはディレクトリが存在しない場合、またはパスがアクセスできない場合、 LSTATはfalseを返します。
$ stat ['mode']＆0170000 ：モードフィールドには、ファイルのタイプ情報が含まれています。 0170000はマスクで、ファイルタイプパーツを抽出するために使用されます。 UNIXファイルの許可によると、シンボリックリンクのタイプ値は0120000です。
裁判官のシンボリックリンク：if （$ stat ['mode']＆0170000）=== 0120000では、ファイルがシンボリックリンクであることを意味します。

V.他の一般的なファイルタイプの判断

シンボリックリンクに加えて、 LSTATはファイルが他のタイプであるかどうかを判断するのにも役立ちます。モードフィールドのマスクを介して、ファイルが通常のファイル、ディレクトリなどであるかどうかを判断できます。

一般ファイル：（$ stat ['mode']＆0170000）=== 0100000
ディレクトリ：（$ stat ['mode']＆0170000）=== 0040000
文字デバイスファイル：（$ stat ['mode']＆0170000）=== 0020000
ブロックデバイスファイル：（$ stat ['mode']＆0170000）=== 0060000
名前付きパイプライン（FIFO） ：（ $ stat ['mode']＆0170000）=== 0010000

6。概要

PHPのLSTAT関数を使用することにより、ファイルまたはディレクトリのステータス情報を簡単に取得し、モードフィールドに基づいてファイルタイプを判断できます。パスが象徴的なリンクであるかどうかを判断するのは非常に簡単です。 LSTATを使用してステータス情報を取得し、ファイルタイプがシンボリックリンクであるかどうかを確認する必要があります。この方法は直感的で効率的であり、ファイルシステム操作が必要なシナリオに非常に適しています。

lstat
stat