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>