closedir 函數的基礎使用方法是什麼？詳解如何正確使用它

gitbox 2025-09-12
<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-keyword">echo</span></span><span> </span><span><span class="hljs-string">"Hello World! 這段代碼和文章內容無關。"</span></span><span>;
</span><span><span class="hljs-meta">?&gt;</span></span><span>

&lt;hr&gt;

</span><span><span class="hljs-meta">&lt;?php</span></span><span>
<span class="hljs-comment">/**
 * 文章標題: closedir 函數的基礎使用方法是什麼？詳解如何正確使用它
 *
 * PHP 中的 `closedir()` 函數是用於關閉由 `opendir()` 打開的目錄句柄的函數。
 * 正確使用它可以釋放系統資源，防止文件句柄洩漏，尤其在處理大量目錄或文件操作時非常重要。
 *
 * 1. 基本語法
 * ```
 * bool closedir(resource $dir_handle)
 * ```
 * - `$dir_handle`：由 `opendir()` 返回的目錄句柄。
 * - 返回值：成功時返回 `true`，失敗時返回 `false`。
 *
 * 2. 使用步驟
 * 1) 使用 `opendir()` 打開一個目錄：
 */</span>
</span><span><span class="hljs-variable">$dir</span></span><span> = </span><span><span class="hljs-string">"example_dir"</span></span><span>;
</span><span><span class="hljs-keyword">if</span></span><span> (</span><span><span class="hljs-variable">$dh</span></span><span> = </span><span><span class="hljs-title function_ invoke__">opendir</span></span><span>(</span><span><span class="hljs-variable">$dir</span></span><span>)) {
    </span><span><span class="hljs-keyword">echo</span></span><span> </span><span><span class="hljs-string">"目錄打開成功&lt;br&gt;"</span></span><span>;
    
    </span><span><span class="hljs-comment">// 2) 讀取目錄內容</span></span><span>
    </span><span><span class="hljs-keyword">while</span></span><span> ((</span><span><span class="hljs-variable">$file</span></span><span> = </span><span><span class="hljs-title function_ invoke__">readdir</span></span><span>(</span><span><span class="hljs-variable">$dh</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">"文件名: <span class="hljs-subst">$file</span></span></span><span>&lt;br&gt;";
    }

    </span><span><span class="hljs-comment">// 3) 使用 closedir() 關閉目錄</span></span><span>
    </span><span><span class="hljs-keyword">if</span></span><span> (</span><span><span class="hljs-title function_ invoke__">closedir</span></span><span>(</span><span><span class="hljs-variable">$dh</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-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 class="hljs-comment">/**
 * 3. 注意事項
 * - 在調用 `closedir()` 之前，應確保目錄句柄有效。
 * - `closedir()` 並不會刪除目錄或文件，它只是釋放由操作系統分配的目錄句柄資源。
 * - 即使 PHP 腳本結束時未顯式調用 `closedir()`，系统也会自动關閉目錄句柄，但在長時間運行的腳本中顯式關閉是個好習慣。
 *
 * 4. 小結
 * `closedir()` 是一個簡單但關鍵的函數，用於關閉通過 `opendir()` 打開的目錄。正確的使用順序是：
 * 1. `opendir()` 打開目錄
 * 2. `readdir()` 或其他操作讀取目錄內容
 * 3. `closedir()` 關閉目錄句柄
 * 
 * 通過遵循這個順序，可以確保資源得到妥善釋放，避免潛在的文件句柄洩漏問題。
 */</span>
</span><span><span class="hljs-meta">?&gt;</span></span><span>

</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-keyword">echo</span></span><span> </span><span><span class="hljs-string">"&lt;hr&gt;文章結束，感謝閱讀！"</span></span><span>;
</span><span><span class="hljs-meta">?&gt;</span></span><span>
</span></span>
closedir