大网数据广告活动
PHP 语言与运行手册

readfile · 输出文件

· 52CE 我爱测

想要在 include_path 中搜索文件,可使用这个可选的第二个参数,设为 true。

readfile

(PHP 4, PHP 5, PHP 7, PHP 8)

readfile — 输出文件

说明

function readfile(string $filename, bool $use_include_path = false, ?resource $context = null): int|false

读取文件并写入到输出缓冲。

参数

filename

要读取的文件名。

use_include_path

想要在 include_path 中搜索文件,可使用这个可选的第二个参数,设为 true。

context

上下文流(context stream) resource。

返回值

成功时返回从文件中读入的字节数, 或者在失败时返回 false

错误/异常

失败时抛出 E_WARNING 警告。

示例

示例 #1 使用 readfile() 强制下载

<?php
$file = 'monkey.gif';

if (file_exists($file)) {
    header('Content-Description: File Transfer');
    header('Content-Type: application/octet-stream');
    header('Content-Disposition: attachment; filename="'.basename($file).'"');
    header('Expires: 0');
    header('Cache-Control: must-revalidate');
    header('Pragma: public');
    header('Content-Length: ' . filesize($file));
    readfile($file);
    exit;
}
?>

以上示例的输出类似于:

注释

注意:

readfile() 自身不会导致任何内存问题。 如果出现内存不足的错误,使用 ob_get_level() 确保输出缓存已经关闭。

小技巧

如已启用fopen 包装器,在此函数中, URL 可作为文件名。关于如何指定文件名详见 fopen()。各种 wapper 的不同功能请参见 支持的协议和封装协议,注意其用法及其可提供的预定义变量。

参见

来源:PHP Documentation Group · 作者与贡献记录 · CC BY 3.0。离线整理了版式、链接和媒体显示。

资料来源与适用范围

资料来源
PHP Documentation Group
适用范围
请按文中版本与环境说明核对
内容语言
中文;命令、路径和错误标识保留技术原文
本地收录日期
2026-11-15
授权说明
CC BY 3.0

正文与所需资源由本站本地存储。查看来源及更新记录 ↗

请按适用版本和实际日志确认原因;本站没有对每一种系统或设备逐项执行文中的操作。