3 // This file is part of Moodle - http://moodle.org/
5 // Moodle is free software: you can redistribute it and/or modify
6 // it under the terms of the GNU General Public License as published by
7 // the Free Software Foundation, either version 3 of the License, or
8 // (at your option) any later version.
10 // Moodle is distributed in the hope that it will be useful,
11 // but WITHOUT ANY WARRANTY; without even the implied warranty of
12 // MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
13 // GNU General Public License for more details.
15 // You should have received a copy of the GNU General Public License
16 // along with Moodle. If not, see <http://www.gnu.org/licenses/>.
19 * This plugin is used to upload files
22 * @package repository_upload
23 * @copyright 2010 Dongsheng Cai {@link http://dongsheng.org}
24 * @license http://www.gnu.org/copyleft/gpl.html GNU GPL v3 or later
26 require_once($CFG->dirroot
. '/repository/lib.php');
29 * A repository plugin to allow user uploading files
32 * @package repository_upload
33 * @copyright 2009 Dongsheng Cai {@link http://dongsheng.org}
34 * @license http://www.gnu.org/copyleft/gpl.html GNU GPL v3 or later
37 class repository_upload
extends repository
{
38 private $mimetypes = array();
44 public function print_login() {
45 return $this->get_listing();
49 * Process uploaded file
52 public function upload($saveas_filename, $maxbytes) {
55 $types = optional_param_array('accepted_types', '*', PARAM_RAW
);
56 $savepath = optional_param('savepath', '/', PARAM_PATH
);
57 $itemid = optional_param('itemid', 0, PARAM_INT
);
58 $license = optional_param('license', $CFG->sitedefaultlicense
, PARAM_TEXT
);
59 $author = optional_param('author', '', PARAM_TEXT
);
60 $areamaxbytes = optional_param('areamaxbytes', FILE_AREA_MAX_BYTES_UNLIMITED
, PARAM_INT
);
61 $overwriteexisting = optional_param('overwrite', false, PARAM_BOOL
);
63 return $this->process_upload($saveas_filename, $maxbytes, $types, $savepath, $itemid, $license, $author, $overwriteexisting, $areamaxbytes);
67 * Do the actual processing of the uploaded file
68 * @param string $saveas_filename name to give to the file
69 * @param int $maxbytes maximum file size
70 * @param mixed $types optional array of file extensions that are allowed or '*' for all
71 * @param string $savepath optional path to save the file to
72 * @param int $itemid optional the ID for this item within the file area
73 * @param string $license optional the license to use for this file
74 * @param string $author optional the name of the author of this file
75 * @param bool $overwriteexisting optional user has asked to overwrite the existing file
76 * @param int $areamaxbytes maximum size of the file area.
77 * @return object containing details of the file uploaded
79 public function process_upload($saveas_filename, $maxbytes, $types = '*', $savepath = '/', $itemid = 0,
80 $license = null, $author = '', $overwriteexisting = false, $areamaxbytes = FILE_AREA_MAX_BYTES_UNLIMITED
) {
83 if ((is_array($types) and in_array('*', $types)) or $types == '*') {
84 $this->mimetypes
= '*';
86 foreach ($types as $type) {
87 $this->mimetypes
[] = mimeinfo('type', $type);
91 if ($license == null) {
92 $license = $CFG->sitedefaultlicense
;
95 $record = new stdClass();
96 $record->filearea
= 'draft';
97 $record->component
= 'user';
98 $record->filepath
= $savepath;
99 $record->itemid
= $itemid;
100 $record->license
= $license;
101 $record->author
= $author;
103 $context = context_user
::instance($USER->id
);
104 $elname = 'repo_upload_file';
106 $fs = get_file_storage();
107 $sm = get_string_manager();
109 if ($record->filepath
!== '/') {
110 $record->filepath
= file_correct_filepath($record->filepath
);
113 if (!isset($_FILES[$elname])) {
114 throw new moodle_exception('nofile');
116 if (!empty($_FILES[$elname]['error'])) {
117 switch ($_FILES[$elname]['error']) {
118 case UPLOAD_ERR_INI_SIZE
:
119 throw new moodle_exception('upload_error_ini_size', 'repository_upload');
121 case UPLOAD_ERR_FORM_SIZE
:
122 throw new moodle_exception('upload_error_form_size', 'repository_upload');
124 case UPLOAD_ERR_PARTIAL
:
125 throw new moodle_exception('upload_error_partial', 'repository_upload');
127 case UPLOAD_ERR_NO_FILE
:
128 throw new moodle_exception('upload_error_no_file', 'repository_upload');
130 case UPLOAD_ERR_NO_TMP_DIR
:
131 throw new moodle_exception('upload_error_no_tmp_dir', 'repository_upload');
133 case UPLOAD_ERR_CANT_WRITE
:
134 throw new moodle_exception('upload_error_cant_write', 'repository_upload');
136 case UPLOAD_ERR_EXTENSION
:
137 throw new moodle_exception('upload_error_extension', 'repository_upload');
140 throw new moodle_exception('nofile');
144 \core\antivirus\manager
::scan_file($_FILES[$elname]['tmp_name'], $_FILES[$elname]['name'], true);
146 // {@link repository::build_source_field()}
147 $sourcefield = $this->get_file_source_info($_FILES[$elname]['name']);
148 $record->source
= self
::build_source_field($sourcefield);
150 if (empty($saveas_filename)) {
151 $record->filename
= clean_param($_FILES[$elname]['name'], PARAM_FILE
);
155 $filename = clean_param($_FILES[$elname]['name'], PARAM_FILE
);
156 if (strpos($filename, '.') === false) {
157 // File has no extension at all - do not add a dot.
158 $record->filename
= $saveas_filename;
160 if (preg_match('/\.([a-z0-9]+)$/i', $filename, $match)) {
161 if (isset($match[1])) {
165 $ext = !empty($ext) ?
$ext : '';
166 if (preg_match('#\.(' . $ext . ')$#i', $saveas_filename)) {
167 // saveas filename contains file extension already
168 $record->filename
= $saveas_filename;
170 $record->filename
= $saveas_filename . '.' . $ext;
175 // Check the file has some non-null contents - usually an indication that a user has
176 // tried to upload a folder by mistake
177 if (!$this->check_valid_contents($_FILES[$elname]['tmp_name'])) {
178 throw new moodle_exception('upload_error_invalid_file', 'repository_upload', '', $record->filename
);
181 if ($this->mimetypes
!= '*') {
183 $filemimetype = file_storage
::mimetype($_FILES[$elname]['tmp_name'], $record->filename
);
184 if (!in_array($filemimetype, $this->mimetypes
)) {
185 throw new moodle_exception('invalidfiletype', 'repository', '', get_mimetype_description(array('filename' => $_FILES[$elname]['name'])));
189 if (empty($record->itemid
)) {
193 if (($maxbytes!==-1) && (filesize($_FILES[$elname]['tmp_name']) > $maxbytes)) {
194 $maxbytesdisplay = display_size($maxbytes);
195 throw new file_exception('maxbytesfile', (object) array('file' => $record->filename
,
196 'size' => $maxbytesdisplay));
199 if (file_is_draft_area_limit_reached($record->itemid
, $areamaxbytes, filesize($_FILES[$elname]['tmp_name']))) {
200 throw new file_exception('maxareabytes');
203 $record->contextid
= $context->id
;
204 $record->userid
= $USER->id
;
206 if (repository
::draftfile_exists($record->itemid
, $record->filepath
, $record->filename
)) {
207 $existingfilename = $record->filename
;
208 $unused_filename = repository
::get_unused_filename($record->itemid
, $record->filepath
, $record->filename
);
209 $record->filename
= $unused_filename;
210 $stored_file = $fs->create_file_from_pathname($record, $_FILES[$elname]['tmp_name']);
211 if ($overwriteexisting) {
212 repository
::overwrite_existing_draftfile($record->itemid
, $record->filepath
, $existingfilename, $record->filepath
, $record->filename
);
213 $record->filename
= $existingfilename;
216 $event['event'] = 'fileexists';
217 $event['newfile'] = new stdClass
;
218 $event['newfile']->filepath
= $record->filepath
;
219 $event['newfile']->filename
= $unused_filename;
220 $event['newfile']->url
= moodle_url
::make_draftfile_url($record->itemid
, $record->filepath
, $unused_filename)->out(false);
222 $event['existingfile'] = new stdClass
;
223 $event['existingfile']->filepath
= $record->filepath
;
224 $event['existingfile']->filename
= $existingfilename;
225 $event['existingfile']->url
= moodle_url
::make_draftfile_url($record->itemid
, $record->filepath
, $existingfilename)->out(false);
229 $stored_file = $fs->create_file_from_pathname($record, $_FILES[$elname]['tmp_name']);
233 'url'=>moodle_url
::make_draftfile_url($record->itemid
, $record->filepath
, $record->filename
)->out(false),
234 'id'=>$record->itemid
,
235 'file'=>$record->filename
);
240 * Checks the contents of the given file is not completely NULL - this can happen if a
241 * user drags & drops a folder onto a filemanager / filepicker element
242 * @param string $filepath full path (including filename) to file to check
243 * @return true if file has at least one non-null byte within it
245 protected function check_valid_contents($filepath) {
248 $fp = fopen($filepath, 'r');
250 return false; // Cannot read the file - something has gone wrong
253 // Read the file 4k at a time
254 $data = fread($fp, $buffersize);
255 if (preg_match('/[^\0]+/', $data)) {
257 return true; // Return as soon as a non-null byte is found
260 // Entire file is NULL
266 * Return a upload form
269 public function get_listing($path = '', $page = '') {
272 $ret['nologin'] = true;
273 $ret['nosearch'] = true;
274 $ret['norefresh'] = true;
275 $ret['list'] = array();
276 $ret['dynload'] = false;
277 $ret['upload'] = array('label'=>get_string('attachment', 'repository'), 'id'=>'repo-form');
278 $ret['allowcaching'] = true; // indicates that result of get_listing() can be cached in filepicker.js
283 * supported return types
286 public function supported_returntypes() {
287 return FILE_INTERNAL
;
291 * Is this repository accessing private data?
295 public function contains_private_data() {