diff options
| author | Jan-Hendrik Willms <tleilax+github@gmail.com> | 2021-07-22 16:07:19 +0200 |
|---|---|---|
| committer | Jan-Hendrik Willms <tleilax+github@gmail.com> | 2021-07-22 16:19:12 +0200 |
| commit | a3da1483a9e689846179159355badfec8073dbec (patch) | |
| tree | 770dcca6bdf5f6f2a11b0e7fcbbeda6919a3fc52 /lib/models/File.php | |
current code from svn, revision 62608
Diffstat (limited to 'lib/models/File.php')
| -rw-r--r-- | lib/models/File.php | 137 |
1 files changed, 137 insertions, 0 deletions
diff --git a/lib/models/File.php b/lib/models/File.php new file mode 100644 index 0000000..7af6d9e --- /dev/null +++ b/lib/models/File.php @@ -0,0 +1,137 @@ +<?php +/** + * File.php + * model class for table files + * + * This program is free software; you can redistribute it and/or + * modify it under the terms of the GNU General Public License as + * published by the Free Software Foundation; either version 2 of + * the License, or (at your option) any later version. + * + * @author André Noack <noack@data-quest.de> + * @copyright 2016 Stud.IP Core-Group + * @license http://www.gnu.org/licenses/gpl-2.0.html GPL version 2 + * @category Stud.IP + * + * + * @property string id database column + * @property string user_id database column + * @property string mime_type database column + * @property string name database column + * @property string size database column + * @property string filetype database column + * @property string metadata database column + * @property string author_name database column + * @property string mkdate database column + * @property string chdate database column + * @property SimpleORMap owner belongs_to User + * @property SimpleORMap url has_one FileURL + * @property SimpleORMapCollection refs has_many FileReference + */ +class File extends SimpleORMap +{ + /** + * @param array $config + */ + protected static function configure($config = []) + { + $config['db_table'] = 'files'; + $config['belongs_to']['owner'] = [ + 'class_name' => 'User', + 'foreign_key' => 'user_id', + ]; + $config['has_many']['refs'] = [ + 'class_name' => 'FileRef', + 'assoc_foreign_key' => 'file_id', + ]; + + $config['additional_fields']['extension'] = true; + $config['additional_fields']['path'] = true; + + $config['serialized_fields']['metadata'] = 'JSONArrayObject'; + + $config['registered_callbacks']['after_delete'][] = 'deleteDataFile'; + $config['registered_callbacks']['before_create'][] = 'cbSetAuthor'; + + parent::configure($config); + } + + /** + * Returns the file extension of a file. + * + * @return string A string with the file extension. + */ + public function getExtension() + { + return pathinfo($this->name, PATHINFO_EXTENSION); + } + + /** + * Returns the path to the file in the operating system's file system. + * + * @return null|string Returns the operating system's file system path of the file or null on failure. + */ + public function getPath() + { + if (!$this->id || !in_array($this->filetype, ['StandardFile', 'LibraryFile', 'LibraryRequestFile'])) { + return null; + } + return $GLOBALS['UPLOAD_PATH'] . '/' . substr($this->id, 0, 2) . '/' . $this->id; + } + + /** + * Deletes the data file associated with the File object. + * + * @return bool Returns true on success and false on failure. + */ + public function deleteDataFile() + { + return @unlink($this->getPath()); + } + + /** + * Connects the File object to a physical file that is stored in the operating system's file system. + * + * @param string $path_to_file The path to the physical file. + * @return bool Returns true on success and false on failure. + */ + public function connectWithDataFile($path_to_file) + { + $newpath = $this->getPath(); + + if (!is_dir(pathinfo($newpath, PATHINFO_DIRNAME))) { + @mkdir(pathinfo($newpath, PATHINFO_DIRNAME)); + } + if (is_uploaded_file($path_to_file)) { + if (!@move_uploaded_file($path_to_file, $newpath)) { + return false; + } + } else if (!@copy($path_to_file, $newpath)) { + return false; + } + $this->size = filesize($newpath); + return true; + + } + + /** + * This callback is called before creating a File object. + * It assures that the author is set to a valid user + * by setting the user_id and author_name field. + * In case no user_id is set the ID of the current user is used. + * In case the author_name field is not set either the name of the user, + * referenced by user_id is set or the name of the current user is set. + */ + public function cbSetAuthor() + { + if (!$this->user_id) { + $this->user_id = User::findCurrent()->id; + } + if (!$this->author_name) { + $user = $this->user_id === User::findCurrent()->id + ? User::findCurrent() + : $this->owner; + $this->author_name = $user ? $user->getFullName('no_title') : ""; + } + } +} |
