异常教程

PHP fnmatch() 函数（长文解析）

更新时间:

💡一则或许对你有用的小广告

欢迎加入小哈的星球 ，你将获得：专属的项目实战 / 1v1 提问 / Java 学习路线 / 学习打卡 / 每月赠书 / 社群讨论

  • 新项目:《从零手撸：仿小红书（微服务架构）》 正在持续爆肝中，基于 Spring Cloud Alibaba + Spring Boot 3.x + JDK 17...，点击查看项目介绍 ;
  • 《从零手撸：前后端分离博客项目（全栈开发）》 2 期已完结，演示链接： http://116.62.199.48/ ;

截止目前， 星球 内专栏累计输出 82w+ 字，讲解图 3441+ 张，还在持续爆肝中.. 后续还会上新更多项目，目标是将 Java 领域典型的项目都整一波，如秒杀系统, 在线商城, IM 即时通讯，权限管理，Spring Cloud Alibaba 微服务等等，已有 2900+ 小伙伴加入学习 ，欢迎点击围观

前言

在 PHP 开发中，字符串匹配是一个常见的需求。无论是验证文件名、过滤日志内容，还是处理用户输入，开发者常常需要根据特定模式筛选数据。PHP fnmatch() 函数正是这样一个强大的工具，它通过通配符语法提供灵活的模式匹配能力，尤其适合对路径、文件名或文本片段进行快速筛选。本文将从基础到进阶，结合实际案例，深入解析该函数的使用方法和核心技巧。

函数基础：语法与参数详解

基本语法与参数说明

fnmatch() 函数的核心作用是判断一个字符串是否与指定的模式匹配。其基本语法如下：

bool fnmatch ( string $pattern , string $string [, int $flags ] )
  • $pattern：要匹配的模式字符串，支持 * 和 ? 两种通配符。
  • $string：需要验证的目标字符串。
  • $flags（可选）：控制匹配行为的标志位，如忽略大小写、启用路径模式等。

返回值：若匹配成功返回 true，否则返回 false。

通配符的魔法世界

1. * 通配符：万能字符的“吞噬”能力

* 可匹配任意长度的字符（包括空字符）。例如：

// 匹配所有以 ".txt" 结尾的文件名  
$pattern = "*.txt";  
$string1 = "report_2023.txt";  
$string2 = "image.jpg";  
var_dump(fnmatch($pattern, $string1)); // bool(true)  
var_dump(fnmatch($pattern, $string2)); // bool(false)

2. ? 通配符：单字符“占位符”

? 仅匹配一个任意字符。例如：

// 匹配长度为 4 且以 ".php" 结尾的文件名  
$pattern = "???.php";  
var_dump(fnmatch($pattern, "web.php")); // bool(true)  
var_dump(fnmatch($pattern, "index.php")); // bool(false)

比喻：
可以将 * 想象成“贪吃蛇”，它会吞噬所有字符直到遇到匹配结尾；而 ? 则像一个“单兵占位器”，仅占据一个位置。

选项参数：精妙控制匹配行为

通过设置 $flags 参数，可以调整 fnmatch() 的匹配逻辑。常用标志位包括：

标志位作用描述
FNM_NOESCAPE禁用反斜杠 \ 的转义功能，即 \* 会被视为普通字符 * 而非转义字符。
FNM_PATHNAME启用路径模式匹配，此时 / 不会被 * 或 ? 匹配，需显式指定路径分隔符。
FNM_CASEFOLD忽略大小写差异，例如 HELLO 与 hello 视为匹配。
FNM_FILE_NAME等同于 FNM_PATHNAME，在 POSIX 系统中保持一致性。

案例：路径匹配与大小写忽略

// 匹配以 "logs/2023" 开头的路径，且忽略大小写  
$pattern = "logs/2023*";  
$flags = FNM_PATHNAME | FNM_CASEFOLD;  

var_dump(fnmatch($pattern, "logs/2023/error.log", $flags)); // true  
var_dump(fnmatch($pattern, "Logs/2023/INFO.txt", $flags));  // true

实战案例：从简单到复杂

案例 1：文件上传类型验证

在处理用户上传的文件时，可使用 fnmatch() 过滤允许的文件类型：

function validateFileExtension($fileName, $allowedPatterns) {  
    foreach ($allowedPatterns as $pattern) {  
        if (fnmatch($pattern, $fileName)) {  
            return true;  
        }  
    }  
    return false;  
}  

$allowed = ["*.jpg", "*.png", "*.gif"];  
var_dump(validateFileExtension("photo.jpg", $allowed)); // true  
var_dump(validateFileExtension("document.pdf", $allowed)); // false

案例 2：日志文件分析

从日志文件中筛选特定错误类型：

$logEntry = "2023-08-20 15:30:00 - ERROR: Database connection failed";  
$pattern = "*ERROR:*Database*";  

if (fnmatch($pattern, $logEntry)) {  
    echo "检测到数据库错误！";  
}

进阶技巧与注意事项

1. 转义字符的使用

默认情况下，反斜杠 \ 可用于转义通配符。例如：

// 匹配字面字符 "*"  
$pattern = "\*.txt";  
var_dump(fnmatch($pattern, "test.txt")); // false  
var_dump(fnmatch($pattern, "*.txt"));    // true

若需禁用此功能，可添加 FNM_NOESCAPE 标志：

$pattern = "\*.txt";  
$flags = FNM_NOESCAPE;  
var_dump(fnmatch($pattern, "test.txt", $flags)); // true

2. 跨平台兼容性

在 Windows 系统中，路径分隔符为 \，而 FNM_PATHNAME 默认使用 / 进行匹配。可通过替换分隔符解决：

$windowsPath = "C:\Users\Documents\report.txt";  
$pattern = "C:/Users/*/report.txt";  
$flags = FNM_PATHNAME;  

// 替换路径分隔符以匹配模式  
$normalizedPath = str_replace("\\", "/", $windowsPath);  
var_dump(fnmatch($pattern, $normalizedPath, $flags)); // true

3. 性能与限制

fnmatch() 的效率通常高于正则表达式（如 preg_match()），但其模式语法较简单，无法处理复杂的逻辑（如分组或重复匹配）。对于需要精确控制的场景，建议结合正则表达式使用。

结论

PHP fnmatch() 函数凭借其简洁的语法和高效的性能，成为处理通配符匹配的利器。无论是文件名过滤、日志分析，还是用户输入验证，它都能提供直观且灵活的解决方案。通过掌握通配符规则和标志位选项，开发者可以快速构建出健壮的匹配逻辑。

建议读者在实际项目中尝试以下练习：

  1. 使用 FNM_CASEFOLD 实现不区分大小写的路径匹配；
  2. 结合 scandir() 函数筛选目录中的文件；
  3. 设计一个基于通配符的权限控制系统。

通过实践，您将更深入理解该函数的潜力，并在 PHP 开发中游刃有余地应用这一工具。

最新发布

查看更多文章