PHP Class elFinderVolumeFTP

Author: Dmitry (dio) Levashov
Author: Cem (discofever)
Inheritance: extends elFinderVolumeDriver
Afficher le fichier Open project: studio-42/elfinder Class Usage Examples

Protected Properties

Свойство Type Description
$connect ftp FTP Connection Instance
$driverId string Driver id Must be started from letter and contains [a-z0-9] Used as part of volume id
$ftpError string Last FTP error message
$ftpOsUnix boolean FTP server output list as ftp on linux
$tmp string Tmp folder path
$tmpPath string Directory for tmp files If not set driver will try to use tmbDir as tmpDir

Méthodes publiques

Méthode Description
__construct ( ) Constructor Extend options with required fields
netmountPrepare ( $options ) : Array Prepare Call from elFinder::netmout() before volume->mount()
umount ( ) : void Close opened connection

Méthodes protégées

Méthode 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
_chmod ( string $path, string $mode ) : boolean chmod availability
_copy ( string $source, string $targetDir, string $name ) : boolean Copy file into another file
_dimensions ( string $path, string $mime ) : string | false 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 ) : true 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
_findSymlinks ( string $path ) : boolean Recursive symlinks search
_fopen ( string $path, string $mode = 'rb' ) : false | resource 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 retur 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 ) : boolean | string Move file into another parent dir.
_normpath ( string $path ) : string Return normalized path, this works the same as os.path.normpath() in Python
_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 $target, string $path, string $name ) : boolean Create symlink. FTP driver does not support symlinks.
_unlink ( string $path ) : boolean Remove file
cacheDir ( string $path ) : void Cache dir contents
configure ( ) : void Configure after successfull mount.
connect ( ) : boolean Connect to ftp server
ftpMode ( string $path ) : string Return ftp transfer mode for file
ftp_scan_dir ( $remote_directory, $targets = null ) : array Gets an array of absolute remote FTP paths of files and folders in $remote_directory omitting symbolic links.
init ( ) : boolean Prepare FTP connection Connect to remote server and check if credentials are correct, if so, store the connection id in $ftp_conn
normalizeRawWindows ( string $raw ) : array Normalize MS-DOS style FTP LIST Raw line
parsePermissions ( string $perm, string $user = '' ) : string Parse permissions string. Return array(read => true/false, write => true/false)
parseRaw ( string $raw, $base, boolean $nameOnly = false ) : array Parse line from ftp_rawlist() output and return file stat (array)

Private Methods

Méthode Description
deleteDir ( $dirPath ) : boolean Delete local directory recursively.
ftp_download_files ( $remote_directory, array $files, $dest_local_directory ) : boolean Downloads specified files from remote directory if there is a directory among files it is downloaded recursively (omitting symbolic links).
listFilesInDirectory ( $dir, $omitSymlinks, string $prefix = '' ) : array Returns array of strings containing all files and folders in the specified local directory.
tempDir ( ) : string Create writable temporary directory and return path to it.

Method Details

__construct() public méthode

Constructor Extend options with required fields
Author: Dmitry (dio) Levashov
Author: Cem (DiscoFever)
public __construct ( )

_abspath() protected méthode

Convert path related to root dir into real path
Author: Dmitry (dio) Levashov
protected _abspath ( string $path ) : string
$path string file path
Résultat string

_archive() protected méthode

Create archive and return its path
Author: Dmitry (dio) Levashov,
Author: Alexey Sukhotin
protected _archive ( string $dir, array $files, string $name, array $arc ) : string | boolean
$dir string target dir
$files array files names list
$name string archive name
$arc array archiver options
Résultat string | boolean

_basename() protected méthode

Return file name
Author: Naoki Sawada
protected _basename ( string $path ) : string
$path string file path
Résultat string

_checkArchivers() protected méthode

Detect available archivers
protected _checkArchivers ( ) : void
Résultat void

_chmod() protected méthode

chmod availability
protected _chmod ( string $path, string $mode ) : boolean
$path string
$mode string
Résultat boolean

