/**
* Set attachment file.
*
* Copies the attachment into proper location and makes sure that all the unset fields get properly assigned.
*
* @param string $source Absolute path to the upcoming attachment.
* @param string $basename Filename without extension.
* @param string $extension File extension.
* @param bool $unlink Whether to delete the original file or not.
* @param bool $overwrite If not allowed, throw exception if the file exists.
*
* @return bool
* @throws InvalidArgumentException
* @throws RuntimeException
*
* @since K4.0
*/
public function saveFile($source, $basename = null, $extension = null, $unlink = false, $overwrite = false)
{
if (!is_file($source)) {
throw new InvalidArgumentException(__CLASS__ . '::' . __METHOD__ . '(): Attachment file not found.');
}
// Hash, size and MIME are set during saving, so let's deal with all other variables.
$this->userid = is_null($this->userid) ? KunenaUserHelper::getMyself() : $this->userid;
$this->folder = is_null($this->folder) ? "media/kunena/attachments/{$this->userid}" : $this->folder;
$this->protected = is_null($this->protected) ? (bool) KunenaConfig::getInstance()->attachment_protection : $this->protected;
if (!$this->filename_real) {
$this->filename_real = $this->filename;
}
if (!$this->filename || $this->filename == $this->filename_real) {
if (!$basename || !$extension) {
throw new InvalidArgumentException(__CLASS__ . '::' . __METHOD__ . '(): Parameters $basename or $extension not provided.');
}
// Find available filename.
$this->filename = KunenaAttachmentHelper::getAvailableFilename($this->folder, $basename, $extension, $this->protected);
}
// Create target directory if it does not exist.
if (!KunenaFolder::exists(JPATH_ROOT . "/{$this->folder}") && !KunenaFolder::create(JPATH_ROOT . "/{$this->folder}")) {
throw new RuntimeException(JText::_('Failed to create attachment directory.'));
}
$destination = JPATH_ROOT . "/{$this->folder}/{$this->filename}";
// Move the file into the final location (if not already in there).
if ($source != $destination) {
// Create target directory if it does not exist.
if (!$overwrite && is_file($destination)) {
throw new RuntimeException(JText::sprintf('Attachment %s already exists.'), $this->filename_real);
}
if ($unlink) {
@chmod($source, 0644);
}
$success = KunenaFile::copy($source, $destination);
if (!$success) {
throw new RuntimeException(JText::sprintf('COM_KUNENA_UPLOAD_ERROR_NOT_MOVED', $destination));
}
KunenaPath::setPermissions($destination);
if ($unlink) {
unlink($source);
}
}
return $this->save();
}
/**
* Upload file by passing it by HTML input
*
* @param array $fileInput The file object returned by JInput
* @param string $destination The path of destination of file uploaded
* @param string $type The type of file uploaded: attachment or avatar
*
* @return object
*/
public function upload($fileInput, $destination, $type = 'attachment')
{
$file = new stdClass();
$file->ext = JFile::getExt($fileInput['name']);
$file->size = $fileInput['size'];
$file->tmp_name = $fileInput['tmp_name'];
$file->error = $fileInput['error'];
$file->destination = $destination . '.' . $file->ext;
$file->success = false;
$file->isAvatar = false;
if ($type != 'attachment') {
$file->isAvatar = true;
}
if (!is_uploaded_file($file->tmp_name)) {
$exception = $this->checkUpload($fileInput);
if ($exception) {
throw $exception;
}
} elseif ($file->error != 0) {
throw new RuntimeException(JText::_('COM_KUNENA_UPLOAD_ERROR_NOT_UPLOADED'), 500);
}
// Check if file extension matches any allowed extensions (case insensitive)
foreach ($this->validExtensions as $ext) {
$extension = JString::substr($file->tmp_name, -JString::strlen($ext));
if (JString::strtolower($extension) == JString::strtolower($ext)) {
// File must contain one letter before extension
$name = JString::substr($file->tmp_name, 0, -JString::strlen($ext));
$extension = JString::substr($extension, 1);
if (!$name) {
throw new RuntimeException(JText::sprintf('COM_KUNENA_UPLOAD_ERROR_EXTENSION_FILE', implode(', ', $this->validExtensions)), 400);
}
}
}
if (!$this->checkFileSize($file->size, true)) {
if ($file->isAvatar) {
throw new RuntimeException(JText::_('COM_KUNENA_UPLOAD_ERROR_AVATAR_EXCEED_LIMIT_IN_CONFIGURATION'), 500);
} else {
throw new RuntimeException(JText::_('COM_KUNENA_UPLOAD_ERROR_FILE_EXCEED_LIMIT_IN_CONFIGURATION'), 500);
}
}
if (!KunenaFile::copy($file->tmp_name, $file->destination)) {
throw new RuntimeException(JText::_('COM_KUNENA_UPLOAD_ERROR_FILE_RIGHT_MEDIA_DIR'), 500);
}
unlink($file->tmp_name);
KunenaPath::setPermissions($file->destination);
$file->success = true;
return $file;
}
