Fixed bug #10629: class and title parameters of typolinks get broken
[Packages/TYPO3.CMS.git] / t3lib / class.t3lib_extfilefunc.php
1 <?php
2 /***************************************************************
3 * Copyright notice
4 *
5 * (c) 1999-2009 Kasper Skaarhoj (kasperYYYY@typo3.com)
6 * All rights reserved
7 *
8 * This script is part of the TYPO3 project. The TYPO3 project is
9 * free software; you can redistribute it and/or modify
10 * it under the terms of the GNU General Public License as published by
11 * the Free Software Foundation; either version 2 of the License, or
12 * (at your option) any later version.
13 *
14 * The GNU General Public License can be found at
15 * http://www.gnu.org/copyleft/gpl.html.
16 * A copy is found in the textfile GPL.txt and important notices to the license
17 * from the author is found in LICENSE.txt distributed with these scripts.
18 *
19 *
20 * This script is distributed in the hope that it will be useful,
21 * but WITHOUT ANY WARRANTY; without even the implied warranty of
22 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
23 * GNU General Public License for more details.
24 *
25 * This copyright notice MUST APPEAR in all copies of the script!
26 ***************************************************************/
27 /**
28 * extending class to class t3lib_basicFileFunctions
29 *
30 * $Id$
31 * Revised for TYPO3 3.6 May/2004 by Kasper Skaarhoj
32 *
33 * @author Kasper Skaarhoj <kasperYYYY@typo3.com>
34 */
35 /**
36 * [CLASS/FUNCTION INDEX of SCRIPT]
37 *
38 *
39 *
40 * 105: class t3lib_extFileFunctions extends t3lib_basicFileFunctions
41 * 151: function start($fileCmds)
42 * 181: function init_actionPerms($setup)
43 * 213: function processData()
44 * 270: function printLogErrorMessages($redirect='')
45 * 328: function findRecycler($theFile)
46 * 357: function writeLog($action,$error,$details_nr,$details,$data)
47 *
48 * SECTION: File operation functions
49 * 384: function func_delete($cmds)
50 * 451: function func_copy($cmds)
51 * 542: function func_move($cmds)
52 * 637: function func_rename($cmds)
53 * 683: function func_newfolder($cmds)
54 * 713: function func_newfile($cmds)
55 * 750: function func_edit($cmds)
56 * 782: function func_upload($cmds)
57 * 821: function func_unzip($cmds)
58 *
59 * TOTAL FUNCTIONS: 15
60 * (This index is automatically created/updated by the extension "extdeveval")
61 *
62 */
63
64
65
66
67
68
69
70
71
72
73
74
75
76 /**
77 * Contains functions for performing file operations like copying, pasting, uploading, moving, deleting etc. through the TCE
78 * Extending class to class t3lib_basicFileFunctions.
79 *
80 * see basicFileFunctions
81 * see document "TYPO3 Core API" for syntax
82 *
83 * This class contains functions primarily used by tce_file.php (TYPO3 Core Engine for file manipulation)
84 * Functions include copying, moving, deleting, uploading and so on...
85 *
86 * Important internal variables:
87 *
88 * $filemounts (see basicFileFunctions)
89 * $f_ext (see basicFileFunctions)
90 * ... All fileoperations must be within the filemount-paths. Further the fileextension MUST validate true with the f_ext array
91 *
92 * The unzip-function allows unzip only if the destination path has it's f_ext[]['allow'] set to '*'!!
93 * You are allowed to copy/move folders within the same 'space' (web/ftp).
94 * You are allowed to copy/move folders between spaces (web/ftp) IF the destination has it's f_ext[]['allow'] set to '*'!
95 *
96 * Advice:
97 * You should always exclude php-files from the webspace. This will keep people from uploading, copy/moving and renaming files to become executable php scripts.
98 * You should never mount a ftp_space 'below' the webspace so that it reaches into the webspace. This is because if somebody unzips a zip-file in the ftp-space so that it reaches out into the webspace this will be a violation of the safety
99 * For example this is a bad idea: you have an ftp-space that is '/www/' and a web-space that is '/www/htdocs/'
100 *
101 * @author Kasper Skaarhoj <kasperYYYY@typo3.com>
102 * @package TYPO3
103 * @subpackage t3lib
104 */
105 class t3lib_extFileFunctions extends t3lib_basicFileFunctions {
106
107 // External static variables:
108 // Notice; some of these are overridden in the start() method with values from $GLOBALS['TYPO3_CONF_VARS']['BE']
109 var $maxCopyFileSize = 10000; // max copy size (kb) for files
110 var $maxMoveFileSize = 10000; // max move size (kb) for files
111 var $maxUploadFileSize = 10000; // max upload size (kb) for files. Remember that PHP has an inner limit often set to 2 MB
112 var $unzipPath = ''; // Path to unzip-program (with trailing '/')
113 var $dontCheckForUnique = 0; // If set, the uploaded files will overwrite existing files.
114
115 var $actionPerms = Array( // This array is self-explaning (look in the class below). It grants access to the functions. This could be set from outside in order to enabled functions to users. See also the function init_actionPerms() which takes input directly from the user-record
116 'deleteFile' => 0, // Deleting files physically
117 'deleteFolder' => 0, // Deleting foldes physically
118 'deleteFolderRecursively' => 0, // normally folders are deleted by the PHP-function rmdir(), but with this option a user deletes with 'rm -Rf ....' which is pretty wild!
119 'moveFile' => 0,
120 'moveFolder' => 0,
121 'copyFile' => 0,
122 'copyFolder' => 0,
123 'newFolder' => 0,
124 'newFile' => 0,
125 'editFile' => 0,
126 'unzipFile' => 0,
127 'uploadFile' => 0,
128 'renameFile' => 0,
129 'renameFolder' => 0
130 );
131
132 var $recyclerFN = '_recycler_'; // This is regarded to be the recycler folder
133 var $useRecycler = 1; // 0 = no, 1 = if available, 2 = always
134
135 // Internal, static:
136 var $PHPFileFunctions = 0; // If set, all fileoperations are done by the default PHP-functions. This is necessary under windows! On UNIX the system commands by exec() can be used unless safe_mode is enabled
137 var $dont_use_exec_commands = 0; // This is necessary under windows!
138
139 // Internal, dynamic:
140 var $internalUploadMap = array(); // Will contain map between upload ID and the final filename
141
142 var $lastError = '';
143
144
145
146
147 /**
148 * Initialization of the class
149 *
150 * @param array The $file array with the commands to execute. See "TYPO3 Core API" document
151 * @return void
152 */
153 function start($fileCmds) {
154
155 // Configure settings from TYPO3_CONF_VARS:
156 if (TYPO3_OS=='WIN' || $GLOBALS['TYPO3_CONF_VARS']['BE']['disable_exec_function']) {
157 $this->PHPFileFunctions = 1;
158 $this->dont_use_exec_commands = 1;
159 } else {
160 $this->PHPFileFunctions = $GLOBALS['TYPO3_CONF_VARS']['BE']['usePHPFileFunctions'];
161 }
162
163 $this->unzipPath = $GLOBALS['TYPO3_CONF_VARS']['BE']['unzip_path'];
164
165 $maxFileSize = intval($GLOBALS['TYPO3_CONF_VARS']['BE']['maxFileSize']);
166 if ($maxFileSize > 0) {
167 $this->maxCopyFileSize = $maxFileSize;
168 $this->maxMoveFileSize = $maxFileSize;
169 }
170 $this->maxUploadFileSize = t3lib_div::getMaxUploadFileSize();
171
172 // Initializing file processing commands:
173 $this->fileCmdMap = $fileCmds;
174 }
175
176 /**
177 * Sets up permission to perform file/directory operations.
178 * See below or the be_user-table for the significance of the various bits in $setup.
179 *
180 * @param integer File permission integer from BE_USER OR'ed with permissions of back-end groups this user is a member of
181 * @return void
182 */
183 function init_actionPerms($setup) {
184 if (($setup&1)==1) { // Files: Upload,Copy,Move,Delete,Rename
185 $this->actionPerms['uploadFile']=1;
186 $this->actionPerms['copyFile']=1;
187 $this->actionPerms['moveFile']=1;
188 $this->actionPerms['deleteFile']=1;
189 $this->actionPerms['renameFile']=1;
190 $this->actionPerms['editFile']=1;
191 $this->actionPerms['newFile']=1;
192 }
193 if (($setup&2)==2) { // Files: Unzip
194 $this->actionPerms['unzipFile']=1;
195 }
196 if (($setup&4)==4) { // Directory: Move,Delete,Rename,New
197 $this->actionPerms['moveFolder']=1;
198 $this->actionPerms['deleteFolder']=1;
199 $this->actionPerms['renameFolder']=1;
200 $this->actionPerms['newFolder']=1;
201 }
202 if (($setup&8)==8) { // Directory: Copy
203 $this->actionPerms['copyFolder']=1;
204 }
205 if (($setup&16)==16) { // Directory: Delete recursively (rm -Rf)
206 $this->actionPerms['deleteFolderRecursively']=1;
207 }
208 }
209
210 /**
211 * Processing the command array in $this->fileCmdMap
212 *
213 * @return mixed false, if the file functions were not initialized
214 * otherwise returns an array of all the results that are returned
215 * from each command, separated in each action.
216 */
217 function processData() {
218 $result = array();
219 if (!$this->isInit) {
220 return false;
221 }
222
223 if (is_array($this->fileCmdMap)) {
224
225 // Check if there were uploads expected, but no one made
226 if ($this->fileCmdMap['upload']) {
227 $uploads = $this->fileCmdMap['upload'];
228 foreach ($uploads as $upload) {
229 if (!$_FILES['upload_' . $upload['data']]['name']) {
230 unset($this->fileCmdMap['upload'][$upload['data']]);
231 }
232 }
233 if (count($this->fileCmdMap['upload']) == 0) {
234 $this->writelog(1,1,108,'No file was uploaded!','');
235 }
236 }
237
238 // Traverse each set of actions
239 foreach ($this->fileCmdMap as $action => $actionData) {
240
241 // Traverse all action data. More than one file might be affected at the same time.
242 if (is_array($actionData)) {
243 $result[$action] = array();
244 foreach ($actionData as $cmdArr) {
245
246 // Clear file stats
247 clearstatcache();
248
249 // Branch out based on command:
250 switch ($action) {
251 case 'delete':
252 $result[$action][] = $this->func_delete($cmdArr);
253 break;
254 case 'copy':
255 $result[$action][] = $this->func_copy($cmdArr);
256 break;
257 case 'move':
258 $result[$action][] = $this->func_move($cmdArr);
259 break;
260 case 'rename':
261 $result[$action][] = $this->func_rename($cmdArr);
262 break;
263 case 'newfolder':
264 $result[$action][] = $this->func_newfolder($cmdArr);
265 break;
266 case 'newfile':
267 $result[$action][] = $this->func_newfile($cmdArr);
268 break;
269 case 'editfile':
270 $result[$action][] = $this->func_edit($cmdArr);
271 break;
272 case 'upload':
273 $result[$action][] = $this->func_upload($cmdArr);
274 break;
275 case 'unzip':
276 $result[$action][] = $this->func_unzip($cmdArr);
277 break;
278 }
279 }
280 }
281 }
282 }
283 return $result;
284 }
285
286 /**
287 * Adds log error messages from the operations of this script instance to the FlashMessageQueue
288 *
289 * @param string Redirect URL (for creating link in message)
290 * @return void
291 */
292 function printLogErrorMessages($redirect = '') {
293 $this->getErrorMessages();
294 }
295
296
297 /**
298 * Adds log error messages from the previous file operations of this script instance
299 * to the FlashMessageQueue
300 *
301 * @return void
302 */
303 function getErrorMessages() {
304 $res = $GLOBALS['TYPO3_DB']->exec_SELECTquery(
305 '*',
306 'sys_log',
307 'type = 2 AND userid = ' . intval($GLOBALS['BE_USER']->user['uid'])
308 . ' AND tstamp=' . intval($GLOBALS['EXEC_TIME'])
309 . ' AND error != 0'
310 );
311 while ($row = $GLOBALS['TYPO3_DB']->sql_fetch_assoc($res)) {
312 $logData = unserialize($row['log_data']);
313 $msg = $row['error'] . ': ' . sprintf($row['details'], $logData[0], $logData[1], $logData[2], $logData[3], $logData[4]);
314 $flashMessage = t3lib_div::makeInstance(
315 't3lib_FlashMessage',
316 $msg,
317 '',
318 t3lib_FlashMessage::ERROR,
319 TRUE
320 );
321 t3lib_FlashMessageQueue::addMessage($flashMessage);
322 }
323 $GLOBALS['TYPO3_DB']->sql_free_result($res);
324 }
325
326
327
328 /**
329 * Goes back in the path and checks in each directory if a folder named $this->recyclerFN (usually '_recycler_') is present.
330 * If a folder in the tree happens to be a _recycler_-folder (which means that we're deleting something inside a _recycler_-folder) this is ignored
331 *
332 * @param string Takes a valid Path ($theFile)
333 * @return string Returns the path (without trailing slash) of the closest recycle-folder if found. Else false.
334 */
335 function findRecycler($theFile) {
336 if ($this->isPathValid($theFile)) {
337 $theFile = $this->cleanDirectoryName($theFile);
338 $fI = t3lib_div::split_fileref($theFile);
339 $c = 0;
340 while($this->checkPathAgainstMounts($fI['path']) && $c<20) {
341 $rDir = $fI['path'].$this->recyclerFN;
342 if (@is_dir($rDir) && $this->recyclerFN!=$fI['file']) {
343 return $rDir;
344 }
345 $theFile = $fI['path'];
346 $theFile = $this->cleanDirectoryName($theFile);
347 $fI = t3lib_div::split_fileref($theFile);
348 $c++;
349 }
350 }
351 }
352
353 /**
354 * Logging file operations
355 *
356 * @param integer The action number. See the functions in the class for a hint. Eg. edit is '9', upload is '1' ...
357 * @param integer The severity: 0 = message, 1 = error, 2 = System Error, 3 = security notice (admin)
358 * @param integer This number is unique for every combination of $type and $action. This is the error-message number, which can later be used to translate error messages.
359 * @param string This is the default, raw error message in english
360 * @param array Array with special information that may go into $details by "%s" marks / sprintf() when the log is shown
361 * @return void
362 * @see class.t3lib_userauthgroup.php
363 */
364 function writeLog($action,$error,$details_nr,$details,$data) {
365 $type = 2; // Type value for tce_file.php
366 if (is_object($GLOBALS['BE_USER'])) {
367 $GLOBALS['BE_USER']->writelog($type,$action,$error,$details_nr,$details,$data);
368 }
369 $this->lastError = vsprintf($details, $data);
370 }
371
372
373
374
375
376
377
378
379
380 /*************************************
381 *
382 * File operation functions
383 *
384 **************************************/
385
386 /**
387 * Deleting files and folders (action=4)
388 *
389 * @param array $cmds['data'] is the file/folder to delete
390 * @return boolean Returns true upon success
391 */
392 function func_delete($cmds) {
393 if (!$this->isInit) return FALSE;
394
395 // Checking path:
396 $theFile = $cmds['data'];
397 if (!$this->isPathValid($theFile)) {
398 $this->writelog(4,2,101,'Target "%s" had invalid path (".." and "//" is not allowed in path).',Array($theFile));
399 return FALSE;
400 }
401
402 // Recycler moving or not?
403 if ($this->useRecycler && $recyclerPath=$this->findRecycler($theFile)) {
404 // If a recycler is found, the deleted items is moved to the recycler and not just deleted.
405 $newCmds=Array();
406 $newCmds['data']=$theFile;
407 $newCmds['target']=$recyclerPath;
408 $newCmds['altName']=1;
409 $this->func_move($newCmds);
410 $this->writelog(4,0,4,'Item "%s" moved to recycler at "%s"',Array($theFile,$recyclerPath));
411 return TRUE;
412 } elseif ($this->useRecycler != 2) { // if $this->useRecycler==2 then we cannot delete for real!!
413 if (@is_file($theFile)) { // If we are deleting a file...
414 if ($this->actionPerms['deleteFile']) {
415 if ($this->checkPathAgainstMounts($theFile)) {
416 if (@unlink($theFile)) {
417 $this->writelog(4,0,1,'File "%s" deleted',Array($theFile));
418 return TRUE;
419 } else $this->writelog(4,1,110,'Could not delete file "%s". Write-permission problem?', Array($theFile));
420 } else $this->writelog(4,1,111,'Target was not within your mountpoints! T="%s"',Array($theFile));
421 } else $this->writelog(4,1,112,'You are not allowed to delete files','');
422 // FINISHED deleting file
423
424 } elseif (@is_dir($theFile)) { // if we're deleting a folder
425 if ($this->actionPerms['deleteFolder']) {
426 $theFile = $this->is_directory($theFile);
427 if ($theFile) {
428 if ($this->checkPathAgainstMounts($theFile)) { // I choose not to append '/' to $theFile here as this will prevent us from deleting mounts!! (which makes sense to me...)
429 if ($this->actionPerms['deleteFolderRecursively']) {
430 if (t3lib_div::rmdir($theFile,true)) {
431 $this->writelog(4,0,2,'Directory "%s" deleted recursively!',Array($theFile));
432 return TRUE;
433 } else $this->writelog(4,2,119,'Directory "%s" WAS NOT deleted recursively! Write-permission problem?',Array($theFile));
434 } else {
435 if (@rmdir($theFile)) {
436 $this->writelog(4,0,3,'Directory "%s" deleted',Array($theFile));
437 return TRUE;
438 } else $this->writelog(4,1,120,'Could not delete directory! Write-permission problem? Is directory "%s" empty? (You are not allowed to delete directories recursively).',Array($theFile));
439 }
440 } else $this->writelog(4,1,121,'Target was not within your mountpoints! T="%s"',Array($theFile));
441 } else $this->writelog(4,2,122,'Target seemed not to be a directory! (Shouldn\'t happen here!)','');
442 } else $this->writelog(4,1,123,'You are not allowed to delete directories','');
443 // FINISHED copying directory
444
445 } else $this->writelog(4,2,130,'The item was not a file or directory! "%s"',Array($theFile));
446 } else $this->writelog(4,1,131,'No recycler found!','');
447 }
448
449 /**
450 * Copying files and folders (action=2)
451 *
452 * @param array $cmds['data'] is the file/folder to copy. $cmds['target'] is the path where to copy to. $cmds['altName'] (boolean): If set, another filename is found in case the target already exists
453 * @return string Returns the new filename upon success
454 */
455 function func_copy($cmds) {
456 if (!$this->isInit) return FALSE;
457
458 // Initialize and check basic conditions:
459 $theFile = $cmds['data'];
460 $theDest = $this->is_directory($cmds['target']); // Clean up destination directory
461 $altName = $cmds['altName'];
462 if (!$theDest) {
463 $this->writelog(2,2,100,'Destination "%s" was not a directory',Array($cmds['target']));
464 return FALSE;
465 }
466 if (!$this->isPathValid($theFile) || !$this->isPathValid($theDest)) {
467 $this->writelog(2,2,101,'Target or destination had invalid path (".." and "//" is not allowed in path). T="%s", D="%s"',Array($theFile,$theDest));
468 return FALSE;
469 }
470
471 // Processing of file or directory.
472 if (@is_file($theFile)) { // If we are copying a file...
473 if ($this->actionPerms['copyFile']) {
474 if (filesize($theFile) < ($this->maxCopyFileSize*1024)) {
475 $fI = t3lib_div::split_fileref($theFile);
476 if ($altName) { // If altName is set, we're allowed to create a new filename if the file already existed
477 $theDestFile = $this->getUniqueName($fI['file'], $theDest);
478 $fI = t3lib_div::split_fileref($theDestFile);
479 } else {
480 $theDestFile = $theDest.'/'.$fI['file'];
481 }
482 if ($theDestFile && !file_exists($theDestFile)) {
483 if ($this->checkIfAllowed($fI['fileext'], $theDest, $fI['file'])) {
484 if ($this->checkPathAgainstMounts($theDestFile) && $this->checkPathAgainstMounts($theFile)) {
485 if ($this->PHPFileFunctions) {
486 copy ($theFile,$theDestFile);
487 } else {
488 $cmd = 'cp "'.$theFile.'" "'.$theDestFile.'"';
489 exec($cmd);
490 }
491 t3lib_div::fixPermissions($theDestFile);
492 clearstatcache();
493 if (@is_file($theDestFile)) {
494 $this->writelog(2,0,1,'File "%s" copied to "%s"',Array($theFile,$theDestFile));
495 return $theDestFile;
496 } else $this->writelog(2,2,109,'File "%s" WAS NOT copied to "%s"! Write-permission problem?',Array($theFile,$theDestFile));
497 } else $this->writelog(2,1,110,'Target or destination was not within your mountpoints! T="%s", D="%s"',Array($theFile,$theDestFile));
498 } else $this->writelog(2,1,111,'Extension of file name "%s" is not allowed in "%s"!',Array($fI['file'],$theDest.'/'));
499 } else $this->writelog(2,1,112,'File "%s" already exists!',Array($theDestFile));
500 } else $this->writelog(2,1,113,'File "%s" exceeds the size-limit of %s bytes',Array($theFile,$this->maxCopyFileSize*1024));
501 } else $this->writelog(2,1,114,'You are not allowed to copy files','');
502 // FINISHED copying file
503
504 } elseif (@is_dir($theFile) && !$this->dont_use_exec_commands) { // if we're copying a folder
505 if ($this->actionPerms['copyFolder']) {
506 $theFile = $this->is_directory($theFile);
507 if ($theFile) {
508 $fI = t3lib_div::split_fileref($theFile);
509 if ($altName) { // If altName is set, we're allowed to create a new filename if the file already existed
510 $theDestFile = $this->getUniqueName($fI['file'], $theDest);
511 $fI = t3lib_div::split_fileref($theDestFile);
512 } else {
513 $theDestFile = $theDest.'/'.$fI['file'];
514 }
515 if ($theDestFile && !file_exists($theDestFile)) {
516 if (!t3lib_div::isFirstPartOfStr($theDestFile.'/',$theFile.'/')) { // Check if the one folder is inside the other or on the same level... to target/dest is the same?
517 if ($this->checkIfFullAccess($theDest) || $this->is_webPath($theDestFile)==$this->is_webPath($theFile)) { // no copy of folders between spaces
518 if ($this->checkPathAgainstMounts($theDestFile) && $this->checkPathAgainstMounts($theFile)) {
519 // No way to do this under windows!
520 $cmd = 'cp -R "'.$theFile.'" "'.$theDestFile.'"';
521 exec($cmd);
522 clearstatcache();
523 if (@is_dir($theDestFile)) {
524 $this->writelog(2,0,2,'Directory "%s" copied to "%s"',Array($theFile,$theDestFile));
525 return $theDestFile;
526 } else $this->writelog(2,2,119,'Directory "%s" WAS NOT copied to "%s"! Write-permission problem?',Array($theFile,$theDestFile));
527 } else $this->writelog(2,1,120,'Target or destination was not within your mountpoints! T="%s", D="%s"',Array($theFile,$theDestFile));
528 } else $this->writelog(2,1,121,'You don\'t have full access to the destination directory "%s"!',Array($theDest.'/'));
529 } else $this->writelog(2,1,122,'Destination cannot be inside the target! D="%s", T="%s"',Array($theDestFile.'/',$theFile.'/'));
530 } else $this->writelog(2,1,123,'Target "%s" already exists!',Array($theDestFile));
531 } else $this->writelog(2,2,124,'Target seemed not to be a directory! (Shouldn\'t happen here!)','');
532 } else $this->writelog(2,1,125,'You are not allowed to copy directories','');
533 // FINISHED copying directory
534
535 } else {
536 $this->writelog(2,2,130,'The item "%s" was not a file or directory!',Array($theFile));
537 }
538 }
539
540 /**
541 * Moving files and folders (action=3)
542 *
543 * @param array $cmds['data'] is the file/folder to move. $cmds['target'] is the path where to move to. $cmds['altName'] (boolean): If set, another filename is found in case the target already exists
544 * @return string Returns the new filename upon success
545 */
546 function func_move($cmds) {
547 if (!$this->isInit) return FALSE;
548
549 // Initialize and check basic conditions:
550 $theFile = $cmds['data'];
551 $theDest = $this->is_directory($cmds['target']); // Clean up destination directory
552 $altName = $cmds['altName'];
553 if (!$theDest) {
554 $this->writelog(3,2,100,'Destination "%s" was not a directory',Array($cmds['target']));
555 return FALSE;
556 }
557 if (!$this->isPathValid($theFile) || !$this->isPathValid($theDest)) {
558 $this->writelog(3,2,101,'Target or destination had invalid path (".." and "//" is not allowed in path). T="%s", D="%s"',Array($theFile,$theDest));
559 return FALSE;
560 }
561
562 // Processing of file or directory:
563 if (@is_file($theFile)) { // If we are moving a file...
564 if ($this->actionPerms['moveFile']) {
565 if (filesize($theFile) < ($this->maxMoveFileSize*1024)) {
566 $fI = t3lib_div::split_fileref($theFile);
567 if ($altName) { // If altName is set, we're allowed to create a new filename if the file already existed
568 $theDestFile = $this->getUniqueName($fI['file'], $theDest);
569 $fI = t3lib_div::split_fileref($theDestFile);
570 } else {
571 $theDestFile = $theDest.'/'.$fI['file'];
572 }
573 if ($theDestFile && !file_exists($theDestFile)) {
574 if ($this->checkIfAllowed($fI['fileext'], $theDest, $fI['file'])) {
575 if ($this->checkPathAgainstMounts($theDestFile) && $this->checkPathAgainstMounts($theFile)) {
576 if ($this->PHPFileFunctions) {
577 @rename($theFile, $theDestFile);
578 } else {
579 $cmd = 'mv "'.$theFile.'" "'.$theDestFile.'"';
580 exec($cmd);
581 }
582 clearstatcache();
583 if (@is_file($theDestFile)) {
584 $this->writelog(3,0,1,'File "%s" moved to "%s"',Array($theFile,$theDestFile));
585 return $theDestFile;
586 } else $this->writelog(3,2,109,'File "%s" WAS NOT moved to "%s"! Write-permission problem?',Array($theFile,$theDestFile));
587 } else $this->writelog(3,1,110,'Target or destination was not within your mountpoints! T="%s", D="%s"',Array($theFile,$theDestFile));
588 } else $this->writelog(3,1,111,'Extension of file name "%s" is not allowed in "%s"!',Array($fI['file'],$theDest.'/'));
589 } else $this->writelog(3,1,112,'File "%s" already exists!',Array($theDestFile));
590 } else $this->writelog(3,1,113,'File "%s" exceeds the size-limit of %s bytes',Array($theFile,$this->maxMoveFileSize*1024));
591 } else $this->writelog(3,1,114,'You are not allowed to move files','');
592 // FINISHED moving file
593
594 } elseif (@is_dir($theFile)) { // if we're moving a folder
595 if ($this->actionPerms['moveFolder']) {
596 $theFile = $this->is_directory($theFile);
597 if ($theFile) {
598 $fI = t3lib_div::split_fileref($theFile);
599 if ($altName) { // If altName is set, we're allowed to create a new filename if the file already existed
600 $theDestFile = $this->getUniqueName($fI['file'], $theDest);
601 $fI = t3lib_div::split_fileref($theDestFile);
602 } else {
603 $theDestFile = $theDest.'/'.$fI['file'];
604 }
605 if ($theDestFile && !file_exists($theDestFile)) {
606 if (!t3lib_div::isFirstPartOfStr($theDestFile.'/',$theFile.'/')) { // Check if the one folder is inside the other or on the same level... to target/dest is the same?
607 if ($this->checkIfFullAccess($theDest) || $this->is_webPath($theDestFile)==$this->is_webPath($theFile)) { // // no moving of folders between spaces
608 if ($this->checkPathAgainstMounts($theDestFile) && $this->checkPathAgainstMounts($theFile)) {
609 if ($this->PHPFileFunctions) {
610 @rename($theFile, $theDestFile);
611 } else {
612 $cmd = 'mv "'.$theFile.'" "'.$theDestFile.'"';
613 $errArr = array();
614 $retVar = 0;
615 exec($cmd,$errArr,$retVar);
616 }
617 clearstatcache();
618 if (@is_dir($theDestFile)) {
619 $this->writelog(3,0,2,'Directory "%s" moved to "%s"',Array($theFile,$theDestFile));
620 return $theDestFile;
621 } else $this->writelog(3,2,119,'Directory "%s" WAS NOT moved to "%s"! Write-permission problem?',Array($theFile,$theDestFile));
622 } else $this->writelog(3,1,120,'Target or destination was not within your mountpoints! T="%s", D="%s"',Array($theFile,$theDestFile));
623 } else $this->writelog(3,1,121,'You don\'t have full access to the destination directory "%s"!',Array($theDest.'/'));
624 } else $this->writelog(3,1,122,'Destination cannot be inside the target! D="%s", T="%s"',Array($theDestFile.'/',$theFile.'/'));
625 } else $this->writelog(3,1,123,'Target "%s" already exists!',Array($theDestFile));
626 } else $this->writelog(3,2,124,'Target seemed not to be a directory! (Shouldn\'t happen here!)','');
627 } else $this->writelog(3,1,125,'You are not allowed to move directories','');
628 // FINISHED moving directory
629
630 } else {
631 $this->writelog(3,2,130,'The item "%s" was not a file or directory!',Array($theFile));
632 }
633 }
634
635 /**
636 * Renaming files or foldes (action=5)
637 *
638 * @param array $cmds['data'] is the new name. $cmds['target'] is the target (file or dir).
639 * @return string Returns the new filename upon success
640 */
641 function func_rename($cmds) {
642 if (!$this->isInit) return FALSE;
643
644 $theNewName = $this->cleanFileName($cmds['data']);
645 if ($theNewName) {
646 if ($this->checkFileNameLen($theNewName)) {
647 $theTarget = $cmds['target'];
648 $type = filetype($theTarget);
649 if ($type=='file' || $type=='dir') { // $type MUST BE file or dir
650 $fileInfo = t3lib_div::split_fileref($theTarget); // Fetches info about path, name, extention of $theTarget
651 if ($fileInfo['file']!=$theNewName) { // The name should be different from the current. And the filetype must be allowed
652 $theRenameName = $fileInfo['path'].$theNewName;
653 if ($this->checkPathAgainstMounts($fileInfo['path'])) {
654 if (!file_exists($theRenameName)) {
655 if ($type=='file') {
656 if ($this->actionPerms['renameFile']) {
657 $fI = t3lib_div::split_fileref($theRenameName);
658 if ($this->checkIfAllowed($fI['fileext'], $fileInfo['path'], $fI['file'])) {
659 if (@rename($theTarget, $theRenameName)) {
660 $this->writelog(5,0,1,'File renamed from "%s" to "%s"',Array($fileInfo['file'],$theNewName));
661 return $theRenameName;
662 } else $this->writelog(5,1,100,'File "%s" was not renamed! Write-permission problem in "%s"?',Array($theTarget,$fileInfo['path']));
663 } else $this->writelog(5,1,101,'Extension of file name "%s" was not allowed!',Array($fI['file']));
664 } else $this->writelog(5,1,102,'You are not allowed to rename files!','');
665 } elseif ($type=='dir') {
666 if ($this->actionPerms['renameFolder']) {
667 if (@rename($theTarget, $theRenameName)) {
668 $this->writelog(5,0,2,'Directory renamed from "%s" to "%s"',Array($fileInfo['file'],$theNewName));
669 return $theRenameName;
670 } else $this->writelog(5,1,110,'Directory "%s" was not renamed! Write-permission problem in "%s"?',Array($theTarget,$fileInfo['path']));
671 } else $this->writelog(5,1,111,'You are not allowed to rename directories!','');
672 }
673 } else $this->writelog(5,1,120,'Destination "%s" existed already!',Array($theRenameName));
674 } else $this->writelog(5,1,121,'Destination path "%s" was not within your mountpoints!',Array($fileInfo['path']));
675 } else $this->writelog(5,1,122,'Old and new name is the same (%s)',Array($theNewName));
676 } else $this->writelog(5,2,123,'Target "%s" was neither a directory nor a file!',Array($theTarget));
677 } else $this->writelog(5,1,124,'New name "%s" was too long (max %s characters)',Array($theNewName,$this->maxInputNameLen));
678 }
679 }
680
681 /**
682 * This creates a new folder. (action=6)
683 *
684 * @param array $cmds['data'] is the foldername. $cmds['target'] is the path where to create it.
685 * @return string Returns the new foldername upon success
686 */
687 function func_newfolder($cmds) {
688 if (!$this->isInit) return FALSE;
689
690 $theFolder = $this->cleanFileName($cmds['data']);
691 if (isset($theFolder) && trim($theFolder) != '') {
692 if ($this->checkFileNameLen($theFolder)) {
693 $theTarget = $this->is_directory($cmds['target']); // Check the target dir
694 if ($theTarget) {
695 if ($this->actionPerms['newFolder']) {
696 $theNewFolder = $theTarget.'/'.$theFolder;
697 if ($this->checkPathAgainstMounts($theNewFolder)) {
698 if (!file_exists($theNewFolder)) {
699 if (t3lib_div::mkdir($theNewFolder)){
700 $this->writelog(6,0,1,'Directory "%s" created in "%s"',Array($theFolder,$theTarget.'/'));
701 return $theNewFolder;
702 } else $this->writelog(6,1,100,'Directory "%s" not created. Write-permission problem in "%s"?',Array($theFolder,$theTarget.'/'));
703 } else $this->writelog(6,1,101,'File or directory "%s" existed already!',Array($theNewFolder));
704 } else $this->writelog(6,1,102,'Destination path "%s" was not within your mountpoints!',Array($theTarget.'/'));
705 } else $this->writelog(6,1,103,'You are not allowed to create directories!','');
706 } else $this->writelog(6,2,104,'Destination "%s" was not a directory',Array($cmds['target']));
707 } else $this->writelog(6,1,105,'New name "%s" was too long (max %s characters)',Array($theFolder,$this->maxInputNameLen));
708 }
709 }
710
711 /**
712 * This creates a new file. (action=8)
713 *
714 * @param array $cmds['data'] is the new filename. $cmds['target'] is the path where to create it
715 * @return string Returns the new filename upon success
716 */
717 function func_newfile($cmds) {
718 $extList = $GLOBALS['TYPO3_CONF_VARS']['SYS']['textfile_ext'];
719 if (!$this->isInit) return FALSE;
720 $newName = $this->cleanFileName($cmds['data']);
721 if ($newName) {
722 if ($this->checkFileNameLen($newName)) {
723 $theTarget = $this->is_directory($cmds['target']); // Check the target dir
724 $fileInfo = t3lib_div::split_fileref($theTarget); // Fetches info about path, name, extention of $theTarget
725 if ($theTarget) {
726 if ($this->actionPerms['newFile']) {
727 $theNewFile = $theTarget.'/'.$newName;
728 if ($this->checkPathAgainstMounts($theNewFile)) {
729 if (!file_exists($theNewFile)) {
730 $fI = t3lib_div::split_fileref($theNewFile);
731 if ($this->checkIfAllowed($fI['fileext'], $fileInfo['path'], $fI['file'])) {
732 if (t3lib_div::inList($extList, $fI['fileext'])) {
733 if (t3lib_div::writeFile($theNewFile,'')) {
734 clearstatcache();
735 $this->writelog(8,0,1,'File created: "%s"',Array($fI['file']));
736 return $theNewFile;
737 } else $this->writelog(8,1,100,'File "%s" was not created! Write-permission problem in "%s"?',Array($fI['file'], $theTarget));
738 } else $this->writelog(8,1,107,'Fileextension "%s" is not a textfile format! (%s)',Array($fI['fileext'], $extList));
739 } else $this->writelog(8,1,106,'Extension of file name "%s" was not allowed!',Array($fI['file']));
740 } else $this->writelog(8,1,101,'File "%s" existed already!',Array($theNewFile));
741 } else $this->writelog(8,1,102,'Destination path "%s" was not within your mountpoints!',Array($theTarget.'/'));
742 } else $this->writelog(8,1,103,'You are not allowed to create files!','');
743 } else $this->writelog(8,2,104,'Destination "%s" was not a directory',Array($cmds['target']));
744 } else $this->writelog(8,1,105,'New name "%s" was too long (max %s characters)',Array($newName,$this->maxInputNameLen));
745 }
746 }
747
748 /**
749 * Editing textfiles or folders (action=9)
750 *
751 * @param array $cmds['data'] is the new content. $cmds['target'] is the target (file or dir)
752 * @return boolean Returns true on success
753 */
754 function func_edit($cmds) {
755 if (!$this->isInit) return FALSE;
756 $theTarget = $cmds['target'];
757 $content = $cmds['data'];
758 $extList = $GLOBALS['TYPO3_CONF_VARS']['SYS']['textfile_ext'];
759 $type = filetype($theTarget);
760 if ($type=='file') { // $type MUST BE file
761 $fileInfo = t3lib_div::split_fileref($theTarget); // Fetches info about path, name, extention of $theTarget
762 $fI =$fileInfo;
763 if ($this->checkPathAgainstMounts($fileInfo['path'])) {
764 if ($this->actionPerms['editFile']) {
765 $fI = t3lib_div::split_fileref($theTarget);
766 if ($this->checkIfAllowed($fI['fileext'], $fileInfo['path'], $fI['file'])) {
767 if (t3lib_div::inList($extList, $fileInfo['fileext'])) {
768 if (t3lib_div::writeFile($theTarget,$content)) {
769 clearstatcache();
770 $this->writelog(9,0,1,'File saved to "%s", bytes: %s, MD5: %s ',Array($fileInfo['file'],@filesize($theTarget),md5($content)));
771 return TRUE;
772 } else $this->writelog(9,1,100,'File "%s" was not saved! Write-permission problem in "%s"?',Array($theTarget,$fileInfo['path']));
773 } else $this->writelog(9,1,102,'Fileextension "%s" is not a textfile format! (%s)',Array($fI['fileext'], $extList));
774 } else $this->writelog(9,1,103,'Extension of file name "%s" was not allowed!',Array($fI['file']));
775 } else $this->writelog(9,1,104,'You are not allowed to edit files!','');
776 } else $this->writelog(9,1,121,'Destination path "%s" was not within your mountpoints!',Array($fileInfo['path']));
777 } else $this->writelog(9,2,123,'Target "%s" was not a file!',Array($theTarget));
778 }
779
780 /**
781 * Upload of files (action=1)
782 *
783 * @param array $cmds['data'] is the ID-number (points to the global var that holds the filename-ref ($_FILES['upload_'.$id]['name']). $cmds['target'] is the target directory, $cmds['charset'] is the the character set of the file name (utf-8 is needed for JS-interaction)
784 * @return string Returns the new filename upon success
785 */
786 function func_upload($cmds) {
787 if (!$this->isInit) return FALSE;
788 $id = $cmds['data'];
789 if ($_FILES['upload_'.$id]['name']) {
790 $theFile = $_FILES['upload_'.$id]['tmp_name']; // filename of the uploaded file
791 $theFileSize = $_FILES['upload_'.$id]['size']; // filesize of the uploaded file
792 $theName = $this->cleanFileName(stripslashes($_FILES['upload_'.$id]['name']), (isset($cmds['charset']) ? $cmds['charset'] : '')); // The original filename
793 if (is_uploaded_file($theFile) && $theName) { // Check the file
794 if ($this->actionPerms['uploadFile']) {
795 if ($theFileSize<($this->maxUploadFileSize*1024)) {
796 $fI = t3lib_div::split_fileref($theName);
797 $theTarget = $this->is_directory($cmds['target']); // Check the target dir
798 if ($theTarget && $this->checkPathAgainstMounts($theTarget.'/')) {
799 if ($this->checkIfAllowed($fI['fileext'], $theTarget, $fI['file'])) {
800 $theNewFile = $this->getUniqueName($theName, $theTarget, $this->dontCheckForUnique);
801 if ($theNewFile) {
802 t3lib_div::upload_copy_move($theFile,$theNewFile);
803 clearstatcache();
804 if (@is_file($theNewFile)) {
805 $this->internalUploadMap[$id] = $theNewFile;
806 $this->writelog(1,0,1,'Uploading file "%s" to "%s"',Array($theName,$theNewFile, $id));
807 return $theNewFile;
808 } else $this->writelog(1,1,100,'Uploaded file could not be moved! Write-permission problem in "%s"?',Array($theTarget.'/'));
809 } else $this->writelog(1,1,101,'No unique filename available in "%s"!',Array($theTarget.'/'));
810 } else $this->writelog(1,1,102,'Extension of file name "%s" is not allowed in "%s"!',Array($fI['file'], $theTarget.'/'));
811 } else $this->writelog(1,1,103,'Destination path "%s" was not within your mountpoints!',Array($theTarget.'/'));
812 } else $this->writelog(1,1,104,'The uploaded file exceeds the size-limit of %s bytes',Array($this->maxUploadFileSize*1024));
813 } else $this->writelog(1,1,105,'You are not allowed to upload files!','');
814 } else $this->writelog(1,2,106,'The upload has failed, no uploaded file found!','');
815 } else $this->writelog(1,2,108,'No file was uploaded!','');
816 }
817
818 /**
819 * Unzipping file (action=7)
820 * This is permitted only if the user has fullAccess or if the file resides
821 *
822 * @param array $cmds['data'] is the zip-file. $cmds['target'] is the target directory. If not set we'll default to the same directory as the file is in.
823 * @return boolean Returns true on success
824 */
825 function func_unzip($cmds) {
826 if (!$this->isInit || $this->dont_use_exec_commands) return FALSE;
827
828 $theFile = $cmds['data'];
829 if (@is_file($theFile)) {
830 $fI = t3lib_div::split_fileref($theFile);
831 if (!isset($cmds['target'])) {
832 $cmds['target'] = $fI['path'];
833 }
834 $theDest = $this->is_directory($cmds['target']); // Clean up destination directory
835 if ($theDest) {
836 if ($this->actionPerms['unzipFile']) {
837 if ($fI['fileext']=='zip') {
838 if ($this->checkIfFullAccess($theDest)) {
839 if ($this->checkPathAgainstMounts($theFile) && $this->checkPathAgainstMounts($theDest.'/')) {
840 // No way to do this under windows.
841 $cmd = $this->unzipPath.'unzip -qq "'.$theFile.'" -d "'.$theDest.'"';
842 exec($cmd);
843 $this->writelog(7,0,1,'Unzipping file "%s" in "%s"',Array($theFile,$theDest));
844 return TRUE;
845 } else $this->writelog(7,1,100,'File "%s" or destination "%s" was not within your mountpoints!',Array($theFile,$theDest));
846 } else $this->writelog(7,1,101,'You don\'t have full access to the destination directory "%s"!',Array($theDest));
847 } else $this->writelog(7,1,102,'Fileextension is not "zip"','');
848 } else $this->writelog(7,1,103,'You are not allowed to unzip files','');
849 } else $this->writelog(7,2,104,'Destination "%s" was not a directory',Array($cmds['target']));
850 } else $this->writelog(7,2,105,'The file "%s" did not exist!',Array($theFile));
851 }
852 }
853
854 if (defined('TYPO3_MODE') && $TYPO3_CONF_VARS[TYPO3_MODE]['XCLASS']['t3lib/class.t3lib_extfilefunc.php']) {
855 include_once($TYPO3_CONF_VARS[TYPO3_MODE]['XCLASS']['t3lib/class.t3lib_extfilefunc.php']);
856 }
857
858 ?>