pathinfo php · 路径信息完全指南

在PHP开发中,pathinfo 函数是处理文件路径与URL解析的核心工具。它能够返回文件路径的目录名、文件名、扩展名等信息。许多现代框架的路由系统都依赖类似pathinfo的模式来解析请求。本攻略深入网民关注的〈路径安全〉〈伪静态配置〉等热点。

参数说明
path要解析的路径字符串
optionsPATHINFO_DIRNAME / BASENAME / EXTENSION / FILENAME

〈 语法与返回值详解 〉

pathinfo(string $path, int $flags = ?) 返回关联数组或字符串。若不指定选项,默认返回四个键:dirname、basename、extension、filename。例如路径 /var/www/index.php 解析后清晰展示目录与文件。

$info = pathinfo('/var/www/config/db.inc.php');
print_r($info);

四个常量:PATHINFO_DIRNAME、PATHINFO_BASENAME、PATHINFO_EXTENSION、PATHINFO_FILENAME。使用时常量作为第二参数,返回字符串而非数组。例如获取纯文件名:pathinfo($path, PATHINFO_FILENAME)。

  • ⚡ PATHINFO_DIRNAME — 目录部分
  • ⚡ PATHINFO_BASENAME — 完整文件名
  • ⚡ PATHINFO_EXTENSION — 最后一个扩展名
  • ⚡ PATHINFO_FILENAME — 不含扩展名的文件

网友们还关心:多扩展名处理。如 archive.tar.gz ,pathinfo 返回扩展名 gz。若需完整后缀需自行处理。示例:

$ext = pathinfo('backup.sql.gz', PATHINFO_EXTENSION); // gz

结合 pathinfo 与 basename() 可实现灵活拆分。

↗ URL路由与伪静态实战

在Nginx或Apache中,常利用 PATH_INFO 实现前端控制器模式。例如 /index.php/user/profile 中,pathinfo 解析出 /user/profile 作为路由参数。

服务器配置要点
Nginxtry_files $uri /index.php?$query_string; 配合PATH_INFO
ApacheAcceptPathInfo On 与 mod_rewrite

⚠️ 安全配置与路径遍历防范

pathinfo 本身不直接引发安全问题,但错误使用路径可能导致目录遍历。网民常搜索“pathinfo php 安全漏洞”。务必过滤用户输入的路径参数。

〓 防御措施 〓

// 安全示例
$base = '/var/www/uploads/';
$userPath = $_GET['file'] ?? '';
$real = realpath($base . basename($userPath));
if(strpos($real, $base) === 0) {  }

❓ 网友们还关心 · 高频问答

pathinfo 对无扩展名文件返回空extension。如 README 则 extension 为空。可用 PATHINFO_FILENAME 直接获取名称。

UTF-8中文路径需确保系统编码一致。PHP7+ 大部分情况支持,但建议对中文路径使用 urlencode 后再处理。

parse_url 解析URL组成部分,pathinfo 专攻文件路径。两者常配合:先用parse_url提取路径,再交给pathinfo拆分。

📌 周边深度:路径处理生态

围绕pathinfo php,开发者还关注 dirname(), basename(), realpath() 以及 FilesystemIterator。以下卡片展示关联函数。

⚙️ dirname()

返回路径的目录部分,与pathinfo的PATHINFO_DIRNAME一致。

⚙️ basename()

获取文件名,可指定后缀剥离。常与pathinfo互补。

网友们还关心:在Windows与Linux下目录分隔符差异。pathinfo 能智能识别 / 和 \ 。建议始终使用 DIRECTORY_SEPARATOR 保证兼容。

// 跨平台路径处理
$path = 'uploads\images\photo.jpg';
$info = pathinfo($path);
echo $info['dirname']; // uploads\images

Ⅵ 进阶:pathinfo 与自动加载

Composer自动加载利用类名与路径映射,其内部虽未直接调用pathinfo,但类似思想用于解析命名空间前缀。例如 App\Controller\HomeController 转换为路径时,需拆分目录与文件名,pathinfo 逻辑可辅助理解。

另外,在生成缓存文件时,常用 pathinfo 获取文件名并附加时间戳,保证唯一性。