setAllowedCategories($allowed); } /** * Determine if a valid non-empty image exists behind this asset, which is a format * compatible with image manipulations * * @return boolean */ public function getIsImage() { // Check file type $mime = $this->getMimeType(); return $mime && in_array($mime, $this->config()->supported_images); } /** * @return AssetStore */ protected function getStore() { return Injector::inst()->get('AssetStore'); } private static $composite_db = array( "Hash" => "Varchar(255)", // SHA of the base content "Filename" => "Varchar(255)", // Path identifier of the base content "Variant" => "Varchar(255)", // Identifier of the variant to the base, if given ); private static $casting = array( 'URL' => 'Varchar', 'AbsoluteURL' => 'Varchar', 'Basename' => 'Varchar', 'Title' => 'Varchar', 'MimeType' => 'Varchar', 'String' => 'Text', 'Tag' => 'HTMLText', 'Size' => 'Varchar' ); public function scaffoldFormField($title = null, $params = null) { return AssetField::create($this->getName(), $title); } /** * Return a html5 tag of the appropriate for this file (normally img or a) * * @return string */ public function forTemplate() { return $this->getTag() ?: ''; } /** * Return a html5 tag of the appropriate for this file (normally img or a) * * @return string */ public function getTag() { $template = $this->getFrontendTemplate(); if(empty($template)) { return ''; } return (string)$this->renderWith($template); } /** * Determine the template to render as on the frontend * * @return string Name of template */ public function getFrontendTemplate() { // Check that path is available $url = $this->getURL(); if(empty($url)) { return null; } // Image template for supported images if($this->getIsImage()) { return 'DBFile_image'; } // Default download return 'DBFile_download'; } /** * Get trailing part of filename * * @return string */ public function getBasename() { if($this->exists()) { return basename($this->getSourceURL()); } } /** * Get file extension * * @return string */ public function getExtension() { if($this->exists()) { return pathinfo($this->Filename, PATHINFO_EXTENSION); } } /** * Alt title for this * * @return string */ public function getTitle() { // If customised, use the customised title if($this->failover && ($title = $this->failover->Title)) { return $title; } // fallback to using base name return $this->getBasename(); } public function setFromLocalFile($path, $filename = null, $hash = null, $variant = null, $conflictResolution = null) { $this->assertFilenameValid($filename ?: $path); $result = $this ->getStore() ->setFromLocalFile($path, $filename, $hash, $variant, $conflictResolution); // Update from result if($result) { $this->setValue($result); } return $result; } public function setFromStream($stream, $filename, $hash = null, $variant = null, $conflictResolution = null) { $this->assertFilenameValid($filename); $result = $this ->getStore() ->setFromStream($stream, $filename, $hash, $variant, $conflictResolution); // Update from result if($result) { $this->setValue($result); } return $result; } public function setFromString($data, $filename, $hash = null, $variant = null, $conflictResolution = null) { $this->assertFilenameValid($filename); $result = $this ->getStore() ->setFromString($data, $filename, $hash, $variant, $conflictResolution); // Update from result if($result) { $this->setValue($result); } return $result; } public function getStream() { if(!$this->exists()) { return null; } return $this ->getStore() ->getAsStream($this->Filename, $this->Hash, $this->Variant); } public function getString() { if(!$this->exists()) { return null; } return $this ->getStore() ->getAsString($this->Filename, $this->Hash, $this->Variant); } public function getURL() { if(!$this->exists()) { return null; } $url = $this->getSourceURL(); $this->updateURL($url); $this->extend('updateURL', $url); return $url; } /** * Get URL, but without resampling. * Note that this will return the url even if the file does not exist. * * @return string */ public function getSourceURL() { return $this ->getStore() ->getAsURL($this->Filename, $this->Hash, $this->Variant); } /** * Get the absolute URL to this resource * * @return type */ public function getAbsoluteURL() { if(!$this->exists()) { return null; } return Director::absoluteURL($this->getURL()); } public function getMetaData() { if(!$this->exists()) { return null; } return $this ->getStore() ->getMetadata($this->Filename, $this->Hash, $this->Variant); } public function getMimeType() { if(!$this->exists()) { return null; } return $this ->getStore() ->getMimeType($this->Filename, $this->Hash, $this->Variant); } public function getValue() { if($this->exists()) { return array( 'Filename' => $this->Filename, 'Hash' => $this->Hash, 'Variant' => $this->Variant ); } } public function exists() { if(empty($this->Filename)) { return false; } return $this ->getStore() ->exists($this->Filename, $this->Hash, $this->Variant); } public static function get_shortcodes() { return 'dbfile_link'; } public static function handle_shortcode($arguments, $content, $parser, $shortcode, $extra = array()) { // @todo } public function getFilename() { return $this->getField('Filename'); } public function getHash() { return $this->getField('Hash'); } public function getVariant() { return $this->getField('Variant'); } /** * Return file size in bytes. * * @return int */ public function getAbsoluteSize() { $metadata = $this->getMetaData(); if(isset($metadata['size'])) { return $metadata['size']; } } /** * Customise this object with an "original" record for getting other customised fields * * @param AssetContainer $original * @return $this */ public function setOriginal($original) { $this->failover = $original; return $this; } /** * Get list of allowed file categories * * @return array */ public function getAllowedCategories() { return $this->allowedCategories; } /** * Assign allowed categories * * @param array|string $categories * @return $this */ public function setAllowedCategories($categories) { if(is_string($categories)) { $categories = preg_split('/\s*,\s*/', $categories); } $this->allowedCategories = (array)$categories; return $this; } /** * Gets the list of extensions (if limited) for this field. Empty list * means there is no restriction on allowed types. * * @return array */ protected function getAllowedExtensions() { $categories = $this->getAllowedCategories(); return File::get_category_extensions($categories); } /** * Validate that this DBFile accepts this filename as valid * * @param string $filename * @throws ValidationException * @return bool */ protected function isValidFilename($filename) { $extension = strtolower(File::get_file_extension($filename)); // Validate true if within the list of allowed extensions $allowed = $this->getAllowedExtensions(); if($allowed) { return in_array($extension, $allowed); } // If no extensions are configured, fallback to global list $globalList = File::config()->allowed_extensions; if(in_array($extension, $globalList)) { return true; } // Only admins can bypass global rules return !File::config()->apply_restrictions_to_admin && Permission::check('ADMIN'); } /** * Check filename, and raise a ValidationException if invalid * * @param string $filename * @throws ValidationException */ protected function assertFilenameValid($filename) { $result = new ValidationResult(); $this->validate($result, $filename); if(!$result->valid()) { throw new ValidationException($result); } } /** * Hook to validate this record against a validation result * * @param ValidationResult $result * @param string $filename Optional filename to validate. If omitted, the current value is validated. * @return bool Valid flag */ public function validate(ValidationResult $result, $filename = null) { if(empty($filename)) { $filename = $this->getFilename(); } if(empty($filename) || $this->isValidFilename($filename)) { return true; } // Check allowed extensions $extensions = $this->getAllowedExtensions(); if(empty($extensions)) { $extensions = File::config()->allowed_extensions; } sort($extensions); $message = _t( 'File.INVALIDEXTENSION', 'Extension is not allowed (valid: {extensions})', 'Argument 1: Comma-separated list of valid extensions', array('extensions' => wordwrap(implode(', ',$extensions))) ); $result->error($message); return false; } public function setField($field, $value, $markChanged = true) { // Catch filename validation on direct assignment if($field === 'Filename' && $value) { $this->assertFilenameValid($value); } return parent::setField($field, $value, $markChanged); } /** * Returns the size of the file type in an appropriate format. * * @return string|false String value, or false if doesn't exist */ public function getSize() { $size = $this->getAbsoluteSize(); if($size) { return \File::format_size($size); } return false; } }