PHP Classes

File: README_EN.txt

Recommend this page to a friend!
  Classes of Carlos Falo Hervás   FTP object   README_EN.txt   Download  
File: README_EN.txt
Role: Documentation
Content type: text/plain
Description: Docs (English)
Class: FTP object
FTP client wrapper
Author: By
Last change:
Date: 20 years ago
Size: 4,838 bytes
 

Contents

Class file image Download
===== BASIC DOCUMENTATION FOR FTP_OBJECT CLASS ===== 0.- INTRODUCTION AND EXTENTS This class is designed as an easy wrapper for FTP connection management, allowing for encapsulated management of FTP commands and results. 1.- BASICS OF OPERATION The class is a wrapper for all common (non blocking support not yet there, but i'll be adding it someday) PUBLIC INTERFACE: VARIABLES: * $connected : boolean This variable determines if connection was successful or not METHODS: * function FTP($server,$user,$pass,$debug=0,$port=21,$timeout=90) ; The constructor: $server-> string with ftp server ip or name $user-> string with a valid ftp user name $pass-> string with a valid pass for the given user $debug-> debug mode, see log_defs.inc for predefined values $port-> port for the server $timeout-> seconds for the timeout This function attempts a connection to the server and sets coonected to true if connection was successful. This function also initializes logging operations if needed. * function destroy() ; The destructor: NO PARAMS This function closses the FTP channel and the log file if needed. * function lcd($dirname) ; Changing local directory: $dirname-> the new directory to switch to This function returns TRUE on success or FALSE otherwise * function cd($dirname) ; Changing remote directory: $dirname-> the new directory to switch to This function returns TRUE on success or FALSE otherwise * function cdup() ; Moving remote directory up: NO PARAMS This function is equivalent to cd("../") with same results * function lmd($dirname,$mode=0755) ; Creating a local directory: $dirname-> the name for the new directory to create $mode-> octal value for the mode, defaults to xrw x-- x-- This function creates a new directory, returns TRUE on succes or FALSE otherwise * function md($dirname) ; Creating a remote directory: $dirname-> the name for the new directory to create This function creates a new directory, returns TRUE on succes or FALSE otherwise * function lrd($dirname) ; Removing a local directory: $dirname-> the name for the directory to remove This function removes a directory, returns TRUE on success or FALSE otherwise. To succed the directory must be empty. * function rd($dirname) ; Removing a remote directory: $dirname-> the name for the directory to remove This function removes a directory, returns TRUE on success or FALSE otherwise. To succed the directory must be empty. * function ldirlist() ; Listing local directory contents: NO PARAMS This function just lists every file/dir (no distinction yet...) in the current directory * function dirlist() ; Listing remote directory contents: NO PARAMS This function just lists every file/dir (no distinction yet...) in the current directory * function del($filename) ; Delete a remote file: $filename-> file to delete This function deletes the remote file, returns TRUE on success or FALSE otherwise. * function ldel($filename) ; Delete a local file: $filename-> file to delete This function deletes the local file, returns TRUE on success or FALSE otherwise. * function put($filename,$mode=0) Putting a file in the remote server: $filename-> filename (in local drive and will be used as well on remote) $mode-> Transfer mode 0->binary 1->ascii Copy $filename to server with the same name, returning TRUE on success or FALSE otherwise * function get($filename,$mode=0) Retrieving a file from the remote server: $filename-> filename (in remote drive and will be used as well on local) $mode-> Transfer mode 0->binary 1->ascii Copy $filename to local directory with the same name, returning TRUE on success or FALSE otherwise * function ren($orig,$dest) Changing a file/directory name in the remote server: $orig-> original name $dest-> new name Change the name, returning TRUE on success or FALSE otherwise 2.- Future releases and WIP I'll be adding new features, like non-blocking transfers and extras for dirlists... I have also a small JavaScript based IDE for ftp management, but I don't think I'll be working too actively on it, as I have plenty of work to do... any suggestions and comments will be appreciated. 3.- Additional notes This class requires various levels of permissions on both filesystems, local and remote, to work fully, so check permissions if strange errors ocurr. CHMOD commands have not been added but will be possibly added soon. 4.- Contact information Carlos Falo Hervás carles@bisinteractive.net http://www.bisinteractive.net C/Manila 54-56 Esc. A Ent. 4ª 08034 Barcelona Spain Phone: +34 9 3 2063652 Fax: +34 9 3 2063689