파일 다운로드 함수(HTTP/1.1을 70% 정도 구현)
컨텐츠 정보
- 21,268 조회
- 5 추천
- 목록
본문
글쓴이:이대규 파일 다운로드 함수(HTTP/1.1을 70% 정도 구현) 조회수:329
이대규
http://www.w3.org/Protocols/rfc2616/rfc2616.html
/**
* void WAF_WriteFile(string filename, string mimetype = null, mixed options = null);
*
* 파일을 열어서 클라이언트에게 전송한다.
* 리턴값은 없고, 파일 전송이 완료되면 페이지 처리가 종료된다.
* 오류가 발생할 경우 상황에 맞는 HTTP 표준 오류(4xx, 5xx)가
* 클라이언트에게 전달되고 페이지 처리가 종료된다.
*
* HTTP/1.1 의 다음 기능을 지원함
*
* - Range 헤더 지원(파일의 일부분만 전송)
*
* - If-Modified-Since 헤더 지원(변경된 경우만 전송)
*
* 클라이언트의 캐시에 컨텐츠가 이미 있을 경우
* 마지막 확인 시간 전송해서 그 이후에 변경되었으면 전송을 하고 변경이 안되었으면
* 같은 컨텐츠가 다시 전송 되는 것을 피하기 위해서 사용한다.
* 변경이 되었으면 전송을 하고(200 OK), 변경 안되었으면 304 Not Modified 를 리턴한다.
*
* - If-Unmodified-Since 헤더 지원(변경 안된 경우만 전송)
*
* If-Unmodified-Since 헤더는 캐시에 컨텐츠의 일부만 있을 경우
* 마지막 확인 시간 전송해서 그 이후에 변경되지 않았으면 필요한 부분만 전송을 하고
* 변경이 안되었을 경우 전체를 받기 위해서 사용한다.(Range 헤더와 조합으로)
* 변경이 되었으면 412 Precondition Failed 을 리턴하고,
* 변경 안되었으면 전송한다. (200 OK 또는 206 Partial Content)
*
* - If-Range 헤더 지원(변경 안된 경우는 부분전송, 변경된 경우는 전체 전송)
*
* If-Range 헤더는 If-Unmodified-Since 와 비슷한데
* If-Unmodified-Since는 변경된 경우에는 412 Precondition Failed 오류로 요청을 끝내므로
* 새로 갱신된 파일을 받으려면 다시 요청을 해야한다.
* If-Range 는 변경이 안되었으면 부분전송을 하고, 변경된 경우는 전체 전송을 하도록 한다.
* Range 헤더가 같이 지정되지 않으면 의미가 없다.
* ※ HTTP/1.1 규약에는 엔티티 태그(Etags 헤더)를 시간 대신에 보낼 수도 있으나
* 이 함수는 엔티티 태그를 지원하지 않는다.
*
* GET /_test/test_range.php HTTP/1.0 // wget은 HTTP/1.1 을
* User-Agent: Wget/1.8.2 // 100% 지원하지 못하는 듯
* Host: image.cine21.com // If- 씨리즈 헤더는 직접지정해야함
* Connection: Keep-Alive
* Range: bytes=200- // Range 헤더가 지정됨
* If-Range: Fri, 19 May 2005 08:03:25 +0000 // 이전에 받은 시간
*
* HTTP/1.1 200 OK // 그러나 200 OK(전체 전송)
* Date: Fri, 20 May 2005 09:20:43 GMT
* Server: Apache
* Content-Length: 512
* Last-Modified: Fri, 20 May 2005 05:03:25 +0000 // 새로 변경된 시간
* Accept-Ranges: bytes
* Keep-Alive: timeout=3, max=128
* Connection: Keep-Alive
* Content-Type: text/plain;charset=euc-kr
*
* ※ HTTP/1.1 규약의 엔티티 태그 관련 Etags, If-Match, If-None-Match 등은 지원하지 않는다.
*
* options:
* disposition
* Content-Disposition 헤더를 지정한다.
* 206 Partial Content, 304 Not Modified 일경우는 무시된다.
*
* WAF_WriteFile($filename, null, array('disposition' => 'attachment'));
*
* filename
* Content-Disposition 헤더에 출력될 파일이름을 지정한다.
*
* $options = array(
* 'disposition' => 'attachment',
* 'filename' => 'a.txt',
* );
* WAF_WriteFile($filename, null, $options);
*
* headers
* 추가 헤더를 지정한다. 파일 전송이 성공될 경우만 실행된다.
*
* $options = array(
* 'headers' => array(
* 'Expires' => gmdate('r', time() + 86400), // 앞으로 24시간까지만 유효함
* );
* );
* WAF_WriteFile($filename, null, $options);
*
* range
* Range 헤더를 override 한다. 클라이언트에서 전달된
* Range 헤더($_SERVER['HTTP_RANGE']) 대신 지정한 값을 쓴다.
*
* WAF_WriteFile($filename, null, array('range' => 'bytes=100-'));
*
* 혹은 부분 전송 기능을 disable 시키기 위해서 사용할 수 있다.
*
* WAF_WriteFile($filename, null, array('range' => FALSE));
*
* check_func
* 파일 이름을 전달받아 boolean을 리턴하는 함수를 만들어
* 검사 함수로 전달할 수 있다.
*
* // 상대경로로 상위 디렉토리의 파일을 찾는 것을 금지
* function SampleCallback($filename) {
* return ($filename{0} == '/' || strpos($filename, '../') === FALSE);
* }
* WAF_WriteFile($filename, null, array('check_func' => 'SampleCallback'));
*/
function WAF_WriteFile($filename, $mimetype = null, $options = null)
{
if (!file_exists($filename)) {
WAF_HTTPError(404); // 404 Not Found
}
elseif (!is_file($filename) || !is_readable($filename)) {
WAF_HTTPError(403); // 403 Forbidden
}
// 만약 검사 함수가 지정되면 추가적인 검사를 수행
if (is_callable($options['check_func'])) {
if (!call_user_func($options['check_func'], $filename)) {
WAF_HTTPError(403); // 403 Forbidden
}
}
// 전체 전송, 부분전송 공통 헤더 설정
$mtime = filemtime($filename);
// If-Modified-Since 처리
if ($_SERVER['HTTP_IF_MODIFIED_SINCE']) {
$if_modified_since = strtotime($_SERVER['HTTP_IF_MODIFIED_SINCE']);
if ($if_modified_since >= $mtime) {
Header("HTTP/1.1 304 Not Modified");
exit();
}
}
// If-Unmodified-Since 처리
if ($_SERVER['HTTP_IF_UNMODIFIED_SINCE']) {
$if_modified_since = strtotime($_SERVER['HTTP_IF_UNMODIFIED_SINCE']);
if ($if_modified_since < $mtime) {
WAF_HTTPError(412); // 412 Precondition Failed
exit();
}
}
$options['headers']["Last-Modified"] = gmdate("r", $mtime);
if ($mimetype == null)
$mimetype = "application/octet-stream";
$options['headers']["Content-Type"] = $mimetype;
// options에 Range 헤더를 지정할 경우 클라이언트에서 온 정보를 무시한다.
$range = (isset($options['range']))? $options['range']: $_SERVER['HTTP_RANGE'];
// If-Range 처리
if ($_SERVER['HTTP_IF_RANGE']) {
$if_modified_since = strtotime($_SERVER['HTTP_IF_RANGE']);
if ($if_modified_since < $mtime) {
$range = ''; // 변경이 되었으므로 전체 전송을 하도록 한다.
}
}
if ($range && preg_match('/bytes\\s*=\\s*(\\d+)?\\s*-\\s*(\\d+)?/i', $range, $part))
{
$start = $part[1];
$end = $part[2];
$options['headers']["Accept-Ranges"] = "bytes";
WAF_WritePartialFile($filename, $start, $end, $mimetype, $options);
}
else { // Range 헤더가 없거나, 형식이 올바르지 않거나, 단위가 bytes 가 아닐 때
// 그러나 range 지원이 중지되지 않았으면 Range 헤더를 지원한다는 것을 알려준다.
if (!(isset($options['range']) && !$options['range']))
$options['headers']["Accept-Ranges"] = "bytes";
if ($options['disposition']) {
$basename = ($options['filename'])? $options['filename']: basename($filename);
$options['headers']["Content-Disposition"] = "{$options['disposition']}; filename=\\"{$basename}\\"";
}
WAF_WriteFullFile($filename, $mimetype, $options);
}
exit();
}
/**
* 파일을 열어서 전체를 전송한다.
* 독립적으로 사용하지 말고 WAF_WriteFile()을 사용할 것
*/
function WAF_WriteFullFile($filename, $mimetype = null, $options = null)
{
global $BUFSIZ;
$length = filesize($filename);
Header("HTTP/1.1 200 OK");
Header("Content-Length: $length");
if (count($options['headers']) > 0) {
foreach ($options['headers'] as $header => $value)
Header("$header: $value");
}
// 만약 출력된 것이 버퍼에 있으면 지운다.
ob_end_clean();
// GET, POST 만 실제 파일을 전송한다.
if ($_SERVER['REQUEST_METHOD'] == 'GET' || $_SERVER['REQUEST_METHOD'] == 'POST')
{
// 파일을 연다.
$fp = fopen($filename, "r");
if (!$fp) {
WAF_HTTPError(500); // 500 Internal Server Error
}
while (!feof($fp)) {
$buf = fread($fp, $BUFSIZ);
$read = strlen($buf);
print($buf);
}
fclose($fp);
}
}
/**
* 파일을 열어서 일부분을 전송한다.
* 독립적으로 사용하지 말고 WAF_WriteFile()을 사용할 것
*/
function WAF_WritePartialFile($filename, $start, $end, $mimetype = null, $options = null)
{
global $BUFSIZ;
$filesize = filesize($filename);
if ($end == null)
$end = $filesize - 1;
// 지정한 Range 가 올바르지 않다.
if ($end >= $filesize || $start > $end) {
WAF_HTTPError(416); // 416 Requested Range Not Satisfiable
}
$length = $end - $start + 1;
Header("HTTP/1.1 206 Partial Content");
Header("Content-Length: $length");
Header("Content-Range: bytes {$start}-{$end}/{$filesize}");
if (count($options['headers']) > 0) {
foreach ($options['headers'] as $header => $value)
Header("$header: $value");
}
// 만약 출력된 것이 버퍼에 있으면 지운다.
ob_end_clean();
// GET, POST 만 실제 파일을 전송한다.
if ($_SERVER['REQUEST_METHOD'] == 'GET' || $_SERVER['REQUEST_METHOD'] == 'POST')
{
// 파일을 연다.
$fp = fopen($filename, "r");
if (!$fp) {
WAF_HTTPError(500); // 500 Internal Server Error
}
// 시작 위치로 이동
if ($start > 0) {
$rs = fseek ($fp, $start, SEEK_SET);
if ($rs < 0) {
WAF_HTTPError(500); // 500 Internal Server Error
}
}
// $start 지점에서 $end 지점까지 쓰기
$pos = $start;
while (!feof($fp) && $pos < $end) {
$buf = fread($fp, $BUFSIZ);
$read = strlen($buf);
if ($pos + $read < $end) {
print($buf);
$pos += $read;
}
else {
$read = $end - $pos + 1;
$buf = substr($buf, 0, $read);
print($buf);
$pos += $read;
}
}
fclose($fp);
}
}
global $HTTP_STATUS_MESSAGE;
$HTTP_STATUS_MESSAGE = array(
400 => 'Bad Request', 412 => 'Precondition Failed',
401 => 'Unauthorized', 413 => 'Request Entity Too Large',
402 => 'Payment Required', 414 => 'Request-URI Too Long',
403 => 'Forbidden', 415 => 'Unsupported Media Type',
404 => 'Not Found', 416 => 'Requested Range Not Satisfiable',
405 => 'Method Not Allowed', 417 => 'Expectation Failed',
406 => 'Not Acceptable', 500 => 'Internal Server Error',
407 => 'Proxy Authentication Required', 501 => 'Not Implemented',
408 => 'Request Timeout', 502 => 'Bad Gateway',
409 => 'Conflict', 503 => 'Service Unavailable',
410 => 'Gone', 504 => 'Gateway Timeout',
411 => 'Length Required', 505 => 'HTTP Version Not Supported',
);
function WAF_HTTPError($status, $title = null, $message = null, $options = null)
{
global $HTTP_STATUS_MESSAGE;
$status_message = $HTTP_STATUS_MESSAGE[$status];
Header("HTTP/1.1 {$status} {$status_message}");
Header("Content-Type: text/html");
if ($message == null)
$message = $status_message;
// 버퍼를 클리어
if ($options['error_page']) {
ob_end_clean();
include($options['error_page']);
exit();
}
else {
ob_end_clean();
?>
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.0 Transitional//EN">
<html>
<head>
<title><?= $title ?></title>
</head>
<body>
<h1><?= "$status $status_message" . (($title)? " - $title": "") ?></h1>
<p><?= $message ?></p>
</body>
</html>
<?
exit();
}
}
?>
관련자료
-
링크
댓글 0
등록된 댓글이 없습니다.