xp-framework/ftp

FTP protocol support for the XP Framework

v11.1.0 2024-03-24 10:37 UTC

Requires

• php: >=7.0.0
• xp-framework/core: ^12.0 | ^11.0 | ^10.0
• xp-framework/io-collections: ^10.0 | ^9.0 | ^8.0
• xp-framework/logging: ^11.0 | ^10.0 | ^9.1
• xp-framework/networking: ^10.0 | ^9.3

Requires (Dev)

• xp-framework/unittest: ^11.0 | ^10.1

BSD-3-Clause

• module
• xp

README

Userland FTP protocol implementation, no dependency on PHP's ftp extension.

Client

Example: Uploading

use peer\ftp\{FtpConnection, FtpTransfer};
use io\File;

$c= (new FtpConnection('ftp://user:[e-mail]/'))->connect();

// Upload logo.png to the connection's root directory
$c->rootDir()->file('logo.png')->uploadFrom(new File('logo.png'));

// Upload from a stream using ASCII mode
$c->rootDir()->file('README.md')->uploadFrom(
  new MemoryInputStream('Read me first!'),
  FtpTransfer::ASCII
);

$c->close();

Example: Listing

use peer\ftp\FtpConnection;

$c= (new FtpConnection('ftp://user:[e-mail]/'))->connect();

// List root directory's contents
foreach ($c->rootDir()->entries() as $entry) {
  Console::writeLine('- ', $entry);
}

$c->close();