PHP Classes

Easy PHP FTP Client: Access files in server using the PHP FTP extension

Recommend this page to a friend!
  Info   View files Documentation   View files View files (7)   DownloadInstall with Composer Download .zip   Reputation   Support forum   Blog    
Ratings Unique User Downloads Download Rankings
Not yet rated by the usersTotal: 234 This week: 1All time: 8,096 This week: 571Up
Version License PHP version Categories
easy-ftp 1.0.2MIT/X Consortium ...7Networking, Files and Folders, PHP 7
Description 

Author

This class can access files in server using the PHP FTP extension.

It can connect to a given FTP server using SSL or not and perform several types of operations to access files in a directories of the server. Currently it can:

- Get current directory
- Change the current directory to a given path or the parent directory
- Create a new directory
- Upload and download a file
- Returns the file size
- List a directory
- Move or rename a file or directory
- Change file or directory permissions
- Delete a file and directory permission recursively
- Delete(string $path, bool $recursive);
- Get the last modification time of a file
- Check if a given path has a file or a directory
- Send a message or an arbitrary command to the FTP server
- Check if any errors occurred previously and get the list of error or debug messages

Picture of Laudir Bispo
  Performance   Level  
Name: Laudir Bispo <contact>
Classes: 7 packages by
Country: Brazil Brazil
Age: 31
All time rank: 2248152 in Brazil Brazil
Week rank: 103 Up8 in Brazil Brazil Up
Innovation award
Innovation award
Nominee: 3x

Documentation

A simple Easy FTPClient class

> I have always chosen to build simple classes and closer to the actual use. This class represents exactly that, simple and functional.

Installation

Install the latest version with

$ composer require laudirbispo/easy-ftp

Basic Usage

<?php

  use laudirbispo\EasyFTP\FTPClient;
  use laudirbispo\EasyFTP\Exceptions\{FTPException, NoConnection};

    $FTP = new FTPClient();
    $FTP->connect(string $host, int $port, int $timeout, bool $ssl);
    // or
    $FTP->sslConnection(string $host, int $port, int $timeout);
    $FTP->login(string $user, string $pass);
    
    /
     * Turns on or off passive mode. 
     * In passive mode, data connections are initiated by the client, rather than by the server.
     * @return bool
     */
    $FTP->passiveModeOn();
    $FTP->passiveModeOff();
    
    /
     * Get current directory
     * @return string|null
     */
     $FTP->getCurrentDir();
     
    /
     * Moves to the specified directory
     * @return bool
     */
     $FTP->goToDir($upUdir);
     
    /
     * Back to the above directory
     * @return bool
     */
     $FTP->backDir();
     
    /
     * Creates a new directory
     * @param $chmod octal - default is 0644
     * @return bool
     */
     $FTP->createDir(string $dir, 0755);
     
    /
     * Move upload file
     * @param string $localFile
     * @param string $remoteFile
     * @param $chmod octal - default is 0644
     * @return bool
     */
     $FTP->upload(string $localFile, string $remoteFile, $chmod);
     
    /
     * Download a file
     * @param string $remoteFile
     * @param string $localFile
     * @return bool
     */
     $FTP->download(string $remoteFile, string $localFile);
     
    /
     * Returns the file size
     * @param string $localFile
     * @return int - 0 if it does not exist or is not a file
     */
     $FTP->getFileSize(string $remoteFile);
     
    /
     * List directory
     * @param string $dir
     * @param bool $recursive
     * @return array
     */
     $FTP->listDir(string $dir, bool $recursive);
     
    /
     * Rename or move file or rename folder
     * @param string $oldName
     * @param string $newName
     * @return bool
     */
     $FTP->rename(string $oldName, string $newName);
     
    /
     * Move dir and files 
     * @param string $oldName
     * @param string $newName
     * @return bool
     */
     $FTP->move(string $oldLocal, string $newLocal);
     
    /
     * Change chmod
     * @param string $path - file or dir
     * @param $chmod octal - default is 0644
     * @param boll $recursive - aplly to subdirectories
     * @return bool
     */
     $FTP->chmod(string $path, $chmod, bool $recursive);
     
     /
     * Delete files and dirs
     * @param string $path - file or dir
     * @param boll $recursive - aplly to subdirectories
     * @return bool
     */
     $FTP->delete(string $path, bool $recursive);
     
    /
     * Get the timestamp of the last modification of the file
     * @param string $file- file
     * @return int timestamp
     */
     $FTP->getLastModificationFile(string $file);
     
     /
     * More
     * @return bool
     */
     $FTP->isDir(string $directory);
     $FTP->isFile(string $file);
     
    /
     * Send an arbitrary command to an FTP server
     * @param string $command 
     * @return bool
     */
     $FTP->command(string $command);
     // Example
     $FTP->command("MSG Wello Word");
     
    /
     * Send a message to server
     * @param string $message 
     * @return bool
     */
     $FTP->message(string $message);
     
    /
     * Returns only the errors that occurred
     * @return array
     */
     $FTP->getErrors();
     
    /
     * Checks for errors
     * @return bool
     */
     $FTP->hasErrors();
     
     /
     * Returns a list formatted with everything that happened
     * @return html string formatted
     */
     $FTP->debug();
     
     // Debug example
    [02/05/2019 18:28:28] Status: Server connected by SSL
    [02/05/2019 18:28:28] Status: Passive mode activated
    [02/05/2019 18:28:28] Status: New directory "example", created
    [02/05/2019 18:28:28] Status: "example" chmod changed to "755"
    [02/05/2019 18:28:29] Status: "/example" deleted successfully
    [02/05/2019 18:28:29] Status: Command sent "MSG lorem ipsum dolor" executed
    [02/05/2019 18:28:29] Status: Message "Hello Word!" sent to server
    [02/05/2019 18:28:29] Status: Connection closed
    
    /
     * Check if there is a connection
     * @return bool
     */
    $FTP->hasConnection();
    
    /
     * End current connection
     */
    $FTP->close();
    
    /
     * Recconect
     */
    $FTP->reconnect();



Author

Laudir Bispo - <laudirbispo@outlook.com> - <https://twitter.com/laudir_bispo><br />

License

Easy FTPClient is licensed under the MIT License - see the LICENSE file for details


  Files folder image Files  
File Role Description
Files folder imagesrc (1 directory)
Accessible without login Plain text file composer.json Data Auxiliary data
Accessible without login Plain text file README.md Doc. Documentation

  Files folder image Files  /  src  
File Role Description
Files folder imageEasyFTP (1 file, 2 directories)

  Files folder image Files  /  src  /  EasyFTP  
File Role Description
Files folder imageExceptions (2 files, 1 directory)
Files folder image_notes (1 file)
  Plain text file FTPClient.php Class Class source

  Files folder image Files  /  src  /  EasyFTP  /  Exceptions  
File Role Description
Files folder image_notes (1 file)
  Plain text file FTPException.php Class Class source
  Plain text file NoConnection.php Class Class source

  Files folder image Files  /  src  /  EasyFTP  /  Exceptions  /  _notes  
File Role Description
  Accessible without login Plain text file dwsync.xml Data Auxiliary data

  Files folder image Files  /  src  /  EasyFTP  /  _notes  
File Role Description
  Accessible without login Plain text file dwsync.xml Data Auxiliary data

 Version Control Unique User Downloads Download Rankings  
 100%
Total:234
This week:1
All time:8,096
This week:571Up