如何使用finfo::set_flags 來控制finfo_file() 輸出格式，讓你更靈活地處理文件

gitbox 2025-09-02

在PHP 中， finfo_file()是一個常用的函數，用於獲取文件的MIME 類型或其他信息。通常， finfo_file()函數會返回文件的MIME 類型，而如果我們想要更精確地控制輸出格式，比如想要獲取更詳細的信息或改變其返回值的格式，就可以通過finfo::set_flags()方法來實現。

finfo::set_flags()是finfo類的一個方法，它允許我們控製文件信息的提取方式。通過設置標誌位，你可以調整finfo_file()函數的行為，以適應特定的需求。

本文將詳細介紹如何使用finfo::set_flags()來改變finfo_file()的輸出格式。

1. finfo::set_flags()介紹

finfo::set_flags()是finfo類中的方法，它可以用來設置文件信息檢索時的附加標誌。這些標誌控制了文件信息返回的具體格式和內容。 finfo::set_flags()方法接受一個或多個常量標誌，這些標誌會影響文件的解析行為。

常用的標誌常量包括：

FILEINFO_MIME_TYPE : 返回MIME 類型（默認行為）。
FILEINFO_MIME_ENCODING : 返回MIME 編碼。
FILEINFO_TEXT : 返回文件是否為文本文件。
FILEINFO_PRESERVE_ATIME : 在打開文件時保持文件的最後訪問時間。

2. 創建finfo對象

首先，我們需要創建一個finfo對象，才能使用它的set_flags()方法。

 <span><span><span class="hljs-meta">&lt;?php</span></span><span>
</span><span><span class="hljs-comment">// 創建 finfo 對象</span></span><span>
</span><span><span class="hljs-variable">$finfo</span></span><span> = </span><span><span class="hljs-keyword">new</span></span><span> </span><span><span class="hljs-title function_ invoke__">finfo</span></span><span>(FILEINFO_MIME);
</span><span><span class="hljs-meta">?&gt;</span></span><span>
</span></span>

上面創建了一個finfo對象，並指定默認的MIME 類型標誌。

3. 設置標誌

使用set_flags()方法，可以向finfo對象添加額外的標誌，以控製文件信息的獲取方式。我們可以使用邏輯OR 操作符將多個標誌組合起來。

 <span><span><span class="hljs-meta">&lt;?php</span></span><span>
</span><span><span class="hljs-comment">// 設定 FILEINFO_MIME_TYPE 和 FILEINFO_MIME_ENCODING 標誌</span></span><span>
</span><span><span class="hljs-variable">$finfo</span></span><span>-&gt;</span><span><span class="hljs-title function_ invoke__">set_flags</span></span><span>(FILEINFO_MIME_TYPE | FILEINFO_MIME_ENCODING);
</span><span><span class="hljs-meta">?&gt;</span></span><span>
</span></span>

上面代碼設置了兩個標誌：

FILEINFO_MIME_TYPE ：返回文件的MIME 類型。
FILEINFO_MIME_ENCODING ：返回MIME 編碼。

4. 使用finfo_file()獲取文件信息

一旦設置了標誌，就可以使用finfo_file()函數來獲取文件的信息。

 <span><span><span class="hljs-meta">&lt;?php</span></span><span>
</span><span><span class="hljs-comment">// 使用 finfo_file 獲取文件的 MIME 類型和編碼</span></span><span>
</span><span><span class="hljs-variable">$fileInfo</span></span><span> = </span><span><span class="hljs-variable">$finfo</span></span><span>-&gt;</span><span><span class="hljs-title function_ invoke__">file</span></span><span>(</span><span><span class="hljs-string">'example.jpg'</span></span><span>);

</span><span><span class="hljs-comment">// 輸出文件的 MIME 類型和編碼</span></span><span>
</span><span><span class="hljs-keyword">echo</span></span><span> </span><span><span class="hljs-variable">$fileInfo</span></span><span>;
</span><span><span class="hljs-meta">?&gt;</span></span><span>
</span></span>

5. 其他常見標誌

除了FILEINFO_MIME_TYPE和FILEINFO_MIME_ENCODING ， finfo類還提供了一些其他的常見標誌：

