在PHP中使用X-SendFile头让文件下载更快

一般来说, 我们可以通过直接让url指向一个位于document root下面的文件, 来引导用户下载文件.

但是, 这样做, 就没办法做一些统计, 权限检查, 等等的工作. 于是, 很多时候, 我们采用让php来做转发, 为用户提供文件下载.

<?php
    $file = "/tmp/dummy.tar.gz";
    header("content-type: application/octet-stream");
    header('content-disposition: attachment; filename="' . basename($file) . '"');
    header("content-length: ". filesize($file));
    readfile($file);

但是这个有一个问题, 就是如果文件是中文名的话, 有的用户可能下载后的文件名是乱码.

于是, 我们做一下修改:

<?php
    $file = "/tmp/中文名.tar.gz";

    $filename = basename($file);

    header("content-type: application/octet-stream");

    //处理中文文件名
    $ua = $_server["http_user_agent"];
    $encoded_filename = rawurlencode($filename);
    if (preg_match("/msie/", $ua)) {
     header('content-disposition: attachment; filename="' . $encoded_filename . '"');
    } else if (preg_match("/firefox/", $ua)) {
     header("content-disposition: attachment; filename*=\"utf8''" . $filename . '"');
    } else {
     header('content-disposition: attachment; filename="' . $filename . '"');
    }

    header("content-length: ". filesize($file));
    readfile($file);

恩, 现在看起来好多了, 不过还有一个问题, 那就是readfile, 虽然php的readfile尝试实现的尽量高效, 不占用php本身的内存, 但是实际上它还是需要采用mmap(如果支持), 或者是一个固定的buffer去循环读取文件, 直接输出.

输出的时候, 如果是apache + php mod, 那么还需要发送到apache的输出缓冲区. 最后才发送给用户. 而对于nginx + fpm如果他们分开部署的话, 那还会带来额外的网络io.

那么, 能不能不经过php这层, 直接让webserver直接把文件发送给用户呢?

今天, 我看到了一个有意思的文章: how i php: x-sendfile.

我们可以使用apache的module mod_xsendfile, 让apache直接发送这个文件给用户:

<?php
    $file = "/tmp/中文名.tar.gz";

    $filename = basename($file);

    header("content-type: application/octet-stream");

    //处理中文文件名
    $ua = $_server["http_user_agent"];
    $encoded_filename = rawurlencode($filename);
    if (preg_match("/msie/", $ua)) {
     header('content-disposition: attachment; filename="' . $encoded_filename . '"');
    } else if (preg_match("/firefox/", $ua)) {
     header("content-disposition: attachment; filename*=\"utf8''" . $filename . '"');
    } else {
     header('content-disposition: attachment; filename="' . $filename . '"');
    }

    //让xsendfile发送文件
    header("x-sendfile: $file");

x-sendfile头将被apache处理, 并且把响应的文件直接发送给client.

lighttpd和nginx也有类似的模块, 大家有兴趣的可以去找找看