PHP：从文本文件按条件查找并提取指定行内容-html教程-PHP中文网

PHP：从文本文件按条件查找并提取指定行内容

霞舞

发布： 2025-10-01 13:24:38

原创

955人浏览过

PHP：从文本文件按条件查找并提取指定行内容

本文详细讲解了如何使用 PHP 从文本文件中按指定字符串查找并提取特定行。通过结合 fgets 循环读取文件内容与 str_contains 函数进行字符串匹配，可以高效定位并输出目标行。教程还涵盖了 PHP 版本兼容性考量以及在特定场景下数据库方案的优势，旨在提供一套完整的文本文件行内容检索解决方案。

在 php 开发中，我们经常会遇到需要从文本文件中读取特定内容的需求。不同于简单地读取文件首行或全部内容，有时我们需要根据某个关键词或字符串来查找并提取文件中匹配的某一行。本教程将详细介绍如何实现这一功能，并提供完整的代码示例及注意事项。

核心实现：逐行读取与字符串匹配

要从文本文件中查找并提取指定行，最直接且内存效率高的方法是逐行读取文件内容，并在每一行中检查是否包含目标字符串。

打开文件： 使用 fopen() 函数以只读模式（"r"）打开目标文本文件。
逐行读取： 使用 fgets() 函数在一个循环中逐行读取文件内容，直到文件末尾。fgets() 每次读取一行，包括行末的换行符。
字符串匹配： 在循环内部，对每一行使用字符串查找函数（如 str_contains() 或 strpos()）来判断是否包含我们正在寻找的字符串。
处理结果： 如果找到匹配的行，可以将其存储起来或直接输出，并可以选择退出循环以提高效率。
关闭文件： 完成操作后，使用 fclose() 函数关闭文件，释放资源。

PHP 版本兼容性考量

在进行字符串匹配时，PHP 提供了多种函数。其中 str_contains() 是一个现代且直观的选择，但需要注意其版本要求。

str_contains() (PHP 8.0+)： 这是推荐的函数，用于判断一个字符串是否包含另一个字符串。它返回 true 或 false，用法简洁明了。
```
if (str_contains($haystack, $needle)) {
    // 字符串包含
}
```
登录后复制
strpos() (PHP 4.0+)： 对于 PHP 8.0 以下的版本，strpos() 是一个常用的替代方案。它查找字符串中第一次出现子字符串的位置。如果找到，返回其起始位置（一个整数）；如果未找到，则返回 false。注意： 由于 0 也是一个有效的位置，因此在使用 strpos() 时需要使用严格的非等运算符 !== false 来判断是否找到。
```
if (strpos($haystack, $needle) !== false) {
    // 字符串包含
}
```
登录后复制
strstr() (PHP 4.0+)： 另一个选项是 strstr()，它返回从匹配点到字符串结尾的部分，或者在未找到时返回 false。
```
if (strstr($haystack, $needle) !== false) {
    // 字符串包含
}
```
登录后复制
在本教程中，我们将主要使用 str_contains() 进行示例，并提醒旧版本 PHP 的用户使用 strpos()。

完整示例代码

假设我们有一个名为 test.txt 的文本文件，内容如下：

立即学习“PHP免费学习笔记（深入）”；

巧文书

巧文书是一款AI写标书、AI写方案的产品。通过自研的先进AI大模型，精准解析招标文件，智能生成投标内容。

查看详情

First line
Second Line
Third Line
Fourth Line

登录后复制

我们希望查找包含 "Second Line" 的行，并将其显示在一个 HTML 标签中。

<?php
// 定义要查找的字符串
$search_string = "Second Line"; // 示例：查找包含“Second Line”的行
$file_path = "test.txt";

// 输出 HTML 头部，为展示结果做准备
echo '<html><body>';

// 尝试打开文件
$myfile = fopen($file_path, "r");

if ($myfile) {
    $found_line = "";
    // 逐行读取文件内容
    while (($line = fgets($myfile)) !== false) {
        // 检查当前行是否包含目标字符串 (PHP 8+ 推荐使用 str_contains)
        // 对于 PHP 7.x 及更早版本，请使用：if (strpos($line, $search_string) !== false)
        if (str_contains($line, $search_string)) {
            $found_line = trim($line); // 移除行末的换行符
            break; // 找到后立即退出循环，提高效率
        }
    }
    fclose($myfile); // 关闭文件

    // 输出结果到 HTML label
    if (!empty($found_line)) {
        // 使用 htmlspecialchars 避免 XSS 攻击，确保输出安全
        echo '<label>找到的行: ' . htmlspecialchars($found_line) . '</label>';
    } else {
        echo '<label>未找到包含 \'' . htmlspecialchars($search_string) . '\' 的行。</label>';
    }

} else {
    // 文件打开失败的处理
    echo '<label style="color: red;">错误：无法打开文件 ' . htmlspecialchars($file_path) . '。</label>';
}

echo '</body></html>';
?>

登录后复制

如何运行：

将上述 PHP 代码保存为 search_file.php。
在同一目录下创建 test.txt 文件，并填充示例内容。
通过 Web 服务器（如 Apache, Nginx）访问 search_file.php，或者在命令行中运行 php search_file.php（但命令行不会渲染 HTML 标签）。

注意事项与最佳实践

错误处理： 始终检查 fopen() 函数的返回值。如果文件不存在或没有读取权限，fopen() 会返回 false。在实际应用中，应包含更健壮的错误处理机制。
文件路径： 确保 $file_path 指向正确的文件位置。相对路径是相对于执行 PHP 脚本的当前工作目录。
内存与性能： 逐行读取（fgets()）对于大型文件来说是内存高效的，因为它不会一次性将整个文件加载到内存中。然而，对于非常大的文件（例如数 GB），频繁的字符串查找操作仍然可能耗时。
字符串修剪： fgets() 函数会读取包括行末换行符在内的整行内容。使用 trim() 或 rtrim() 可以移除这些不必要的空白字符，使输出更整洁。
安全性（XSS 预防）： 当将从文件中读取的内容输出到 HTML 页面时，应使用 htmlspecialchars() 函数对内容进行编码，以防止跨站脚本（XSS）攻击，特别是当文件内容可能包含用户输入时。
数据存储选择： 尽管文本文件简单易用，但对于更复杂的、结构化的数据存储和查询需求，使用数据库（如 MySQL, PostgreSQL, SQLite）会是更优的选择。数据库提供了索引、强大的查询语言（SQL）和事务管理等功能，能够大幅提高数据检索的效率和灵活性。例如，如果您需要根据多个条件进行查找、排序或聚合数据，数据库将是不可或缺的。