note 24249 added to function.fread

From: Date: Sat, 10 Aug 2002 14:45:05 +0000
Subject: note 24249 added to function.fread
Groups: php.notes 
Request: Send a blank email to php-notes+get-34704@lists.php.net to get a copy of this message
Here's a function for sending a file to the client - it may look more complicated than necessary, but has a number of advantages over simpler file sending functions: - Works with large files, and uses only an 8KB buffer per transfer. - Stops transferring if the client is disconnected (unlike many scripts, that continue to read and buffer the entire file, wasting valuable resources) but does not halt the script - Returns TRUE if transfer was completed, or FALSE if the client was disconnected before completing the download - you'll often need this, so you can log downloads correctly. - Sends a number of headers, including ones that ensure it's never cached on the client side in any browser, and "Content-Length" which most people seem to forget Now here's the function: function send_file($name) { $path = "protected/".$name; if (!is_file($path) or connection_status()!=0) return(FALSE); header("Content-type: application/octet-stream"); header("Content-Disposition: inline; filename=\"".$name."\""); header("Content-length: ".(string)(filesize($path))); header("Expires: Mon, 12 Dec 2001 08:00:00 GMT"); header("Last-Modified: ".gmdate("D, d M Y H:i:s")." GMT"); header("Cache-Control: no-cache, must-revalidate"); header("Pragma: no-cache"); if ($file = fopen($path, 'rb')) { while(!feof($file) and (connection_status()==0)) { print(fread($file, 1024*8)); flush(); } return(connection_status()==0); fclose($file); } else { return(FALSE); } } And here's an example of using the function: if (!send_file("platinumdemo.zip")) { die ("file transfer failed"); // either the file transfer was incomplete // or the file was not found } else { // the download was a success // log, or do whatever else } Regards, Rasmus Schultz -- http://www.php.net/manual/en/function.fread.php http://master.php.net/manage/user-notes.php?action=edit+24249 http://master.php.net/manage/user-notes.php?action=delete+24249 http://master.php.net/manage/user-notes.php?action=reject+24249

« previous php.notes (#34704) next »