pecee / ftp-client
PHP的一个灵活的FTP和SSL-FTP客户端。这个库提供了一些易于使用的辅助工具,用于管理远程文件。
1.1.1
2016-04-27 10:07 UTC
Requires
- php: >=5.4
Requires (Dev)
- phpunit/phpunit: 5.3.*
This package is auto-updated.
Last update: 2024-08-25 11:51:06 UTC
README
PHP的一个灵活的FTP和SSL-FTP客户端。这个库提供了一些易于使用的辅助工具,用于管理远程文件。
安装
composer require pecee/ftp-client
入门
连接到FTP服务器
$ftp = new \FtpClient\FtpClient(); $ftp->connect($host, $sslEnabled, $port); $ftp->login($login, $password);
注意:在脚本执行结束时(当对象被销毁时),连接会隐式关闭。因此,除了显式重新连接外,无需调用$ftp->close()
。
用法
上传所有文件和目录非常简单
// upload with the BINARY mode $ftp->uploadDirectory($sourceDirectory, $targetDirectory); // Is equal to $ftp->uploadDirectory($sourceDirectory, $targetDirectory, FTP_BINARY); // or upload with the ASCII mode $ftp->uploadDirectory($sourceDirectory, $targetDirectory, FTP_ASCII);
注意:FTP_ASCII
和FTP_BINARY
是预定义的PHP内部常量。
获取目录大小
// size of the current directory $size = $ftp->getDirectorySize(); // size of a given directory $size = $ftp->getDirectorySize('/path/of/directory');
计算目录中的项目数量
// count in the current directory $total = $ftp->count(); // count in a given directory $total = $ftp->count('/path/of/directory'); // count only the "files" in the current directory $total_file = $ftp->count('.', 'file'); // count only the "files" in a given directory $total_file = $ftp->count('/path/of/directory', 'file'); // count only the "directories" in a given directory $total_dir = $ftp->count('/path/of/directory', 'directory'); // count only the "symbolic links" in a given directory $total_link = $ftp->count('/path/of/directory', 'link');
所有文件和目录的详细列表
// scan the current directory and returns the details of each item $items = $ftp->scanDirectory(); // scan the current directory (recursive) and returns the details of each item var_dump($ftp->scanDirectory('.', true));
结果
'directory#www' =>
array (size=10)
'permissions' => string 'drwx---r-x' (length=10)
'number' => string '3' (length=1)
'owner' => string '32385' (length=5)
'group' => string 'users' (length=5)
'size' => string '5' (length=1)
'month' => string 'Nov' (length=3)
'day' => string '24' (length=2)
'time' => string '17:25' (length=5)
'name' => string 'www' (length=3)
'type' => string 'directory' (length=9)
'link#www/index.html' =>
array (size=11)
'permissions' => string 'lrwxrwxrwx' (length=10)
'number' => string '1' (length=1)
'owner' => string '0' (length=1)
'group' => string 'users' (length=5)
'size' => string '38' (length=2)
'month' => string 'Nov' (length=3)
'day' => string '16' (length=2)
'time' => string '14:57' (length=5)
'name' => string 'index.html' (length=10)
'type' => string 'link' (length=4)
'target' => string '/var/www/shared/index.html' (length=26)
'file#www/README' =>
array (size=10)
'permissions' => string '-rw----r--' (length=10)
'number' => string '1' (length=1)
'owner' => string '32385' (length=5)
'group' => string 'users' (length=5)
'size' => string '0' (length=1)
'month' => string 'Nov' (length=3)
'day' => string '24' (length=2)
'time' => string '17:25' (length=5)
'name' => string 'README' (length=6)
'type' => string 'file' (length=4)
支持所有FTP PHP函数,并进行了改进
// Requests execution of a command on the FTP server $ftp->exec($command); // Turns passive mode on or off $ftp->pasv(true); // Set permissions on a file via FTP $ftp->chmod('0777', 'file.php'); // Removes a directory $ftp->deleteFile('path/of/directory/to/remove'); // Removes a directory (recursive) $ftp->deleteDirectory('path/of/directory/to/remove', true); // Creates a directory $ftp->createDirectory('path/of/directory/to/create'); // Creates a directory (recursive), // creates automaticaly the sub directory if not exist $ftp->createDirectory('path/of/directory/to/create', true); // and more ...
获取远程FTP服务器的帮助信息
var_dump($ftp->help());
结果
array (size=6)
0 => string '214-The following SITE commands are recognized' (length=46)
1 => string ' ALIAS' (length=6)
2 => string ' CHMOD' (length=6)
3 => string ' IDLE' (length=5)
4 => string ' UTIME' (length=6)
5 => string '214 Pure-FTPd - http://pureftpd.org/' (length=36)
注意:结果取决于FTP服务器。
可扩展性
创建您自己的FtpClient
。
// MyFtpClient.php /** * My custom FTP Client * @inheritDoc */ class MyFtpClient extends \FtpClient\FtpClient { public function removeByTime($path, $timestamp) { // your code here } public function search($regex) { // your code here } }
// example.php $ftp = new MyFtpClient(); $ftp->connect($host); $ftp->login($login, $password); // remove the old files $ftp->removeByTime('/www/mysite.com/demo', time() - 86400)); // search PNG files $ftp->search('/(.*)\.png$/i');
测试
使用PHPUnit测试
许可
MIT (c) 2016。