readfile() 应直接调用而非 echo，否则会额外输出字节数；其参数只需填文件路径，支持流式输出大文件但需注意输出缓冲和权限问题。
readfile() 不是拿来 echo 的，直接调用就行。它自己就把文件内容吐到浏览器了，再套一层 echo 会多输出一个字节数，这是新手最常踩的坑。
为什么 echo readfile() 会在页面末尾多出一串数字
因为 readfile() 的返回值是读取的字节数（比如 2048），而 echo 会把这个数字也打印出来。
现象：文件内容正常显示，但最后跟着一个整数，比如 Mickey Doe\nMinnie Doe\n22。
根本原因：PHP 函数执行 + 返回值被 echo 捕获，属于双重输出。
- 错误写法：
echo readfile('data.txt'); - 正确写法：
readfile('data.txt'); - 如果想在失败时静默处理，加
@：@readfile('data.txt'); - 注意：
@只压制警告，不解决权限、路径或文件不存在等实际问题
readfile() 的三个参数怎么填
readfile() 签名是 readfile(string $filename, bool $use_include_path = false, ?resource $context = null)，日常用第一个就够了。
-
$filename：必须是真实存在的绝对路径或相对于当前脚本的相对路径，比如'./assets/style.css'或__DIR__ . '/config.json' -
$use_include_path：设为true时，PHP 会按include_path配置顺序查找该文件；一般不用，除非你刻意把资源放进了include_path目录 -
$context：高级用法，比如加 HTTP 超时、自定义 User-Agent（对 URL 文件有效）；本地文件基本用不到 - URL 作为
$filename是支持的（需开启fopen wrappers），但不推荐用于外部链接——超时、重定向、SSL 验证都得自己兜底
大文件下载时 readfile() 会卡住或内存溢出吗
不会。readfile() 是流式输出，不加载整个文件进 PHP 内存，所以即使读 2GB 的日志也不会爆内存。但它依赖 PHP 输出缓冲机制，容易被意外干扰。
- 务必确保没有开启
ob_start()后忘记ob_end_flush()，否则内容全卡在缓冲区不出去 - 下载场景下，建议手动关掉输出缓冲：
if (ob_get_level()) ob_end_clean(); - 加上必要响应头，尤其是
Content-Length（可选但推荐）和Content-Type：header('Content-Type: application/octet-stream');header('Content-Length: ' . filesize($file)); - 遇到超大文件（>1GB）且 Apache/Nginx 有代理限制时，考虑换
X-Sendfile或X-Accel-Redirect，readfile()就退居备用方案
readfile() 失败时只返回 false，怎么定位具体问题
readfile() 失败不抛异常，只触发 E_WARNING 并返回 false，所以靠 var_dump() 看不到原因。
- 先检查文件是否存在且可读：
is_file($file) && is_readable($file) - 确认 Web 服务器用户（如 www-data、nginx）有权限读该路径，尤其注意 SELinux 或 macOS 的 ACL 限制
- 路径含中文或特殊字符？试试
rawurlencode()或改用英文命名 - 启用错误报告看警告：
error_reporting(E_ALL); ini_set('display_errors', '1'); - 别用
@readfile()掩盖问题——它只是让警告不显示，不代表问题消失
readfile() 最干净的用法就是三行：关缓冲、设头、调函数。它不处理内容、不解析格式、不校验编码，正因为足够“笨”，才足够稳。真正容易翻车的地方，从来不是函数本身，而是路径权限、输出控制和错误盲区。php免费学习视频：立即使用
踏上前端学习之旅，开启通往精通之路！从前端基础到项目实战，循序渐进，一步一个脚印，迈向巅峰！