_copy() protected méthode

Copy file into another file
Author: Dmitry (dio) Levashov
protected _copy ( string $source, string $targetDir, string $name ) : boolean
$source string source file path
$targetDir string target directory path
$name string new file name
Résultat boolean

_dimensions() protected méthode

..
Author: Dmitry (dio) Levashov
protected _dimensions ( string $path, string $mime ) : string | false
$path string file path
$mime string file mime type
Résultat string | false

_dirname() protected méthode

Return parent directory path
Author: Naoki Sawada
protected _dirname ( string $path ) : string
$path string file path
Résultat string

_extract() protected méthode

Extract files from archive
Author: Dmitry (dio) Levashov,
Author: Alexey Sukhotin
protected _extract ( string $path, array $arc ) : true
$path string archive path
$arc array archiver command and arguments (same as in $this->archivers)
Résultat true

_fclose() protected méthode

Close opened file
Author: Dmitry (dio) Levashov
protected _fclose ( resource $fp, string $path = '' ) : boolean
$fp resource file pointer
$path string
Résultat boolean

_filePutContents() protected méthode

Write a string to a file
Author: Dmitry (dio) Levashov
protected _filePutContents ( string $path, string $content ) : boolean
$path string file path
$content string new file content
Résultat boolean

_fopen() protected méthode

Open file and return file pointer
Author: Dmitry (dio) Levashov
protected _fopen ( string $path, string $mode = 'rb' ) : false | resource
$path string file path
$mode string
Résultat false | resource

_getContents() protected méthode

Get file contents
Author: Dmitry (dio) Levashov
protected _getContents ( string $path ) : string | false
$path string file path
Résultat string | false

_inpath() protected méthode

Return true if $path is children of $parent
Author: Dmitry (dio) Levashov
protected _inpath ( string $path, string $parent ) : boolean
$path string path to check
$parent string parent path
Résultat boolean

_joinPath() protected méthode

Join dir name and file name and retur full path
Author: Dmitry (dio) Levashov
protected _joinPath ( string $dir, string $name ) : string
$dir string
$name string
Résultat string

_mkdir() protected méthode

Create dir and return created dir path or false on failed
Author: Dmitry (dio) Levashov
protected _mkdir ( string $path, string $name ) : string | boolean
$path string parent dir path
$name string new directory name
Résultat string | boolean

_mkfile() protected méthode

Create file and return it's path or false on failed
Author: Dmitry (dio) Levashov
protected _mkfile ( string $path, string $name ) : string | boolean
$path string parent dir path
$name string new file name
Résultat string | boolean

_move() protected méthode

Return new file path or false.
Author: Dmitry (dio) Levashov
protected _move ( string $source, $targetDir, string $name ) : boolean | string
$source string source file path
$targetDir
$name string file name
Résultat boolean | string

_normpath() protected méthode

Return normalized path, this works the same as os.path.normpath() in Python
Author: Troex Nevelin
protected _normpath ( string $path ) : string
$path string path
Résultat string

_path() protected méthode

Return fake path started from root dir
Author: Dmitry (dio) Levashov
protected _path ( string $path ) : string
$path string file path
Résultat string

_relpath() protected méthode

Return file path related to root dir
Author: Dmitry (dio) Levashov
protected _relpath ( string $path ) : string
$path string file path
Résultat string

_rmdir() protected méthode

Remove dir
Author: Dmitry (dio) Levashov
protected _rmdir ( string $path ) : boolean
$path string dir path
Résultat boolean

_save() protected méthode

Return new file path or false on error.
Author: Dmitry (dio) Levashov
protected _save ( resource $fp, string $dir, string $name, array $stat ) : boolean | string
$fp resource file pointer
$dir string target dir path
$name string file name
$stat array file stat (required by some virtual fs)
Résultat boolean | string

_scandir() protected méthode

Return files list in directory.
Author: Dmitry (dio) Levashov
Author: Cem (DiscoFever)
protected _scandir ( string $path ) : array
$path string dir path
Résultat array

