本文旨在深入探讨php `readfile()` 函数的正确用法，解决常见的“`readfile()` 后出现额外数字”的困惑。我们将阐明 `readfile()` 函数不仅直接输出文件内容，还会返回所读取的字节数，因此与 `echo` 结合使用会导致冗余输出。同时，文章还将指导如何在html环境中正确处理文件中的换行符，确保内容以预期格式显示。
理解 readfile() 函数的行为
PHP的 readfile() 函数是一个非常方便的工具，用于直接将文件内容输出到输出缓冲区（通常是浏览器）。它的主要特点是：
- 直接输出内容： readfile() 会读取指定文件的全部内容，并将其直接发送到标准输出。这意味着你通常不需要再使用 echo 或 print 来显示文件内容。
- 返回字节数： readfile() 函数在成功执行后，会返回所读取文件的字节数。如果发生错误，它将返回 false。
当你在代码中使用 echo readfile("filename.txt"); 时，就会出现问题。readfile() 首先会读取 filename.txt 的内容并将其输出到浏览器。然后，readfile() 函数会返回它所读取的字节数（例如，如果文件内容是 "Mickey Doe\nMinnie Doe\n"，总共22个字符/字节），这个返回值又被 echo 捕获并输出。因此，你会在文件内容的末尾看到这个表示字节数的数字。
例如，对于包含 "Mickey Doe\nMinnie Doe\n" 的文件，readfile() 会先输出：
Mickey Doe Minnie Doe
然后，readfile() 返回 22 (Mickey Doe\nMinnie Doe\n 的字节数)。接着 echo 会输出这个 22。最终在浏览器中可能看到：
立即学习“PHP免费学习笔记（深入）”；
Mickey Doe Minnie Doe 22
正确使用 readfile()
为了避免额外的数字输出，只需直接调用 readfile() 函数，而不要在其前面加上 echo。
错误示例（导致额外数字）：
<?php
$myfile = fopen("newfile.txt", "w") or die("Unable to open the file");
fwrite($myfile, "Mickey Doe\n");
fwrite($myfile, "Minnie Doe\n");
fclose($myfile);
echo readfile("newfile.txt"); // 这里是问题所在
?>正确示例（避免额外数字）：
<?php
$myfile = fopen("newfile.txt", "w") or die("Unable to open the file");
fwrite($myfile, "Mickey Doe\n");
fwrite($myfile, "Minnie Doe\n");
fclose($myfile);
readfile("newfile.txt"); // 直接调用，不使用 echo
?>这样，浏览器只会显示文件的内容，而不会有额外的数字。
在HTML环境中处理换行符
文件中的 \n (换行符) 在文本编辑器中会创建新的一行，但在HTML浏览器中，\n 通常会被解释为空格，并不会强制换行。要在HTML中实现换行，你需要使用HTML的 <br> 标签。
如果你希望文件内容在浏览器中也显示为多行，有两种主要方法：
-
在写入文件时使用 <br>： 直接将 <br>\n 写入文件，这样 readfile() 输出的内容就包含了HTML换行符。
<?php $myfile = fopen("newfile.txt", "w") or die("Unable to open the file"); fwrite($myfile, "Mickey Doe<br>\n"); // 使用 <br> 标签 fwrite($myfile, "Minnie Doe<br>\n"); // 使用 <br> 标签 fclose($myfile); readfile("newfile.txt"); ?>这种方法适用于你希望文件内容本身就包含HTML格式的情况。
-
使用 nl2br() 函数在输出前转换： 如果你文件中的内容只是纯文本，只包含 \n 换行符，但你希望在HTML页面中显示时它们能转换为 <br>，那么可以在读取文件内容后，使用 nl2br() 函数进行转换。
<?php $myfile = fopen("newfile.txt", "w") or die("Unable to open the file"); fwrite($myfile, "Mickey Doe\n"); // 文件中仍是纯文本换行 fwrite($myfile, "Minnie Doe\n"); fclose($myfile); $fileContent = file_get_contents("newfile.txt"); // 使用 file_get_contents 读取内容 echo nl2br($fileContent); // 使用 nl2br 转换并输出 ?>请注意，这里我们使用了 file_get_contents() 来读取整个文件内容到一个字符串变量，然后对这个字符串应用 nl2br()，最后再用 echo 输出。readfile() 函数由于直接输出，不方便进行这种中间处理。选择哪种方法取决于你的具体需求和文件内容的性质。
完整示例代码
结合上述讨论，以下是一个优化后的PHP代码示例，它创建文件、写入内容，并以正确的方式在HTML中显示：
<!DOCTYPE html>
<html lang="en">
<head>
<meta charset="UTF-8">
<meta http-equiv="X-UA-Compatible" content="IE=edge">
<meta name="viewport" content="width=device-width, initial-scale=1.0">
<title>PHP readfile 示例</title>
</head>
<body>
<h1>文件内容显示</h1>
<pre>
<?php
// 1. 创建并写入文件
$filename = "newfile.txt";
$myfile = fopen($filename, "w") or die("无法打开文件进行写入！");
$txt1 = "Mickey Doe\n";
$txt2 = "Minnie Doe\n";
fwrite($myfile, $txt1);
fwrite($myfile, $txt2);
fclose($myfile);
echo "<h2>使用 readfile() 直接输出 (内容包含纯文本换行):</h2>";
// 2. 直接使用 readfile() 输出文件内容
// 注意：在浏览器中，纯文本换行符 \n 不会显示为换行
readfile($filename);
echo "<h2>使用 file_get_contents() 和 nl2br() 转换后输出:</h2>";
// 3. 读取文件内容到变量，并使用 nl2br() 转换为 HTML 换行
$content = file_get_contents($filename);
echo nl2br($content);
echo "<h2>写入时包含 <br> 标签，再使用 readfile() 输出:</h2>";
// 4. 重新写入文件，这次直接包含 <br> 标签
$myfile_html = fopen("newfile_html.txt", "w") or die("无法打开文件进行写入！");
fwrite($myfile_html, "Goofy Doe<br>\n");
fwrite($myfile_html, "Donald Duck<br>\n");
fclose($myfile_html);
readfile("newfile_html.txt");
?>
</pre>
</body>
</html>在上述代码中，我们展示了三种不同的处理方式，以满足不同的显示需求。<pre> 标签用于在HTML中保留文本的预格式化，包括空格和换行符，这在调试时非常有用，但通常我们更倾向于使用 <br> 来控制布局。
总结与注意事项
- readfile() 的核心用途： 直接将文件内容输出到浏览器，非常适合下载文件或显示纯文本内容。
- 避免 echo readfile()： readfile() 本身会输出内容，并返回字节数。在其前面加上 echo 会导致字节数被额外输出。
- HTML换行处理： 在HTML环境中，\n 不会产生可见的换行。需要使用 <br> 标签或 nl2br() 函数来确保内容正确分行显示。
-
选择合适的方法：
- 如果文件内容需要直接作为HTML片段，可以在写入时就包含 <br>。
- 如果文件是纯文本，需要动态转换为HTML显示，可以使用 file_get_contents() 结合 nl2br()。
- 如果只是想将文件内容原封不动地输出，且不关心HTML格式，直接使用 readfile() 即可。
通过理解 readfile() 的工作原理及其返回值，并掌握HTML换行符的处理方式，可以有效避免常见的PHP文件操作和显示问题。
