2 /***************************************************************
5 * (c) 1999-2008 Kasper Skaarhoj (kasperYYYY@typo3.com)
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.
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.
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.
25 * This copyright notice MUST APPEAR in all copies of the script!
26 ***************************************************************/
28 * extending class to class t3lib_basicFileFunctions
31 * Revised for TYPO3 3.6 May/2004 by Kasper Skaarhoj
33 * @author Kasper Skaarhoj <kasperYYYY@typo3.com>
36 * [CLASS/FUNCTION INDEX of SCRIPT]
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)
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)
60 * (This index is automatically created/updated by the extension "extdeveval")
77 * Contains functions for performing file operations like copying, pasting, uploading, moving, deleting etc. through the TCE
78 * Extending class to class t3lib_basicFileFunctions.
80 * see basicFileFunctions
81 * see document "TYPO3 Core API" for syntax
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...
86 * Important internal variables:
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
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 '*'!
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/'
101 * @author Kasper Skaarhoj <kasperYYYY@typo3.com>
105 class t3lib_extFileFunctions
extends t3lib_basicFileFunctions
{
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.
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!
132 var $recyclerFN = '_recycler_'; // This is regarded to be the recycler folder
133 var $useRecycler = 1; // 0 = no, 1 = if available, 2 = always
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!
139 // Internal, dynamic:
140 var $internalUploadMap = array(); // Will contain map between upload ID and the final filename
148 * Initialization of the class
150 * @param array The $file array with the commands to execute. See "TYPO3 Core API" document
153 function start($fileCmds) {
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;
160 $this->PHPFileFunctions
= $GLOBALS['TYPO3_CONF_VARS']['BE']['usePHPFileFunctions'];
163 $this->unzipPath
= $GLOBALS['TYPO3_CONF_VARS']['BE']['unzip_path'];
165 $maxFileSize = intval($GLOBALS['TYPO3_CONF_VARS']['BE']['maxFileSize']);
166 if ($maxFileSize>0) {
167 $this->maxCopyFileSize
= $maxFileSize;
168 $this->maxMoveFileSize
= $maxFileSize;
169 $this->maxUploadFileSize
= $maxFileSize;
172 // Initializing file processing commands:
173 $this->fileCmdMap
= $fileCmds;
177 * Sets up permission to perform file/directory operations.
178 * See below or the be_user-table for the significanse of the various bits in $setup ($BE_USER->user['fileoper_perms'])
180 * @param integer File permission integer from BE_USER object.
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;
193 if (($setup&2)==2) { // Files: Unzip
194 $this->actionPerms
['unzipFile']=1;
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;
202 if (($setup&8)==8) { // Directory: Copy
203 $this->actionPerms
['copyFolder']=1;
205 if (($setup&16)==16) { // Directory: Delete recursively (rm -Rf)
206 $this->actionPerms
['deleteFolderRecursively']=1;
211 * Processing the command array in $this->fileCmdMap
215 function processData() {
216 if (!$this->isInit
) return FALSE;
218 if (is_array($this->fileCmdMap
)) {
220 // Check if there were uploads expected, but no one made
221 if ($this->fileCmdMap
['upload']) {
222 $uploads = $this->fileCmdMap
['upload'];
223 foreach ($uploads as $arr) {
224 if (!$_FILES['upload_'.$arr['data']]['name']) {
225 unset($this->fileCmdMap
['upload'][$arr['data']]);
228 if (count($this->fileCmdMap
['upload']) == 0) {
229 $this->writelog(1,1,108,'No file was uploaded!','');
233 // Traverse each set of actions
234 foreach($this->fileCmdMap
as $action => $actionData) {
236 // Traverse all action data. More than one file might be affected at the same time.
237 if (is_array($actionData)) {
238 foreach($actionData as $cmdArr) {
243 // Branch out based on command:
246 $this->func_delete($cmdArr);
249 $this->func_copy($cmdArr);
252 $this->func_move($cmdArr);
255 $this->func_rename($cmdArr);
258 $this->func_newfolder($cmdArr);
261 $this->func_newfile($cmdArr);
264 $this->func_edit($cmdArr);
267 $this->func_upload($cmdArr);
270 $this->func_unzip($cmdArr);
280 * Print log error messages from the operations of this script instance
282 * @param string Redirect URL (for creating link in message)
283 * @return void (Will exit on error)
285 function printLogErrorMessages($redirect='') {
287 $res_log = $GLOBALS['TYPO3_DB']->exec_SELECTquery(
290 'type=2 AND userid='.intval($GLOBALS['BE_USER']->user
['uid']).' AND tstamp='.intval($GLOBALS['EXEC_TIME']).' AND error!=0'
293 while ($row = $GLOBALS['TYPO3_DB']->sql_fetch_assoc($res_log)) {
294 $log_data = unserialize($row['log_data']);
295 $errorJS[] = $row[error
].': '.sprintf($row['details'], $log_data[0],$log_data[1],$log_data[2],$log_data[3],$log_data[4]);
298 if (count($errorJS)) {
299 $error_doc = t3lib_div
::makeInstance('template');
300 $error_doc->backPath
= '';
302 $content.= $error_doc->startPage('tce_db.php Error output');
305 <tr class="bgColor5">
306 <td colspan="2" align="center"><strong>Errors:</strong></td>
309 foreach($errorJS as $line) {
311 <tr class="bgColor4">
312 <td valign="top"><img'.t3lib_iconWorks
::skinImg('','gfx/icon_fatalerror.gif','width="18" height="16"').' alt="" /></td>
313 <td>'.htmlspecialchars($line).'</td>
319 <td colspan="2" align="center"><br />'.
320 '<form action=""><input type="submit" value="Continue" onclick="'.htmlspecialchars('window.location.href=\''.$redirect.'\';return false;').'" /></form>'.
326 <table border="0" cellpadding="1" cellspacing="1" width="300" align="center">
327 '.implode('',$lines).'
330 $content.= $error_doc->endPage();
337 * Goes back in the path and checks in each directory if a folder named $this->recyclerFN (usually '_recycler_') is present.
338 * 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
340 * @param string Takes a valid Path ($theFile)
341 * @return string Returns the path (without trailing slash) of the closest recycle-folder if found. Else false.
343 function findRecycler($theFile) {
344 if ($this->isPathValid($theFile)) {
345 $theFile = $this->cleanDirectoryName($theFile);
346 $fI = t3lib_div
::split_fileref($theFile);
348 while($this->checkPathAgainstMounts($fI['path']) && $c<20) {
349 $rDir = $fI['path'].$this->recyclerFN
;
350 if (@is_dir
($rDir) && $this->recyclerFN
!=$fI['file']) {
353 $theFile = $fI['path'];
354 $theFile = $this->cleanDirectoryName($theFile);
355 $fI = t3lib_div
::split_fileref($theFile);
362 * Logging file operations
364 * @param integer The action number. See the functions in the class for a hint. Eg. edit is '9', upload is '1' ...
365 * @param integer The severity: 0 = message, 1 = error, 2 = System Error, 3 = security notice (admin)
366 * @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.
367 * @param string This is the default, raw error message in english
368 * @param array Array with special information that may go into $details by "%s" marks / sprintf() when the log is shown
370 * @see class.t3lib_userauthgroup.php
372 function writeLog($action,$error,$details_nr,$details,$data) {
373 $type = 2; // Type value for tce_file.php
374 if (is_object($GLOBALS['BE_USER'])) {
375 $GLOBALS['BE_USER']->writelog($type,$action,$error,$details_nr,$details,$data);
377 $this->lastError
= vsprintf($details, $data);
388 /*************************************
390 * File operation functions
392 **************************************/
395 * Deleting files and folders (action=4)
397 * @param array $cmds['data'] is the file/folder to delete
398 * @return boolean Returns true upon success
400 function func_delete($cmds) {
401 if (!$this->isInit
) return FALSE;
404 $theFile = $cmds['data'];
405 if (!$this->isPathValid($theFile)) {
406 $this->writelog(4,2,101,'Target "%s" had invalid path (".." and "//" is not allowed in path).',Array($theFile));
410 // Recycler moving or not?
411 if ($this->useRecycler
&& $recyclerPath=$this->findRecycler($theFile)) {
412 // If a recycler is found, the deleted items is moved to the recycler and not just deleted.
414 $newCmds['data']=$theFile;
415 $newCmds['target']=$recyclerPath;
416 $newCmds['altName']=1;
417 $this->func_move($newCmds);
418 $this->writelog(4,0,4,'Item "%s" moved to recycler at "%s"',Array($theFile,$recyclerPath));
420 } elseif ($this->useRecycler
!= 2) { // if $this->useRecycler==2 then we cannot delete for real!!
421 if (@is_file
($theFile)) { // If we are deleting a file...
422 if ($this->actionPerms
['deleteFile']) {
423 if ($this->checkPathAgainstMounts($theFile)) {
424 if (@unlink
($theFile)) {
425 $this->writelog(4,0,1,'File "%s" deleted',Array($theFile));
427 } else $this->writelog(4,1,110,'Could not delete file "%s". Write-permission problem?', Array($theFile));
428 } else $this->writelog(4,1,111,'Target was not within your mountpoints! T="%s"',Array($theFile));
429 } else $this->writelog(4,1,112,'You are not allowed to delete files','');
430 // FINISHED deleting file
432 } elseif (@is_dir
($theFile)) { // if we're deleting a folder
433 if ($this->actionPerms
['deleteFolder']) {
434 $theFile = $this->is_directory($theFile);
436 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...)
437 if ($this->actionPerms
['deleteFolderRecursively'] && !$this->dont_use_exec_commands
) {
438 if (t3lib_div
::rmdir($theFile,true)) {
439 $this->writelog(4,0,2,'Directory "%s" deleted recursively!',Array($theFile));
441 } else $this->writelog(4,2,119,'Directory "%s" WAS NOT deleted recursively! Write-permission problem?',Array($theFile));
443 if (@rmdir
($theFile)) {
444 $this->writelog(4,0,3,'Directory "%s" deleted',Array($theFile));
446 } 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));
448 } else $this->writelog(4,1,121,'Target was not within your mountpoints! T="%s"',Array($theFile));
449 } else $this->writelog(4,2,122,'Target seemed not to be a directory! (Shouldn\'t happen here!)','');
450 } else $this->writelog(4,1,123,'You are not allowed to delete directories','');
451 // FINISHED copying directory
453 } else $this->writelog(4,2,130,'The item was not a file or directory! "%s"',Array($theFile));
454 } else $this->writelog(4,1,131,'No recycler found!','');
458 * Copying files and folders (action=2)
460 * @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
461 * @return string Returns the new filename upon success
463 function func_copy($cmds) {
464 if (!$this->isInit
) return FALSE;
466 // Initialize and check basic conditions:
467 $theFile = $cmds['data'];
468 $theDest = $this->is_directory($cmds['target']); // Clean up destination directory
469 $altName = $cmds['altName'];
471 $this->writelog(2,2,100,'Destination "%s" was not a directory',Array($cmds['target']));
474 if (!$this->isPathValid($theFile) ||
!$this->isPathValid($theDest)) {
475 $this->writelog(2,2,101,'Target or destination had invalid path (".." and "//" is not allowed in path). T="%s", D="%s"',Array($theFile,$theDest));
479 // Processing of file or directory.
480 if (@is_file
($theFile)) { // If we are copying a file...
481 if ($this->actionPerms
['copyFile']) {
482 if (filesize($theFile) < ($this->maxCopyFileSize
*1024)) {
483 $fI = t3lib_div
::split_fileref($theFile);
484 if ($altName) { // If altName is set, we're allowed to create a new filename if the file already existed
485 $theDestFile = $this->getUniqueName($fI['file'], $theDest);
486 $fI = t3lib_div
::split_fileref($theDestFile);
488 $theDestFile = $theDest.'/'.$fI['file'];
490 if ($theDestFile && !@file_exists
($theDestFile)) {
491 if ($this->checkIfAllowed($fI['fileext'], $theDest, $fI['file'])) {
492 if ($this->checkPathAgainstMounts($theDestFile) && $this->checkPathAgainstMounts($theFile)) {
493 if ($this->PHPFileFunctions
) {
494 copy ($theFile,$theDestFile);
496 $cmd = 'cp "'.$theFile.'" "'.$theDestFile.'"';
499 t3lib_div
::fixPermissions($theDestFile);
501 if (@is_file
($theDestFile)) {
502 $this->writelog(2,0,1,'File "%s" copied to "%s"',Array($theFile,$theDestFile));
504 } else $this->writelog(2,2,109,'File "%s" WAS NOT copied to "%s"! Write-permission problem?',Array($theFile,$theDestFile));
505 } else $this->writelog(2,1,110,'Target or destination was not within your mountpoints! T="%s", D="%s"',Array($theFile,$theDestFile));
506 } else $this->writelog(2,1,111,'Extension of file name "%s" is not allowed in "%s"!',Array($fI['file'],$theDest.'/'));
507 } else $this->writelog(2,1,112,'File "%s" already exists!',Array($theDestFile));
508 } else $this->writelog(2,1,113,'File "%s" exceeds the size-limit of %s bytes',Array($theFile,$this->maxCopyFileSize
*1024));
509 } else $this->writelog(2,1,114,'You are not allowed to copy files','');
510 // FINISHED copying file
512 } elseif (@is_dir
($theFile) && !$this->dont_use_exec_commands
) { // if we're copying a folder
513 if ($this->actionPerms
['copyFolder']) {
514 $theFile = $this->is_directory($theFile);
516 $fI = t3lib_div
::split_fileref($theFile);
517 if ($altName) { // If altName is set, we're allowed to create a new filename if the file already existed
518 $theDestFile = $this->getUniqueName($fI['file'], $theDest);
519 $fI = t3lib_div
::split_fileref($theDestFile);
521 $theDestFile = $theDest.'/'.$fI['file'];
523 if ($theDestFile && !@file_exists
($theDestFile)) {
524 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?
525 if ($this->checkIfFullAccess($theDest) ||
$this->is_webPath($theDestFile)==$this->is_webPath($theFile)) { // no copy of folders between spaces
526 if ($this->checkPathAgainstMounts($theDestFile) && $this->checkPathAgainstMounts($theFile)) {
527 // No way to do this under windows!
528 $cmd = 'cp -R "'.$theFile.'" "'.$theDestFile.'"';
531 if (@is_dir
($theDestFile)) {
532 $this->writelog(2,0,2,'Directory "%s" copied to "%s"',Array($theFile,$theDestFile));
534 } else $this->writelog(2,2,119,'Directory "%s" WAS NOT copied to "%s"! Write-permission problem?',Array($theFile,$theDestFile));
535 } else $this->writelog(2,1,120,'Target or destination was not within your mountpoints! T="%s", D="%s"',Array($theFile,$theDestFile));
536 } else $this->writelog(2,1,121,'You don\'t have full access to the destination directory "%s"!',Array($theDest.'/'));
537 } else $this->writelog(2,1,122,'Destination cannot be inside the target! D="%s", T="%s"',Array($theDestFile.'/',$theFile.'/'));
538 } else $this->writelog(2,1,123,'Target "%s" already exists!',Array($theDestFile));
539 } else $this->writelog(2,2,124,'Target seemed not to be a directory! (Shouldn\'t happen here!)','');
540 } else $this->writelog(2,1,125,'You are not allowed to copy directories','');
541 // FINISHED copying directory
544 $this->writelog(2,2,130,'The item "%s" was not a file or directory!',Array($theFile));
549 * Moving files and folders (action=3)
551 * @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
552 * @return string Returns the new filename upon success
554 function func_move($cmds) {
555 if (!$this->isInit
) return FALSE;
557 // Initialize and check basic conditions:
558 $theFile = $cmds['data'];
559 $theDest = $this->is_directory($cmds['target']); // Clean up destination directory
560 $altName = $cmds['altName'];
562 $this->writelog(3,2,100,'Destination "%s" was not a directory',Array($cmds['target']));
565 if (!$this->isPathValid($theFile) ||
!$this->isPathValid($theDest)) {
566 $this->writelog(3,2,101,'Target or destination had invalid path (".." and "//" is not allowed in path). T="%s", D="%s"',Array($theFile,$theDest));
570 // Processing of file or directory:
571 if (@is_file
($theFile)) { // If we are moving a file...
572 if ($this->actionPerms
['moveFile']) {
573 if (filesize($theFile) < ($this->maxMoveFileSize
*1024)) {
574 $fI = t3lib_div
::split_fileref($theFile);
575 if ($altName) { // If altName is set, we're allowed to create a new filename if the file already existed
576 $theDestFile = $this->getUniqueName($fI['file'], $theDest);
577 $fI = t3lib_div
::split_fileref($theDestFile);
579 $theDestFile = $theDest.'/'.$fI['file'];
581 if ($theDestFile && !@file_exists
($theDestFile)) {
582 if ($this->checkIfAllowed($fI['fileext'], $theDest, $fI['file'])) {
583 if ($this->checkPathAgainstMounts($theDestFile) && $this->checkPathAgainstMounts($theFile)) {
584 if ($this->PHPFileFunctions
) {
585 rename($theFile, $theDestFile);
587 $cmd = 'mv "'.$theFile.'" "'.$theDestFile.'"';
591 if (@is_file
($theDestFile)) {
592 $this->writelog(3,0,1,'File "%s" moved to "%s"',Array($theFile,$theDestFile));
594 } else $this->writelog(3,2,109,'File "%s" WAS NOT moved to "%s"! Write-permission problem?',Array($theFile,$theDestFile));
595 } else $this->writelog(3,1,110,'Target or destination was not within your mountpoints! T="%s", D="%s"',Array($theFile,$theDestFile));
596 } else $this->writelog(3,1,111,'Extension of file name "%s" is not allowed in "%s"!',Array($fI['file'],$theDest.'/'));
597 } else $this->writelog(3,1,112,'File "%s" already exists!',Array($theDestFile));
598 } else $this->writelog(3,1,113,'File "%s" exceeds the size-limit of %s bytes',Array($theFile,$this->maxMoveFileSize
*1024));
599 } else $this->writelog(3,1,114,'You are not allowed to move files','');
600 // FINISHED moving file
602 } elseif (@is_dir
($theFile)) { // if we're moving a folder
603 if ($this->actionPerms
['moveFolder']) {
604 $theFile = $this->is_directory($theFile);
606 $fI = t3lib_div
::split_fileref($theFile);
607 if ($altName) { // If altName is set, we're allowed to create a new filename if the file already existed
608 $theDestFile = $this->getUniqueName($fI['file'], $theDest);
609 $fI = t3lib_div
::split_fileref($theDestFile);
611 $theDestFile = $theDest.'/'.$fI['file'];
613 if ($theDestFile && !@file_exists
($theDestFile)) {
614 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?
615 if ($this->checkIfFullAccess($theDest) ||
$this->is_webPath($theDestFile)==$this->is_webPath($theFile)) { // // no moving of folders between spaces
616 if ($this->checkPathAgainstMounts($theDestFile) && $this->checkPathAgainstMounts($theFile)) {
617 if ($this->PHPFileFunctions
) {
618 rename($theFile, $theDestFile);
620 $cmd = 'mv "'.$theFile.'" "'.$theDestFile.'"';
623 exec($cmd,$errArr,$retVar);
626 if (@is_dir
($theDestFile)) {
627 $this->writelog(3,0,2,'Directory "%s" moved to "%s"',Array($theFile,$theDestFile));
629 } else $this->writelog(3,2,119,'Directory "%s" WAS NOT moved to "%s"! Write-permission problem?',Array($theFile,$theDestFile));
630 } else $this->writelog(3,1,120,'Target or destination was not within your mountpoints! T="%s", D="%s"',Array($theFile,$theDestFile));
631 } else $this->writelog(3,1,121,'You don\'t have full access to the destination directory "%s"!',Array($theDest.'/'));
632 } else $this->writelog(3,1,122,'Destination cannot be inside the target! D="%s", T="%s"',Array($theDestFile.'/',$theFile.'/'));
633 } else $this->writelog(3,1,123,'Target "%s" already exists!',Array($theDestFile));
634 } else $this->writelog(3,2,124,'Target seemed not to be a directory! (Shouldn\'t happen here!)','');
635 } else $this->writelog(3,1,125,'You are not allowed to move directories','');
636 // FINISHED moving directory
639 $this->writelog(3,2,130,'The item "%s" was not a file or directory!',Array($theFile));
644 * Renaming files or foldes (action=5)
646 * @param array $cmds['data'] is the new name. $cmds['target'] is the target (file or dir).
647 * @return string Returns the new filename upon success
649 function func_rename($cmds) {
650 if (!$this->isInit
) return FALSE;
652 $theNewName = $this->cleanFileName($cmds['data']);
654 if ($this->checkFileNameLen($theNewName)) {
655 $theTarget = $cmds['target'];
656 $type = filetype($theTarget);
657 if ($type=='file' ||
$type=='dir') { // $type MUST BE file or dir
658 $fileInfo = t3lib_div
::split_fileref($theTarget); // Fetches info about path, name, extention of $theTarget
659 if ($fileInfo['file']!=$theNewName) { // The name should be different from the current. And the filetype must be allowed
660 $theRenameName = $fileInfo['path'].$theNewName;
661 if ($this->checkPathAgainstMounts($fileInfo['path'])) {
662 if (!@file_exists
($theRenameName)) {
664 if ($this->actionPerms
['renameFile']) {
665 $fI = t3lib_div
::split_fileref($theRenameName);
666 if ($this->checkIfAllowed($fI['fileext'], $fileInfo['path'], $fI['file'])) {
667 if (@rename
($theTarget, $theRenameName)) {
668 $this->writelog(5,0,1,'File renamed from "%s" to "%s"',Array($fileInfo['file'],$theNewName));
669 return $theRenameName;
670 } else $this->writelog(5,1,100,'File "%s" was not renamed! Write-permission problem in "%s"?',Array($theTarget,$fileInfo['path']));
671 } else $this->writelog(5,1,101,'Extension of file name "%s" was not allowed!',Array($fI['file']));
672 } else $this->writelog(5,1,102,'You are not allowed to rename files!','');
673 } elseif ($type=='dir') {
674 if ($this->actionPerms
['renameFolder']) {
675 if (@rename
($theTarget, $theRenameName)) {
676 $this->writelog(5,0,2,'Directory renamed from "%s" to "%s"',Array($fileInfo['file'],$theNewName));
677 return $theRenameName;
678 } else $this->writelog(5,1,110,'Directory "%s" was not renamed! Write-permission problem in "%s"?',Array($theTarget,$fileInfo['path']));
679 } else $this->writelog(5,1,111,'You are not allowed to rename directories!','');
681 } else $this->writelog(5,1,120,'Destination "%s" existed already!',Array($theRenameName));
682 } else $this->writelog(5,1,121,'Destination path "%s" was not within your mountpoints!',Array($fileInfo['path']));
683 } else $this->writelog(5,1,122,'Old and new name is the same (%s)',Array($theNewName));
684 } else $this->writelog(5,2,123,'Target "%s" was neither a directory nor a file!',Array($theTarget));
685 } else $this->writelog(5,1,124,'New name "%s" was too long (max %s characters)',Array($theNewName,$this->maxInputNameLen
));
690 * This creates a new folder. (action=6)
692 * @param array $cmds['data'] is the foldername. $cmds['target'] is the path where to create it.
693 * @return string Returns the new foldername upon success
695 function func_newfolder($cmds) {
696 if (!$this->isInit
) return FALSE;
698 $theFolder = $this->cleanFileName($cmds['data']);
700 if ($this->checkFileNameLen($theFolder)) {
701 $theTarget = $this->is_directory($cmds['target']); // Check the target dir
703 if ($this->actionPerms
['newFolder']) {
704 $theNewFolder = $theTarget.'/'.$theFolder;
705 if ($this->checkPathAgainstMounts($theNewFolder)) {
706 if (!@file_exists
($theNewFolder)) {
707 if (t3lib_div
::mkdir($theNewFolder)){
708 $this->writelog(6,0,1,'Directory "%s" created in "%s"',Array($theFolder,$theTarget.'/'));
709 return $theNewFolder;
710 } else $this->writelog(6,1,100,'Directory "%s" not created. Write-permission problem in "%s"?',Array($theFolder,$theTarget.'/'));
711 } else $this->writelog(6,1,101,'File or directory "%s" existed already!',Array($theNewFolder));
712 } else $this->writelog(6,1,102,'Destination path "%s" was not within your mountpoints!',Array($theTarget.'/'));
713 } else $this->writelog(6,1,103,'You are not allowed to create directories!','');
714 } else $this->writelog(6,2,104,'Destination "%s" was not a directory',Array($cmds['target']));
715 } else $this->writelog(6,1,105,'New name "%s" was too long (max %s characters)',Array($theFolder,$this->maxInputNameLen
));
720 * This creates a new file. (action=8)
722 * @param array $cmds['data'] is the new filename. $cmds['target'] is the path where to create it
723 * @return string Returns the new filename upon success
725 function func_newfile($cmds) {
726 $extList = $GLOBALS['TYPO3_CONF_VARS']['SYS']['textfile_ext'];
727 if (!$this->isInit
) return FALSE;
728 $newName = $this->cleanFileName($cmds['data']);
730 if ($this->checkFileNameLen($newName)) {
731 $theTarget = $this->is_directory($cmds['target']); // Check the target dir
732 $fileInfo = t3lib_div
::split_fileref($theTarget); // Fetches info about path, name, extention of $theTarget
734 if ($this->actionPerms
['newFile']) {
735 $theNewFile = $theTarget.'/'.$newName;
736 if ($this->checkPathAgainstMounts($theNewFile)) {
737 if (!@file_exists
($theNewFile)) {
738 $fI = t3lib_div
::split_fileref($theNewFile);
739 if ($this->checkIfAllowed($fI['fileext'], $fileInfo['path'], $fI['file'])) {
740 if (t3lib_div
::inList($extList, $fI['fileext'])) {
741 if (t3lib_div
::writeFile($theNewFile,'')) {
743 $this->writelog(8,0,1,'File created: "%s"',Array($fI['file']));
745 } else $this->writelog(8,1,100,'File "%s" was not created! Write-permission problem in "%s"?',Array($fI['file'], $theTarget));
746 } else $this->writelog(8,1,107,'Fileextension "%s" is not a textfile format! (%s)',Array($fI['fileext'], $extList));
747 } else $this->writelog(8,1,106,'Extension of file name "%s" was not allowed!',Array($fI['file']));
748 } else $this->writelog(8,1,101,'File "%s" existed already!',Array($theNewFile));
749 } else $this->writelog(8,1,102,'Destination path "%s" was not within your mountpoints!',Array($theTarget.'/'));
750 } else $this->writelog(8,1,103,'You are not allowed to create files!','');
751 } else $this->writelog(8,2,104,'Destination "%s" was not a directory',Array($cmds['target']));
752 } else $this->writelog(8,1,105,'New name "%s" was too long (max %s characters)',Array($newName,$this->maxInputNameLen
));
757 * Editing textfiles or folders (action=9)
759 * @param array $cmds['data'] is the new content. $cmds['target'] is the target (file or dir)
760 * @return boolean Returns true on success
762 function func_edit($cmds) {
763 if (!$this->isInit
) return FALSE;
764 $theTarget = $cmds['target'];
765 $content = $cmds['data'];
766 $extList = $GLOBALS['TYPO3_CONF_VARS']['SYS']['textfile_ext'];
767 $type = filetype($theTarget);
768 if ($type=='file') { // $type MUST BE file
769 $fileInfo = t3lib_div
::split_fileref($theTarget); // Fetches info about path, name, extention of $theTarget
771 if ($this->checkPathAgainstMounts($fileInfo['path'])) {
772 if ($this->actionPerms
['editFile']) {
773 $fI = t3lib_div
::split_fileref($theTarget);
774 if ($this->checkIfAllowed($fI['fileext'], $fileInfo['path'], $fI['file'])) {
775 if (t3lib_div
::inList($extList, $fileInfo['fileext'])) {
776 if (t3lib_div
::writeFile($theTarget,$content)) {
778 $this->writelog(9,0,1,'File saved to "%s", bytes: %s, MD5: %s ',Array($fileInfo['file'],@filesize
($theTarget),md5($content)));
780 } else $this->writelog(9,1,100,'File "%s" was not saved! Write-permission problem in "%s"?',Array($theTarget,$fileInfo['path']));
781 } else $this->writelog(9,1,102,'Fileextension "%s" is not a textfile format! (%s)',Array($fI['fileext'], $extList));
782 } else $this->writelog(9,1,103,'Extension of file name "%s" was not allowed!',Array($fI['file']));
783 } else $this->writelog(9,1,104,'You are not allowed to edit files!','');
784 } else $this->writelog(9,1,121,'Destination path "%s" was not within your mountpoints!',Array($fileInfo['path']));
785 } else $this->writelog(9,2,123,'Target "%s" was not a file!',Array($theTarget));
789 * Upload of files (action=1)
791 * @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
792 * @return string Returns the new filename upon success
794 function func_upload($cmds) {
795 if (!$this->isInit
) return FALSE;
797 if ($_FILES['upload_'.$id]['name']) {
798 $theFile = $_FILES['upload_'.$id]['tmp_name']; // filename of the uploaded file
799 $theFileSize = $_FILES['upload_'.$id]['size']; // filesize of the uploaded file
800 $theName = $this->cleanFileName(stripslashes($_FILES['upload_'.$id]['name'])); // The original filename
801 if (is_uploaded_file($theFile) && $theName) { // Check the file
802 if ($this->actionPerms
['uploadFile']) {
803 if ($theFileSize<($this->maxUploadFileSize
*1024)) {
804 $fI = t3lib_div
::split_fileref($theName);
805 $theTarget = $this->is_directory($cmds['target']); // Check the target dir
806 if ($theTarget && $this->checkPathAgainstMounts($theTarget.'/')) {
807 if ($this->checkIfAllowed($fI['fileext'], $theTarget, $fI['file'])) {
808 $theNewFile = $this->getUniqueName($theName, $theTarget, $this->dontCheckForUnique
);
810 t3lib_div
::upload_copy_move($theFile,$theNewFile);
812 if (@is_file
($theNewFile)) {
813 $this->internalUploadMap
[$id] = $theNewFile;
814 $this->writelog(1,0,1,'Uploading file "%s" to "%s"',Array($theName,$theNewFile, $id));
816 } else $this->writelog(1,1,100,'Uploaded file could not be moved! Write-permission problem in "%s"?',Array($theTarget.'/'));
817 } else $this->writelog(1,1,101,'No unique filename available in "%s"!',Array($theTarget.'/'));
818 } else $this->writelog(1,1,102,'Extension of file name "%s" is not allowed in "%s"!',Array($fI['file'], $theTarget.'/'));
819 } else $this->writelog(1,1,103,'Destination path "%s" was not within your mountpoints!',Array($theTarget.'/'));
820 } else $this->writelog(1,1,104,'The uploaded file exceeds the size-limit of %s bytes',Array($this->maxUploadFileSize
*1024));
821 } else $this->writelog(1,1,105,'You are not allowed to upload files!','');
822 } else $this->writelog(1,2,106,'The upload has failed, no uploaded file found!','');
823 } else $this->writelog(1,2,108,'No file was uploaded!','');
827 * Unzipping file (action=7)
828 * This is permitted only if the user has fullAccess or if the file resides
830 * @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.
831 * @return boolean Returns true on success
833 function func_unzip($cmds) {
834 if (!$this->isInit ||
$this->dont_use_exec_commands
) return FALSE;
836 $theFile = $cmds['data'];
837 if (@is_file
($theFile)) {
838 $fI = t3lib_div
::split_fileref($theFile);
839 if (!isset($cmds['target'])) {
840 $cmds['target'] = $fI['path'];
842 $theDest = $this->is_directory($cmds['target']); // Clean up destination directory
844 if ($this->actionPerms
['unzipFile']) {
845 if ($fI['fileext']=='zip') {
846 if ($this->checkIfFullAccess($theDest)) {
847 if ($this->checkPathAgainstMounts($theFile) && $this->checkPathAgainstMounts($theDest.'/')) {
848 // No way to do this under windows.
849 $cmd = $this->unzipPath
.'unzip -qq "'.$theFile.'" -d "'.$theDest.'"';
851 $this->writelog(7,0,1,'Unzipping file "%s" in "%s"',Array($theFile,$theDest));
853 } else $this->writelog(7,1,100,'File "%s" or destination "%s" was not within your mountpoints!',Array($theFile,$theDest));
854 } else $this->writelog(7,1,101,'You don\'t have full access to the destination directory "%s"!',Array($theDest));
855 } else $this->writelog(7,1,102,'Fileextension is not "zip"','');
856 } else $this->writelog(7,1,103,'You are not allowed to unzip files','');
857 } else $this->writelog(7,2,104,'Destination "%s" was not a directory',Array($cmds['target']));
858 } else $this->writelog(7,2,105,'The file "%s" did not exist!',Array($theFile));
862 if (defined('TYPO3_MODE') && $TYPO3_CONF_VARS[TYPO3_MODE
]['XCLASS']['t3lib/class.t3lib_extfilefunc.php']) {
863 include_once($TYPO3_CONF_VARS[TYPO3_MODE
]['XCLASS']['t3lib/class.t3lib_extfilefunc.php']);