_stat() protected méthode

Stat contains following fields: - (int) size file size in b. required - (int) ts file modification time in unix time. required - (string) mime mimetype. required for folders, others - optionally - (bool) read read permissions. required - (bool) write write permissions. required - (bool) locked is object locked. optionally - (bool) hidden is object hidden. optionally - (string) alias for symlinks - link target path relative to root path. optionally - (string) target for symlinks - link target path. optionally If file does not exists - returns empty array or false.
Author: Dmitry (dio) Levashov
protected _stat ( string $path ) : array | false
$path string file path
Résultat array | false

_subdirs() protected méthode

Return true if path is dir and has at least one childs directory
Author: Dmitry (dio) Levashov
protected _subdirs ( string $path ) : boolean
$path string dir path
Résultat boolean

cacheDir() protected méthode

Cache dir contents
Author: Dmitry Levashov
protected cacheDir ( string $path ) : void
$path string dir path
Résultat void

configure() protected méthode

Configure after successfull mount.
Author: Dmitry (dio) Levashov
protected configure ( ) : void
Résultat void

connect() protected méthode

Connect to ftp server
Author: Dmitry (dio) Levashov
protected connect ( ) : boolean
Résultat boolean

ftpMode() protected méthode

Return ftp transfer mode for file
Author: Dmitry (dio) Levashov
protected ftpMode ( string $path ) : string
$path string file path
Résultat string

ftp_scan_dir() protected méthode

Gets an array of absolute remote FTP paths of files and folders in $remote_directory omitting symbolic links.
protected ftp_scan_dir ( $remote_directory, $targets = null ) : array
$remote_directory string remote FTP path to scan for file and folders recursively
$targets array Array of target item. `null` is to get all of items
Résultat array of elements each of which is an array of two elements:
  • $item['path'] - absolute remote FTP path
  • $item['type'] - either 'f' for file or 'd' for directory

init() protected méthode

Prepare FTP connection Connect to remote server and check if credentials are correct, if so, store the connection id in $ftp_conn
Author: Dmitry (dio) Levashov
Author: Cem (DiscoFever)
protected init ( ) : boolean
Résultat boolean

netmountPrepare() public méthode

Prepare Call from elFinder::netmout() before volume->mount()
Author: Naoki Sawada
public netmountPrepare ( $options ) : Array
$options
Résultat Array

normalizeRawWindows() protected méthode

Normalize MS-DOS style FTP LIST Raw line
Author: Naoki Sawada
protected normalizeRawWindows ( string $raw ) : array
$raw string line from FTP LIST (MS-DOS style)
Résultat array

parsePermissions() protected méthode

Parse permissions string. Return array(read => true/false, write => true/false)
Author: Dmitry (dio) Levashov
protected parsePermissions ( string $perm, string $user = '' ) : string
$perm string permissions string
$user string
Résultat string

parseRaw() protected méthode

Parse line from ftp_rawlist() output and return file stat (array)
Author: Dmitry Levashov
protected parseRaw ( string $raw, $base, boolean $nameOnly = false ) : array
$raw string line from ftp_rawlist() output
$base
$nameOnly boolean
Résultat array

umount() public méthode

Close opened connection
Author: Dmitry (dio) Levashov
public umount ( ) : void
Résultat void

Property Details

$connect protected_oe property

FTP Connection Instance
protected ftp $connect
Résultat ftp

$driverId protected_oe property

Driver id Must be started from letter and contains [a-z0-9] Used as part of volume id
protected string $driverId
Résultat string

$ftpError protected_oe property

Last FTP error message
protected string $ftpError
Résultat string

$ftpOsUnix protected_oe property

FTP server output list as ftp on linux
protected bool $ftpOsUnix
Résultat boolean

$tmp protected_oe property

Tmp folder path
protected string $tmp
Résultat string

$tmpPath protected_oe property

Directory for tmp files If not set driver will try to use tmbDir as tmpDir
protected string $tmpPath
Résultat string