JFTP
FTP client class
package |
Joomla.Platform |
---|---|
subpackage |
Client |
since |
11.1 |
Methods
__construct
JFTP object constructor
__construct(array $options = array())
since |
11.1 |
---|
Arguments
- $options
array
Associative array of options to set
__destruct
JFTP object destructor
__destruct()
Closes an existing connection, if we have one
since |
11.1 |
---|
_findMode
Method to find out the correct transfer mode for a specific file
_findMode(string $fileName) : integer
since |
11.1 |
---|
Arguments
- $fileName
string
Name of the file
Response
integer
Transfer-mode for this filetype [FTP_ASCII|FTP_BINARY]
_mode
Set transfer mode
_mode(integer $mode) : boolean
since |
11.1 |
---|
Arguments
- $mode
integer
Integer representation of data transfer mode [1:Binary|0:Ascii] Defined constants can also be used [FTP_BINARY|FTP_ASCII]
Response
boolean
True if successful
_passive
Set server to passive mode and open a data port connection
_passive() : boolean
since |
11.1 |
---|
Response
boolean
True if successful
_putCmd
Send command to the FTP server and validate an expected response code
_putCmd(string $cmd, mixed $expectedResponse) : boolean
since |
11.1 |
---|
Arguments
- $cmd
string
Command to send to the FTP server- $expectedResponse
mixed
Integer response code or array of integer response codes
Response
boolean
True if command executed successfully
_verifyResponse
Verify the response code from the server and log response if flag is set
_verifyResponse(mixed $expected) : boolean
since |
11.1 |
---|
Arguments
- $expected
mixed
Integer response code or array of integer response codes
Response
boolean
True if response code from the server is expected
chdir
Method to change the current working directory on the FTP server
chdir(string $path) : boolean
since |
11.1 |
---|
Arguments
- $path
string
Path to change into on the server
Response
boolean
True if successful
chmod
Method to change mode for a path on the FTP server
chmod(string $path, mixed $mode) : boolean
since |
11.1 |
---|
Arguments
- $path
string
Path to change mode on- $mode
mixed
Octal value to change mode to, e.g. '0777', 0777 or 511 (string or integer)
Response
boolean
True if successful
connect
Method to connect to a FTP server
connect(string $host = '127.0.0.1', string $port = 21) : boolean
since |
11.1 |
---|
Arguments
- $host
string
Host to connect to [Default: 127.0.0.1]- $port
string
Port to connect on [Default: port 21]
Response
boolean
True if successful
create
Method to create an empty file on the FTP server
create(string $path) : boolean
since |
11.1 |
---|
Arguments
- $path
string
Path local file to store on the FTP server
Response
boolean
True if successful
delete
Method to delete a path [file/folder] on the FTP server
delete(string $path) : boolean
since |
11.1 |
---|
Arguments
- $path
string
Path to delete
Response
boolean
True if successful
get
Method to get a file from the FTP server and save it to a local file
get(string $local, string $remote) : boolean
since |
11.1 |
---|
Arguments
- $local
string
Local path to save remote file to- $remote
string
Path to remote file to get on the FTP server
Response
boolean
True if successful
getInstance
Returns the global FTP connector object, only creating it if it doesn't already exist.
getInstance(string $host = '127.0.0.1', string $port = '21', array $options = null, string $user = null, string $pass = null) : \JFTP
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.
since |
11.1 |
---|
Arguments
- $host
string
Host to connect to- $port
string
Port to connect to- $options
array
Array with any of these options: type=>[FTP_AUTOASCII|FTP_ASCII|FTP_BINARY], timeout=>(int)- $user
string
Username to use for a connection- $pass
string
Password to use for a connection
Response
\JFTP
The FTP Client object.
isConnected
Method to determine if the object is connected to an FTP server
isConnected() : boolean
since |
11.1 |
---|
Response
boolean
True if connected
listDetails
Method to list the contents of a directory on the FTP server
listDetails(string $path = null, string $type = 'all') : mixed
Arguments
- $path
string
Path to the local file to be stored on the FTP server- $type
string
Return type [raw|all|folders|files]
Response
mixed
If $type is raw: string Directory listing, otherwise array of string with file-names
listNames
Method to list the filenames of the contents of a directory on the FTP server
listNames(string $path = null) : string
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
since |
11.1 |
---|
Arguments
- $path
string
Path local file to store on the FTP server
Response
string
Directory listing
login
Method to login to a server once connected
login(string $user = 'anonymous', string $pass = '[email protected]') : boolean
since |
11.1 |
---|
Arguments
- $user
string
Username to login to the server- $pass
string
Password to login to the server
Response
boolean
True if successful
mkdir
Method to create a directory on the FTP server
mkdir(string $path) : boolean
since |
11.1 |
---|
Arguments
- $path
string
Directory to create
Response
boolean
True if successful
pwd
Method to retrieve the current working directory on the FTP server
pwd() : string
since |
11.1 |
---|
Response
string
Current working directory
quit
Method to quit and close the connection
quit() : boolean
since |
11.1 |
---|
Response
boolean
True if successful
read
Method to read a file from the FTP server's contents into a buffer
read(string $remote, &$buffer) : boolean
since |
11.1 |
---|
Arguments
- $remote
string
Path to remote file to read on the FTP server- $buffer
Response
boolean
True if successful
reinit
Method to reinitialise the server, ie. need to login again
reinit() : boolean
NOTE: This command not available on all servers
since |
11.1 |
---|
Response
boolean
True if successful
rename
Method to rename a file/folder on the FTP server
rename(string $from, string $to) : boolean
since |
11.1 |
---|
Arguments
- $from
string
Path to change file/folder from- $to
string
Path to change file/folder to
Response
boolean
True if successful
restart
Method to restart data transfer at a given byte
restart(integer $point) : boolean
since |
11.1 |
---|
Arguments
- $point
integer
Byte to restart transfer at
Response
boolean
True if successful
setOptions
Set client options
setOptions(array $options) : boolean
since |
11.1 |
---|
Arguments
- $options
array
Associative array of options to set
Response
boolean
True if successful
store
Method to store a file to the FTP server
store(string $local, string $remote = null) : boolean
since |
11.1 |
---|
Arguments
- $local
string
Path to local file to store on the FTP server- $remote
string
FTP path to file to create
Response
boolean
True if successful
syst
Method to system string from the FTP server
syst() : string
since |
11.1 |
---|
Response
string
System identifier string
write
Method to write a string to the FTP server
write(string $remote, string $buffer) : boolean
since |
11.1 |
---|
Arguments
- $remote
string
FTP path to file to write to- $buffer
string
Contents to write to the FTP server
Response
boolean
True if successful
Properties
_conn
Socket resource
since |
11.1 |
---|
Type(s)
resource
_dataconn
Data port connection resource
since |
11.1 |
---|
Type(s)
resource
_pasv
Passive connection information
since |
11.1 |
---|
Type(s)
array
_response
Response Message
since |
11.1 |
---|
Type(s)
string
_timeout
Timeout limit
since |
11.1 |
---|
Type(s)
integer
_type
Transfer Type
since |
11.1 |
---|
Type(s)
integer
_OS
Native OS Type
since |
11.1 |
---|
Type(s)
string
_autoAscii
Array to hold ascii format file extensions
since |
11.1 |
---|
Type(s)
array
_lineEndings
Array to hold native line ending characters
since |
11.1 |
---|
Type(s)
array
instances
JFTP instances container.
since |
11.3 |
---|
Type(s)
array