Andrey Andreev | c5536aa | 2012-11-01 17:33:58 +0200 | [diff] [blame^] | 1 | <?php |
Derek Allard | 2067d1a | 2008-11-13 22:59:24 +0000 | [diff] [blame] | 2 | /** |
| 3 | * CodeIgniter |
| 4 | * |
Phil Sturgeon | 07c1ac8 | 2012-03-09 17:03:37 +0000 | [diff] [blame] | 5 | * An open source application development framework for PHP 5.2.4 or newer |
Derek Allard | 2067d1a | 2008-11-13 22:59:24 +0000 | [diff] [blame] | 6 | * |
Derek Jones | f4a4bd8 | 2011-10-20 12:18:42 -0500 | [diff] [blame] | 7 | * NOTICE OF LICENSE |
Andrey Andreev | b38c5dd | 2012-02-29 14:07:45 +0200 | [diff] [blame] | 8 | * |
Derek Jones | f4a4bd8 | 2011-10-20 12:18:42 -0500 | [diff] [blame] | 9 | * Licensed under the Open Software License version 3.0 |
Andrey Andreev | b38c5dd | 2012-02-29 14:07:45 +0200 | [diff] [blame] | 10 | * |
Derek Jones | f4a4bd8 | 2011-10-20 12:18:42 -0500 | [diff] [blame] | 11 | * This source file is subject to the Open Software License (OSL 3.0) that is |
| 12 | * bundled with this package in the files license.txt / license.rst. It is |
| 13 | * also available through the world wide web at this URL: |
| 14 | * http://opensource.org/licenses/OSL-3.0 |
| 15 | * If you did not receive a copy of the license and are unable to obtain it |
| 16 | * through the world wide web, please send an email to |
| 17 | * licensing@ellislab.com so we can send you a copy immediately. |
| 18 | * |
Derek Allard | 2067d1a | 2008-11-13 22:59:24 +0000 | [diff] [blame] | 19 | * @package CodeIgniter |
Derek Jones | f4a4bd8 | 2011-10-20 12:18:42 -0500 | [diff] [blame] | 20 | * @author EllisLab Dev Team |
Greg Aker | 0defe5d | 2012-01-01 18:46:41 -0600 | [diff] [blame] | 21 | * @copyright Copyright (c) 2008 - 2012, EllisLab, Inc. (http://ellislab.com/) |
Derek Jones | f4a4bd8 | 2011-10-20 12:18:42 -0500 | [diff] [blame] | 22 | * @license http://opensource.org/licenses/OSL-3.0 Open Software License (OSL 3.0) |
Derek Allard | 2067d1a | 2008-11-13 22:59:24 +0000 | [diff] [blame] | 23 | * @link http://codeigniter.com |
| 24 | * @since Version 1.0 |
| 25 | * @filesource |
| 26 | */ |
Andrey Andreev | c5536aa | 2012-11-01 17:33:58 +0200 | [diff] [blame^] | 27 | defined('BASEPATH') OR exit('No direct script access allowed'); |
Derek Allard | 2067d1a | 2008-11-13 22:59:24 +0000 | [diff] [blame] | 28 | |
Derek Allard | 2067d1a | 2008-11-13 22:59:24 +0000 | [diff] [blame] | 29 | /** |
| 30 | * CodeIgniter Download Helpers |
| 31 | * |
| 32 | * @package CodeIgniter |
| 33 | * @subpackage Helpers |
| 34 | * @category Helpers |
Derek Jones | f4a4bd8 | 2011-10-20 12:18:42 -0500 | [diff] [blame] | 35 | * @author EllisLab Dev Team |
Derek Allard | 2067d1a | 2008-11-13 22:59:24 +0000 | [diff] [blame] | 36 | * @link http://codeigniter.com/user_guide/helpers/download_helper.html |
| 37 | */ |
| 38 | |
| 39 | // ------------------------------------------------------------------------ |
| 40 | |
Derek Allard | 2067d1a | 2008-11-13 22:59:24 +0000 | [diff] [blame] | 41 | if ( ! function_exists('force_download')) |
| 42 | { |
Timothy Warren | 01b129a | 2012-04-27 11:36:50 -0400 | [diff] [blame] | 43 | /** |
| 44 | * Force Download |
| 45 | * |
| 46 | * Generates headers that force a download to happen |
| 47 | * |
| 48 | * @param string filename |
| 49 | * @param mixed the data to be downloaded |
Alex Bilbie | f512b73 | 2012-06-16 11:15:19 +0100 | [diff] [blame] | 50 | * @param bool whether to try and send the actual file MIME type |
Timothy Warren | 01b129a | 2012-04-27 11:36:50 -0400 | [diff] [blame] | 51 | * @return void |
| 52 | */ |
Andrey Andreev | b38c5dd | 2012-02-29 14:07:45 +0200 | [diff] [blame] | 53 | function force_download($filename = '', $data = '', $set_mime = FALSE) |
Derek Allard | 2067d1a | 2008-11-13 22:59:24 +0000 | [diff] [blame] | 54 | { |
Alex Bilbie | 773ccc3 | 2012-06-02 11:11:08 +0100 | [diff] [blame] | 55 | if ($filename === '' OR $data === '') |
Derek Allard | 2067d1a | 2008-11-13 22:59:24 +0000 | [diff] [blame] | 56 | { |
| 57 | return FALSE; |
| 58 | } |
| 59 | |
Andrey Andreev | b38c5dd | 2012-02-29 14:07:45 +0200 | [diff] [blame] | 60 | // Set the default MIME type to send |
| 61 | $mime = 'application/octet-stream'; |
| 62 | |
Andrey Andreev | fce2ed6 | 2012-03-11 22:04:48 +0200 | [diff] [blame] | 63 | $x = explode('.', $filename); |
| 64 | $extension = end($x); |
| 65 | |
Andrey Andreev | b38c5dd | 2012-02-29 14:07:45 +0200 | [diff] [blame] | 66 | if ($set_mime === TRUE) |
Derek Allard | 2067d1a | 2008-11-13 22:59:24 +0000 | [diff] [blame] | 67 | { |
Andrey Andreev | fce2ed6 | 2012-03-11 22:04:48 +0200 | [diff] [blame] | 68 | if (count($x) === 1 OR $extension === '') |
Andrey Andreev | b38c5dd | 2012-02-29 14:07:45 +0200 | [diff] [blame] | 69 | { |
Andrey Andreev | fce2ed6 | 2012-03-11 22:04:48 +0200 | [diff] [blame] | 70 | /* If we're going to detect the MIME type, |
| 71 | * we'll need a file extension. |
| 72 | */ |
Andrey Andreev | b38c5dd | 2012-02-29 14:07:45 +0200 | [diff] [blame] | 73 | return FALSE; |
| 74 | } |
| 75 | |
Andrey Andreev | b38c5dd | 2012-02-29 14:07:45 +0200 | [diff] [blame] | 76 | // Load the mime types |
Andrey Andreev | 6ef498b | 2012-06-05 22:01:58 +0300 | [diff] [blame] | 77 | $mimes =& get_mimes(); |
Andrey Andreev | b38c5dd | 2012-02-29 14:07:45 +0200 | [diff] [blame] | 78 | |
| 79 | // Only change the default MIME if we can find one |
| 80 | if (isset($mimes[$extension])) |
| 81 | { |
| 82 | $mime = is_array($mimes[$extension]) ? $mimes[$extension][0] : $mimes[$extension]; |
| 83 | } |
Derek Allard | 2067d1a | 2008-11-13 22:59:24 +0000 | [diff] [blame] | 84 | } |
Barry Mieny | dd67197 | 2010-10-04 16:33:58 +0200 | [diff] [blame] | 85 | |
Andrey Andreev | fce2ed6 | 2012-03-11 22:04:48 +0200 | [diff] [blame] | 86 | /* It was reported that browsers on Android 2.1 (and possibly older as well) |
| 87 | * need to have the filename extension upper-cased in order to be able to |
| 88 | * download it. |
| 89 | * |
| 90 | * Reference: http://digiblog.de/2011/04/19/android-and-the-download-file-headers/ |
| 91 | */ |
Andrey Andreev | 3d933b6 | 2012-03-11 22:08:57 +0200 | [diff] [blame] | 92 | if (count($x) !== 1 && isset($_SERVER['HTTP_USER_AGENT']) && preg_match('/Android\s(1|2\.[01])/', $_SERVER['HTTP_USER_AGENT'])) |
Andrey Andreev | fce2ed6 | 2012-03-11 22:04:48 +0200 | [diff] [blame] | 93 | { |
| 94 | $x[count($x) - 1] = strtoupper($extension); |
| 95 | $filename = implode('.', $x); |
| 96 | } |
Andrey Andreev | ae31eb5 | 2012-05-17 14:54:15 +0300 | [diff] [blame] | 97 | |
Sam Li | bbd9dd3 | 2012-04-23 23:13:46 +0800 | [diff] [blame] | 98 | // Clean output buffer |
Michiel Vugteveen | 28ff292 | 2012-08-14 10:55:46 +0200 | [diff] [blame] | 99 | if (ob_get_level() !== 0) |
| 100 | { |
| 101 | ob_clean(); |
| 102 | } |
Andrey Andreev | fce2ed6 | 2012-03-11 22:04:48 +0200 | [diff] [blame] | 103 | |
Derek Allard | 2067d1a | 2008-11-13 22:59:24 +0000 | [diff] [blame] | 104 | // Generate the server headers |
dododedodonl | 4da9478 | 2012-03-10 13:56:17 +0100 | [diff] [blame] | 105 | header('Content-Type: '.$mime); |
Eric Roberts | 0e4d2b6 | 2012-01-23 18:19:20 -0600 | [diff] [blame] | 106 | header('Content-Disposition: attachment; filename="'.$filename.'"'); |
| 107 | header('Expires: 0'); |
Andrey Andreev | b38c5dd | 2012-02-29 14:07:45 +0200 | [diff] [blame] | 108 | header('Content-Transfer-Encoding: binary'); |
| 109 | header('Content-Length: '.strlen($data)); |
Eric Roberts | 0e4d2b6 | 2012-01-23 18:19:20 -0600 | [diff] [blame] | 110 | |
Andrey Andreev | b38c5dd | 2012-02-29 14:07:45 +0200 | [diff] [blame] | 111 | // Internet Explorer-specific headers |
| 112 | if (isset($_SERVER['HTTP_USER_AGENT']) && strpos($_SERVER['HTTP_USER_AGENT'], 'MSIE') !== FALSE) |
Derek Allard | 2067d1a | 2008-11-13 22:59:24 +0000 | [diff] [blame] | 113 | { |
Andrey Andreev | d87f6bf | 2012-10-24 22:12:53 +0300 | [diff] [blame] | 114 | header('Cache-Control: no-cache, no-store, must-revalidate'); |
Derek Allard | 2067d1a | 2008-11-13 22:59:24 +0000 | [diff] [blame] | 115 | } |
Andrey Andreev | d87f6bf | 2012-10-24 22:12:53 +0300 | [diff] [blame] | 116 | |
| 117 | header('Pragma: no-cache'); |
Barry Mieny | dd67197 | 2010-10-04 16:33:58 +0200 | [diff] [blame] | 118 | |
Derek Allard | 2067d1a | 2008-11-13 22:59:24 +0000 | [diff] [blame] | 119 | exit($data); |
| 120 | } |
| 121 | } |
| 122 | |
Derek Allard | 2067d1a | 2008-11-13 22:59:24 +0000 | [diff] [blame] | 123 | /* End of file download_helper.php */ |
Andrey Andreev | 627e172 | 2012-03-26 20:53:47 +0300 | [diff] [blame] | 124 | /* Location: ./system/helpers/download_helper.php */ |