怎樣用PHP 的fileinode 函數獲取文件的inode 編號？步驟與示例

gitbox 2025-07-10

1. 什麼是inode？

在文件系統中，每個文件都有一個唯一的inode，它包含關於文件的各種信息，如文件大小、權限、擁有者、文件類型等。 inode 不包含文件名，文件名與inode 的關聯是通過目錄項（directory entry）來完成的。

簡單來說，inode 是文件的“身份證”，它幫助文件系統管理文件。

2. PHP fileinode()函數概述

fileinode()是一個用於獲取指定文件inode 編號的PHP 內置函數。其語法如下：

 <span><span><span class="hljs-title function_ invoke__">fileinode</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">int</span></span><span>|</span><span><span class="hljs-literal">false</span></span><span>
</span></span>

$filename ：文件的路徑。該文件必須是已存在的文件，否則函數會返回false 。
返回值：
- 返回文件的inode 編號（整數）。
- 如果文件不存在或者無法訪問，返回false 。

3. 如何使用fileinode()獲取文件的inode 編號？

通過PHP 的fileinode()函數，你可以輕鬆獲取文件的inode 編號。以下是幾個步驟：

步驟1：確認文件是否存在

首先，我們要確認指定的文件確實存在。如果文件不存在， fileinode()函數將返回false 。

步驟2：調用fileinode()函數

通過傳入文件路徑，調用fileinode()函數獲取該文件的inode 編號。

步驟3：處理返回值

如果文件存在， fileinode()將返回一個整數值，即inode 編號；如果文件不存在或無法訪問，則返回false 。

4. 示例代碼

以下是一個完整的示例，展示瞭如何使用fileinode()獲取文件的inode 編號：

 <span><span><span class="hljs-meta">&lt;?php</span></span><span>
</span><span><span class="hljs-comment">// 設置文件路徑</span></span><span>
</span><span><span class="hljs-variable">$file_path</span></span><span> = </span><span><span class="hljs-string">'example.txt'</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-title function_ invoke__">file_exists</span></span><span>(</span><span><span class="hljs-variable">$file_path</span></span><span>)) {
    </span><span><span class="hljs-comment">// 獲取文件的 inode 編號</span></span><span>
    </span><span><span class="hljs-variable">$inode</span></span><span> = </span><span><span class="hljs-title function_ invoke__">fileinode</span></span><span>(</span><span><span class="hljs-variable">$file_path</span></span><span>);

    </span><span><span class="hljs-comment">// 輸出 inode 編號</span></span><span>
    </span><span><span class="hljs-keyword">echo</span></span><span> </span><span><span class="hljs-string">"文件的 inode 編號是: "</span></span><span> . </span><span><span class="hljs-variable">$inode</span></span><span>;
} </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></span><span>;
}
</span><span><span class="hljs-meta">?&gt;</span></span><span>
</span></span>

說明：

file_exists()函數用於檢查文件是否存在。
如果文件存在， fileinode()函數將返回該文件的inode 編號，並將其輸出。
如果文件不存在，輸出"文件不存在"。

5. 示例結果

假設我們有一個名為example.txt的文件，且該文件存在於當前目錄中。當運行上述PHP 代碼時，輸出將是類似如下內容：

 <span><span>文件的 inode 編號是: 123456
</span></span>

這裡的123456只是一個示例，實際的inode 編號會根據你的文件系統而有所不同。

6. 注意事項

文件權限：確保PHP 腳本有足夠的權限去讀取文件。如果權限不足， fileinode()將無法獲取inode 編號。
符號鏈接：如果文件是符號鏈接（symlink）， fileinode()返回的是符號鏈接本身的inode 編號，而不是它指向的實際文件的inode 編號。如果想要獲取符號鏈接所指向的文件的inode 編號，可以使用realpath()函數來獲取真實路徑。

 <span><span><span class="hljs-variable">$file_path</span></span><span> = </span><span><span class="hljs-string">'symlink.txt'</span></span><span>;
</span><span><span class="hljs-variable">$real_path</span></span><span> = </span><span><span class="hljs-title function_ invoke__">realpath</span></span><span>(</span><span><span class="hljs-variable">$file_path</span></span><span>);
</span><span><span class="hljs-keyword">if</span></span><span> (</span><span><span class="hljs-variable">$real_path</span></span><span>) {
    </span><span><span class="hljs-keyword">echo</span></span><span> </span><span><span class="hljs-string">"符號鏈接指向的文件的 inode 編號是: "</span></span><span> . </span><span><span class="hljs-title function_ invoke__">fileinode</span></span><span>(</span><span><span class="hljs-variable">$real_path</span></span><span>);
}
</span></span>

返回值為false ：如果文件不存在或者路徑不正確， fileinode()返回false 。你可以使用is_file()函數進一步檢查路徑是否為有效的文件路徑。

7. 總結

通過PHP 的fileinode()函數，你可以方便地獲取指定文件的inode 編號。這在某些場景下可能非常有用，比如文件的唯一標識、文件系統的管理等。只要確保文件存在並且PHP 腳本有足夠的權限，就能順利地獲取文件的inode 編號。