FILEINFO_MIME : 返回文件的MIME 類型（不包括編碼）。
FILEINFO_TEXT : 判斷文件是否為文本文件。
FILEINFO_DEVICES : 如果文件是設備文件，則返回設備類型。

例如，如果你想獲取一個文件的MIME 類型以及判斷是否為文本文件，你可以使用如下代碼：

 <span><span><span class="hljs-meta">&lt;?php</span></span><span>
</span><span><span class="hljs-comment">// 設定 FILEINFO_MIME 和 FILEINFO_TEXT 標誌</span></span><span>
</span><span><span class="hljs-variable">$finfo</span></span><span>-&gt;</span><span><span class="hljs-title function_ invoke__">set_flags</span></span><span>(FILEINFO_MIME | FILEINFO_TEXT);

</span><span><span class="hljs-comment">// 獲取文件信息</span></span><span>
</span><span><span class="hljs-variable">$fileInfo</span></span><span> = </span><span><span class="hljs-variable">$finfo</span></span><span>-&gt;</span><span><span class="hljs-title function_ invoke__">file</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">echo</span></span><span> </span><span><span class="hljs-variable">$fileInfo</span></span><span>;
</span><span><span class="hljs-meta">?&gt;</span></span><span>
</span></span>

6. 示例：綜合應用

假設你有多個文件，想要根據文件類型和編碼處理它們，你可以這樣做：

 <span><span><span class="hljs-meta">&lt;?php</span></span><span>
</span><span><span class="hljs-comment">// 創建 finfo 對象</span></span><span>
</span><span><span class="hljs-variable">$finfo</span></span><span> = </span><span><span class="hljs-keyword">new</span></span><span> </span><span><span class="hljs-title function_ invoke__">finfo</span></span><span>(FILEINFO_MIME);

</span><span><span class="hljs-comment">// 設定標誌，獲取 MIME 類型和編碼</span></span><span>
</span><span><span class="hljs-variable">$finfo</span></span><span>-&gt;</span><span><span class="hljs-title function_ invoke__">set_flags</span></span><span>(FILEINFO_MIME_TYPE | FILEINFO_MIME_ENCODING);

</span><span><span class="hljs-comment">// 文件列表</span></span><span>
</span><span><span class="hljs-variable">$files</span></span><span> = [</span><span><span class="hljs-string">'example.jpg'</span></span><span>, </span><span><span class="hljs-string">'example.txt'</span></span><span>, </span><span><span class="hljs-string">'example.mp4'</span></span><span>];

</span><span><span class="hljs-keyword">foreach</span></span><span> (</span><span><span class="hljs-variable">$files</span></span><span> </span><span><span class="hljs-keyword">as</span></span><span> </span><span><span class="hljs-variable">$file</span></span><span>) {
    </span><span><span class="hljs-comment">// 獲取文件信息</span></span><span>
    </span><span><span class="hljs-variable">$fileInfo</span></span><span> = </span><span><span class="hljs-variable">$finfo</span></span><span>-&gt;</span><span><span class="hljs-title function_ invoke__">file</span></span><span>(</span><span><span class="hljs-variable">$file</span></span><span>);

    </span><span><span class="hljs-comment">// 输出文件類型和編碼</span></span><span>
    </span><span><span class="hljs-keyword">echo</span></span><span> </span><span><span class="hljs-string">"File: <span class="hljs-subst">$file</span></span></span><span>\n";
    </span><span><span class="hljs-keyword">echo</span></span><span> </span><span><span class="hljs-string">"MIME Type and Encoding: <span class="hljs-subst">$fileInfo</span></span></span><span>\n\n";
}
</span><span><span class="hljs-meta">?&gt;</span></span><span>
</span></span>

7. 總結

使用finfo::set_flags()方法，我們可以靈活地調整finfo_file()返回的文件信息格式。根據具體需求，我們可以設置不同的標誌來獲取更詳細的文件類型、編碼、是否為文本文件等信息。這樣可以更精準地處理和解析文件類型，尤其在處理多種類型的文件時，能夠提高代碼的靈活性與可靠性。

通過合理配置標誌，你可以確保文件信息獲取的準確性與完整性，從而更好地支持文件上傳、文件驗證等功能的開發。