• Home
• elFinder
• elFinderVolumeDriver

PHP Class elFinder\elFinderVolumeDriver

Show file Open project: gotcms/gotcms

Protected Properties

Property	Type	Description
$URL	string	Base URL
$access	mixed	Access control function/class
$archivers	array	Archivers config
$attributes	mixed	Access control function/class
$cache	array	Cache storage
$cryptLib	string	Library to crypt files name
$defaults	array	Defaults permissions
$diabled	array	List of disabled client's commands
$dirsCache	array	Cache by folders
$driverId	string	Driver id Must be started from letter and contains [a-z0-9] Used as part of volume id
$error	array	Errors from last failed action
$finfo	object	Finfo object for mimeDetect == 'finfo'
$id	string	Volume id - used as prefix for files hashes
$imgLib	string	Image manipulation lib name auto|imagick|mogtify|gd
$mimeDetect	string	Mimetype detect method
$mimetypes	array	default extensions/mimetypes for mimeDetect == 'internal'
$mounted	boolean	Flag - volume "mounted" and available
$onlyMimes	array	Mimetypes allowed to display
$options	array	Object configuration
$removed	array	Store files moved or overwrited files info
$root	string	Root directory path
$rootName	string	Root basename | alias
$separator	string	Directory separator - required by client
$startPath	string	Default directory to open
$tmbPath	string	Thumbnails dir path
$tmbPathWritable	boolean	Is thumbnails dir writable
$tmbSize	integer	Thumbnails size in px
$tmbURL	string	Thumbnails base URL
$today	integer	Today 24:00 timestamp
$treeDeep	integer	How many subdirs levels return for tree
$uploadAllow	array	Mime types allowed to upload
$uploadDeny	array	Mime types denied to upload
$uploadMaxSize	integer | string	Set as number or string with unit - "10M", "500K", "1G"
$uploadOrder	array	Order to validate uploadAllow and uploadDeny
$yesterday	integer	Yesterday 24:00 timestamp

Public Methods

Method	Description
archive ( $hashes, $mime ) : void	Add files to archive
close ( Resource $fp, string $hash ) : void	Close file pointer
closest ( string $hash, string $attr, boolean $val ) : string | false	Return file/dir hash or first founded child hash with required attr == $val
commandDisabled ( string $cmd ) : boolean	Return true if command disabled in options
copyFromAllowed ( ) : boolean	Return true if copy from this volume allowed
debug ( ) : array	Return debug info for client
defaultPath ( ) : string	Return root or startPath hash
dimensions ( string $hash ) : array	Return image dimensions
dir ( string $hash, $resolveLink = false ) : array | false	Return folder info
driverId ( ) : string	Return driver id. Used as a part of volume id.
duplicate ( string $hash, string $suffix = 'copy' ) : array | false	Create file copy with suffix "copy number" and return its info
error ( ) : array	Return error message from last failed action
extract ( string $hash ) : array | boolean	Extract files from archive
file ( string $hash ) : array | false	Return file info or false on error
getContents ( string $hash ) : string | false	Return file contents
id ( ) : string	Return volume id
isReadable ( ) : boolean	Return true if voume is readable.
ls ( string $hash ) : array	Return dir files names list
mimeAccepted ( string $mime, array $mimes = [], boolean | null $empty = true ) : boolean | null	Return true if mime is required mimes list
mkdir ( string $dst, string $name ) : array | false	Create directory and return dir info
mkfile ( string $dst, string $name ) : array | false	Create empty file and return its info
mount ( array $opts ) : boolean	"Mount" volume.
open ( $hash ) : Resource	Open file for reading and return file pointer
options ( $hash ) : array	Return volume options required by client:
parents ( string $hash ) : array	Return part of dirs tree from required dir up to root dir
paste ( Object $volume, $src, string $dst, boolean $rmSrc = false ) : array | false	Paste files
path ( string $hash ) : string	Return file path related to root
putContents ( string $hash, string $content ) : array	Put content in text file and return file info.
realpath ( string $hash ) : string	Return file real path if file exists
removed ( ) : array	Return list of moved/overwrited files
rename ( string $hash, string $name ) : array | false	Rename file and return file info
resetRemoved ( ) : void	Clean removed files list
resize ( string $hash, integer $width, integer $height, integer $x, integer $y, string $mode = 'resize', $bg = '', $degree ) : array | false	Resize image
rm ( string $hash ) : boolean	Remove file/dir
root ( ) : string	Return root folder hash
scandir ( string $hash ) : array | false	Return directory content or false on error
search ( string $q, array $mimes ) : array	Search files
setMimesFilter ( array $mimes ) : void	Set mimetypes allowed to display to client
size ( $hash ) : integer	Return file size / total directory size
tmb ( $hash ) : string | false	Create thumbnail for required file and return its name of false on failed
tree ( string $hash = '', integer $deep, string $exclude = '' ) : array | false	Return subfolders for required folder or false on error
umount ( ) : void	Some "unmount" stuffs - may be required by virtual fs
uniqueName ( $dir, $name, string $suffix = ' copy', $checkNum = true ) : string	Return new unique name based on file name and suffix
upload ( Resource $fp, string $dst, $name, string $tmpname ) : array | false	Save uploaded file.

Protected Methods

