File indexing completed on 2024-12-22 05:33:08

 <?php
 /** @noinspection PhpUnused */
 /** @noinspection PhpUndefinedFieldInspection */
 
 use Aws\Credentials\Credentials;
 use Aws\S3\S3Client;
 use Ocs\Filter\File\Filename;
 use Ocs\Storage\FilesystemAdapter;
 use Ocs\Url\UrlSigner;
 
 /**
  * ocs-fileserver
  *
  * Copyright 2016 by pling GmbH.
  *
  * This file is part of ocs-fileserver.
  *
  * ocs-fileserver is free software: you can redistribute it and/or modify
  * it under the terms of the GNU Affero General Public License as published by
  * the Free Software Foundation, either version 3 of the License, or
  * (at your option) any later version.
  *
  * ocs-fileserver 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
  * along with Foobar.  If not, see <http://www.gnu.org/licenses/>.
  **/
 class Files extends BaseController
 {
 
     const MIN_TIME = 60;
     const MAX_REQUEST_PER_MINUTE = 10;
     const BLOCKING_PERIOD = 180;
 
     /**
      * @throws Flooer_Exception
      */
     public function getIndex()
     {
         $originId = null;
         $status = 'active';
         $clientId = null;
         $ownerId = null;
         $collectionId = null;
         $collectionStatus = 'active';
         $collectionCategory = null;
         $collectionTags = null; // Comma-separated list
         $collectionContentId = null;
         $types = null;  // Comma-separated list
         $category = null;
         $tags = null; // Comma-separated list
         $ocsCompatibility = 'all';
         $contentId = null;
         $search = null; // 3 or more strings
         $ids = null; // Comma-separated list
         $favoriteIds = array();
         $downloadedTimeperiodBegin = null; // Datetime format
         $downloadedTimeperiodEnd = null; // Datetime format
         $sort = 'name';
         $perpage = $this->appConfig->general['perpage'];
         $page = 1;
 
         if (!empty($this->request->origin_id)) {
             $originId = $this->request->origin_id;
         }
         if (!empty($this->request->status)) {
             $status = $this->request->status;
         }
         if (!empty($this->request->client_id)) {
             $clientId = $this->request->client_id;
         }
         if (!empty($this->request->owner_id)) {
             $ownerId = $this->request->owner_id;
         }
         if (!empty($this->request->collection_id)) {
             $collectionId = $this->request->collection_id;
         }
         if (!empty($this->request->collection_status)) {
             $collectionStatus = $this->request->collection_status;
         }
         if (isset($this->request->collection_category)) {
             $collectionCategory = $this->request->collection_category;
         }
         if (isset($this->request->collection_tags)) {
             $collectionTags = $this->request->collection_tags;
         }
         if (isset($this->request->collection_content_id)) {
             $collectionContentId = $this->request->collection_content_id;
         }
         if (!empty($this->request->types)) {
             $types = $this->request->types;
         }
         if (isset($this->request->category)) {
             $category = $this->request->category;
         }
         if (isset($this->request->tags)) {
             $tags = $this->request->tags;
         }
         if (!empty($this->request->ocs_compatibility)) {
             $ocsCompatibility = $this->request->ocs_compatibility;
         }
         if (isset($this->request->content_id)) {
             $contentId = $this->request->content_id;
         }
         if (!empty($this->request->search)) {
             $search = $this->request->search;
         }
         if (!empty($this->request->ids)) {
             $ids = $this->request->ids;
         }
         if (!empty($this->request->client_id) && !empty($this->request->favoritesby)) {
             $favoriteIds = $this->_getFavoriteIds($this->request->client_id, $this->request->favoritesby);
             if (!$favoriteIds) {
                 $this->response->setStatus(404);
                 throw new Flooer_Exception('Not found', LOG_NOTICE);
             }
         }
         if (!empty($this->request->downloaded_timeperiod_begin)) {
             $downloadedTimeperiodBegin = $this->request->downloaded_timeperiod_begin;
         }
         if (!empty($this->request->downloaded_timeperiod_end)) {
             $downloadedTimeperiodEnd = $this->request->downloaded_timeperiod_end;
         }
         if (!empty($this->request->sort)) {
             $sort = $this->request->sort;
         }
         if (!empty($this->request->perpage) && $this->_isValidPerpageNumber($this->request->perpage)) {
             $perpage = $this->request->perpage;
         }
         if (!empty($this->request->page) && $this->_isValidPageNumber($this->request->page)) {
             $page = $this->request->page;
         }
 
         $files = $this->models->files->getFiles($originId, $status, $clientId, $ownerId, $collectionId, $collectionStatus, $collectionCategory, $collectionTags, $collectionContentId, $types, $category, $tags, $ocsCompatibility, $contentId, $search, $ids, $favoriteIds, $downloadedTimeperiodBegin, $downloadedTimeperiodEnd, $sort, $perpage, $page);
 
         if (!$files) {
             $this->response->setStatus(404);
             throw new Flooer_Exception('Not found', LOG_NOTICE);
         }
 
         $this->_setResponseContent('success', $files);
     }
 
     /**
      * @throws Flooer_Exception
      */
     public function getFile()
     {
         $id = null;
 
         if (!empty($this->request->id)) {
             $id = $this->request->id;
         }
 
         $file = $this->models->files->getFile($id);
 
         if (!$file) {
             $this->response->setStatus(404);
             throw new Flooer_Exception('Not found', LOG_NOTICE);
         }
 
         $this->_setResponseContent('success', array('file' => $file));
     }
 
     /**
      * @param $element_name
      * @param $error_message
      *
      * @return bool
      */
     protected function testFileUpload($element_name, &$error_message): bool
     {
         if (!isset($_FILES[$element_name])) {
             $error_message = "No file upload with name '$element_name' in request.";
 
             return false;
         }
         $error = $_FILES[$element_name]['error'];
 
         // List at: http://php.net/manual/en/features.file-upload.errors.php
         if ($error != UPLOAD_ERR_OK) {
             switch ($error) {
                 case UPLOAD_ERR_INI_SIZE:
                     $error_message = 'The uploaded file exceeds the upload_max_filesize directive in php.ini.';
                     break;
 
                 case UPLOAD_ERR_FORM_SIZE:
                     $error_message = 'The uploaded file exceeds the MAX_FILE_SIZE directive that was specified in the HTML form.';
                     break;
 
                 case UPLOAD_ERR_PARTIAL:
                     $error_message = 'The uploaded file was only partially uploaded.';
                     break;
 
                 case UPLOAD_ERR_NO_FILE:
                     $error_message = 'No file was uploaded.';
                     break;
 
                 case UPLOAD_ERR_NO_TMP_DIR:
                     $error_message = 'Missing a temporary folder.';
                     break;
 
                 case UPLOAD_ERR_CANT_WRITE:
                     $error_message = 'Failed to write file to disk.';
                     break;
 
                 case UPLOAD_ERR_EXTENSION:
                     $error_message = 'A PHP extension interrupted the upload.';
                     break;
 
                 default:
                     $error_message = 'Unknown error';
                     break;
             }
 
             return false;
         }
 
         $error_message = null;
 
         return true;
     }
 
     /**
      * @throws Flooer_Exception
      */
     public function postFile() {
         if (!$this->_isAllowedAccess()) {
             $this->response->setStatus(403);
             throw new Flooer_Exception('Forbidden', LOG_NOTICE);
         }
 
         $errors = array();
         if (!$this->request->client_id) {
             $errors['client_id'] = 'Required';
         }
         if (!$this->request->owner_id) {
             $errors['owner_id'] = 'Required';
         }
         /*
         if (!isset($_FILES['file'])) {
             $errors['file'] = 'Required';
         }
         else if (!empty($_FILES['file']['error'])) { // 0 = UPLOAD_ERR_OK
             $errors['file'] = $_FILES['file']['error'];
         }
         */
         // for hive files importing (Deprecated) ----------
         if (!isset($_FILES['file']) && !isset($this->request->local_file_path)) {
             $errors['file'] = 'Required';
         }
         if (isset($_FILES['file']) && !empty($_FILES['file']['error'])) { // 0 = UPLOAD_ERR_OK
             $errors['file'] = $_FILES['file']['error'];
         }
         // ------------------------------------------------
 
         if ($errors) {
             $this->response->setStatus(400);
             $this->_setResponseContent('error', array(
                 'message' => 'Validation error',
                 'errors'  => $errors,
             ));
 
             return;
         }
 
         $file = $this->processFileUpload();
 
         $this->_setResponseContent('success', array('file' => $file));
     }
 
     /**
      * @return Flooer_Db_Table_Row|null
      * @throws Flooer_Exception
      */
     private function processFileUpload(): ?Flooer_Db_Table_Row
     {
         $id = null; // Auto generated
         $originId = null; // Auto generated
         $active = 1;
         $clientId = null;
         $ownerId = null;
         $collectionId = null;
         $name = null; // Auto generated
         $type = null; // Auto detect
         $size = null; // Auto detect
         $md5sum = null; // Auto detect
         $title = null; // Name as default
         $description = null;
         $category = null;
         $tags = null; // Comma-separated list
         $version = null;
         $ocsCompatible = 1;
         $contentId = null;
         $contentPage = null;
 
         $downloadedCount = 0; // for hive files importing (Deprecated)
 
         if (!empty($this->request->client_id)) {
             $clientId = $this->request->client_id;
         }
         if (!empty($this->request->owner_id)) {
             $ownerId = $this->request->owner_id;
         }
         if (!empty($this->request->collection_id)) {
             $collectionId = $this->request->collection_id;
         }
         if (isset($this->request->tags)) {
             $tags = strip_tags($this->request->tags);
         }
         if (isset($_FILES['file'])) {
             if (!empty($_FILES['file']['name'])) {
                 //$name = mb_substr(strip_tags(basename($_FILES['file']['name'])), 0, 200);
                 $filter = new Filename(['beautify' => true]);
                 $name = $filter->filter(basename($_FILES['file']['name']));
             }
             if (!empty($_FILES['file']['tmp_name'])) {
                 $info = new finfo(FILEINFO_MIME_TYPE);
                 $type = $info->file($_FILES['file']['tmp_name']);
                 if (!$type) {
                     $type = 'application/octet-stream';
                 }
                 $md5sum = md5_file($_FILES['file']['tmp_name']);
             }
             if (!empty($_FILES['file']['size'])) {
                 $size = $_FILES['file']['size'];
             }
         }
         else { // alternative application path when user uploads an url
             if (isset($this->request->local_file_path)) {
                 if (!empty($this->request->local_file_path)) {
                     // $name = mb_substr(strip_tags(basename($this->request->local_file_path)), 0, 200);
                     $filter = new Filename(['beautify' => true]);
                     $name = $filter->filter(basename($this->request->local_file_path));
                     $externalUri = $this->_detectLinkInTags($tags);
                     if ($name == 'empty' && !empty($externalUri)) {
                         $fileAttribs = $this->getRemoteFileInfo($externalUri);
                         $size = isset($fileAttribs['fileSize']) ? (int)$fileAttribs['fileSize'] : 0;
                         $this->logWithRequestId(__METHOD__ . " - file size detected: $size");
 
                         //$data = get_headers($externalUri, true);
                         //$size = isset($data['Content-Length']) ? (int)$data['Content-Length'] : 0;
 
                         $type = $this->_detectMimeTypeFromUri($externalUri);
                         if (0 >= $size) {
                             $size = $this->_detectFilesizeFromUri($externalUri);
                             $this->logWithRequestId(__METHOD__ . " - file size detected: $size");
                         }
                     } else {
                         $info = new finfo(FILEINFO_MIME_TYPE);
                         $type = $info->file($this->request->local_file_path);
                         if (!$type) {
                             $type = 'application/octet-stream';
                         }
                         $size = filesize($this->request->local_file_path);
                     }
                 }
                 if (!empty($this->request->local_file_name)) {
                     //$name = mb_substr(strip_tags(basename($this->request->local_file_name)), 0, 200);
                     $filter = new Filename(['beautify' => true]);
                     $name = $filter->filter(basename($this->request->local_file_name));
                 }
             }
         }
         if (!empty($this->request->title)) {
             $title = mb_substr(strip_tags($this->request->title), 0, 200);
         }
         if (isset($this->request->description)) {
             $description = strip_tags($this->request->description);
         }
         if (isset($this->request->category)) {
             $category = mb_substr(strip_tags($this->request->category), 0, 64);
         }
         if (isset($this->request->version)) {
             $version = mb_substr(strip_tags($this->request->version), 0, 64);
         }
         if (isset($this->request->ocs_compatible)) {
             if ($this->request->ocs_compatible == 1) {
                 $ocsCompatible = 1;
             } else {
                 if ($this->request->ocs_compatible == 0) {
                     $ocsCompatible = 0;
                 }
             }
         }
         if (isset($this->request->content_id)) {
             $contentId = $this->request->content_id;
         }
         if (!empty($this->request->content_page)) {
             $contentPage = $this->request->content_page;
         }
         // for hive files importing (Deprecated) ----------
         if (!empty($this->request->downloaded_count)) {
             $downloadedCount = intval($this->request->downloaded_count);
         }
         // ------------------------------------------------
 
 
         // Get ID3 tags in the file. 'getid3' may not work on network storage
         $id3Tags = $this->_getId3Tags($type, $_FILES['file']['tmp_name']);
 
         $fileSystemAdapter = new FilesystemAdapter($this->appConfig);
 //        $fileSystemAdapter = new \Ocs\Storage\S3Adapter($this->appConfig);
 
         // Prepare to append the file to collection
         $collectionName = null;
         $collectionData = array();
         if ($collectionId) {
             // Get specified collection and check owner and client
             $collection = $this->models->collections->$collectionId;
             if (!$collection || $collection->client_id != $clientId || $collection->owner_id != $ownerId) {
                 $this->response->setStatus(403);
                 throw new Flooer_Exception('Forbidden', LOG_NOTICE);
             }
             $collectionName = $collection->name;
             // add file count and size
             $collectionData = array('files' => $collection->files + 1,
                                     'size'  => $collection->size + $size,);
         } else {
             // Prepare new collection
             $collectionId = $this->models->collections->generateId();
             $collectionActive = 1;
             $collectionName = $collectionId;
             $collectionTitle = $collectionName;
             $collectionDescription = null;
             $collectionCategory = null;
             $collectionTags = null;
             $collectionVersion = null;
             $collectionContentId = null;
             $collectionContentPage = null;
 
             $collectionPath = $this->appConfig->general['filesDir'] . DIRECTORY_SEPARATOR . $collectionName;
             if (!$fileSystemAdapter->testAndCreate($collectionPath)) {
                 $this->response->setStatus(500);
                 throw new Flooer_Exception('Failed to create new collection path: ' . $collectionPath, LOG_ALERT);
             }
             $collectionData = array('active'       => $collectionActive,
                                     'client_id'    => $clientId,
                                     'owner_id'     => $ownerId,
                                     'name'         => $collectionName,
                                     'files'        => 1,
                                     'size'         => $size,
                                     'title'        => $collectionTitle,
                                     'description'  => $collectionDescription,
                                     'category'     => $collectionCategory,
                                     'tags'         => $collectionTags,
                                     'version'      => $collectionVersion,
                                     'content_id'   => $collectionContentId,
                                     'content_page' => $collectionContentPage,);
         }
 
         $id = $this->models->files->generateId();
         $originId = $id;
         $collectionPath = $this->appConfig->general['filesDir'] . DIRECTORY_SEPARATOR . $collectionName;
         $name = $fileSystemAdapter->fixFilename($name, $collectionPath);
         if (!$title) {
             $title = mb_substr(strip_tags($name), 0, 200);
         }
 
         // Save the uploaded file
         $pathFile = $collectionPath . DIRECTORY_SEPARATOR . $name;
         $this->logWithRequestId(__METHOD__ . ' - check general storage path exists: ' . $collectionPath . ' :: ' . (is_dir($collectionPath) ? 'true' : 'false'));
         if (empty($this->request->local_file_path) && !$fileSystemAdapter->moveUploadedFile($_FILES['file']['tmp_name'], $pathFile)) {
             $this->response->setStatus(500);
             throw new Flooer_Exception('Failed to save the file: ' . $_FILES['file']['tmp_name'] . ' --> ' . $pathFile, LOG_ALERT);
         }
         if (!empty($this->request->local_file_path) && !$fileSystemAdapter->copyFile($this->appConfig->general['filesDir'] . '/empty', $pathFile)) {
             $this->response->setStatus(500);
             throw new Flooer_Exception('Failed to copy the empty dummy file ('.$this->appConfig->general['filesDir'] . '/empty'.') to destination: ' . $pathFile, LOG_ALERT);
         }
         // Add/Update the collection
         $this->models->collections->$collectionId = $collectionData;
 
         // Add the file
         $this->models->files->$id = array('origin_id'        => $originId,
                                           'active'           => $active,
                                           'client_id'        => $clientId,
                                           'owner_id'         => $ownerId,
                                           'collection_id'    => $collectionId,
                                           'name'             => $name,
                                           'type'             => $type,
                                           'size'             => $size,
                                           'md5sum'           => $md5sum,
                                           'title'            => $title,
                                           'description'      => $description,
                                           'category'         => $category,
                                           'tags'             => $tags,
                                           'version'          => $version,
                                           'ocs_compatible'   => $ocsCompatible,
                                           'content_id'       => $contentId,
                                           'content_page'     => $contentPage,
                                           'downloaded_count' => $downloadedCount);
 
         // Add the media
         if ($id3Tags) {
             $this->_addMedia($id3Tags, $clientId, $ownerId, $collectionId, $id, $name);
         }
 
         return $this->models->files->getFile($id);
     }
 
     private function _getId3Tags($filetype, $filepath)
     {
         // NOTE: getid3 may not work for a files in a network storage.
         $id3Tags = null;
         if (strpos($filetype, 'audio/') !== false || strpos($filetype, 'video/') !== false || strpos($filetype, 'application/ogg') !== false) {
             require_once 'getid3/getid3.php';
             $getID3 = new getID3();
             $id3Tags = $getID3->analyze($filepath);
             getid3_lib::CopyTagsToComments($id3Tags);
         }
 
         return $id3Tags;
     }
 
     private function _addMedia(array $id3Tags, $clientId, $ownerId, $collectionId, $fileId, $defaultTitle)
     {
         // Get artist id or add new one
         $artistName = 'Unknown';
         if (isset($id3Tags['comments']['artist'][0]) && $id3Tags['comments']['artist'][0] != '') {
             $artistName = mb_substr(strip_tags($id3Tags['comments']['artist'][0]), 0, 255);
         }
         $artistId = $this->models->media_artists->getId($clientId, $artistName);
         if (!$artistId) {
             $artistId = $this->models->media_artists->generateId();
             $this->models->media_artists->$artistId = array('client_id' => $clientId,
                                                             'name'      => $artistName,);
         }
 
         // Get album id or add new one
         $albumName = 'Unknown';
         if (isset($id3Tags['comments']['album'][0]) && $id3Tags['comments']['album'][0] != '') {
             $albumName = mb_substr(strip_tags($id3Tags['comments']['album'][0]), 0, 255);
         }
         $albumId = $this->models->media->getAlbumId($clientId, $artistName, $albumName);
         if (!$albumId) {
             $albumId = $this->models->media_albums->generateId();
             $this->models->media_albums->$albumId = array('client_id' => $clientId,
                                                           'name'      => $albumName,);
         }
 
         // Add the media
         $mediaData = array('client_id'        => $clientId,
                            'owner_id'         => $ownerId,
                            'collection_id'    => $collectionId,
                            'file_id'          => $fileId,
                            'artist_id'        => $artistId,
                            'album_id'         => $albumId,
                            'title'            => $defaultTitle,
                            'genre'            => null,
                            'track'            => null,
                            'creationdate'     => null,
                            'bitrate'          => 0,
                            'playtime_seconds' => 0,
                            'playtime_string'  => 0,);
         if (isset($id3Tags['comments']['title'][0]) && $id3Tags['comments']['title'][0] != '') {
             $mediaData['title'] = mb_substr(strip_tags($id3Tags['comments']['title'][0]), 0, 255);
         }
         if (!empty($id3Tags['comments']['genre'][0])) {
             $mediaData['genre'] = mb_substr(strip_tags($id3Tags['comments']['genre'][0]), 0, 64);
         }
         if (!empty($id3Tags['comments']['track_number'][0])) {
             $mediaData['track'] = mb_substr(strip_tags($id3Tags['comments']['track_number'][0]), 0, 5);
         }
         if (!empty($id3Tags['comments']['creationdate'][0])) {
             $mediaData['creationdate'] = mb_substr(strip_tags($id3Tags['comments']['creationdate'][0]), 0, 4);
         }
         if (!empty($id3Tags['bitrate'])) {
             $mediaData['bitrate'] = mb_substr(strip_tags($id3Tags['bitrate']), 0, 11);
         }
         if (!empty($id3Tags['playtime_seconds'])) {
             $mediaData['playtime_seconds'] = mb_substr(strip_tags($id3Tags['playtime_seconds']), 0, 11);
         }
         if (!empty($id3Tags['playtime_string'])) {
             $mediaData['playtime_string'] = mb_substr(strip_tags($id3Tags['playtime_string']), 0, 8);
         }
 
         $mediaId = $this->models->media->generateId();
         $this->models->media->$mediaId = $mediaData;
 
         // Save the album cover
         if (!empty($id3Tags['comments']['picture'][0]['data'])) {
             $image = imagecreatefromstring($id3Tags['comments']['picture'][0]['data']);
             if ($image !== false) {
                 imagejpeg($image, $this->appConfig->general['thumbnailsDir'] . '/album_' . $albumId . '.jpg', 75);
                 imagedestroy($image);
             }
         }
     }
 
     /**
      * @throws Flooer_Exception
      */
     public function putFile() {
         if (!$this->_isAllowedAccess()) {
             $this->response->setStatus(403);
             throw new Flooer_Exception('Forbidden', LOG_NOTICE);
         }
 
         $errors = array();
         if (!empty($_FILES['file']['error'])) { // 0 = UPLOAD_ERR_OK
             $errors['file'] = $_FILES['file']['error'];
         }
         if ($errors) {
             $this->response->setStatus(400);
             $this->_setResponseContent('error', array(
                 'message' => 'File upload error',
                 'errors'  => $errors,
             ));
 
             return;
         }
         $errors = array();
         if (!$this->request->id) {
             $errors['id'] = 'Required';
         }
         if (!$this->request->client_id) {
             $errors['client_id'] = 'Required';
         }
         if ($errors) {
             $this->response->setStatus(400);
             $this->_setResponseContent('error', array(
                 'message' => 'Validation error',
                 'errors'  => $errors,
             ));
 
             return;
         }
 
         $file = $this->processFileUpdate();
 
         $this->_setResponseContent('success', array('file' => $file));
     }
 
     /**
      * @return Flooer_Db_Table_Row|null
      * @throws Flooer_Exception
      */
     protected function processFileUpdate(): ?Flooer_Db_Table_Row
     {
         $id = null;
         $title = null;
         $description = null;
         $category = null;
         $tags = null; // Comma-separated list
         $version = null;
         $ocsCompatible = null;
         $contentId = null;
         $contentPage = null;
 
         if (!empty($this->request->id)) {
             $id = $this->request->id;
         }
         if (!empty($this->request->title)) {
             $title = mb_substr(strip_tags($this->request->title), 0, 200);
         }
         if (isset($this->request->description)) {
             $description = strip_tags($this->request->description);
         }
         if (isset($this->request->category)) {
             $category = mb_substr(strip_tags($this->request->category), 0, 64);
         }
         if (isset($this->request->tags)) {
             $tags = strip_tags($this->request->tags);
         }
         if (isset($this->request->version)) {
             $version = mb_substr(strip_tags($this->request->version), 0, 64);
         }
         if (isset($this->request->ocs_compatible)) {
             if ($this->request->ocs_compatible == 1) {
                 $ocsCompatible = 1;
             } else {
                 if ($this->request->ocs_compatible == 0) {
                     $ocsCompatible = 0;
                 }
             }
         }
         if (isset($this->request->content_id)) {
             $contentId = $this->request->content_id;
         }
         if (!empty($this->request->content_page)) {
             $contentPage = $this->request->content_page;
         }
 
         $file = $this->models->files->$id;
 
         if (!$file) {
             $this->response->setStatus(404);
             throw new Flooer_Exception('Not found', LOG_NOTICE);
         } else {
             if (!$file->active || $file->client_id != $this->request->client_id) {
                 $this->response->setStatus(403);
                 throw new Flooer_Exception('Forbidden', LOG_NOTICE);
             }
         }
 
         // If new file has uploaded,
         // remove old file and replace to the new file with new file id
         if (isset($_FILES['file'])) {
             $id = null;
             $originId = $file->origin_id;
             $active = 1;
             $clientId = $file->client_id;
             $ownerId = $file->owner_id;
             $collectionId = $file->collection_id;
             $name = null; // Auto generated
             $type = null; // Auto detect
             $size = null; // Auto detect
             $md5sum = null; // Auto detect
 
             $downloadedCount = 0; // for hive files importing (Deprecated)
 
             if (!empty($_FILES['file']['name'])) {
                 //$name = mb_substr(strip_tags(basename($_FILES['file']['name'])), 0, 200);
                 $filter = new Filename(['beautify' => true]);
                 $name = $filter->filter(basename($_FILES['file']['name']));
             }
             if (!empty($_FILES['file']['tmp_name'])) {
                 $info = new finfo(FILEINFO_MIME_TYPE);
                 $type = $info->file($_FILES['file']['tmp_name']);
                 $md5sum = md5_file($_FILES['file']['tmp_name']);
                 if (!$type) {
                     $type = 'application/octet-stream';
                 }
             }
             if (!empty($_FILES['file']['size'])) {
                 $size = $_FILES['file']['size'];
             }
 
             if ($description === null) {
                 $description = $file->description;
             }
             if ($category === null) {
                 $category = $file->category;
             }
             if ($tags === null) {
                 $tags = $file->tags;
             }
             if ($version === null) {
                 $version = $file->version;
             }
             if ($ocsCompatible === null) {
                 $ocsCompatible = $file->ocs_compatible;
             }
             if ($contentId === null) {
                 $contentId = $file->content_id;
             }
             if ($contentPage === null) {
                 $contentPage = $file->content_page;
             }
 
             $fileSystemAdapter = new FilesystemAdapter($this->appConfig);
 //            $fileSystemAdapter = new S3Adapter($this->appConfig);
 
             // Remove old file
             $this->_removeFile($file);
 
             // Get ID3 tags in the file. 'getid3' may not work on a network storage
             $id3Tags = $this->_getId3Tags($type, $_FILES['file']['tmp_name']);
 
             // Prepare to append the file to collection
             $collection = $this->models->collections->$collectionId;
             $collectionName = $collection->name;
             $collectionData = array('files' => $collection->files + 1,
                                     'size'  => $collection->size + $size,);
 
             $id = $this->models->files->generateId();
             $collectionPath = $this->appConfig->general['filesDir'] . DIRECTORY_SEPARATOR . $collectionName;
             $name = $fileSystemAdapter->fixFilename($name, $collectionPath);
             if (!$title) {
                 $title = mb_substr(strip_tags($name), 0, 200);
             }
 
             // Save the uploaded file
             if (!$fileSystemAdapter->moveUploadedFile($_FILES['file']['tmp_name'], $collectionPath . DIRECTORY_SEPARATOR . $name)) {
                 $this->response->setStatus(500);
                 throw new Flooer_Exception('Failed to save the file', LOG_ALERT);
             }
 
             // Add the file
             $this->models->files->$id = array('origin_id'        => $originId,
                                               'active'           => $active,
                                               'client_id'        => $clientId,
                                               'owner_id'         => $ownerId,
                                               'collection_id'    => $collectionId,
                                               'name'             => $name,
                                               'type'             => $type,
                                               'size'             => $size,
                                               'md5sum'           => $md5sum,
                                               'title'            => $title,
                                               'description'      => $description,
                                               'category'         => $category,
                                               'tags'             => $tags,
                                               'version'          => $version,
                                               'ocs_compatible'   => $ocsCompatible,
                                               'content_id'       => $contentId,
                                               'content_page'     => $contentPage,
                                               'downloaded_count' => $downloadedCount
                                               // for hive files importing (Deprecated)
             );
 
             // Update the collection
             $this->models->collections->$collectionId = $collectionData;
 
             // Add the media
             if ($id3Tags) {
                 $this->_addMedia($id3Tags, $clientId, $ownerId, $collectionId, $id, $name);
             }
         } // Update only file information
         else {
             $updata = array();
 
             if ($title !== null) {
                 $updata['title'] = $title;
             }
             if ($description !== null) {
                 $updata['description'] = $description;
             }
             if ($category !== null) {
                 $updata['category'] = $category;
             }
             if ($tags !== null) {
                 $updata['tags'] = $tags;
             }
             if ($version !== null) {
                 $updata['version'] = $version;
             }
             if ($ocsCompatible !== null) {
                 $updata['ocs_compatible'] = $ocsCompatible;
             }
             if ($contentId !== null) {
                 $updata['content_id'] = $contentId;
             }
             if ($contentPage !== null) {
                 $updata['content_page'] = $contentPage;
             }
 
             $this->models->files->$id = $updata;
         }
 
         return $this->models->files->getFile($id);
     }
 
     /**
      * @throws Flooer_Exception
      */
     private function _removeFile(Flooer_Db_Table_Row &$file) {
         // Please be care the remove process in Collections::deleteCollection()
 
         $id = $file->id;
 
         $collectionId = $file->collection_id;
         $collection = $this->models->collections->$collectionId;
         $fileSystemAdapter = new FilesystemAdapter($this->appConfig);
 //        $fileSystemAdapter = new S3Adapter($this->appConfig);
 
         $trashDir = $this->appConfig->general['filesDir'] . DIRECTORY_SEPARATOR . $collection->name . '/.trash';
         $this->logWithRequestId(__METHOD__ . ' - test trash dir exists: ' . $trashDir . ' :: ' . (is_dir($trashDir) ? 'true' : 'false'));
         if (!$fileSystemAdapter->testAndCreate($trashDir)) {
             $this->response->setStatus(500);
             throw new Flooer_Exception('Failed to create trash dir ' . $trashDir, LOG_ALERT);
         }
         $from = $this->appConfig->general['filesDir'] . DIRECTORY_SEPARATOR . $collection->name . DIRECTORY_SEPARATOR . $file->name;
         if (is_file($from)) {
             if (!$fileSystemAdapter->moveFile($from, $trashDir . '/' . $id . '-' . $file->name)) {
                 $this->response->setStatus(500);
                 throw new Flooer_Exception('Failed to remove the file ' . $from, LOG_ALERT);
             }
         } else {
             $this->logWithRequestId(__METHOD__ . ' - File could not be found. But we continue and set file inactive in the database. ' . $from,LOG_WARNING);
         }
 
         $this->models->files->$id = array('active' => 0);
         //$this->models->files_downloaded->deleteByFileId($id);
         $this->models->favorites->deleteByFileId($id);
         $this->models->media->deleteByFileId($id);
         $this->models->media_played->deleteByFileId($id);
 
         $this->models->collections->$collectionId = array(
             'files' => $collection->files - 1,
             'size'  => $collection->size - $file->size,
         );
     }
 
     /**
      * @param $name
      * @param $collectionName
      *
      * @return mixed|string
      * @deprecated
      */
     private function _fixFilename($name, $collectionName)
     {
         if (is_file($this->appConfig->general['filesDir'] . '/' . $collectionName . '/' . $name)) {
             $fix = date('YmdHis');
             if (preg_match("/^([^.]+)(\..+)/", $name, $matches)) {
                 $name = $matches[1] . '-' . $fix . $matches[2];
             } else {
                 $name = $name . '-' . $fix;
             }
         }
 
         return $name;
     }
 
     /**
      * @throws Flooer_Exception
      */
     public function deleteFile()
     {
         if (!$this->_isAllowedAccess()) {
             $this->response->setStatus(403);
             throw new Flooer_Exception('Forbidden', LOG_NOTICE);
         }
 
         $id = null;
 
         if (!empty($this->request->id)) {
             $id = $this->request->id;
         }
 
         $file = $this->models->files->$id;
 
         if (!$file) {
             $this->response->setStatus(404);
             throw new Flooer_Exception('Not found', LOG_NOTICE);
         } else {
             if (!$file->active || $file->client_id != $this->request->client_id) {
                 $this->response->setStatus(403);
                 throw new Flooer_Exception('Forbidden', LOG_NOTICE);
             }
         }
 
         $this->_removeFile($file);
 
         $this->_setResponseContent('success');
     }
 
     /**
      * @throws Flooer_Exception
      * @deprecated
      */
     public function headDownloadfile() // Deprecated
     {
         // This is alias for HEAD /files/download
         $this->headDownload();
     }
 
     /**
      * @throws Flooer_Exception
      */
     public function headDownload()
     {
         $this->getDownload(true);
     }
 
     /**
      * @throws Flooer_Exception
      */
     public function getDownload($headeronly = false)
     {
         $id = null;
         $as = null;
         $userId = null;
         $hashGiven = null;
         $validUntil = null;
         $isFromOcsApi = false;
         $isFilepreview = false;
 
         $linkType = null;
 
         $fp = null;
         $ip = null;
         $payload = null;
         $payloadHash = null;
 
         if (!empty($this->request->j)) {
             require_once '../../library/JWT.php';
             $payload = JWT::decode($this->request->j, $this->appConfig->general['jwt_secret'], true);
             $payloadHash = sha1($this->request->j);
             $id = isset($payload->id) ? $payload->id : null;
             $hashGiven = isset($payload->s) ? $payload->s : null;
             $validUntil = isset($payload->t) ? $payload->t : null;
             $userId = isset($payload->u) ? $payload->u : null;
             $linkType = isset($payload->lt) ? $payload->lt : null;
             $isFilepreview = ($linkType === 'filepreview') ? true : false;
             $fp = isset($payload->stfp) ? $payload->stfp : null;
             $ip = isset($payload->stip) ? $payload->stip : null; //TODO: set ip from request if null
             $as = isset($payload->as) ? $payload->as : null;
             $isFromOcsApi = (isset($payload->o) and ($payload->o == 1));
         }
         if (!empty($this->request->id)) {
             $id = $this->request->id;
         }
         if (!empty($this->request->as)) {
             $as = $this->request->as;
         }
         if (!empty($this->request->u)) {
             $userId = $this->request->u;
         }
         if (!empty($this->request->s)) {
             $hashGiven = $this->request->s;
         }
         if (!empty($this->request->t)) {
             $validUntil = $this->request->t;
         }
         if (!empty($this->request->o)) {
             $isFromOcsApi = ($this->request->o == 1);
         }
         if (!empty($this->request->lt)) {
             $linkType = $this->request->lt;
             if ($linkType === 'filepreview') {
                 $isFilepreview = true;
             }
         }
 
         // if $as = origin || latest then overwrite the file id
         if ($id && $as) {
             $id = $this->models->files->getFileId($id, $as);
         }
 
         $file = $this->models->files->$id;
         if (!$file) {
             $this->response->setStatus(404);
             throw new Flooer_Exception('Not found', LOG_NOTICE);
         }
 
         $collectionId = $file->collection_id;
 
         $salt = $this->_getDownloadSecret($file->client_id);
         $hash = hash('sha512', $salt . $collectionId . $validUntil);
         $expires = $validUntil - time();
 
         $agent = null;
         if (isset($_SERVER)) {
             $agent = $_SERVER['HTTP_USER_AGENT'] ?? 'unidentified';
         }
 
         // Log
         $this->logWithRequestId("Prepare Download (collection: $file->collection_id; file: $file->id; agent: $agent; remote ip: {$this->getIpAddress()};  request uri: {$_SERVER['REQUEST_URI']})", LOG_NOTICE);
 
         //Save all(!) download requests, but not for preview downloads
         //remark: I really don't understand why we keep all this shit (20210125 alex)
         $ref = null;
         if (false == $isFilepreview) {
             $data = array('client_id'     => $file->client_id,
                           'owner_id'      => $file->owner_id,
                           'collection_id' => $file->collection_id,
                           'file_id'       => $file->id,
                           'user_id'       => $userId,
                           'link_type'     => $linkType,
                           'source'        => 'OCS-Webserver',
                           'referer'       => $ref,
                           'user_agent'    => $agent,);
             // if request comes from api then overwrite some details
             if ($isFromOcsApi) {
                 $ref = 'OCS-API';
                 $data['referer'] = $ref;
                 $data['source'] = $ref;
             }
 
             try {
                 //$downloadedId = $this->models->files_downloaded_all->generateId();
                 $downloadedId = $this->models->files_downloaded_all->generateNewId();
                 $this->models->files_downloaded_all->$downloadedId = $data;
             } catch (Exception $exc) {
                 //echo $exc->getTraceAsString();
                 $this->logWithRequestId("ERROR saving Download Data to DB: {$exc->getMessage()} :: {$exc->getTraceAsString()}", LOG_ERR);
             }
         }
 
         // check preconditions
         if (0 >= $expires) {
             // Log
             $this->logWithRequestId("Download expired (file: $file->id; time-div: $expires;  )", LOG_NOTICE);
             $this->response->setStatus(410);
             $this->_setResponseContent('error', array('message' => 'link expired'));
 
             return;
         }
         if ($hashGiven != $hash) {
             // Log
             $this->logWithRequestId("Download hash invalid (file: $file->id; hash: $hash; hashGiven: $hashGiven; )", LOG_NOTICE);
             $this->response->setStatus(400);
             $this->_setResponseContent('error', array('message' => 'link invalid'));
 
             return;
         }
         if ($this->tooManyRequests($payloadHash, self::BLOCKING_PERIOD)) {
             $this->logWithRequestId("Too many requests (file: $file->id; payload hash: $payloadHash;  )", LOG_NOTICE);
             $this->response->setStatus(429);
             $this->_setResponseContent('error', array('message' => 'too many requests'));
 
             return;
         }
         $uniqueDownload = $this->uniqueDownload($payloadHash, $expires);
         if (!$uniqueDownload) {
             $this->logWithRequestId("Too many downloads for one token (file: $file->id; time-div: $expires;  paypload hash: $payloadHash;  )", LOG_NOTICE);
         }
 
 
         // incoming Link is ok, go on and check collection and file
         $collection = $this->models->collections->$collectionId;
         if (!$collection) {
             $this->logWithRequestId("Collection not found (collection id: $collectionId; file: $file->id;  )", LOG_NOTICE);
             $this->response->setStatus(404);
             throw new Flooer_Exception('Not found', LOG_NOTICE);
         }
 
         // important note: When a collection is inactive, it means it is archived.
         if ($collection->active) {
             $collectionDir = $this->appConfig->general['filesDir'] . '/' . $collection->name;
 //            $sendFileCollection = $collection->name;
         } else {
             $collectionDir = $this->appConfig->general['filesDir'] . '/.trash/' . $collection->id . '-' . $collection->name;
             $this->logWithRequestId("Collection inactive take it from trash (collection: $collection->id; file: $file->id; )", LOG_NOTICE);
 //            $sendFileCollection = '.trash/' . $collection->id . '-' . $collection->name;
         }
 
         // important note: When a file is inactive, it means it is archived.
         if ($file->active) {
             $filePath = $collectionDir . '/' . $file->name;
 //            $sendFilePath = 'data/files/' . $sendFileCollection . '/' . $file->name;
         } else {
             $filePath = $collectionDir . '/.trash/' . $file->id . '-' . $file->name;
             $this->logWithRequestId("File inactive take it from trash (file: $file->id; )", LOG_NOTICE);
 //            $sendFilePath = 'data/files/' . $sendFileCollection . '/.trash/' . $file->id . '-' . $file->name;
         }
 
         $fileName = $file->name;
         $fileType = $file->type;
         $fileSize = $file->size;
 
         // If request URI ended with .zsync, make a response data as zsync data
         if (strtolower(substr($this->request->getUri(), -6)) == '.zsync') {
             // But don't make zsync for external URI
             if (!empty($this->_detectLinkInTags($file->tags))) {
                 $this->response->setStatus(404);
                 throw new Flooer_Exception('Not found. (request id: '.$this->getRequestId().')', LOG_NOTICE);
             }
 
             $zsyncPath = $this->appConfig->general['zsyncDir'] . '/' . $file->id . '.zsync';
             if (!is_file($zsyncPath)) {
                 $this->_generateZsync($filePath, $zsyncPath, $fileName);
             }
 
             $filePath = $zsyncPath;
             $fileName .= '.zsync';
             $fileType = 'application/x-zsync';
             $fileSize = filesize($zsyncPath);
 
             $this->_sendFile($filePath, $fileName, $fileType, $fileSize, true, $headeronly);
         }
 
         if (!$isFilepreview && !$headeronly) {
             $this->models->files->updateDownloadedStatus($file->id);
 
             try {
                 //$downloadedId = $this->models->files_downloaded->generateId();
                 $downloadedId = $this->models->files_downloaded->generateNewId();
                 $this->models->files_downloaded->$downloadedId = array('client_id'     => $file->client_id,
                                                                        'owner_id'      => $file->owner_id,
                                                                        'collection_id' => $file->collection_id,
                                                                        'file_id'       => $file->id,
                                                                        'user_id'       => $userId,
                                                                        'referer'       => $ref,);
 
                 //save unique dataset
                 if ($uniqueDownload) {
                     $downloadedId = $this->models->files_downloaded_unique->generateNewId();
                     $this->models->files_downloaded_unique->$downloadedId = array('client_id'     => $file->client_id,
                                                                                   'owner_id'      => $file->owner_id,
                                                                                   'collection_id' => $file->collection_id,
                                                                                   'file_id'       => $file->id,
                                                                                   'user_id'       => $userId,
                                                                                   'referer'       => $ref,);
                 }
 
                 // save download in impression table
 //                $this->modelOcs->ocs_downloads->save(array('file_id' => $file->id,
 //                                                           'ip'      => $ip,
 //                                                           'fp'      => $fp,
 //                                                           'u'       => $userId,));
             } catch (Exception $exc) {
                 //echo $exc->getTraceAsString();
                 $this->logWithRequestId("ERROR saving Download Data to DB: $exc->getMessage()", LOG_ERR);
                 $this->response->setStatus(500);
                 $this->_setResponseContent('error', array('message' => 'internal error' . " (id: {$this->getRequestId()})"));
 
                 return;
             }
         }
 
         // If external URI has set, redirect to it
         $externalUri = $this->_detectLinkInTags($file->tags);
         if (!empty($externalUri)) {
             $this->response->redirect($externalUri);
         }
 
 //        if (getenv('MOD_X_ACCEL_REDIRECT_ENABLED') === 'on') {
 //            $this->_xSendFile($sendFilePath, $filePath, $fileName, $fileType, $fileSize, true, $headeronly);
 //        }
 
 //        if (getenv('X_OCS_ACCEL_REDIRECT_ENABLED') === 'on') {
 //            $this->_xSendFile($sendFilePath, $filePath, $fileName, $fileType, $fileSize, true, $headeronly);
 //        }
 
         if (getenv('X_OCS_S3_DOWNLOAD_ENABLED') === 'on') {
             $this->logWithRequestId(__METHOD__ . ' - check storage for file: ' . $filePath . ' :: ' . (is_file($filePath) ? 'true' : 'false'));
             if (is_file($filePath)) {
                 $sendFilePath = preg_replace("|^{$this->appConfig->general['basePath']}|", '', $filePath);
                 $this->_s3SendFile($sendFilePath, $filePath, $fileName, $fileType, $fileSize, true, $headeronly, $this->appConfig->s3storage);
             } else
             // checks if the alternate storage contains the file. If it does, we continue with that file path.
             if ($this->appConfig->s3storage2) {
                 $alternativeCollectionDir = rtrim($this->appConfig->s3storage2['basePath'],'/') . '/' . preg_replace("|^{$this->appConfig->general['basePath']}|", '', $this->appConfig->general['filesDir']) . '/' . $collection->name;
                 $alternativeFilePath = $alternativeCollectionDir . DIRECTORY_SEPARATOR . $file->name;
                 $sendFilePath = preg_replace("|^{$this->appConfig->s3storage2['basePath']}|", '', $alternativeFilePath);
                 $this->logWithRequestId(__METHOD__ . ' - check alternative storage for file: ' . $alternativeFilePath . ' :: ' . (is_file($alternativeFilePath) ? 'true' : 'false'));
                 if (is_file($alternativeFilePath)) {
                     $this->_s3SendFile($sendFilePath, $alternativeFilePath, $fileName, $fileType, $fileSize, true, $headeronly, $this->appConfig->s3storage2);
                 }
             }
             $this->logWithRequestId(__METHOD__ . ' - file not found. ' . $filePath, LOG_ERR);
             $this->response->setStatus(500);
             $this->_setResponseContent('error', array('message' => 'file not found' . " (id: {$this->getRequestId()})"));
 
             return;
         }
 
         $this->_sendFile($filePath, $fileName, $fileType, $fileSize, true, $headeronly);
     }
 
     /**
      * @param string $payloadHash
      * @param int    $expires
      *
      * @return bool
      */
     private function tooManyRequests(string $payloadHash, int $expires): bool {
         $ttl = intval($this->appConfig->redis['ttl']);
         if (0 < $expires) {
             $ttl = $expires;
         }
         $request = array(
             'count'     => 1,
             'last_seen' => time(),
         );
         if ($this->redisCache) {
             if ($this->redisCache->has($payloadHash)) {
                 $request = $this->redisCache->get($payloadHash);
                 if ($request['count'] > self::MAX_REQUEST_PER_MINUTE) {
                     return true;
                 }
                 // Count (only) new requests made in last minute
                 if ($request["last_seen"] >= time() - self::MIN_TIME) {
                     $request['count'] += 1;
                 } else {
                     // restart timer
                     $request['last_seen'] = time();
                     $request['count'] = 1;
                 }
             }
             $this->redisCache->set($payloadHash, $request, $ttl);
         }
 
         return false;
     }
 
     /**
      * @param string $ip
      * @param int    $expires
      *
      * @return bool
      */
     private function tooManyRequestsFromIP(string $ip, int $expires): bool {
         $ttl = intval($this->appConfig->redis['ttl']);
         if (0 < $expires) {
             $ttl = $expires;
         }
         $request = array(
             'count'     => 1,
             'last_seen' => time(),
         );
         if ($this->redisCache) {
             if ($this->redisCache->has($ip)) {
                 $request = $this->redisCache->get($ip);
                 if ($request['count'] > self::MAX_REQUEST_PER_MINUTE) {
                     return true;
                 }
                 // Count (only) new requests made in last minute
                 if ($request["last_seen"] >= time() - self::MIN_TIME) {
                     $request['count'] += 1;
                 } else {
                     // restart timer
                     $request['last_seen'] = time();
                     $request['count'] = 1;
                 }
             }
             $this->redisCache->set($ip, $request, $ttl);
         }
 
         return false;
     }
 
     /**
      * @param string $payloadHash
      * @param int    $expires
      *
      * @return bool
      */
     private function uniqueDownload(string $payloadHash, int $expires): bool
     {
         $ttl = (0 < $expires) ? intval($expires) : intval($this->appConfig->redis['ttl']);
         $keyName = __FUNCTION__ . ':' . $payloadHash;
         $count = 1;
 
         if ($this->redisCache) {
             if ($this->redisCache->has($keyName)) {
 
                 return false;
             }
             $this->redisCache->set($keyName, $count, $ttl);
         }
 
         return true;
     }
 
     /**
      * @param string $sendFilePath
      * @param string $filePath
      * @param string $fileName
      * @param string $fileType
      * @param string $fileSize
      * @param bool   $attachment
      * @param bool   $headeronly
      */
     private function _xSendFile(string $sendFilePath,
                                 string $filePath,
                                 string $fileName,
                                 string $fileType,
                                 string $fileSize,
                                 bool   $attachment = false,
                                 bool   $headeronly = false)
     {
         if (($headeronly) or (false == $this->appConfig->xsendfile['enabled'])) {
             $this->_sendFile($filePath, $fileName, $fileType, $fileSize, true, $headeronly);
         }
 
         $disposition = 'inline';
         if ($attachment) {
             $disposition = 'attachment';
         }
 
         $this->response->setHeader('Content-Type', $fileType);
         $this->response->setHeader('Content-Length', $fileSize);
         $this->response->setHeader('Content-Disposition', $disposition . '; filename="' . $fileName . '"');
         $path = $this->appConfig->xsendfile['pathPrefix'] . $sendFilePath;
         if (boolval($this->appConfig->awss3['enabled'])) {
             $signedUrl = $this->generateSignedDownloadUrl($sendFilePath, $this->appConfig->awss3);
             $path = $this->appConfig->awss3['pathPrefix'] . $signedUrl;
         }
         $this->logWithRequestId("Response (mod_accel_redirect: $path)", LOG_NOTICE);
 
         $this->response->setHeader($this->appConfig->xsendfile['headerName'], $path);
         $this->response->send();
 
         if (php_sapi_name() == 'fpm-fcgi') {
             fastcgi_finish_request();
         }
 
         exit();
     }
 
     /**
      * @param string      $sendFilePath
      * @param array|null $s3Config
      * @param bool        $withoutHttpScheme
      *
      * @return string
      */
     private function generateSignedDownloadUrl(string $sendFilePath, array $s3Config = null,
                                                bool   $withoutHttpScheme = true): string {
         if (false == $s3Config['enabled']) {
             return $sendFilePath;
         }
 
         // Instantiate an S3 client.
         if (empty($s3Config['endpoint'])) {
             $s3Client = new S3Client([
                                          'credentials' => new Credentials($s3Config['key'], $s3Config['secret']),
                                          'version'     => 'latest',
                                          'region'      => $s3Config['region'],
                                      ]);
         } else {
             $s3Client = new S3Client([
                                          'credentials' => new Credentials($s3Config['key'], $s3Config['secret']),
                                          'version'     => 'latest',
                                          'region'      => $s3Config['region'],
                                          'endpoint'    => $s3Config['endpoint'],
                                      ]);
         }
 
         // Creating a pre-signed URL and request
         $cmd = $s3Client->getCommand('GetObject', [
             'Bucket'                     => $s3Config['bucket'],
             'Key'                        => $sendFilePath,
             'ResponseContentDisposition' => 'attachment;%20' . basename($sendFilePath),
         ]);
         $request = $s3Client->createPresignedRequest($cmd, $s3Config['signedUrlExpires']);
 
         $uri = (string)$request->getUri();
 
         if (!empty($s3Config['cdn']) && !empty($s3Config['endpoint'])) {
             $host = preg_replace("(^https?://)", "", $s3Config['cdn']);
             $uri = (string)$request->getUri()->withHost($host);
         }
 
         if ($withoutHttpScheme) {
             return preg_replace("(^https?://)", "", $uri);
         }
 
         return $uri;
     }
 
     private function _s3SendFile(string $sendFilePath, string $filePath, string $fileName, string $fileType, bool   $fileSize, bool $attachment, $headeronly, array $appconfig) {
         if (($headeronly) or !$appconfig['enabled']) {
             $this->_sendFile($filePath, $fileName, $fileType, $fileSize, true, $headeronly);
         }
         $signedUrl = $this->generateSignedDownloadUrl($sendFilePath, $appconfig, false);
         $this->logWithRequestId("Response (redirect: $signedUrl)", LOG_NOTICE);
 
         $this->response->setHeader('Location', $signedUrl);
         $this->response->setStatus(302);
         $this->response->send();
 
         if (php_sapi_name() == 'fpm-fcgi') {
             fastcgi_finish_request();
         }
 
         exit();
     }
 
     /**
      * @param bool $headeronly
      *
      * @throws Flooer_Exception
      * @deprecated
      */
     public function getDownloadfile(bool $headeronly = false) // Deprecated
     {
         // This is alias for GET /files/download
         $this->getDownload($headeronly);
     }
 
     public function optionsFile()
     {
         $response = $this->response;
         $response->setStatus(200);
         $this->response->send();
         if (php_sapi_name() == 'fpm-fcgi') {
             fastcgi_finish_request();
         }
         exit();
     }
 
     /**
      * @throws Flooer_Exception
      */
     public function postUpload()
     {
         if (!$this->isValidSignedUrl()) {
             $this->response->setStatus(403);
             throw new Flooer_Exception("Forbidden", LOG_NOTICE);
         }
 
         $errors = array();
         if (!$this->request->client_id) {
             $errors['client_id'] = 'Required';
         }
         if (!$this->request->owner_id) {
             $errors['owner_id'] = 'Required';
         }
         /*
         if (!isset($_FILES['file'])) {
             $errors['file'] = 'Required';
         }
         else if (!empty($_FILES['file']['error'])) { // 0 = UPLOAD_ERR_OK
             $errors['file'] = $_FILES['file']['error'];
         }
         */
         // for hive files importing (Deprecated) ----------
         if (!isset($_FILES['file']) && !isset($this->request->local_file_path)) {
             $errors['file'] = 'Required';
         }
         if (isset($_FILES['file']) && !empty($_FILES['file']['error'])) { // 0 = UPLOAD_ERR_OK
             $errors['file'] = $_FILES['file']['error'];
         }
         // ------------------------------------------------
 
         if ($errors) {
             $this->response->setStatus(400);
             $this->_setResponseContent('error', array('message' => 'Validation error',
                                                       'errors'  => $errors,));
 
             return;
         }
 
         $file = $this->processFileUpload();
 
         $this->_setResponseContent('success', array('file' => $file));
     }
 
     /**
      * @return bool
      */
     private function isValidSignedUrl(): bool
     {
         $result = false;
         if (!empty($this->request->client_id)) {
             $clients = parse_ini_file('configs/clients.ini', true);
             $url = $this->getScheme() . '://' . $this->getHost() . $this->request->getUri();
             $this->logWithRequestId(__METHOD__ . ' - ' . print_r($_SERVER, true), LOG_NOTICE);
             if (isset($clients[$this->request->client_id]) && (UrlSigner::verifySignedUrl($url, $clients[$this->request->client_id]['secret']))) {
                 $result = true;
             }
         }
         $this->logWithRequestId(__METHOD__ . ' - verify signature for $url: ' . ($url ? $url : '(url is empty caused by missing client_id)') . ' :: ' . ($result?'true':'false'), LOG_NOTICE);
 
         return $result;
     }
 
     public function optionsUpload()
     {
         $response = $this->response;
         $response->setStatus(200);
         $this->response->send();
         if (php_sapi_name() == 'fpm-fcgi') {
             fastcgi_finish_request();
         }
         exit();
     }
 
     /**
      * @throws Flooer_Exception
      */
     public function putUpload()
     {
         if (!$this->isValidSignedUrl()) {
             $this->response->setStatus(403);
             throw new Flooer_Exception("Forbidden", LOG_NOTICE);
         }
 
 
         $errors = array();
         if (!empty($_FILES['file']['error'])) { // 0 = UPLOAD_ERR_OK
             $errors['file'] = $_FILES['file']['error'];
         }
         if ($errors) {
             $this->response->setStatus(400);
             $this->_setResponseContent('error', array('message' => 'File upload error',
                                                       'errors'  => $errors,));
 
             return;
         }
         $errors = array();
         if (!$this->request->id) {
             $errors['id'] = 'Required';
         }
         if (!$this->request->client_id) {
             $errors['client_id'] = 'Required';
         }
         if ($errors) {
             $this->response->setStatus(400);
             $this->_setResponseContent('error', array('message' => 'Validation error',
                                                       'errors'  => $errors,));
 
             return;
         }
 
         $file = $this->processFileUpdate();
 
         $this->_setResponseContent('success', array('file' => $file));
     }
 }