stream_is_local配合fopen能做什麼？快速檢測本地文件的方法分享

gitbox 2025-09-24

1. 什麼是stream_is_local ？

stream_is_local是PHP 內置的一個函數，它的作用是檢查一個文件或流是否是本地文件系統中的文件。該函數返回布爾值，如果給定的流是本地文件系統的文件，返回true ，否則返回false 。

 <span><span><span class="hljs-keyword">bool</span></span><span> </span><span><span class="hljs-title function_ invoke__">stream_is_local</span></span><span> ( resource </span><span><span class="hljs-variable">$stream</span></span><span> )
</span></span>

參數說明：

$stream ：這是一個有效的流資源（可以通過fopen函數獲取到流資源）。

2. 如何使用fopen和stream_is_local ？

fopen是PHP 中用於打開文件的函數，它能夠打開本地文件、遠程文件（例如通過HTTP 或FTP 協議）等。結合stream_is_local ，我們可以判斷文件是否是存儲在本地文件系統中的，這在需要進行本地文件處理時特別有用。

基本示例：

 <span><span><span class="hljs-meta">&lt;?php</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">// 使用 fopen 打開文件</span></span><span>
</span><span><span class="hljs-variable">$handle</span></span><span> = </span><span><span class="hljs-title function_ invoke__">fopen</span></span><span>(</span><span><span class="hljs-variable">$file_path</span></span><span>, </span><span><span class="hljs-string">'r'</span></span><span>);

</span><span><span class="hljs-keyword">if</span></span><span> (</span><span><span class="hljs-variable">$handle</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__">stream_is_local</span></span><span>(</span><span><span class="hljs-variable">$handle</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-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-title function_ invoke__">fclose</span></span><span>(</span><span><span class="hljs-variable">$handle</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>

在這個示例中，我們通過fopen打開example.txt文件，如果文件成功打開，接著使用stream_is_local檢查文件是否是本地文件。

3. stream_is_local的實際應用場景

在實際開發中， stream_is_local可以應用在多個場景，尤其是當文件路徑可以是本地路徑、URL 或其他協議時，我們需要確定文件是否存儲在本地。

3.1 處理上傳文件

當用戶上傳文件時，可能會有文件路徑是URL，也可能是本地文件路徑。如果需要確認上傳的文件是否是本地文件，可以使用stream_is_local來判斷：

 <span><span><span class="hljs-meta">&lt;?php</span></span><span>
</span><span><span class="hljs-variable">$file_path</span></span><span> = </span><span><span class="hljs-variable">$_FILES</span></span><span>[</span><span><span class="hljs-string">'upload_file'</span></span><span>][</span><span><span class="hljs-string">'tmp_name'</span></span><span>];

</span><span><span class="hljs-comment">// 檢查上傳的文件是否為本地文件</span></span><span>
</span><span><span class="hljs-variable">$handle</span></span><span> = </span><span><span class="hljs-title function_ invoke__">fopen</span></span><span>(</span><span><span class="hljs-variable">$file_path</span></span><span>, </span><span><span class="hljs-string">'r'</span></span><span>);

</span><span><span class="hljs-keyword">if</span></span><span> (</span><span><span class="hljs-variable">$handle</span></span><span>) {
    </span><span><span class="hljs-keyword">if</span></span><span> (</span><span><span class="hljs-title function_ invoke__">stream_is_local</span></span><span>(</span><span><span class="hljs-variable">$handle</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-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-title function_ invoke__">fclose</span></span><span>(</span><span><span class="hljs-variable">$handle</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>

3.2 遠程文件和本地文件的區分

在某些情況下，可能需要根據文件的來源（本地或遠程）來決定後續操作。例如，如果需要下載文件，可以優先處理本地文件，否則進行遠程文件下載。

 <span><span><span class="hljs-meta">&lt;?php</span></span><span>
</span><span><span class="hljs-variable">$file_path</span></span><span> = </span><span><span class="hljs-string">'https://example.com/file.txt'</span></span><span>;

</span><span><span class="hljs-comment">// 通過 fopen 打開文件流</span></span><span>
</span><span><span class="hljs-variable">$handle</span></span><span> = </span><span><span class="hljs-title function_ invoke__">fopen</span></span><span>(</span><span><span class="hljs-variable">$file_path</span></span><span>, </span><span><span class="hljs-string">'r'</span></span><span>);

</span><span><span class="hljs-keyword">if</span></span><span> (</span><span><span class="hljs-variable">$handle</span></span><span>) {
    </span><span><span class="hljs-keyword">if</span></span><span> (</span><span><span class="hljs-title function_ invoke__">stream_is_local</span></span><span>(</span><span><span class="hljs-variable">$handle</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-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-title function_ invoke__">fclose</span></span><span>(</span><span><span class="hljs-variable">$handle</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>

4. 注意事項

stream_is_local僅適用於流資源。如果傳遞給它的不是一個有效的流資源，函數將返回false 。
這個函數只能用來判斷文件流是否來自本地文件系統，不能判斷文件的實際內容、權限或是否存在。

5. 總結

stream_is_local和fopen組合使用能夠有效地幫助開發者在處理文件時快速判斷文件是否來自本地文件系統。這在多種應用場景下都非常實用，特別是在需要區分本地文件和遠程文件時。通過這兩個函數，我們可以輕鬆地做出相應的操作決策，提高開發效率。

相關標籤:
fopen