| 步骤 | 关键点 |
| Content-Type | 必须与实际图片格式匹配: JPEG → image/jpeg PNG → image/png GIF → image/gif WebP → image/webp SVG → image/svg+xml |
| 二进制模式 | fopen(..., 'rb') Windows 下防止 \r\n 转换 |
| 文件存在性 | 生产代码需先 is_file() 判断,不存在返回 404 |
| 缓存控制 | 可选添加 header('Cache-Control: public, max-age=31536000'); 启用浏览器缓存 |
| ETag/Last-Modified | 配合 if-none-match 实现 304 Not Modified |
完整健壮版本
<?php
function outputImage(string $path): void {
if (!is_file($path)) {
http_response_code(404);
exit('Image not found');
}
$ext = strtolower(pathinfo($path, PATHINFO_EXTENSION));
$mime = match ($ext) {
'jpg', 'jpeg' => 'image/jpeg',
'png' => 'image/png',
'gif' => 'image/gif',
'webp' => 'image/webp',
'svg' => 'image/svg+xml',
default => 'application/octet-stream',
};
$size = filesize($path);
$etag = md5_file($path);
$lastMod = gmdate('D, d M Y H:i:s', filemtime($path)) . ' GMT';
// 客户端缓存验证
if (isset($_SERVER['HTTP_IF_NONE_MATCH']) && $_SERVER['HTTP_IF_NONE_MATCH'] === $etag) {
http_response_code(304);
exit;
}
if (isset($_SERVER['HTTP_IF_MODIFIED_SINCE']) && strtotime($_SERVER['HTTP_IF_MODIFIED_SINCE']) >= filemtime($path)) {
http_response_code(304);
exit;
}
header('Content-Type: ' . $mime);
header('Content-Length: ' . $size);
header('ETag: ' . $etag);
header('Last-Modified: ' . $lastMod);
header('Cache-Control: public, max-age=31536000'); // 1 年
header('Accept-Ranges: bytes'); // 支持断点续传/视频流式
readfile($path); // 比 fread+echo 更高效,直接发送文件到输出缓冲
}
// 使用
outputImage(__DIR__ . '/images/photo.jpg');
应用场景
- 权限控制下的图片访问(如会员头像、付费资源)
- 动态水印、缩略图生成后直接输出
- 跨域图片代理(解决 Referer 防盗链)
- 数据库 Blob 字段存储图片读取输出
性能提示
readfile() 内部使用 mmap/sendfile 系统调用,零拷贝,比 fread+echo 更快、内存占用更低
- 大文件(>10MB)建议分块读取或使用
X-Sendfile/X-Accel-Redirect 交给 Nginx/Apache 发送
- 高并发场景务必启用 HTTP 缓存(ETag/Last-Modified)减少 PHP 进程占用
掌握这 4 行核心代码与健壮封装,即可实现任意权限控制下的高性能图片直传。
copyright ©
萬盛學電腦網 all rights reserved