Method	Description
_abspath ( string $path ) : string	Convert path related to root dir into real path
_archive ( string $dir, array $files, string $name, array $arc ) : string | boolean	Create archive and return its path
_basename ( string $path ) : string	Return file name
_checkArchivers ( ) : void	Detect available archivers
_copy ( string $source, $targetDir, string $name ) : boolean	Copy file into another file (only inside one volume)
_dimensions ( string $path, string $mime ) : string	Return object width and height Ususaly used for images, but can be realize for video etc.
_dirname ( string $path ) : string	Return parent directory path
_extract ( string $path, array $arc ) : boolean	Extract files from archive
_fclose ( resource $fp, string $path = '' ) : boolean	Close opened file
_filePutContents ( string $path, string $content ) : boolean	Write a string to a file
_fopen ( string $path, $mode = "rb" ) : resource | false	Open file and return file pointer
_getContents ( string $path ) : string | false	Get file contents
_inpath ( string $path, string $parent ) : boolean	Return true if $path is children of $parent
_joinPath ( string $dir, string $name ) : string	Join dir name and file name and return full path.
_mkdir ( string $path, string $name ) : string | boolean	Create dir and return created dir path or false on failed
_mkfile ( string $path, string $name ) : string | boolean	Create file and return it's path or false on failed
_move ( string $source, $targetDir, string $name ) : string | boolean	Move file into another parent dir.
_normpath ( string $path ) : string	Return normalized path
_path ( string $path ) : string	Return fake path started from root dir.
_relpath ( string $path ) : string	Return file path related to root dir
_rmdir ( string $path ) : boolean	Remove dir
_save ( resource $fp, string $dir, string $name, array $stat ) : boolean | string	Create new file and write into it from file pointer.
_scandir ( string $path ) : array	Return files list in directory
_stat ( string $path ) : array | false	Return stat for given path.
_subdirs ( string $path ) : boolean	Return true if path is dir and has at least one childs directory
_symlink ( string $source, string $targetDir, string $name ) : boolean	Create symlink
_unlink ( string $path ) : boolean	Remove file
allowCreate ( string $dir, string $name ) : boolean	Return true if file with given name can be created in given folder.
attr ( string $path, string $name, boolean $val = null ) : boolean	Check file attribute
cacheDir ( string $path ) : void	Get stat for folder content and put in cache
canCreateTmb ( string $path, array $stat ) : string | boolean	Return true if thumnbnail for required file can be created
canResize ( string $path, array $stat ) : string | boolean	Return true if required file can be resized.
childsByAttr ( string $path, string $attr, boolean $val ) : string | false	Return first found children with required attr == $val
clearcache ( ) : void	Clean cache
closestByAttr ( string $path, string $attr, boolean $val ) : string | false	If file has required attr == $val - return file path, If dir has child with has required attr == $val - return child path
configure ( ) : void	Configure after successfull mount.
copy ( string $src, string $dst, string $name ) : string | false	Copy file/recursive copy dir only in current volume.
copyFrom ( Object $volume, string $src, string $destination, string $name ) : string | false	Copy file from another volume.
countSize ( string $path ) : integer	Return file/total directory size
createTmb ( string $path, $stat ) : string | false	Create thumnbnail and return it's URL on success
crypt ( $path ) : mixed	Return crypted path Not implemented
decode ( $hash ) : string	Decode path from hash
doSearch ( string $path, string $q, array $mimes ) : array	Recursive files search
encode ( $path ) : string	Encode path into hash
gdImage ( resource $image, string $filename, string $destformat, string $mime )	Output gd image to file
gdImageBackground ( resource $image, string $bgcolor )	Assign the proper background to a gd image
gdImageCreate ( string $path, string $mime ) : gd	Create an gd image according to the specified mime type
getScandir ( string $path ) : array	Return required dir's files info.
gettmb ( string $path, array $stat ) : string | false	Return thumnbnail name if exists
gettree ( string $path, integer $deep, $exclude = '' ) : array	Return subdirs tree
imgCrop ( string $path, integer $width, integer $height, boolean $x, boolean $y, string $destformat = null ) : string | false	Crop image
imgResize ( string $path, integer $width, integer $height, boolean $keepProportions = false, boolean $resizeByBiggerSide = true, string $destformat = null ) : string | false	Resize image
imgRotate ( string $path, integer $degree, string $bgcolor = '#ffffff', string $destformat = null ) : string | false	Rotate image
imgSquareFit ( string $path, integer $width, integer $height, integer $align = 'center', integer $valign = 'middle', string $bgcolor = '#0000ff', string $destformat = null ) : string | false	Put image to square
init ( ) : boolean	Prepare driver before mount volume.
isSameType ( string $mime1, string $mime2 ) : boolean	Return true if all mimes is directory or files
mimetype ( string $path, $name = '' ) : string	Return file mimetype
mimetypeInternalDetect ( string $path ) : string	Detect file mimetype using "internal" method
move ( string $src, string $dst, string $name ) : string | false	Move file Return new file path or false.
nameAccepted ( string $name ) : boolean	Validate file name based on $this->options['acceptedName'] regexp
procExec ( string $command, array &$output = null, array &$return_var, array &$error_output = null ) : integer	Execute shell command
remove ( string $path, boolean $force = false ) : boolean	Remove file/ recursive remove dir
rmTmb ( string $stat ) : void	Remove thumbnail, also remove recursively if stat is directory
setError ( $error ) : false	Save error message
stat ( string $path ) : array	Return fileinfo
stripos ( string $haystack, string $needle, integer $offset ) : integer | boolean	Find position of first occurrence of string in a string with multibyte support
tmbname ( array $stat ) : string	Return thumbnail file name for required file
uncrypt ( $hash ) : mixed	Return uncrypted path Not implemented
updateCache ( string $path, array $stat ) : array	Put file stat in cache and return it

Method Details

Property Details