PHP realpath和dirname函數搭配使用，如何準確獲取文件所在目錄的絕對路徑？

gitbox 2025-10-01

<span><span><span class="hljs-meta">&lt;?php</span></span><span>
</span><span><span class="hljs-comment">// 與文章內容無關的PHP代碼示例</span></span><span>
</span><span><span class="hljs-keyword">echo</span></span><span> </span><span><span class="hljs-string">"這是一段無關的PHP代碼，用於演示文章分隔。"</span></span><span>;
</span><span><span class="hljs-meta">?&gt;</span></span><span>

&lt;hr&gt;

PHP在文件操作中，經常需要獲取文件所在目錄的絕對路徑，以便進行後續的讀取或寫入操作。`</span><span><span class="hljs-title function_ invoke__">realpath</span></span><span>()`和`</span><span><span class="hljs-title function_ invoke__">dirname</span></span><span>()`是兩個在這類場景中非常實用的函數，它們各有用途，但搭配使用可以更加精確和安全地獲取文件路徑。

</span><span><span class="hljs-comment">### 1. `dirname()`函數</span></span><span>

`</span><span><span class="hljs-title function_ invoke__">dirname</span></span><span>()`用於獲取文件路徑的父級目錄。它的基本用法如下：

```php
</span><span><span class="hljs-variable">$filePath</span></span><span> = </span><span><span class="hljs-string">"/var/www/html/index.php"</span></span><span>;
</span><span><span class="hljs-variable">$dirPath</span></span><span> = </span><span><span class="hljs-title function_ invoke__">dirname</span></span><span>(</span><span><span class="hljs-variable">$filePath</span></span><span>);
</span><span><span class="hljs-keyword">echo</span></span><span> </span><span><span class="hljs-variable">$dirPath</span></span><span>; </span><span><span class="hljs-comment">// 輸出: /var/www/html</span></span><span>
</span></span>

如果路徑中包含多級目錄，可以通過第二個參數指定返回的層級：

 <span><span><span class="hljs-variable">$dirPath</span></span><span> = </span><span><span class="hljs-title function_ invoke__">dirname</span></span><span>(</span><span><span class="hljs-variable">$filePath</span></span><span>, </span><span><span class="hljs-number">2</span></span><span>);
</span><span><span class="hljs-keyword">echo</span></span><span> </span><span><span class="hljs-variable">$dirPath</span></span><span>; </span><span><span class="hljs-comment">// 輸出: /var/www</span></span><span>
</span></span>

注意， dirname()返回的是一個相對路徑或者原路徑中解析後的父目錄，它不會驗證路徑是否真實存在。

2. realpath()函數

realpath()用於將路徑解析為絕對路徑，並解析符號鏈接、 .和.. ，同時驗證路徑是否真實存在。示例如下：

 <span><span><span class="hljs-variable">$path</span></span><span> = </span><span><span class="hljs-string">"./test/../index.php"</span></span><span>;
</span><span><span class="hljs-variable">$absolutePath</span></span><span> = </span><span><span class="hljs-title function_ invoke__">realpath</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-variable">$absolutePath</span></span><span>; </span><span><span class="hljs-comment">// 輸出绝对路径，例如: /var/www/html/index.php</span></span><span>
</span></span>

如果路徑不存在， realpath()會返回false 。

3. 搭配使用獲取文件所在目錄的絕對路徑

為了確保獲取的目錄路徑既準確又是絕對路徑，可以將兩者結合：

 <span><span><span class="hljs-variable">$file</span></span><span> = </span><span><span class="hljs-string">"./test/../index.php"</span></span><span>;
</span><span><span class="hljs-variable">$absoluteDir</span></span><span> = </span><span><span class="hljs-title function_ invoke__">dirname</span></span><span>(</span><span><span class="hljs-title function_ invoke__">realpath</span></span><span>(</span><span><span class="hljs-variable">$file</span></span><span>));
</span><span><span class="hljs-keyword">echo</span></span><span> </span><span><span class="hljs-variable">$absoluteDir</span></span><span>; </span><span><span class="hljs-comment">// 輸出: /var/www/html</span></span><span>
</span></span>

這裡的流程是：

realpath($file)將文件路徑轉換為真實存在的絕對路徑。
dirname()再從絕對路徑中獲取父目錄。

這種方法能夠保證你拿到的目錄路徑是存在的且為絕對路徑，避免了相對路徑可能引發的錯誤。

4. 使用場景

動態加載文件或包含文件時，需要確保路徑正確。
保存日誌、緩存文件到與腳本文件同目錄下。
在跨平台部署時，避免路徑混亂。

5. 總結

dirname() ：獲取父目錄，可指定層級。
realpath() ：將路徑解析為真實存在的絕對路徑。
搭配使用：先用realpath()確保路徑真實存在，再用dirname()獲取所在目錄。

這種組合使用方式，是PHP項目中處理文件路徑的最佳實踐之一。

 <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">"文章示例結束"</span></span><span>;
</span><span><span class="hljs-meta">?&gt;</span></span><span>
</span></span>