Joomla CMS  4.2.2
Documentation des API du CMS Joomla en version 4.2.2
Référence de la classe FtpClient

Fonctions membres publiques

 __construct (array $options=[])
 
 __destruct ()
 
 setOptions (array $options)
 
 connect ($host='127.0.0.1', $port=21)
 
 isConnected ()
 
 login ($user='anonymous', $pass='jftp @joomla.org')
 
 quit ()
 
 pwd ()
 
 syst ()
 
 chdir ($path)
 
 reinit ()
 
 rename ($from, $to)
 
 chmod ($path, $mode)
 
 delete ($path)
 
 mkdir ($path)
 
 restart ($point)
 
 create ($path)
 
 read ($remote, &$buffer)
 
 get ($local, $remote)
 
 store ($local, $remote=null)
 
 write ($remote, $buffer)
 
 listNames ($path=null)
 
 listDetails ($path=null, $type='all')
 

Fonctions membres publiques statiques

static getInstance ($host='127.0.0.1', $port='21', array $options=[], $user=null, $pass=null)
 

Fonctions membres protégées

 _putCmd ($cmd, $expectedResponse)
 
 _verifyResponse ($expected)
 
 _passive ()
 
 _findMode ($fileName)
 
 _mode ($mode)
 

Attributs protégés statiques

static $instances = []
 

