基于换行符检测的HTML结构化输出教程

具体步骤如下：

1. 逐行读取数据： 使用PHP的file()函数可以方便地将文件内容按行读取到一个数组中。
2. 判断行是否为空： 通过检查行的长度或使用trim()函数去除空白字符后判断是否为空字符串。
3. 维护状态： 使用一个布尔变量（例如$last_is_line_empty）来记录前一行是否为空。
4. 条件判断与输出：
   • 如果上一行是空行且当前行非空，则表示一个新的
     组开始，需要输出

     标签。
   • 如果上一行和当前行都非空，则表示仍在同一个
     组内，直接输出标签。
   • 如果上一行非空但当前行是空行，则表示一个
     组结束，需要输出
     标签。
   • 处理文件末尾： 需要确保在文件处理完毕后，如果最后一个
     组尚未关闭，能够正确地关闭它。

     PHP代码实现

     下面是基于上述思路的PHP代码示例，它将读取 data.txt 文件并生成符合要求的HTML输出。为了增强通用性，我们增加了动态生成div的唯一ID和span的类名。

     标签添加的CSS类名。
      * @return string 生成的HTML字符串。
      */
     function generateStructuredHtmlFromText(string $filepath, string $spanClass = 'my-class'): string
     {
         if (!file_exists($filepath)) {
             return "
     错误：文件 '{$filepath}' 不存在。
     ";
         }
     
         $outputHtml = '';
         $lines = file($filepath, FILE_IGNORE_NEW_LINES | FILE_SKIP_EMPTY_LINES); // 读取非空行，并去除换行符
         $rawLines = file($filepath); // 读取所有行，包括空行，保留原始换行符
     
         $last_is_line_empty = true; // 初始状态：假定文件开头是空行或文件为空
         $div_id_counter = 0;
         $in_div_block = false; // 标记当前是否在一个div块中
     
         foreach ($rawLines as $index => $line) {
             // 清理当前行，去除首尾空白字符（包括换行符）
             $trimmed_line = trim($line);
             $is_line_empty = ($trimmed_line === '');
     
             // 场景1: 上一行是空行，当前行非空 -> 开始一个新的
     块
             if ($last_is_line_empty && !$is_line_empty) {
                 $div_id_counter++;
                 $outputHtml .= "
     \n";
                 $outputHtml .= "    " . htmlspecialchars($trimmed_line) . "\n";
                 $in_div_block = true;
             }
             // 场景2: 上一行非空，当前行非空 -> 继续在当前
     块内或独立
             else if (!$last_is_line_empty && !$is_line_empty) {
                 if ($in_div_block) {
                     $outputHtml .= "    " . htmlspecialchars($trimmed_line) . "\n";
                 } else {
                     // 如果之前没有进入div块，但也没有空行分隔，则单独输出span
                     $outputHtml .= "" . htmlspecialchars($trimmed_line) . "\n";
                 }
             }
             // 场景3: 上一行非空，当前行是空行 -> 结束当前的
     块
             else if (!$last_is_line_empty && $is_line_empty) {
                 if ($in_div_block) {
                     $outputHtml .= "
     \n";
                     $in_div_block = false;
                 }
                 // 如果不在div块中，空行则不输出任何内容
             }
             // 场景4: 上一行是空行，当前行也是空行 -> 忽略，不做任何输出
     
             $last_is_line_empty = $is_line_empty;
         }
     
         // 文件处理完毕后，如果最后一个
     块尚未关闭，则关闭它
         if ($in_div_block) {
             $outputHtml .= "
     \n";
         }
     
         return $outputHtml;
     }
     
     // 使用示例
     $dataFilePath = 'data.txt';
     echo generateStructuredHtmlFromText($dataFilePath, 'custom-line-item');
     
     ?>

     示例 data.txt 内容：

     words group 1.1
     words group 1.2
     words group 1.3
     
     words group 2.1
     words group 2.2
     
     words group 3.1
     words group 3.2

     运行上述PHP代码的输出：

     
         words group 1.1
         words group 1.2
         words group 1.3
     
     
         words group 2.1
         words group 2.2
     
     
         words group 3.1
         words group 3.2
     

     代码解析

     1. generateStructuredHtmlFromText(string $filepath, string $spanClass = 'my-class'): string 函数：

        • 将核心逻辑封装在一个函数中，提高了代码的可重用性。
        • 接受文件路径和标签的CSS类名作为参数。
        • 首先检查文件是否存在，提高健壮性。

     2. $rawLines = file($filepath);：

        

        唱鸭

        音乐创作全流程的AI自动作曲工具，集 AI 辅助作词、AI 自动作曲、编曲、混音于一体

        下载
        • file()函数读取整个文件，并将其内容按行分割成一个数组。
        • 重要的是，这里我们读取了所有行，包括空行，以便正确检测换行模式。

     3. $last_is_line_empty = true;：

        • 这是一个关键的状态变量。初始化为true，意味着我们假设在处理第一行之前，存在一个“虚拟的”空行。这有助于在文件开头是非空行时，正确地开启第一个
          。
        • $div_id_counter用于为每个
          生成唯一的ID。
        • $in_div_block用于跟踪当前是否处于一个打开的
          块内。

        • foreach ($rawLines as $index => $line)：

          • 遍历文件中的每一行。

        • $trimmed_line = trim($line); 和 $is_line_empty = ($trimmed_line === '');：

          • trim()函数用于去除字符串两端的空白字符（包括空格、制表符、换行符等）。
          • 通过比较trim()后的结果是否为空字符串来判断当前行是否为“空行”。这种方式比strlen($line)

        • 条件分支逻辑：

          • if ($last_is_line_empty && !$is_line_empty)：
            • 当上一行是空行（true）而当前行不是空行（false）时，这标志着一个新内容块的开始。
            • 此时，我们递增$div_id_counter，输出一个带有唯一ID的
              标签，并在其内部输出当前行的标签。
            • 设置$in_div_block = true;表示我们现在在一个div块内。
            • else if (!$last_is_line_empty && !$is_line_empty)：
              • 当上一行和当前行都不是空行时，表示内容仍在同一个块中。
              • 如果$in_div_block为真，说明我们正在一个div块内，继续输出。
              • 如果$in_div_block为假，说明之前没有空行分隔，直接输出独立的。这处理了没有空行分隔的普通多行文本情况。
            • else if (!$last_is_line_empty && $is_line_empty)：
              • 当上一行非空而当前行是空行时，这标志着一个内容块的结束。
              • 如果$in_div_block为真，则输出
     标签来关闭当前的
     。
   • 设置$in_div_block = false;表示我们已离开div块。
   • 其他情况： 如果上一行和当前行都是空行，或者文件以非空行开头但没有空行分隔，则不进行特殊处理。

   • $last_is_line_empty = $is_line_empty;：

     • 在每次循环结束时，更新$last_is_line_empty变量，为下一行的判断做准备。

   • if ($in_div_block) { $outputHtml .= "