rjkip / ftp-php
A small, easy-to-use library for accessing FTP servers.
Installs: 182 263
Dependents: 1
Suggesters: 0
Security: 0
Stars: 15
Watchers: 2
Forks: 79
Open Issues: 0
Requires
- php: >=5.3
This package is not auto-updated.
Last update: 2020-08-21 17:43:06 UTC
README
FTP for PHP (c) David Grudl, 2008 (http://davidgrudl.com)
Introduction
FTP for PHP is a very small and easy-to-use library for accessing FTP servers.
David Grudl's project at GoogleCode: http://ftp-php.googlecode.com
David Grudl's PHP blog: http://phpfashion.com
Requirements
- PHP 5.3+
Installation
Install FtpPhp
through Composer.
Just specify rjkip/ftp-php
as a dependency.
Usage
Opens an FTP connection to the specified host:
<?php require "vendor/autoload.php"; use FtpPhp\FtpClient; use FtpPhp\FtpException; $ftp = new FtpClient; $ftp->connect($host);
Login with username and password
<?php $ftp->login($username, $password);
You can also pass a URI to the constructor, as such:
<?php $ftp = new FtpClient("ftp://user:password@host/path");
<?php $arr = $ftp->nlist(); foreach ($arr as $value) { echo $value.PHP_EOL; }
Upload the file
<?php $ftp->put($destination_file, $source_file, FtpClient::BINARY);
Close the FTP stream
<?php # Connection is also closed when `$ftp` goes out of scope. $ftp->close();
Ftp throws exception if operation failed. So you can simply do following:
<?php try { $ftp = new FtpClient; $ftp->connect($host); $ftp->login($username, $password); $ftp->put($destination_file, $source_file, FtpClient::BINARY); } catch (FtpException $e) { echo 'Error: ', $e->getMessage(); }
On the other hand, if you'd like the possible exception quietly catch, call methods with the prefix 'try':
<?php $ftp->tryDelete($destination_file);
When the connection is accidentally interrupted, you can re-establish it using method $ftp->reconnect()
.
Changelog
v1.1.0 - 2014-01-13
- Introducing a base exception class for all FtpPhp exceptions. This shouldn't break any of your exception handling, unless you rely on
FtpException
directly extending\Exception
. - All classes comply largely to PSR-2.
- Updated docblocks to satisfy PhpStorm.