Attributs privés

 $conn
 
 $dataconn
 
 $pasv
 
 $response
 
 $responseCode
 
 $responseMsg
 
 $timeout = 15
 
 $type
 
 $autoAscii
 
 $lineEndings = ['UNIX' => "\n"
 

Description détaillée

FTP client class

Depuis
1.0

Documentation des constructeurs et destructeur

◆ __construct()

__construct ( array  $options = [])

FtpClient object constructor

Paramètres
array$optionsAssociative array of options to set
Depuis
1.0

Références $options, et FtpClient\setOptions().

◆ __destruct()

__destruct ( )

FtpClient object destructor

Closes an existing connection, if we have one

Depuis
1.0

Références FtpClient\quit().

Documentation des fonctions membres

◆ _findMode()

_findMode (   $fileName)
protected

Method to find out the correct transfer mode for a specific file

Paramètres
string$fileNameName of the file
Renvoie
integer Transfer-mode for this filetype [FTP_ASCII|FTP_BINARY]
Depuis
1.0

Références $mode, et elseif.

Référencé par FtpClient\get(), FtpClient\read(), FtpClient\store(), et FtpClient\write().

◆ _mode()

_mode (   $mode)
protected

Set transfer mode

Paramètres
integer$modeInteger representation of data transfer mode [1:Binary|0:Ascii] Defined constants can also be used [FTP_BINARY|FTP_ASCII]
Renvoie
boolean True if successful
Depuis
1.0
Exceptions
FilesystemException

Références $mode, et FtpClient\_putCmd().

Référencé par FtpClient\get(), FtpClient\read(), FtpClient\store(), et FtpClient\write().

◆ _passive()

_passive ( )
protected

Set server to passive mode and open a data port connection

Renvoie
boolean True if successful
Depuis
1.0
Exceptions
FilesystemException

Références $parts, FtpClient\$timeout, et null.

Référencé par FtpClient\create(), FtpClient\get(), FtpClient\listDetails(), FtpClient\listNames(), FtpClient\read(), FtpClient\store(), et FtpClient\write().

◆ _putCmd()

_putCmd (   $cmd,
  $expectedResponse 
)
protected

Send command to the FTP server and validate an expected response code

Paramètres
string$cmdCommand to send to the FTP server
mixed$expectedResponseInteger response code or array of integer response codes
Renvoie
boolean True if command executed successfully
Depuis
1.0
Exceptions
FilesystemException

Références FtpClient\_verifyResponse().

Référencé par FtpClient\_mode(), FtpClient\chdir(), FtpClient\chmod(), FtpClient\create(), FtpClient\delete(), FtpClient\get(), FtpClient\listDetails(), FtpClient\listNames(), FtpClient\login(), FtpClient\mkdir(), FtpClient\pwd(), FtpClient\read(), FtpClient\reinit(), FtpClient\rename(), FtpClient\restart(), FtpClient\store(), FtpClient\syst(), et FtpClient\write().

◆ _verifyResponse()

_verifyResponse (   $expected)
protected

Verify the response code from the server and log response if flag is set

Paramètres
mixed$expectedInteger response code or array of integer response codes
Renvoie
boolean True if response code from the server is expected
Depuis
1.0
Exceptions
FilesystemException

Références $parts, FtpClient\$timeout, et null.

Référencé par FtpClient\_putCmd(), FtpClient\connect(), FtpClient\create(), FtpClient\get(), FtpClient\listDetails(), FtpClient\listNames(), FtpClient\read(), FtpClient\store(), et FtpClient\write().

◆ chdir()

chdir (   $path)

Method to change the current working directory on the FTP server

Paramètres
string$pathPath to change into on the server
Renvoie
boolean True if successful
Depuis
1.0
Exceptions
FilesystemException

Références $path, et FtpClient\_putCmd().

◆ chmod()

chmod (   $path,
  $mode 
)

Method to change mode for a path on the FTP server

Paramètres
string$pathPath to change mode on
mixed$modeOctal value to change mode to, e.g. '0777', 0777 or 511 (string or integer)
Renvoie
boolean True if successful
Depuis
1.0
Exceptions
FilesystemException

Références $mode, $path, et FtpClient\_putCmd().

◆ connect()

connect (   $host = '127.0.0.1',
  $port = 21 
)

Method to connect to a FTP server

Paramètres
string$hostHost to connect to [Default: 127.0.0.1]
integer$portPort to connect on [Default: port 21]
Renvoie
boolean True if successful
Depuis
1.0
Exceptions
FilesystemException

Références FtpClient\_verifyResponse(), et null.

◆ create()

create (   $path)

Method to create an empty file on the FTP server

Paramètres
string$pathPath local file to store on the FTP server
Renvoie
boolean True if successful
Depuis
1.0
Exceptions
FilesystemException

Références $buffer, $path, FtpClient\_passive(), FtpClient\_putCmd(), et FtpClient\_verifyResponse().

◆ delete()

delete (   $path)

Method to delete a path [file/folder] on the FTP server

Paramètres
string$pathPath to delete
Renvoie
boolean True if successful
Depuis
1.0
Exceptions
FilesystemException

Références $path, et FtpClient\_putCmd().

◆ get()

get (   $local,
  $remote 
)

Method to get a file from the FTP server and save it to a local file

Paramètres
string$localLocal path to save remote file to
string$remotePath to remote file to get on the FTP server
Renvoie
boolean True if successful
Depuis
1.0
Exceptions
FilesystemException

Références $buffer, $mode, FtpClient\_findMode(), FtpClient\_mode(), FtpClient\_passive(), FtpClient\_putCmd(), et FtpClient\_verifyResponse().

◆ getInstance()

static getInstance (   $host = '127.0.0.1',
  $port = '21',
array  $options = [],
  $user = null,
  $pass = null 
)
static

Returns the global FTP connector object, only creating it if it doesn't already exist.

You may optionally specify a username and password in the parameters. If you do so, you may not login() again with different credentials using the same object. If you do not use this option, you must quit() the current connection when you are done, to free it for use by others.

Paramètres
string$hostHost to connect to
string$portPort to connect to
array$optionsArray with any of these options: type=>[FTP_AUTOASCII|FTP_ASCII|FTP_BINARY], timeout=>(int)
string$userUsername to use for a connection
string$passPassword to use for a connection
Renvoie
FtpClient The FTP Client object.
Depuis
1.0

Références $options, $return, $user, FtpClient\isConnected(), et null.

◆ isConnected()

isConnected ( )

Method to determine if the object is connected to an FTP server

Renvoie
boolean True if connected
Depuis
1.0

Référencé par FtpClient\getInstance().

◆ listDetails()

listDetails (   $path = null,
  $type = 'all' 
)

Method to list the contents of a directory on the FTP server

Paramètres
string$pathPath to the local file to be stored on the FTP server
string$typeReturn type [raw|all|folders|files]
Renvoie
string[] If $type is raw: string Directory listing, otherwise array of string with file-names
Depuis
1.0
Exceptions
FilesystemException

Références $data, $path, FtpClient\$type, FtpClient\_passive(), FtpClient\_putCmd(), FtpClient\_verifyResponse(), et null.

Référencé par FtpClient\listNames().

◆ listNames()

listNames (   $path = null)

Method to list the filenames of the contents of a directory on the FTP server

Note: Some servers also return folder names. However, to be sure to list folders on all servers, you should use listDetails() instead if you also need to deal with folders

Paramètres
string$pathPath local file to store on the FTP server
Renvoie
string Directory listing
Depuis
1.0
Exceptions
FilesystemException

Références $data, $key, $list, $path, FtpClient\_passive(), FtpClient\_putCmd(), FtpClient\_verifyResponse(), FtpClient\listDetails(), et null.

◆ login()

login (   $user = 'anonymous',
  $pass = 'jftp@joomla.org' 
)

Method to login to a server once connected

Paramètres
string$userUsername to login to the server
string$passPassword to login to the server
Renvoie
boolean True if successful
Depuis
1.0
Exceptions
FilesystemException

Références $user, et FtpClient\_putCmd().

◆ mkdir()

mkdir (   $path)

Method to create a directory on the FTP server

Paramètres
string$pathDirectory to create
Renvoie
boolean True if successful
Depuis
1.0
Exceptions
FilesystemException

Références $path, et FtpClient\_putCmd().

◆ pwd()

pwd ( )

Method to retrieve the current working directory on the FTP server

Renvoie
string Current working directory
Depuis
1.0
Exceptions
FilesystemException

Références FtpClient\_putCmd(), et null.

◆ quit()

quit ( )

Method to quit and close the connection

Renvoie
boolean True if successful
Depuis
1.0

Référencé par FtpClient\__destruct().

◆ read()

read (   $remote,
$buffer 
)

Method to read a file from the FTP server's contents into a buffer

Paramètres
string$remotePath to remote file to read on the FTP server
string$bufferBuffer variable to read file contents into
Renvoie
boolean True if successful
Depuis
1.0
Exceptions
FilesystemException

Références $buffer, $mode, $os, $tmp, FtpClient\_findMode(), FtpClient\_mode(), FtpClient\_passive(), FtpClient\_putCmd(), et FtpClient\_verifyResponse().

◆ reinit()

reinit ( )

Method to reinitialise the server, ie. need to login again

NOTE: This command not available on all servers

Renvoie
boolean True if successful
Depuis
1.0
Exceptions
FilesystemException

Références FtpClient\_putCmd().

◆ rename()

rename (   $from,
  $to 
)

Method to rename a file/folder on the FTP server

Paramètres
string$fromPath to change file/folder from
string$toPath to change file/folder to
Renvoie
boolean True if successful
Depuis
1.0
Exceptions
FilesystemException

Références FtpClient\_putCmd().

◆ restart()

restart (   $point)

Method to restart data transfer at a given byte

Paramètres
integer$pointByte to restart transfer at
Renvoie
boolean True if successful
Depuis
1.0
Exceptions
FilesystemException

Références FtpClient\_putCmd().

◆ setOptions()

setOptions ( array  $options)

Set client options

Paramètres
array$optionsAssociative array of options to set
Renvoie
boolean True if successful
Depuis
1.0

Références $options.

Référencé par FtpClient\__construct().

◆ store()

store (   $local,
  $remote = null 
)

Method to store a file to the FTP server

Paramètres
string$localPath to local file to store on the FTP server
string$remoteFTP path to file to create
Renvoie
boolean True if successful
Depuis
1.0
Exceptions
FilesystemException

Références $mode, $result, FtpClient\_findMode(), FtpClient\_mode(), FtpClient\_passive(), FtpClient\_putCmd(), FtpClient\_verifyResponse(), et null.

◆ syst()

syst ( )

Method to system string from the FTP server

Renvoie
string System identifier string
Depuis
1.0
Exceptions
FilesystemException

Références FtpClient\$response, FtpClient\_putCmd(), et elseif.

◆ write()

write (   $remote,
  $buffer 
)

Method to write a string to the FTP server

Paramètres
string$remoteFTP path to file to write to
string$bufferContents to write to the FTP server
Renvoie
boolean True if successful
Depuis
1.0
Exceptions
FilesystemException

Références $buffer, $mode, $result, $tmp, FtpClient\_findMode(), FtpClient\_mode(), FtpClient\_passive(), FtpClient\_putCmd(), et FtpClient\_verifyResponse().

Documentation des champs

◆ $autoAscii

$autoAscii
private
Valeur initiale :
= [
'asp',
'bat',
'c',
'cpp',
'csv',
'h',
'htm',
'html',
'shtml',
'ini',
'inc',
'log',
'php',
'php3',
'pl',
'perl',
'sh',
'sql',
'txt',
'xhtml',
'xml',
]

◆ $conn

$conn
private

◆ $dataconn

$dataconn
private

◆ $instances

$instances = []
staticprotected

◆ $lineEndings

$lineEndings = ['UNIX' => "\n"
private

◆ $pasv

$pasv
private

◆ $response

$response
private

Référencé par FtpClient\syst().

◆ $responseCode

$responseCode
private

◆ $responseMsg

$responseMsg
private

◆ $timeout

$timeout = 15
private

◆ $type

$type
private

Référencé par FtpClient\listDetails().


La documentation de cette classe a été générée à partir du fichier suivant :