2014-10-22 19:33:36 +04:00
|
|
|
<?php
|
|
|
|
/**
|
2015-06-25 12:43:55 +03:00
|
|
|
* @author Lukas Reschke <lukas@owncloud.com>
|
2015-03-26 13:44:34 +03:00
|
|
|
* @author Morris Jobke <hey@morrisjobke.de>
|
2015-06-25 12:43:55 +03:00
|
|
|
* @author Olivier Paroz <github@oparoz.com>
|
2015-03-26 13:44:34 +03:00
|
|
|
* @author Robin Appelman <icewind@owncloud.com>
|
|
|
|
*
|
|
|
|
* @copyright Copyright (c) 2015, ownCloud, Inc.
|
|
|
|
* @license AGPL-3.0
|
|
|
|
*
|
|
|
|
* This code is free software: you can redistribute it and/or modify
|
|
|
|
* it under the terms of the GNU Affero General Public License, version 3,
|
|
|
|
* as published by the Free Software Foundation.
|
|
|
|
*
|
|
|
|
* This program is distributed in the hope that it will be useful,
|
|
|
|
* but WITHOUT ANY WARRANTY; without even the implied warranty of
|
|
|
|
* MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
|
|
|
|
* GNU Affero General Public License for more details.
|
|
|
|
*
|
|
|
|
* You should have received a copy of the GNU Affero General Public License, version 3,
|
|
|
|
* along with this program. If not, see <http://www.gnu.org/licenses/>
|
|
|
|
*
|
2014-10-22 19:33:36 +04:00
|
|
|
*/
|
2015-02-26 13:37:37 +03:00
|
|
|
|
2014-10-22 19:33:36 +04:00
|
|
|
namespace OC;
|
|
|
|
|
|
|
|
use OCP\ILogger;
|
|
|
|
use OCP\ITempManager;
|
|
|
|
|
|
|
|
class TempManager implements ITempManager {
|
2015-04-23 15:29:15 +03:00
|
|
|
/** @var string[] Current temporary files and folders, used for cleanup */
|
|
|
|
protected $current = [];
|
|
|
|
/** @var string i.e. /tmp on linux systems */
|
2014-10-22 19:33:36 +04:00
|
|
|
protected $tmpBaseDir;
|
2015-04-23 15:29:15 +03:00
|
|
|
/** @var ILogger */
|
2014-10-22 19:33:36 +04:00
|
|
|
protected $log;
|
2015-04-23 15:29:15 +03:00
|
|
|
/** Prefix */
|
|
|
|
const TMP_PREFIX = 'oc_tmp_';
|
2014-10-22 19:33:36 +04:00
|
|
|
|
|
|
|
/**
|
|
|
|
* @param \OCP\ILogger $logger
|
|
|
|
*/
|
2015-05-29 22:56:08 +03:00
|
|
|
public function __construct(ILogger $logger) {
|
|
|
|
$this->tmpBaseDir = $this->t_get_temp_dir();
|
2014-10-22 19:33:36 +04:00
|
|
|
$this->log = $logger;
|
|
|
|
}
|
|
|
|
|
2015-03-27 01:14:24 +03:00
|
|
|
/**
|
2015-04-23 15:29:15 +03:00
|
|
|
* Builds the filename with suffix and removes potential dangerous characters
|
|
|
|
* such as directory separators.
|
|
|
|
*
|
|
|
|
* @param string $absolutePath Absolute path to the file / folder
|
|
|
|
* @param string $postFix Postfix appended to the temporary file name, may be user controlled
|
2015-03-27 01:14:24 +03:00
|
|
|
* @return string
|
|
|
|
*/
|
2015-04-23 15:29:15 +03:00
|
|
|
private function buildFileNameWithSuffix($absolutePath, $postFix = '') {
|
|
|
|
if($postFix !== '') {
|
2015-03-19 17:35:36 +03:00
|
|
|
$postFix = '.' . ltrim($postFix, '.');
|
2015-04-23 15:29:15 +03:00
|
|
|
$postFix = str_replace(['\\', '/'], '', $postFix);
|
|
|
|
$absolutePath .= '-';
|
2015-03-19 17:35:36 +03:00
|
|
|
}
|
2015-04-23 15:29:15 +03:00
|
|
|
|
|
|
|
return $absolutePath . $postFix;
|
2014-10-22 19:33:36 +04:00
|
|
|
}
|
|
|
|
|
|
|
|
/**
|
|
|
|
* Create a temporary file and return the path
|
|
|
|
*
|
2015-04-23 15:29:15 +03:00
|
|
|
* @param string $postFix Postfix appended to the temporary file name
|
2014-10-22 19:33:36 +04:00
|
|
|
* @return string
|
|
|
|
*/
|
|
|
|
public function getTemporaryFile($postFix = '') {
|
|
|
|
if (is_writable($this->tmpBaseDir)) {
|
2015-04-23 15:29:15 +03:00
|
|
|
// To create an unique file and prevent the risk of race conditions
|
|
|
|
// or duplicated temporary files by other means such as collisions
|
|
|
|
// we need to create the file using `tempnam` and append a possible
|
|
|
|
// postfix to it later
|
|
|
|
$file = tempnam($this->tmpBaseDir, self::TMP_PREFIX);
|
2014-10-22 19:33:36 +04:00
|
|
|
$this->current[] = $file;
|
2015-04-23 15:29:15 +03:00
|
|
|
|
|
|
|
// If a postfix got specified sanitize it and create a postfixed
|
|
|
|
// temporary file
|
|
|
|
if($postFix !== '') {
|
|
|
|
$fileNameWithPostfix = $this->buildFileNameWithSuffix($file, $postFix);
|
|
|
|
touch($fileNameWithPostfix);
|
|
|
|
chmod($fileNameWithPostfix, 0600);
|
|
|
|
$this->current[] = $fileNameWithPostfix;
|
|
|
|
return $fileNameWithPostfix;
|
|
|
|
}
|
|
|
|
|
2014-10-22 19:33:36 +04:00
|
|
|
return $file;
|
|
|
|
} else {
|
|
|
|
$this->log->warning(
|
|
|
|
'Can not create a temporary file in directory {dir}. Check it exists and has correct permissions',
|
2015-04-23 15:29:15 +03:00
|
|
|
[
|
|
|
|
'dir' => $this->tmpBaseDir,
|
|
|
|
]
|
2014-10-22 19:33:36 +04:00
|
|
|
);
|
|
|
|
return false;
|
|
|
|
}
|
|
|
|
}
|
|
|
|
|
|
|
|
/**
|
|
|
|
* Create a temporary folder and return the path
|
|
|
|
*
|
2015-04-23 15:29:15 +03:00
|
|
|
* @param string $postFix Postfix appended to the temporary folder name
|
2014-10-22 19:33:36 +04:00
|
|
|
* @return string
|
|
|
|
*/
|
|
|
|
public function getTemporaryFolder($postFix = '') {
|
|
|
|
if (is_writable($this->tmpBaseDir)) {
|
2015-04-23 15:29:15 +03:00
|
|
|
// To create an unique directory and prevent the risk of race conditions
|
|
|
|
// or duplicated temporary files by other means such as collisions
|
|
|
|
// we need to create the file using `tempnam` and append a possible
|
|
|
|
// postfix to it later
|
|
|
|
$uniqueFileName = tempnam($this->tmpBaseDir, self::TMP_PREFIX);
|
|
|
|
$this->current[] = $uniqueFileName;
|
|
|
|
|
|
|
|
// Build a name without postfix
|
|
|
|
$path = $this->buildFileNameWithSuffix($uniqueFileName . '-folder', $postFix);
|
|
|
|
mkdir($path, 0700);
|
2014-10-22 19:33:36 +04:00
|
|
|
$this->current[] = $path;
|
2015-04-23 15:29:15 +03:00
|
|
|
|
2014-10-22 19:33:36 +04:00
|
|
|
return $path . '/';
|
|
|
|
} else {
|
|
|
|
$this->log->warning(
|
|
|
|
'Can not create a temporary folder in directory {dir}. Check it exists and has correct permissions',
|
2015-04-23 15:29:15 +03:00
|
|
|
[
|
|
|
|
'dir' => $this->tmpBaseDir,
|
|
|
|
]
|
2014-10-22 19:33:36 +04:00
|
|
|
);
|
|
|
|
return false;
|
|
|
|
}
|
|
|
|
}
|
|
|
|
|
|
|
|
/**
|
|
|
|
* Remove the temporary files and folders generated during this request
|
|
|
|
*/
|
|
|
|
public function clean() {
|
|
|
|
$this->cleanFiles($this->current);
|
|
|
|
}
|
|
|
|
|
2015-04-23 15:29:15 +03:00
|
|
|
/**
|
|
|
|
* @param string[] $files
|
|
|
|
*/
|
2014-10-22 19:33:36 +04:00
|
|
|
protected function cleanFiles($files) {
|
|
|
|
foreach ($files as $file) {
|
|
|
|
if (file_exists($file)) {
|
|
|
|
try {
|
|
|
|
\OC_Helper::rmdirr($file);
|
|
|
|
} catch (\UnexpectedValueException $ex) {
|
|
|
|
$this->log->warning(
|
|
|
|
"Error deleting temporary file/folder: {file} - Reason: {error}",
|
2015-04-23 15:29:15 +03:00
|
|
|
[
|
2014-10-22 19:33:36 +04:00
|
|
|
'file' => $file,
|
2015-04-23 15:29:15 +03:00
|
|
|
'error' => $ex->getMessage(),
|
|
|
|
]
|
2014-10-22 19:33:36 +04:00
|
|
|
);
|
|
|
|
}
|
|
|
|
}
|
|
|
|
}
|
|
|
|
}
|
|
|
|
|
|
|
|
/**
|
|
|
|
* Remove old temporary files and folders that were failed to be cleaned
|
|
|
|
*/
|
|
|
|
public function cleanOld() {
|
|
|
|
$this->cleanFiles($this->getOldFiles());
|
|
|
|
}
|
|
|
|
|
|
|
|
/**
|
|
|
|
* Get all temporary files and folders generated by oc older than an hour
|
|
|
|
*
|
|
|
|
* @return string[]
|
|
|
|
*/
|
|
|
|
protected function getOldFiles() {
|
|
|
|
$cutOfTime = time() - 3600;
|
2015-04-23 15:29:15 +03:00
|
|
|
$files = [];
|
2014-10-22 19:33:36 +04:00
|
|
|
$dh = opendir($this->tmpBaseDir);
|
2015-02-09 14:36:18 +03:00
|
|
|
if ($dh) {
|
|
|
|
while (($file = readdir($dh)) !== false) {
|
2015-04-23 15:29:15 +03:00
|
|
|
if (substr($file, 0, 7) === self::TMP_PREFIX) {
|
2015-02-09 14:36:18 +03:00
|
|
|
$path = $this->tmpBaseDir . '/' . $file;
|
|
|
|
$mtime = filemtime($path);
|
|
|
|
if ($mtime < $cutOfTime) {
|
|
|
|
$files[] = $path;
|
|
|
|
}
|
2014-10-22 19:33:36 +04:00
|
|
|
}
|
|
|
|
}
|
|
|
|
}
|
|
|
|
return $files;
|
|
|
|
}
|
2015-05-29 22:56:08 +03:00
|
|
|
|
|
|
|
/**
|
|
|
|
* Get the temporary directory to store transfer data
|
|
|
|
* @return null|string Path to the temporary directory or null
|
|
|
|
*/
|
|
|
|
public function t_get_temp_dir() {
|
|
|
|
// Get the temporary directory and log the path if loglevel is set to debug
|
|
|
|
// Info: based on the temp dir, further directories may be created unique to the instance
|
|
|
|
$temp = self::gather_temp_dir();
|
|
|
|
\OCP\Util::writeLog('Core', 'Temporary directory set to: ' . ($temp ? $temp : 'NULL'), \OCP\Util::DEBUG);
|
|
|
|
return $temp;
|
|
|
|
}
|
|
|
|
|
|
|
|
/**
|
|
|
|
* Get a temporary directory from possible sources
|
|
|
|
* If a temporary directory is set in config.php, use this one
|
|
|
|
* @return null|string Path to the temporary directory or null
|
|
|
|
*/
|
|
|
|
private function gather_temp_dir() {
|
|
|
|
if ($temp = self::get_config_temp_dir()) return $temp;
|
|
|
|
if ($temp = ini_get('upload_tmp_dir')) return $temp;
|
|
|
|
if ($temp = getenv('TMP')) return $temp;
|
|
|
|
if ($temp = getenv('TEMP')) return $temp;
|
|
|
|
if ($temp = getenv('TMPDIR')) return $temp;
|
|
|
|
$temp = tempnam(__FILE__, '');
|
|
|
|
if (file_exists($temp)) {
|
|
|
|
unlink($temp);
|
|
|
|
return dirname($temp);
|
|
|
|
}
|
|
|
|
if ($temp = sys_get_temp_dir()) return $temp;
|
|
|
|
return null;
|
|
|
|
}
|
|
|
|
|
|
|
|
/**
|
|
|
|
* Check if the temporary directory is defined in config.php and is present and writable
|
|
|
|
* @return bool|string Path to the temporary directory or false
|
|
|
|
*/
|
|
|
|
private function get_config_temp_dir() {
|
|
|
|
$temp = \OC::$server->getConfig()->getSystemValue('tempdirectory', false);
|
|
|
|
// surpress any possible errors caused by is_writable
|
|
|
|
// checks missing or invalid path or characters, wrong permissions ect
|
|
|
|
if ($temp) {
|
|
|
|
try {
|
|
|
|
if (is_writeable($temp)) {
|
|
|
|
return $temp;
|
|
|
|
} else {
|
|
|
|
\OCP\Util::writeLog('Core', 'Manually set temporary directory in config.php is not present or writable: ' . $temp, \OCP\Util::WARN);
|
|
|
|
return false;
|
|
|
|
}
|
|
|
|
} catch (Exception $e) {
|
|
|
|
return false;
|
|
|
|
}
|
|
|
|
}
|
|
|
|
}
|
|
|
|
|
2014-10-22 19:33:36 +04:00
|
|
|
}
|