mirror of
https://github.com/phpseclib/phpseclib.git
synced 2024-12-29 04:23:34 +00:00
3863 lines
123 KiB
PHP
3863 lines
123 KiB
PHP
<?php
|
|
|
|
/**
|
|
* Pure-PHP implementation of SFTP.
|
|
*
|
|
* PHP versions 4 and 5
|
|
*
|
|
* Supports SFTPv2/3/4/5/6. Defaults to v3.
|
|
*
|
|
* The API for this library is modeled after the API from PHP's {@link http://php.net/book.ftp FTP extension}.
|
|
*
|
|
* Here's a short example of how to use this library:
|
|
* <code>
|
|
* <?php
|
|
* include 'Net/SFTP.php';
|
|
*
|
|
* $sftp = new Net_SFTP('www.domain.tld');
|
|
* if (!$sftp->login('username', 'password')) {
|
|
* exit('Login Failed');
|
|
* }
|
|
*
|
|
* echo $sftp->pwd() . "\r\n";
|
|
* $sftp->put('filename.ext', 'hello, world!');
|
|
* print_r($sftp->nlist());
|
|
* ?>
|
|
* </code>
|
|
*
|
|
* LICENSE: Permission is hereby granted, free of charge, to any person obtaining a copy
|
|
* of this software and associated documentation files (the "Software"), to deal
|
|
* in the Software without restriction, including without limitation the rights
|
|
* to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
|
|
* copies of the Software, and to permit persons to whom the Software is
|
|
* furnished to do so, subject to the following conditions:
|
|
*
|
|
* The above copyright notice and this permission notice shall be included in
|
|
* all copies or substantial portions of the Software.
|
|
*
|
|
* THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
|
|
* IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
|
|
* FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
|
|
* AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
|
|
* LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
|
|
* OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
|
|
* THE SOFTWARE.
|
|
*
|
|
* @category Net
|
|
* @package Net_SFTP
|
|
* @author Jim Wigginton <terrafrost@php.net>
|
|
* @copyright 2009 Jim Wigginton
|
|
* @license http://www.opensource.org/licenses/mit-license.html MIT License
|
|
* @link http://phpseclib.sourceforge.net
|
|
*/
|
|
|
|
/**
|
|
* Include Net_SSH2
|
|
*/
|
|
if (!class_exists('Net_SSH2')) {
|
|
include_once 'SSH2.php';
|
|
}
|
|
|
|
/**#@+
|
|
* @access public
|
|
* @see self::getLog()
|
|
*/
|
|
/**
|
|
* Returns the message numbers
|
|
*/
|
|
define('NET_SFTP_LOG_SIMPLE', NET_SSH2_LOG_SIMPLE);
|
|
/**
|
|
* Returns the message content
|
|
*/
|
|
define('NET_SFTP_LOG_COMPLEX', NET_SSH2_LOG_COMPLEX);
|
|
/**
|
|
* Outputs the message content in real-time.
|
|
*/
|
|
define('NET_SFTP_LOG_REALTIME', 3);
|
|
/**#@-*/
|
|
|
|
/**
|
|
* SFTP channel constant
|
|
*
|
|
* Net_SSH2::exec() uses 0 and Net_SSH2::read() / Net_SSH2::write() use 1.
|
|
*
|
|
* @see Net_SSH2::_send_channel_packet()
|
|
* @see Net_SSH2::_get_channel_packet()
|
|
* @access private
|
|
*/
|
|
define('NET_SFTP_CHANNEL', 0x100);
|
|
|
|
/**#@+
|
|
* @access public
|
|
* @see self::put()
|
|
*/
|
|
/**
|
|
* Reads data from a local file.
|
|
*/
|
|
define('NET_SFTP_LOCAL_FILE', 1);
|
|
/**
|
|
* Reads data from a string.
|
|
*/
|
|
// this value isn't really used anymore but i'm keeping it reserved for historical reasons
|
|
define('NET_SFTP_STRING', 2);
|
|
/**
|
|
* Reads data from callback:
|
|
* function callback($length) returns string to proceed, null for EOF
|
|
*/
|
|
define('NET_SFTP_CALLBACK', 16);
|
|
/**
|
|
* Resumes an upload
|
|
*/
|
|
define('NET_SFTP_RESUME', 4);
|
|
/**
|
|
* Append a local file to an already existing remote file
|
|
*/
|
|
define('NET_SFTP_RESUME_START', 8);
|
|
/**#@-*/
|
|
|
|
/**
|
|
* Pure-PHP implementations of SFTP.
|
|
*
|
|
* @package Net_SFTP
|
|
* @author Jim Wigginton <terrafrost@php.net>
|
|
* @access public
|
|
*/
|
|
class Net_SFTP extends Net_SSH2
|
|
{
|
|
/**
|
|
* Packet Types
|
|
*
|
|
* @see self::Net_SFTP()
|
|
* @var array
|
|
* @access private
|
|
*/
|
|
var $packet_types = array();
|
|
|
|
/**
|
|
* Status Codes
|
|
*
|
|
* @see self::Net_SFTP()
|
|
* @var array
|
|
* @access private
|
|
*/
|
|
var $status_codes = array();
|
|
|
|
/**
|
|
* The Request ID
|
|
*
|
|
* The request ID exists in the off chance that a packet is sent out-of-order. Of course, this library doesn't support
|
|
* concurrent actions, so it's somewhat academic, here.
|
|
*
|
|
* @var boolean
|
|
* @see self::_send_sftp_packet()
|
|
* @access private
|
|
*/
|
|
var $use_request_id = false;
|
|
|
|
/**
|
|
* The Packet Type
|
|
*
|
|
* The request ID exists in the off chance that a packet is sent out-of-order. Of course, this library doesn't support
|
|
* concurrent actions, so it's somewhat academic, here.
|
|
*
|
|
* @var int
|
|
* @see self::_get_sftp_packet()
|
|
* @access private
|
|
*/
|
|
var $packet_type = -1;
|
|
|
|
/**
|
|
* Packet Buffer
|
|
*
|
|
* @var string
|
|
* @see self::_get_sftp_packet()
|
|
* @access private
|
|
*/
|
|
var $packet_buffer = '';
|
|
|
|
/**
|
|
* Extensions supported by the server
|
|
*
|
|
* @var array
|
|
* @see self::_initChannel()
|
|
* @access private
|
|
*/
|
|
var $extensions = array();
|
|
|
|
/**
|
|
* Server SFTP version
|
|
*
|
|
* @var int
|
|
* @see self::_initChannel()
|
|
* @access private
|
|
*/
|
|
var $version;
|
|
|
|
/**
|
|
* Default Server SFTP version
|
|
*
|
|
* @var int
|
|
* @see self::_initChannel()
|
|
* @access private
|
|
*/
|
|
var $defaultVersion;
|
|
|
|
/**
|
|
* Preferred SFTP version
|
|
*
|
|
* @var int
|
|
* @see self::_initChannel()
|
|
* @access private
|
|
*/
|
|
var $preferredVersion = 3;
|
|
|
|
/**
|
|
* Current working directory
|
|
*
|
|
* @var string
|
|
* @see self::realpath()
|
|
* @see self::chdir()
|
|
* @access private
|
|
*/
|
|
var $pwd = false;
|
|
|
|
/**
|
|
* Packet Type Log
|
|
*
|
|
* @see self::getLog()
|
|
* @var array
|
|
* @access private
|
|
*/
|
|
var $packet_type_log = array();
|
|
|
|
/**
|
|
* Packet Log
|
|
*
|
|
* @see self::getLog()
|
|
* @var array
|
|
* @access private
|
|
*/
|
|
var $packet_log = array();
|
|
|
|
/**
|
|
* Error information
|
|
*
|
|
* @see self::getSFTPErrors()
|
|
* @see self::getLastSFTPError()
|
|
* @var array
|
|
* @access private
|
|
*/
|
|
var $sftp_errors = array();
|
|
|
|
/**
|
|
* Stat Cache
|
|
*
|
|
* Rather than always having to open a directory and close it immediately there after to see if a file is a directory
|
|
* we'll cache the results.
|
|
*
|
|
* @see self::_update_stat_cache()
|
|
* @see self::_remove_from_stat_cache()
|
|
* @see self::_query_stat_cache()
|
|
* @var array
|
|
* @access private
|
|
*/
|
|
var $stat_cache = array();
|
|
|
|
/**
|
|
* Max SFTP Packet Size
|
|
*
|
|
* @see self::Net_SFTP()
|
|
* @see self::get()
|
|
* @var array
|
|
* @access private
|
|
*/
|
|
var $max_sftp_packet;
|
|
|
|
/**
|
|
* Stat Cache Flag
|
|
*
|
|
* @see self::disableStatCache()
|
|
* @see self::enableStatCache()
|
|
* @var bool
|
|
* @access private
|
|
*/
|
|
var $use_stat_cache = true;
|
|
|
|
/**
|
|
* Sort Options
|
|
*
|
|
* @see self::_comparator()
|
|
* @see self::setListOrder()
|
|
* @var array
|
|
* @access private
|
|
*/
|
|
var $sortOptions = array();
|
|
|
|
/**
|
|
* Canonicalization Flag
|
|
*
|
|
* Determines whether or not paths should be canonicalized before being
|
|
* passed on to the remote server.
|
|
*
|
|
* @see self::enablePathCanonicalization()
|
|
* @see self::disablePathCanonicalization()
|
|
* @see self::realpath()
|
|
* @var bool
|
|
* @access private
|
|
*/
|
|
var $canonicalize_paths = true;
|
|
|
|
/**
|
|
* Request Buffers
|
|
*
|
|
* @see self::_get_sftp_packet()
|
|
* @var array
|
|
* @access private
|
|
*/
|
|
var $requestBuffer = array();
|
|
|
|
/**
|
|
* Preserve timestamps on file downloads / uploads
|
|
*
|
|
* @see self::get()
|
|
* @see self::put()
|
|
* @var bool
|
|
* @access private
|
|
*/
|
|
var $preserveTime = false;
|
|
|
|
/**
|
|
* Arbitrary Length Packets Flag
|
|
*
|
|
* Determines whether or not packets of any length should be allowed,
|
|
* in cases where the server chooses the packet length (such as
|
|
* directory listings). By default, packets are only allowed to be
|
|
* 256 * 1024 bytes (SFTP_MAX_MSG_LENGTH from OpenSSH's sftp-common.h)
|
|
*
|
|
* @see self::enableArbitraryLengthPackets()
|
|
* @see self::_get_sftp_packet()
|
|
* @var bool
|
|
* @access private
|
|
*/
|
|
var $allow_arbitrary_length_packets = false;
|
|
|
|
/**
|
|
* Was the last packet due to the channels being closed or not?
|
|
*
|
|
* @see self::get()
|
|
* @see self::get_sftp_packet()
|
|
* @var bool
|
|
* @access private
|
|
*/
|
|
var $channel_close = false;
|
|
|
|
/**
|
|
* Has the SFTP channel been partially negotiated?
|
|
*
|
|
* @var bool
|
|
* @access private
|
|
*/
|
|
var $partial_init = false;
|
|
|
|
/**
|
|
* Default Constructor.
|
|
*
|
|
* Connects to an SFTP server
|
|
*
|
|
* @param string $host
|
|
* @param int $port
|
|
* @param int $timeout
|
|
* @return Net_SFTP
|
|
* @access public
|
|
*/
|
|
function __construct($host, $port = 22, $timeout = 10)
|
|
{
|
|
parent::__construct($host, $port, $timeout);
|
|
|
|
$this->max_sftp_packet = 1 << 15;
|
|
|
|
$this->packet_types = array(
|
|
1 => 'NET_SFTP_INIT',
|
|
2 => 'NET_SFTP_VERSION',
|
|
3 => 'NET_SFTP_OPEN',
|
|
4 => 'NET_SFTP_CLOSE',
|
|
5 => 'NET_SFTP_READ',
|
|
6 => 'NET_SFTP_WRITE',
|
|
7 => 'NET_SFTP_LSTAT',
|
|
9 => 'NET_SFTP_SETSTAT',
|
|
10 => 'NET_SFTP_FSETSTAT',
|
|
11 => 'NET_SFTP_OPENDIR',
|
|
12 => 'NET_SFTP_READDIR',
|
|
13 => 'NET_SFTP_REMOVE',
|
|
14 => 'NET_SFTP_MKDIR',
|
|
15 => 'NET_SFTP_RMDIR',
|
|
16 => 'NET_SFTP_REALPATH',
|
|
17 => 'NET_SFTP_STAT',
|
|
18 => 'NET_SFTP_RENAME',
|
|
19 => 'NET_SFTP_READLINK',
|
|
20 => 'NET_SFTP_SYMLINK',
|
|
21 => 'NET_SFTP_LINK',
|
|
|
|
101=> 'NET_SFTP_STATUS',
|
|
102=> 'NET_SFTP_HANDLE',
|
|
103=> 'NET_SFTP_DATA',
|
|
104=> 'NET_SFTP_NAME',
|
|
105=> 'NET_SFTP_ATTRS',
|
|
|
|
200=> 'NET_SFTP_EXTENDED'
|
|
);
|
|
$this->status_codes = array(
|
|
0 => 'NET_SFTP_STATUS_OK',
|
|
1 => 'NET_SFTP_STATUS_EOF',
|
|
2 => 'NET_SFTP_STATUS_NO_SUCH_FILE',
|
|
3 => 'NET_SFTP_STATUS_PERMISSION_DENIED',
|
|
4 => 'NET_SFTP_STATUS_FAILURE',
|
|
5 => 'NET_SFTP_STATUS_BAD_MESSAGE',
|
|
6 => 'NET_SFTP_STATUS_NO_CONNECTION',
|
|
7 => 'NET_SFTP_STATUS_CONNECTION_LOST',
|
|
8 => 'NET_SFTP_STATUS_OP_UNSUPPORTED',
|
|
9 => 'NET_SFTP_STATUS_INVALID_HANDLE',
|
|
10 => 'NET_SFTP_STATUS_NO_SUCH_PATH',
|
|
11 => 'NET_SFTP_STATUS_FILE_ALREADY_EXISTS',
|
|
12 => 'NET_SFTP_STATUS_WRITE_PROTECT',
|
|
13 => 'NET_SFTP_STATUS_NO_MEDIA',
|
|
14 => 'NET_SFTP_STATUS_NO_SPACE_ON_FILESYSTEM',
|
|
15 => 'NET_SFTP_STATUS_QUOTA_EXCEEDED',
|
|
16 => 'NET_SFTP_STATUS_UNKNOWN_PRINCIPAL',
|
|
17 => 'NET_SFTP_STATUS_LOCK_CONFLICT',
|
|
18 => 'NET_SFTP_STATUS_DIR_NOT_EMPTY',
|
|
19 => 'NET_SFTP_STATUS_NOT_A_DIRECTORY',
|
|
20 => 'NET_SFTP_STATUS_INVALID_FILENAME',
|
|
21 => 'NET_SFTP_STATUS_LINK_LOOP',
|
|
22 => 'NET_SFTP_STATUS_CANNOT_DELETE',
|
|
23 => 'NET_SFTP_STATUS_INVALID_PARAMETER',
|
|
24 => 'NET_SFTP_STATUS_FILE_IS_A_DIRECTORY',
|
|
25 => 'NET_SFTP_STATUS_BYTE_RANGE_LOCK_CONFLICT',
|
|
26 => 'NET_SFTP_STATUS_BYTE_RANGE_LOCK_REFUSED',
|
|
27 => 'NET_SFTP_STATUS_DELETE_PENDING',
|
|
28 => 'NET_SFTP_STATUS_FILE_CORRUPT',
|
|
29 => 'NET_SFTP_STATUS_OWNER_INVALID',
|
|
30 => 'NET_SFTP_STATUS_GROUP_INVALID',
|
|
31 => 'NET_SFTP_STATUS_NO_MATCHING_BYTE_RANGE_LOCK'
|
|
);
|
|
// http://tools.ietf.org/html/draft-ietf-secsh-filexfer-13#section-7.1
|
|
// the order, in this case, matters quite a lot - see Net_SFTP::_parseAttributes() to understand why
|
|
$this->attributes = array(
|
|
0x00000001 => 'NET_SFTP_ATTR_SIZE',
|
|
0x00000002 => 'NET_SFTP_ATTR_UIDGID', // defined in SFTPv3, removed in SFTPv4+
|
|
0x00000080 => 'NET_SFTP_ATTR_OWNERGROUP', // defined in SFTPv4+
|
|
0x00000004 => 'NET_SFTP_ATTR_PERMISSIONS',
|
|
0x00000008 => 'NET_SFTP_ATTR_ACCESSTIME',
|
|
0x00000010 => 'NET_SFTP_ATTR_CREATETIME', // SFTPv4+
|
|
0x00000020 => 'NET_SFTP_ATTR_MODIFYTIME',
|
|
0x00000040 => 'NET_SFTP_ATTR_ACL',
|
|
0x00000100 => 'NET_SFTP_ATTR_SUBSECOND_TIMES',
|
|
0x00000200 => 'NET_SFTP_ATTR_BITS', // SFTPv5+
|
|
0x00000400 => 'NET_SFTP_ATTR_ALLOCATION_SIZE', // SFTPv6+
|
|
0x00000800 => 'NET_SFTP_ATTR_TEXT_HINT',
|
|
0x00001000 => 'NET_SFTP_ATTR_MIME_TYPE',
|
|
0x00002000 => 'NET_SFTP_ATTR_LINK_COUNT',
|
|
0x00004000 => 'NET_SFTP_ATTR_UNTRANSLATED_NAME',
|
|
0x00008000 => 'NET_SFTP_ATTR_CTIME',
|
|
// 0x80000000 will yield a floating point on 32-bit systems and converting floating points to integers
|
|
// yields inconsistent behavior depending on how php is compiled. so we left shift -1 (which, in
|
|
// two's compliment, consists of all 1 bits) by 31. on 64-bit systems this'll yield 0xFFFFFFFF80000000.
|
|
// that's not a problem, however, and 'anded' and a 32-bit number, as all the leading 1 bits are ignored.
|
|
(-1 << 31) & 0xFFFFFFFF => 'NET_SFTP_ATTR_EXTENDED'
|
|
);
|
|
$this->open_flags = array(
|
|
0x00000001 => 'NET_SFTP_OPEN_READ',
|
|
0x00000002 => 'NET_SFTP_OPEN_WRITE',
|
|
0x00000004 => 'NET_SFTP_OPEN_APPEND',
|
|
0x00000008 => 'NET_SFTP_OPEN_CREATE',
|
|
0x00000010 => 'NET_SFTP_OPEN_TRUNCATE',
|
|
0x00000020 => 'NET_SFTP_OPEN_EXCL',
|
|
0x00000040 => 'NET_SFTP_OPEN_TEXT' // defined in SFTPv4
|
|
);
|
|
// SFTPv5+ changed the flags up:
|
|
// https://datatracker.ietf.org/doc/html/draft-ietf-secsh-filexfer-13#section-8.1.1.3
|
|
$this->open_flags5 = array(
|
|
// when SSH_FXF_ACCESS_DISPOSITION is a 3 bit field that controls how the file is opened
|
|
0x00000000 => 'NET_SFTP_OPEN_CREATE_NEW',
|
|
0x00000001 => 'NET_SFTP_OPEN_CREATE_TRUNCATE',
|
|
0x00000002 => 'NET_SFTP_OPEN_OPEN_EXISTING',
|
|
0x00000003 => 'NET_SFTP_OPEN_OPEN_OR_CREATE',
|
|
0x00000004 => 'NET_SFTP_OPEN_TRUNCATE_EXISTING',
|
|
// the rest of the flags are not supported
|
|
0x00000008 => 'NET_SFTP_OPEN_APPEND_DATA', // "the offset field of SS_FXP_WRITE requests is ignored"
|
|
0x00000010 => 'NET_SFTP_OPEN_APPEND_DATA_ATOMIC',
|
|
0x00000020 => 'NET_SFTP_OPEN_TEXT_MODE',
|
|
0x00000040 => 'NET_SFTP_OPEN_BLOCK_READ',
|
|
0x00000080 => 'NET_SFTP_OPEN_BLOCK_WRITE',
|
|
0x00000100 => 'NET_SFTP_OPEN_BLOCK_DELETE',
|
|
0x00000200 => 'NET_SFTP_OPEN_BLOCK_ADVISORY',
|
|
0x00000400 => 'NET_SFTP_OPEN_NOFOLLOW',
|
|
0x00000800 => 'NET_SFTP_OPEN_DELETE_ON_CLOSE',
|
|
0x00001000 => 'NET_SFTP_OPEN_ACCESS_AUDIT_ALARM_INFO',
|
|
0x00002000 => 'NET_SFTP_OPEN_ACCESS_BACKUP',
|
|
0x00004000 => 'NET_SFTP_OPEN_BACKUP_STREAM',
|
|
0x00008000 => 'NET_SFTP_OPEN_OVERRIDE_OWNER',
|
|
);
|
|
// http://tools.ietf.org/html/draft-ietf-secsh-filexfer-04#section-5.2
|
|
// see Net_SFTP::_parseLongname() for an explanation
|
|
$this->file_types = array(
|
|
1 => 'NET_SFTP_TYPE_REGULAR',
|
|
2 => 'NET_SFTP_TYPE_DIRECTORY',
|
|
3 => 'NET_SFTP_TYPE_SYMLINK',
|
|
4 => 'NET_SFTP_TYPE_SPECIAL',
|
|
5 => 'NET_SFTP_TYPE_UNKNOWN',
|
|
// the followin types were first defined for use in SFTPv5+
|
|
// http://tools.ietf.org/html/draft-ietf-secsh-filexfer-05#section-5.2
|
|
6 => 'NET_SFTP_TYPE_SOCKET',
|
|
7 => 'NET_SFTP_TYPE_CHAR_DEVICE',
|
|
8 => 'NET_SFTP_TYPE_BLOCK_DEVICE',
|
|
9 => 'NET_SFTP_TYPE_FIFO'
|
|
);
|
|
$this->_define_array(
|
|
$this->packet_types,
|
|
$this->status_codes,
|
|
$this->attributes,
|
|
$this->open_flags,
|
|
$this->open_flags5,
|
|
$this->file_types
|
|
);
|
|
|
|
if (!defined('NET_SFTP_QUEUE_SIZE')) {
|
|
define('NET_SFTP_QUEUE_SIZE', 32);
|
|
}
|
|
if (!defined('NET_SFTP_UPLOAD_QUEUE_SIZE')) {
|
|
define('NET_SFTP_UPLOAD_QUEUE_SIZE', 1024);
|
|
}
|
|
}
|
|
|
|
/**
|
|
* PHP4 compatible Default Constructor.
|
|
*
|
|
* @see self::__construct()
|
|
* @param string $host
|
|
* @param int $port
|
|
* @param int $timeout
|
|
* @access public
|
|
*/
|
|
function Net_SFTP($host, $port = 22, $timeout = 10)
|
|
{
|
|
$this->__construct($host, $port, $timeout);
|
|
}
|
|
|
|
/**
|
|
* Check a few things before SFTP functions are called
|
|
*
|
|
* @return bool
|
|
* @access public
|
|
*/
|
|
function _precheck()
|
|
{
|
|
if (!($this->bitmap & NET_SSH2_MASK_LOGIN)) {
|
|
return false;
|
|
}
|
|
|
|
if ($this->pwd === false) {
|
|
return $this->_init_sftp_connection();
|
|
}
|
|
|
|
return true;
|
|
}
|
|
|
|
/**
|
|
* Partially initialize an SFTP connection
|
|
*
|
|
* @return bool
|
|
* @access public
|
|
*/
|
|
function _partial_init_sftp_connection()
|
|
{
|
|
$this->window_size_server_to_client[NET_SFTP_CHANNEL] = $this->window_size;
|
|
|
|
$packet = pack(
|
|
'CNa*N3',
|
|
NET_SSH2_MSG_CHANNEL_OPEN,
|
|
strlen('session'),
|
|
'session',
|
|
NET_SFTP_CHANNEL,
|
|
$this->window_size,
|
|
0x4000
|
|
);
|
|
|
|
if (!$this->_send_binary_packet($packet)) {
|
|
return false;
|
|
}
|
|
|
|
$this->channel_status[NET_SFTP_CHANNEL] = NET_SSH2_MSG_CHANNEL_OPEN;
|
|
|
|
$response = $this->_get_channel_packet(NET_SFTP_CHANNEL, true);
|
|
if ($response === false) {
|
|
return false;
|
|
} elseif ($response === true && $this->isTimeout()) {
|
|
return false;
|
|
}
|
|
|
|
$packet = pack(
|
|
'CNNa*CNa*',
|
|
NET_SSH2_MSG_CHANNEL_REQUEST,
|
|
$this->server_channels[NET_SFTP_CHANNEL],
|
|
strlen('subsystem'),
|
|
'subsystem',
|
|
1,
|
|
strlen('sftp'),
|
|
'sftp'
|
|
);
|
|
if (!$this->_send_binary_packet($packet)) {
|
|
return false;
|
|
}
|
|
|
|
$this->channel_status[NET_SFTP_CHANNEL] = NET_SSH2_MSG_CHANNEL_REQUEST;
|
|
|
|
$response = $this->_get_channel_packet(NET_SFTP_CHANNEL, true);
|
|
if ($response === false) {
|
|
// from PuTTY's psftp.exe
|
|
$command = "test -x /usr/lib/sftp-server && exec /usr/lib/sftp-server\n" .
|
|
"test -x /usr/local/lib/sftp-server && exec /usr/local/lib/sftp-server\n" .
|
|
"exec sftp-server";
|
|
// we don't do $this->exec($command, false) because exec() operates on a different channel and plus the SSH_MSG_CHANNEL_OPEN that exec() does
|
|
// is redundant
|
|
$packet = pack(
|
|
'CNNa*CNa*',
|
|
NET_SSH2_MSG_CHANNEL_REQUEST,
|
|
$this->server_channels[NET_SFTP_CHANNEL],
|
|
strlen('exec'),
|
|
'exec',
|
|
1,
|
|
strlen($command),
|
|
$command
|
|
);
|
|
if (!$this->_send_binary_packet($packet)) {
|
|
return false;
|
|
}
|
|
|
|
$this->channel_status[NET_SFTP_CHANNEL] = NET_SSH2_MSG_CHANNEL_REQUEST;
|
|
|
|
$response = $this->_get_channel_packet(NET_SFTP_CHANNEL, true);
|
|
if ($response === false) {
|
|
return false;
|
|
}
|
|
} elseif ($response === true && $this->isTimeout()) {
|
|
return false;
|
|
}
|
|
|
|
$this->channel_status[NET_SFTP_CHANNEL] = NET_SSH2_MSG_CHANNEL_DATA;
|
|
|
|
if (!$this->_send_sftp_packet(NET_SFTP_INIT, "\0\0\0\3")) {
|
|
return false;
|
|
}
|
|
|
|
$response = $this->_get_sftp_packet();
|
|
if ($this->packet_type != NET_SFTP_VERSION) {
|
|
user_error('Expected SSH_FXP_VERSION');
|
|
return false;
|
|
}
|
|
|
|
$this->use_request_id = true;
|
|
|
|
if (strlen($response) < 4) {
|
|
return false;
|
|
}
|
|
extract(unpack('Nversion', $this->_string_shift($response, 4)));
|
|
$this->defaultVersion = $version;
|
|
while (!empty($response)) {
|
|
if (strlen($response) < 4) {
|
|
return false;
|
|
}
|
|
extract(unpack('Nlength', $this->_string_shift($response, 4)));
|
|
$key = $this->_string_shift($response, $length);
|
|
if (strlen($response) < 4) {
|
|
return false;
|
|
}
|
|
extract(unpack('Nlength', $this->_string_shift($response, 4)));
|
|
$value = $this->_string_shift($response, $length);
|
|
$this->extensions[$key] = $value;
|
|
}
|
|
|
|
$this->partial_init = true;
|
|
|
|
return true;
|
|
}
|
|
|
|
/**
|
|
* (Re)initializes the SFTP channel
|
|
*
|
|
* @return bool
|
|
* @access private
|
|
*/
|
|
function _init_sftp_connection()
|
|
{
|
|
if (!$this->partial_init && !$this->_partial_init_sftp_connection()) {
|
|
return false;
|
|
}
|
|
|
|
/*
|
|
A Note on SFTPv4/5/6 support:
|
|
<http://tools.ietf.org/html/draft-ietf-secsh-filexfer-13#section-5.1> states the following:
|
|
|
|
"If the client wishes to interoperate with servers that support noncontiguous version
|
|
numbers it SHOULD send '3'"
|
|
|
|
Given that the server only sends its version number after the client has already done so, the above
|
|
seems to be suggesting that v3 should be the default version. This makes sense given that v3 is the
|
|
most popular.
|
|
|
|
<http://tools.ietf.org/html/draft-ietf-secsh-filexfer-13#section-5.5> states the following;
|
|
|
|
"If the server did not send the "versions" extension, or the version-from-list was not included, the
|
|
server MAY send a status response describing the failure, but MUST then close the channel without
|
|
processing any further requests."
|
|
|
|
So what do you do if you have a client whose initial SSH_FXP_INIT packet says it implements v3 and
|
|
a server whose initial SSH_FXP_VERSION reply says it implements v4 and only v4? If it only implements
|
|
v4, the "versions" extension is likely not going to have been sent so version re-negotiation as discussed
|
|
in draft-ietf-secsh-filexfer-13 would be quite impossible. As such, what Net_SFTP would do is close the
|
|
channel and reopen it with a new and updated SSH_FXP_INIT packet.
|
|
*/
|
|
$this->version = $this->defaultVersion;
|
|
if (isset($this->extensions['versions']) && (!$this->preferredVersion || $this->preferredVersion != $this->version)) {
|
|
$versions = explode(',', $this->extensions['versions']);
|
|
$supported = array(6, 5, 4);
|
|
if ($this->preferredVersion) {
|
|
$supported = array_diff($supported, array($this->preferredVersion));
|
|
array_unshift($supported, $this->preferredVersion);
|
|
}
|
|
foreach ($supported as $ver) {
|
|
if (in_array($ver, $versions)) {
|
|
if ($ver === $this->version) {
|
|
break;
|
|
}
|
|
$this->version = (int) $ver;
|
|
$packet = pack('Na*Na*', strlen('version-select'), 'version-select', strlen($ver), $ver);
|
|
if (!$this->_send_sftp_packet(NET_SFTP_EXTENDED, $packet)) {
|
|
return false;
|
|
}
|
|
$response = $this->_get_sftp_packet();
|
|
if ($this->packet_type != NET_SFTP_STATUS) {
|
|
user_error('Expected SSH_FXP_STATUS');
|
|
return false;
|
|
}
|
|
|
|
if (strlen($response) < 4) {
|
|
return false;
|
|
}
|
|
extract(unpack('Nstatus', $this->_string_shift($response, 4)));
|
|
if ($status != NET_SFTP_STATUS_OK) {
|
|
$this->_logError($response, $status);
|
|
return false;
|
|
}
|
|
|
|
break;
|
|
}
|
|
}
|
|
}
|
|
|
|
/*
|
|
SFTPv4+ defines a 'newline' extension. SFTPv3 seems to have unofficial support for it via 'newline@vandyke.com',
|
|
however, I'm not sure what 'newline@vandyke.com' is supposed to do (the fact that it's unofficial means that it's
|
|
not in the official SFTPv3 specs) and 'newline@vandyke.com' / 'newline' are likely not drop-in substitutes for
|
|
one another due to the fact that 'newline' comes with a SSH_FXF_TEXT bitmask whereas it seems unlikely that
|
|
'newline@vandyke.com' would.
|
|
*/
|
|
/*
|
|
if (isset($this->extensions['newline@vandyke.com'])) {
|
|
$this->extensions['newline'] = $this->extensions['newline@vandyke.com'];
|
|
unset($this->extensions['newline@vandyke.com']);
|
|
}
|
|
*/
|
|
|
|
if ($this->version < 2 || $this->version > 6) {
|
|
return false;
|
|
}
|
|
|
|
$this->pwd = $this->_realpath('.');
|
|
|
|
$this->_update_stat_cache($this->pwd, array());
|
|
|
|
return true;
|
|
}
|
|
|
|
/**
|
|
* Disable the stat cache
|
|
*
|
|
* @access public
|
|
*/
|
|
function disableStatCache()
|
|
{
|
|
$this->use_stat_cache = false;
|
|
}
|
|
|
|
/**
|
|
* Enable the stat cache
|
|
*
|
|
* @access public
|
|
*/
|
|
function enableStatCache()
|
|
{
|
|
$this->use_stat_cache = true;
|
|
}
|
|
|
|
/**
|
|
* Clear the stat cache
|
|
*
|
|
* @access public
|
|
*/
|
|
function clearStatCache()
|
|
{
|
|
$this->stat_cache = array();
|
|
}
|
|
|
|
/**
|
|
* Enable path canonicalization
|
|
*
|
|
* @access public
|
|
*/
|
|
function enablePathCanonicalization()
|
|
{
|
|
$this->canonicalize_paths = true;
|
|
}
|
|
|
|
/**
|
|
* Enable path canonicalization
|
|
*
|
|
* @access public
|
|
*/
|
|
function disablePathCanonicalization()
|
|
{
|
|
$this->canonicalize_paths = false;
|
|
}
|
|
|
|
/**
|
|
* Enable arbitrary length packets
|
|
*
|
|
* @access public
|
|
*/
|
|
function enableArbitraryLengthPackets()
|
|
{
|
|
$this->allow_arbitrary_length_packets = true;
|
|
}
|
|
|
|
/**
|
|
* Disable arbitrary length packets
|
|
*
|
|
* @access public
|
|
*/
|
|
function disableArbitraryLengthPackets()
|
|
{
|
|
$this->allow_arbitrary_length_packets = false;
|
|
}
|
|
|
|
/**
|
|
* Returns the current directory name
|
|
*
|
|
* @return mixed
|
|
* @access public
|
|
*/
|
|
function pwd()
|
|
{
|
|
if (!$this->_precheck()) {
|
|
return false;
|
|
}
|
|
|
|
return $this->pwd;
|
|
}
|
|
|
|
/**
|
|
* Logs errors
|
|
*
|
|
* @param string $response
|
|
* @param int $status
|
|
* @access public
|
|
*/
|
|
function _logError($response, $status = -1)
|
|
{
|
|
if ($status == -1) {
|
|
if (strlen($response) < 4) {
|
|
return;
|
|
}
|
|
extract(unpack('Nstatus', $this->_string_shift($response, 4)));
|
|
}
|
|
|
|
$error = $this->status_codes[$status];
|
|
|
|
if ($this->version > 2 || strlen($response) < 4) {
|
|
extract(unpack('Nlength', $this->_string_shift($response, 4)));
|
|
$this->sftp_errors[] = $error . ': ' . $this->_string_shift($response, $length);
|
|
} else {
|
|
$this->sftp_errors[] = $error;
|
|
}
|
|
}
|
|
|
|
/**
|
|
* Returns canonicalized absolute pathname
|
|
*
|
|
* realpath() expands all symbolic links and resolves references to '/./', '/../' and extra '/' characters in the input
|
|
* path and returns the canonicalized absolute pathname.
|
|
*
|
|
* @param string $path
|
|
* @return mixed
|
|
* @access public
|
|
*/
|
|
function realpath($path)
|
|
{
|
|
if (!$this->_precheck()) {
|
|
return false;
|
|
}
|
|
|
|
return $this->_realpath($path);
|
|
}
|
|
|
|
/**
|
|
* Canonicalize the Server-Side Path Name
|
|
*
|
|
* SFTP doesn't provide a mechanism by which the current working directory can be changed, so we'll emulate it. Returns
|
|
* the absolute (canonicalized) path.
|
|
*
|
|
* If canonicalize_paths has been disabled using disablePathCanonicalization(), $path is returned as-is.
|
|
*
|
|
* @see self::chdir()
|
|
* @see self::disablePathCanonicalization()
|
|
* @param string $path
|
|
* @return mixed
|
|
* @access private
|
|
*/
|
|
function _realpath($path)
|
|
{
|
|
if (!$this->canonicalize_paths) {
|
|
return $path;
|
|
}
|
|
|
|
if ($this->pwd === false) {
|
|
// http://tools.ietf.org/html/draft-ietf-secsh-filexfer-13#section-8.9
|
|
if (!$this->_send_sftp_packet(NET_SFTP_REALPATH, pack('Na*', strlen($path), $path))) {
|
|
return false;
|
|
}
|
|
|
|
$response = $this->_get_sftp_packet();
|
|
switch ($this->packet_type) {
|
|
case NET_SFTP_NAME:
|
|
// although SSH_FXP_NAME is implemented differently in SFTPv3 than it is in SFTPv4+, the following
|
|
// should work on all SFTP versions since the only part of the SSH_FXP_NAME packet the following looks
|
|
// at is the first part and that part is defined the same in SFTP versions 3 through 6.
|
|
$this->_string_shift($response, 4); // skip over the count - it should be 1, anyway
|
|
if (strlen($response) < 4) {
|
|
return false;
|
|
}
|
|
extract(unpack('Nlength', $this->_string_shift($response, 4)));
|
|
return $this->_string_shift($response, $length);
|
|
case NET_SFTP_STATUS:
|
|
$this->_logError($response);
|
|
return false;
|
|
default:
|
|
user_error('Expected SSH_FXP_NAME or SSH_FXP_STATUS');
|
|
return false;
|
|
}
|
|
}
|
|
|
|
if (!strlen($path) || $path[0] != '/') {
|
|
$path = $this->pwd . '/' . $path;
|
|
}
|
|
|
|
$path = explode('/', $path);
|
|
$new = array();
|
|
foreach ($path as $dir) {
|
|
if (!strlen($dir)) {
|
|
continue;
|
|
}
|
|
switch ($dir) {
|
|
case '..':
|
|
array_pop($new);
|
|
case '.':
|
|
break;
|
|
default:
|
|
$new[] = $dir;
|
|
}
|
|
}
|
|
|
|
return '/' . implode('/', $new);
|
|
}
|
|
|
|
/**
|
|
* Changes the current directory
|
|
*
|
|
* @param string $dir
|
|
* @return bool
|
|
* @access public
|
|
*/
|
|
function chdir($dir)
|
|
{
|
|
if (!$this->_precheck()) {
|
|
return false;
|
|
}
|
|
|
|
// assume current dir if $dir is empty
|
|
if ($dir === '') {
|
|
$dir = './';
|
|
// suffix a slash if needed
|
|
} elseif ($dir[strlen($dir) - 1] != '/') {
|
|
$dir.= '/';
|
|
}
|
|
|
|
$dir = $this->_realpath($dir);
|
|
|
|
// confirm that $dir is, in fact, a valid directory
|
|
if ($this->use_stat_cache && is_array($this->_query_stat_cache($dir))) {
|
|
$this->pwd = $dir;
|
|
return true;
|
|
}
|
|
|
|
// we could do a stat on the alleged $dir to see if it's a directory but that doesn't tell us
|
|
// the currently logged in user has the appropriate permissions or not. maybe you could see if
|
|
// the file's uid / gid match the currently logged in user's uid / gid but how there's no easy
|
|
// way to get those with SFTP
|
|
|
|
if (!$this->_send_sftp_packet(NET_SFTP_OPENDIR, pack('Na*', strlen($dir), $dir))) {
|
|
return false;
|
|
}
|
|
|
|
// see Net_SFTP::nlist() for a more thorough explanation of the following
|
|
$response = $this->_get_sftp_packet();
|
|
switch ($this->packet_type) {
|
|
case NET_SFTP_HANDLE:
|
|
$handle = substr($response, 4);
|
|
break;
|
|
case NET_SFTP_STATUS:
|
|
$this->_logError($response);
|
|
return false;
|
|
default:
|
|
user_error('Expected SSH_FXP_HANDLE or SSH_FXP_STATUS');
|
|
return false;
|
|
}
|
|
|
|
if (!$this->_close_handle($handle)) {
|
|
return false;
|
|
}
|
|
|
|
$this->_update_stat_cache($dir, array());
|
|
|
|
$this->pwd = $dir;
|
|
return true;
|
|
}
|
|
|
|
/**
|
|
* Returns a list of files in the given directory
|
|
*
|
|
* @param string $dir
|
|
* @param bool $recursive
|
|
* @return mixed
|
|
* @access public
|
|
*/
|
|
function nlist($dir = '.', $recursive = false)
|
|
{
|
|
return $this->_nlist_helper($dir, $recursive, '');
|
|
}
|
|
|
|
/**
|
|
* Helper method for nlist
|
|
*
|
|
* @param string $dir
|
|
* @param bool $recursive
|
|
* @param string $relativeDir
|
|
* @return mixed
|
|
* @access private
|
|
*/
|
|
function _nlist_helper($dir, $recursive, $relativeDir)
|
|
{
|
|
$files = $this->_list($dir, false);
|
|
|
|
if (!$recursive || $files === false) {
|
|
return $files;
|
|
}
|
|
|
|
$result = array();
|
|
foreach ($files as $value) {
|
|
if ($value == '.' || $value == '..') {
|
|
if ($relativeDir == '') {
|
|
$result[] = $value;
|
|
}
|
|
continue;
|
|
}
|
|
if (is_array($this->_query_stat_cache($this->_realpath($dir . '/' . $value)))) {
|
|
$temp = $this->_nlist_helper($dir . '/' . $value, true, $relativeDir . $value . '/');
|
|
$temp = is_array($temp) ? $temp : array();
|
|
$result = array_merge($result, $temp);
|
|
} else {
|
|
$result[] = $relativeDir . $value;
|
|
}
|
|
}
|
|
|
|
return $result;
|
|
}
|
|
|
|
/**
|
|
* Returns a detailed list of files in the given directory
|
|
*
|
|
* @param string $dir
|
|
* @param bool $recursive
|
|
* @return mixed
|
|
* @access public
|
|
*/
|
|
function rawlist($dir = '.', $recursive = false)
|
|
{
|
|
$files = $this->_list($dir, true);
|
|
if (!$recursive || $files === false) {
|
|
return $files;
|
|
}
|
|
|
|
static $depth = 0;
|
|
|
|
foreach ($files as $key => $value) {
|
|
if ($depth != 0 && $key == '..') {
|
|
unset($files[$key]);
|
|
continue;
|
|
}
|
|
$is_directory = false;
|
|
if ($key != '.' && $key != '..') {
|
|
if ($this->use_stat_cache) {
|
|
$is_directory = is_array($this->_query_stat_cache($this->_realpath($dir . '/' . $key)));
|
|
} else {
|
|
$stat = $this->lstat($dir . '/' . $key);
|
|
$is_directory = $stat && $stat['type'] === NET_SFTP_TYPE_DIRECTORY;
|
|
}
|
|
}
|
|
|
|
if ($is_directory) {
|
|
$depth++;
|
|
$files[$key] = $this->rawlist($dir . '/' . $key, true);
|
|
$depth--;
|
|
} else {
|
|
$files[$key] = (object) $value;
|
|
}
|
|
}
|
|
|
|
return $files;
|
|
}
|
|
|
|
/**
|
|
* Reads a list, be it detailed or not, of files in the given directory
|
|
*
|
|
* @param string $dir
|
|
* @param bool $raw
|
|
* @return mixed
|
|
* @access private
|
|
*/
|
|
function _list($dir, $raw = true)
|
|
{
|
|
if (!$this->_precheck()) {
|
|
return false;
|
|
}
|
|
|
|
$dir = $this->_realpath($dir . '/');
|
|
if ($dir === false) {
|
|
return false;
|
|
}
|
|
|
|
// http://tools.ietf.org/html/draft-ietf-secsh-filexfer-13#section-8.1.2
|
|
if (!$this->_send_sftp_packet(NET_SFTP_OPENDIR, pack('Na*', strlen($dir), $dir))) {
|
|
return false;
|
|
}
|
|
|
|
$response = $this->_get_sftp_packet();
|
|
switch ($this->packet_type) {
|
|
case NET_SFTP_HANDLE:
|
|
// http://tools.ietf.org/html/draft-ietf-secsh-filexfer-13#section-9.2
|
|
// since 'handle' is the last field in the SSH_FXP_HANDLE packet, we'll just remove the first four bytes that
|
|
// represent the length of the string and leave it at that
|
|
$handle = substr($response, 4);
|
|
break;
|
|
case NET_SFTP_STATUS:
|
|
// presumably SSH_FX_NO_SUCH_FILE or SSH_FX_PERMISSION_DENIED
|
|
$this->_logError($response);
|
|
return false;
|
|
default:
|
|
user_error('Expected SSH_FXP_HANDLE or SSH_FXP_STATUS');
|
|
return false;
|
|
}
|
|
|
|
$this->_update_stat_cache($dir, array());
|
|
|
|
$contents = array();
|
|
while (true) {
|
|
// http://tools.ietf.org/html/draft-ietf-secsh-filexfer-13#section-8.2.2
|
|
// why multiple SSH_FXP_READDIR packets would be sent when the response to a single one can span arbitrarily many
|
|
// SSH_MSG_CHANNEL_DATA messages is not known to me.
|
|
if (!$this->_send_sftp_packet(NET_SFTP_READDIR, pack('Na*', strlen($handle), $handle))) {
|
|
return false;
|
|
}
|
|
|
|
$response = $this->_get_sftp_packet();
|
|
switch ($this->packet_type) {
|
|
case NET_SFTP_NAME:
|
|
if (strlen($response) < 4) {
|
|
return false;
|
|
}
|
|
extract(unpack('Ncount', $this->_string_shift($response, 4)));
|
|
for ($i = 0; $i < $count; $i++) {
|
|
if (strlen($response) < 4) {
|
|
return false;
|
|
}
|
|
extract(unpack('Nlength', $this->_string_shift($response, 4)));
|
|
$shortname = $this->_string_shift($response, $length);
|
|
// SFTPv4 "removed the long filename from the names structure-- it can now be
|
|
// built from information available in the attrs structure."
|
|
if ($this->version < 4) {
|
|
if (strlen($response) < 4) {
|
|
return false;
|
|
}
|
|
extract(unpack('Nlength', $this->_string_shift($response, 4)));
|
|
$longname = $this->_string_shift($response, $length);
|
|
}
|
|
$attributes = $this->_parseAttributes($response);
|
|
if (!isset($attributes['type']) && $this->version < 4) {
|
|
$fileType = $this->_parseLongname($longname);
|
|
if ($fileType) {
|
|
$attributes['type'] = $fileType;
|
|
}
|
|
}
|
|
$contents[$shortname] = $attributes + array('filename' => $shortname);
|
|
|
|
if (isset($attributes['type']) && $attributes['type'] == NET_SFTP_TYPE_DIRECTORY && ($shortname != '.' && $shortname != '..')) {
|
|
$this->_update_stat_cache($dir . '/' . $shortname, array());
|
|
} else {
|
|
if ($shortname == '..') {
|
|
$temp = $this->_realpath($dir . '/..') . '/.';
|
|
} else {
|
|
$temp = $dir . '/' . $shortname;
|
|
}
|
|
$this->_update_stat_cache($temp, (object) array('lstat' => $attributes));
|
|
}
|
|
// SFTPv6 has an optional boolean end-of-list field, but we'll ignore that, since the
|
|
// final SSH_FXP_STATUS packet should tell us that, already.
|
|
}
|
|
break;
|
|
case NET_SFTP_STATUS:
|
|
if (strlen($response) < 4) {
|
|
return false;
|
|
}
|
|
extract(unpack('Nstatus', $this->_string_shift($response, 4)));
|
|
if ($status != NET_SFTP_STATUS_EOF) {
|
|
$this->_logError($response, $status);
|
|
return false;
|
|
}
|
|
break 2;
|
|
default:
|
|
user_error('Expected SSH_FXP_NAME or SSH_FXP_STATUS');
|
|
return false;
|
|
}
|
|
}
|
|
|
|
if (!$this->_close_handle($handle)) {
|
|
return false;
|
|
}
|
|
|
|
if (count($this->sortOptions)) {
|
|
uasort($contents, array(&$this, '_comparator'));
|
|
}
|
|
|
|
return $raw ? $contents : array_map('strval', array_keys($contents));
|
|
}
|
|
|
|
/**
|
|
* Compares two rawlist entries using parameters set by setListOrder()
|
|
*
|
|
* Intended for use with uasort()
|
|
*
|
|
* @param array $a
|
|
* @param array $b
|
|
* @return int
|
|
* @access private
|
|
*/
|
|
function _comparator($a, $b)
|
|
{
|
|
switch (true) {
|
|
case $a['filename'] === '.' || $b['filename'] === '.':
|
|
if ($a['filename'] === $b['filename']) {
|
|
return 0;
|
|
}
|
|
return $a['filename'] === '.' ? -1 : 1;
|
|
case $a['filename'] === '..' || $b['filename'] === '..':
|
|
if ($a['filename'] === $b['filename']) {
|
|
return 0;
|
|
}
|
|
return $a['filename'] === '..' ? -1 : 1;
|
|
case isset($a['type']) && $a['type'] === NET_SFTP_TYPE_DIRECTORY:
|
|
if (!isset($b['type'])) {
|
|
return 1;
|
|
}
|
|
if ($b['type'] !== $a['type']) {
|
|
return -1;
|
|
}
|
|
break;
|
|
case isset($b['type']) && $b['type'] === NET_SFTP_TYPE_DIRECTORY:
|
|
return 1;
|
|
}
|
|
foreach ($this->sortOptions as $sort => $order) {
|
|
if (!isset($a[$sort]) || !isset($b[$sort])) {
|
|
if (isset($a[$sort])) {
|
|
return -1;
|
|
}
|
|
if (isset($b[$sort])) {
|
|
return 1;
|
|
}
|
|
return 0;
|
|
}
|
|
switch ($sort) {
|
|
case 'filename':
|
|
$result = strcasecmp($a['filename'], $b['filename']);
|
|
if ($result) {
|
|
return $order === SORT_DESC ? -$result : $result;
|
|
}
|
|
break;
|
|
case 'permissions':
|
|
case 'mode':
|
|
$a[$sort]&= 07777;
|
|
$b[$sort]&= 07777;
|
|
default:
|
|
if ($a[$sort] === $b[$sort]) {
|
|
break;
|
|
}
|
|
return $order === SORT_ASC ? $a[$sort] - $b[$sort] : $b[$sort] - $a[$sort];
|
|
}
|
|
}
|
|
}
|
|
|
|
/**
|
|
* Defines how nlist() and rawlist() will be sorted - if at all.
|
|
*
|
|
* If sorting is enabled directories and files will be sorted independently with
|
|
* directories appearing before files in the resultant array that is returned.
|
|
*
|
|
* Any parameter returned by stat is a valid sort parameter for this function.
|
|
* Filename comparisons are case insensitive.
|
|
*
|
|
* Examples:
|
|
*
|
|
* $sftp->setListOrder('filename', SORT_ASC);
|
|
* $sftp->setListOrder('size', SORT_DESC, 'filename', SORT_ASC);
|
|
* $sftp->setListOrder(true);
|
|
* Separates directories from files but doesn't do any sorting beyond that
|
|
* $sftp->setListOrder();
|
|
* Don't do any sort of sorting
|
|
*
|
|
* @access public
|
|
*/
|
|
function setListOrder()
|
|
{
|
|
$this->sortOptions = array();
|
|
$args = func_get_args();
|
|
if (empty($args)) {
|
|
return;
|
|
}
|
|
$len = count($args) & 0x7FFFFFFE;
|
|
for ($i = 0; $i < $len; $i+=2) {
|
|
$this->sortOptions[$args[$i]] = $args[$i + 1];
|
|
}
|
|
if (!count($this->sortOptions)) {
|
|
$this->sortOptions = array('bogus' => true);
|
|
}
|
|
}
|
|
|
|
/**
|
|
* Returns the file size, in bytes, or false, on failure
|
|
*
|
|
* Files larger than 4GB will show up as being exactly 4GB.
|
|
*
|
|
* @param string $filename
|
|
* @return mixed
|
|
* @access public
|
|
*/
|
|
function size($filename)
|
|
{
|
|
$result = $this->stat($filename);
|
|
if ($result === false) {
|
|
return false;
|
|
}
|
|
return isset($result['size']) ? $result['size'] : -1;
|
|
}
|
|
|
|
/**
|
|
* Save files / directories to cache
|
|
*
|
|
* @param string $path
|
|
* @param mixed $value
|
|
* @access private
|
|
*/
|
|
function _update_stat_cache($path, $value)
|
|
{
|
|
if ($this->use_stat_cache === false) {
|
|
return;
|
|
}
|
|
|
|
// preg_replace('#^/|/(?=/)|/$#', '', $dir) == str_replace('//', '/', trim($path, '/'))
|
|
$dirs = explode('/', preg_replace('#^/|/(?=/)|/$#', '', $path));
|
|
|
|
$temp = &$this->stat_cache;
|
|
$max = count($dirs) - 1;
|
|
foreach ($dirs as $i => $dir) {
|
|
// if $temp is an object that means one of two things.
|
|
// 1. a file was deleted and changed to a directory behind phpseclib's back
|
|
// 2. it's a symlink. when lstat is done it's unclear what it's a symlink to
|
|
if (is_object($temp)) {
|
|
$temp = array();
|
|
}
|
|
if (!isset($temp[$dir])) {
|
|
$temp[$dir] = array();
|
|
}
|
|
if ($i === $max) {
|
|
if (is_object($temp[$dir]) && is_object($value)) {
|
|
if (!isset($value->stat) && isset($temp[$dir]->stat)) {
|
|
$value->stat = $temp[$dir]->stat;
|
|
}
|
|
if (!isset($value->lstat) && isset($temp[$dir]->lstat)) {
|
|
$value->lstat = $temp[$dir]->lstat;
|
|
}
|
|
}
|
|
$temp[$dir] = $value;
|
|
break;
|
|
}
|
|
$temp = &$temp[$dir];
|
|
}
|
|
}
|
|
|
|
/**
|
|
* Remove files / directories from cache
|
|
*
|
|
* @param string $path
|
|
* @return bool
|
|
* @access private
|
|
*/
|
|
function _remove_from_stat_cache($path)
|
|
{
|
|
$dirs = explode('/', preg_replace('#^/|/(?=/)|/$#', '', $path));
|
|
|
|
$temp = &$this->stat_cache;
|
|
$max = count($dirs) - 1;
|
|
foreach ($dirs as $i => $dir) {
|
|
if (!is_array($temp)) {
|
|
return false;
|
|
}
|
|
if ($i === $max) {
|
|
unset($temp[$dir]);
|
|
return true;
|
|
}
|
|
if (!isset($temp[$dir])) {
|
|
return false;
|
|
}
|
|
$temp = &$temp[$dir];
|
|
}
|
|
}
|
|
|
|
/**
|
|
* Checks cache for path
|
|
*
|
|
* Mainly used by file_exists
|
|
*
|
|
* @param string $path
|
|
* @return mixed
|
|
* @access private
|
|
*/
|
|
function _query_stat_cache($path)
|
|
{
|
|
$dirs = explode('/', preg_replace('#^/|/(?=/)|/$#', '', $path));
|
|
|
|
$temp = &$this->stat_cache;
|
|
foreach ($dirs as $dir) {
|
|
if (!is_array($temp)) {
|
|
return null;
|
|
}
|
|
if (!isset($temp[$dir])) {
|
|
return null;
|
|
}
|
|
$temp = &$temp[$dir];
|
|
}
|
|
return $temp;
|
|
}
|
|
|
|
/**
|
|
* Returns general information about a file.
|
|
*
|
|
* Returns an array on success and false otherwise.
|
|
*
|
|
* @param string $filename
|
|
* @return mixed
|
|
* @access public
|
|
*/
|
|
function stat($filename)
|
|
{
|
|
if (!$this->_precheck()) {
|
|
return false;
|
|
}
|
|
|
|
$filename = $this->_realpath($filename);
|
|
if ($filename === false) {
|
|
return false;
|
|
}
|
|
|
|
if ($this->use_stat_cache) {
|
|
$result = $this->_query_stat_cache($filename);
|
|
if (is_array($result) && isset($result['.']) && isset($result['.']->stat)) {
|
|
return $result['.']->stat;
|
|
}
|
|
if (is_object($result) && isset($result->stat)) {
|
|
return $result->stat;
|
|
}
|
|
}
|
|
|
|
$stat = $this->_stat($filename, NET_SFTP_STAT);
|
|
if ($stat === false) {
|
|
$this->_remove_from_stat_cache($filename);
|
|
return false;
|
|
}
|
|
if (isset($stat['type'])) {
|
|
if ($stat['type'] == NET_SFTP_TYPE_DIRECTORY) {
|
|
$filename.= '/.';
|
|
}
|
|
$this->_update_stat_cache($filename, (object) array('stat' => $stat));
|
|
return $stat;
|
|
}
|
|
|
|
$pwd = $this->pwd;
|
|
$stat['type'] = $this->chdir($filename) ?
|
|
NET_SFTP_TYPE_DIRECTORY :
|
|
NET_SFTP_TYPE_REGULAR;
|
|
$this->pwd = $pwd;
|
|
|
|
if ($stat['type'] == NET_SFTP_TYPE_DIRECTORY) {
|
|
$filename.= '/.';
|
|
}
|
|
$this->_update_stat_cache($filename, (object) array('stat' => $stat));
|
|
|
|
return $stat;
|
|
}
|
|
|
|
/**
|
|
* Returns general information about a file or symbolic link.
|
|
*
|
|
* Returns an array on success and false otherwise.
|
|
*
|
|
* @param string $filename
|
|
* @return mixed
|
|
* @access public
|
|
*/
|
|
function lstat($filename)
|
|
{
|
|
if (!$this->_precheck()) {
|
|
return false;
|
|
}
|
|
|
|
$filename = $this->_realpath($filename);
|
|
if ($filename === false) {
|
|
return false;
|
|
}
|
|
|
|
if ($this->use_stat_cache) {
|
|
$result = $this->_query_stat_cache($filename);
|
|
if (is_array($result) && isset($result['.']) && isset($result['.']->lstat)) {
|
|
return $result['.']->lstat;
|
|
}
|
|
if (is_object($result) && isset($result->lstat)) {
|
|
return $result->lstat;
|
|
}
|
|
}
|
|
|
|
$lstat = $this->_stat($filename, NET_SFTP_LSTAT);
|
|
if ($lstat === false) {
|
|
$this->_remove_from_stat_cache($filename);
|
|
return false;
|
|
}
|
|
if (isset($lstat['type'])) {
|
|
if ($lstat['type'] == NET_SFTP_TYPE_DIRECTORY) {
|
|
$filename.= '/.';
|
|
}
|
|
$this->_update_stat_cache($filename, (object) array('lstat' => $lstat));
|
|
return $lstat;
|
|
}
|
|
|
|
$stat = $this->_stat($filename, NET_SFTP_STAT);
|
|
|
|
if ($lstat != $stat) {
|
|
$lstat = array_merge($lstat, array('type' => NET_SFTP_TYPE_SYMLINK));
|
|
$this->_update_stat_cache($filename, (object) array('lstat' => $lstat));
|
|
return $stat;
|
|
}
|
|
|
|
$pwd = $this->pwd;
|
|
$lstat['type'] = $this->chdir($filename) ?
|
|
NET_SFTP_TYPE_DIRECTORY :
|
|
NET_SFTP_TYPE_REGULAR;
|
|
$this->pwd = $pwd;
|
|
|
|
if ($lstat['type'] == NET_SFTP_TYPE_DIRECTORY) {
|
|
$filename.= '/.';
|
|
}
|
|
$this->_update_stat_cache($filename, (object) array('lstat' => $lstat));
|
|
|
|
return $lstat;
|
|
}
|
|
|
|
/**
|
|
* Returns general information about a file or symbolic link
|
|
*
|
|
* Determines information without calling Net_SFTP::realpath().
|
|
* The second parameter can be either NET_SFTP_STAT or NET_SFTP_LSTAT.
|
|
*
|
|
* @param string $filename
|
|
* @param int $type
|
|
* @return mixed
|
|
* @access private
|
|
*/
|
|
function _stat($filename, $type)
|
|
{
|
|
// SFTPv4+ adds an additional 32-bit integer field - flags - to the following:
|
|
$packet = pack('Na*', strlen($filename), $filename);
|
|
if (!$this->_send_sftp_packet($type, $packet)) {
|
|
return false;
|
|
}
|
|
|
|
$response = $this->_get_sftp_packet();
|
|
switch ($this->packet_type) {
|
|
case NET_SFTP_ATTRS:
|
|
return $this->_parseAttributes($response);
|
|
case NET_SFTP_STATUS:
|
|
$this->_logError($response);
|
|
return false;
|
|
}
|
|
|
|
user_error('Expected SSH_FXP_ATTRS or SSH_FXP_STATUS');
|
|
return false;
|
|
}
|
|
|
|
/**
|
|
* Truncates a file to a given length
|
|
*
|
|
* @param string $filename
|
|
* @param int $new_size
|
|
* @return bool
|
|
* @access public
|
|
*/
|
|
function truncate($filename, $new_size)
|
|
{
|
|
$attr = pack('N3', NET_SFTP_ATTR_SIZE, $new_size / 4294967296, $new_size); // 4294967296 == 0x100000000 == 1<<32
|
|
|
|
return $this->_setstat($filename, $attr, false);
|
|
}
|
|
|
|
/**
|
|
* Sets access and modification time of file.
|
|
*
|
|
* If the file does not exist, it will be created.
|
|
*
|
|
* @param string $filename
|
|
* @param int $time
|
|
* @param int $atime
|
|
* @return bool
|
|
* @access public
|
|
*/
|
|
function touch($filename, $time = null, $atime = null)
|
|
{
|
|
if (!$this->_precheck()) {
|
|
return false;
|
|
}
|
|
|
|
$filename = $this->_realpath($filename);
|
|
if ($filename === false) {
|
|
return false;
|
|
}
|
|
|
|
if (!isset($time)) {
|
|
$time = time();
|
|
}
|
|
if (!isset($atime)) {
|
|
$atime = $time;
|
|
}
|
|
|
|
if ($this->version < 4) {
|
|
$attr = pack('N3', NET_SFTP_ATTR_ACCESSTIME, $atime, $time);
|
|
} else {
|
|
$attr = pack(
|
|
'N5',
|
|
NET_SFTP_ATTR_ACCESSTIME | NET_SFTP_ATTR_MODIFYTIME,
|
|
$atime / 4294967296,
|
|
$atime,
|
|
$time / 4294967296,
|
|
$time
|
|
);
|
|
}
|
|
|
|
$packet = pack('Na*', strlen($filename), $filename);
|
|
$packet.= $this->version >= 5 ?
|
|
pack('N2', 0, NET_SFTP_OPEN_OPEN_EXISTING) :
|
|
pack('N', NET_SFTP_OPEN_WRITE | NET_SFTP_OPEN_CREATE | NET_SFTP_OPEN_EXCL);
|
|
$packet.= $attr;
|
|
|
|
if (!$this->_send_sftp_packet(NET_SFTP_OPEN, $packet)) {
|
|
return false;
|
|
}
|
|
|
|
$response = $this->_get_sftp_packet();
|
|
switch ($this->packet_type) {
|
|
case NET_SFTP_HANDLE:
|
|
return $this->_close_handle(substr($response, 4));
|
|
case NET_SFTP_STATUS:
|
|
$this->_logError($response);
|
|
break;
|
|
default:
|
|
user_error('Expected SSH_FXP_HANDLE or SSH_FXP_STATUS');
|
|
return false;
|
|
}
|
|
|
|
return $this->_setstat($filename, $attr, false);
|
|
}
|
|
|
|
/**
|
|
* Changes file or directory owner
|
|
*
|
|
* $uid should be an int for SFTPv3 and a string for SFTPv4+. Ideally the string
|
|
* would be of the form "user@dns_domain" but it does not need to be.
|
|
* `$sftp->getSupportedVersions()['version']` will return the specific version
|
|
* that's being used.
|
|
*
|
|
* Returns true on success or false on error.
|
|
*
|
|
* @param string $filename
|
|
* @param int|string $uid
|
|
* @param bool $recursive
|
|
* @return bool
|
|
* @access public
|
|
*/
|
|
function chown($filename, $uid, $recursive = false)
|
|
{
|
|
/*
|
|
quoting <https://datatracker.ietf.org/doc/html/draft-ietf-secsh-filexfer-13#section-7.5>,
|
|
|
|
"To avoid a representation that is tied to a particular underlying
|
|
implementation at the client or server, the use of UTF-8 strings has
|
|
been chosen. The string should be of the form "user@dns_domain".
|
|
This will allow for a client and server that do not use the same
|
|
local representation the ability to translate to a common syntax that
|
|
can be interpreted by both. In the case where there is no
|
|
translation available to the client or server, the attribute value
|
|
must be constructed without the "@"."
|
|
|
|
phpseclib _could_ auto append the dns_domain to $uid BUT what if it shouldn't
|
|
have one? phpseclib would have no way of knowing so rather than guess phpseclib
|
|
will just use whatever value the user provided
|
|
*/
|
|
|
|
$attr = $this->version < 4 ?
|
|
// quoting <http://www.kernel.org/doc/man-pages/online/pages/man2/chown.2.html>,
|
|
// "if the owner or group is specified as -1, then that ID is not changed"
|
|
pack('N3', NET_SFTP_ATTR_UIDGID, $uid, -1) :
|
|
// quoting <https://datatracker.ietf.org/doc/html/draft-ietf-secsh-filexfer-13#section-7.5>,
|
|
// "If either the owner or group field is zero length, the field should be
|
|
// considered absent, and no change should be made to that specific field
|
|
// during a modification operation"
|
|
pack('NNa*Na*', NET_SFTP_ATTR_OWNERGROUP, strlen($uid), $uid, 0, '');
|
|
|
|
return $this->_setstat($filename, $attr, $recursive);
|
|
}
|
|
|
|
/**
|
|
* Changes file or directory group
|
|
*
|
|
* $gid should be an int for SFTPv3 and a string for SFTPv4+. Ideally the string
|
|
* would be of the form "user@dns_domain" but it does not need to be.
|
|
* `$sftp->getSupportedVersions()['version']` will return the specific version
|
|
* that's being used.
|
|
*
|
|
* Returns true on success or false on error.
|
|
*
|
|
* @param string $filename
|
|
* @param int|string $gid
|
|
* @param bool $recursive
|
|
* @return bool
|
|
* @access public
|
|
*/
|
|
function chgrp($filename, $gid, $recursive = false)
|
|
{
|
|
$attr = $this->version < 4 ?
|
|
pack('N3', NET_SFTP_ATTR_UIDGID, $gid, -1) :
|
|
pack('NNa*Na*', NET_SFTP_ATTR_OWNERGROUP, 0, '', strlen($gid), $gid);
|
|
|
|
return $this->_setstat($filename, $attr, $recursive);
|
|
}
|
|
|
|
/**
|
|
* Set permissions on a file.
|
|
*
|
|
* Returns the new file permissions on success or false on error.
|
|
* If $recursive is true than this just returns true or false.
|
|
*
|
|
* @param int $mode
|
|
* @param string $filename
|
|
* @param bool $recursive
|
|
* @return mixed
|
|
* @access public
|
|
*/
|
|
function chmod($mode, $filename, $recursive = false)
|
|
{
|
|
if (is_string($mode) && is_int($filename)) {
|
|
$temp = $mode;
|
|
$mode = $filename;
|
|
$filename = $temp;
|
|
}
|
|
|
|
$attr = pack('N2', NET_SFTP_ATTR_PERMISSIONS, $mode & 07777);
|
|
if (!$this->_setstat($filename, $attr, $recursive)) {
|
|
return false;
|
|
}
|
|
if ($recursive) {
|
|
return true;
|
|
}
|
|
|
|
$filename = $this->realpath($filename);
|
|
// rather than return what the permissions *should* be, we'll return what they actually are. this will also
|
|
// tell us if the file actually exists.
|
|
// incidentally, SFTPv4+ adds an additional 32-bit integer field - flags - to the following:
|
|
$packet = pack('Na*', strlen($filename), $filename);
|
|
if (!$this->_send_sftp_packet(NET_SFTP_STAT, $packet)) {
|
|
return false;
|
|
}
|
|
|
|
$response = $this->_get_sftp_packet();
|
|
switch ($this->packet_type) {
|
|
case NET_SFTP_ATTRS:
|
|
$attrs = $this->_parseAttributes($response);
|
|
return $attrs['permissions'];
|
|
case NET_SFTP_STATUS:
|
|
$this->_logError($response);
|
|
return false;
|
|
}
|
|
|
|
user_error('Expected SSH_FXP_ATTRS or SSH_FXP_STATUS');
|
|
return false;
|
|
}
|
|
|
|
/**
|
|
* Sets information about a file
|
|
*
|
|
* @param string $filename
|
|
* @param string $attr
|
|
* @param bool $recursive
|
|
* @return bool
|
|
* @access private
|
|
*/
|
|
function _setstat($filename, $attr, $recursive)
|
|
{
|
|
if (!$this->_precheck()) {
|
|
return false;
|
|
}
|
|
|
|
$filename = $this->_realpath($filename);
|
|
if ($filename === false) {
|
|
return false;
|
|
}
|
|
|
|
$this->_remove_from_stat_cache($filename);
|
|
|
|
if ($recursive) {
|
|
$i = 0;
|
|
$result = $this->_setstat_recursive($filename, $attr, $i);
|
|
$this->_read_put_responses($i);
|
|
return $result;
|
|
}
|
|
|
|
$packet = $this->version >= 4 ?
|
|
pack('Na*a*Ca*', strlen($filename), $filename, substr($attr, 0, 4), NET_SFTP_TYPE_UNKNOWN, substr($attr, 4)) :
|
|
pack('Na*a*', strlen($filename), $filename, $attr);
|
|
if (!$this->_send_sftp_packet(NET_SFTP_SETSTAT, $packet)) {
|
|
return false;
|
|
}
|
|
|
|
/*
|
|
"Because some systems must use separate system calls to set various attributes, it is possible that a failure
|
|
response will be returned, but yet some of the attributes may be have been successfully modified. If possible,
|
|
servers SHOULD avoid this situation; however, clients MUST be aware that this is possible."
|
|
|
|
-- http://tools.ietf.org/html/draft-ietf-secsh-filexfer-13#section-8.6
|
|
*/
|
|
$response = $this->_get_sftp_packet();
|
|
if ($this->packet_type != NET_SFTP_STATUS) {
|
|
user_error('Expected SSH_FXP_STATUS');
|
|
return false;
|
|
}
|
|
|
|
if (strlen($response) < 4) {
|
|
return false;
|
|
}
|
|
extract(unpack('Nstatus', $this->_string_shift($response, 4)));
|
|
if ($status != NET_SFTP_STATUS_OK) {
|
|
$this->_logError($response, $status);
|
|
return false;
|
|
}
|
|
|
|
return true;
|
|
}
|
|
|
|
/**
|
|
* Recursively sets information on directories on the SFTP server
|
|
*
|
|
* Minimizes directory lookups and SSH_FXP_STATUS requests for speed.
|
|
*
|
|
* @param string $path
|
|
* @param string $attr
|
|
* @param int $i
|
|
* @return bool
|
|
* @access private
|
|
*/
|
|
function _setstat_recursive($path, $attr, &$i)
|
|
{
|
|
if (!$this->_read_put_responses($i)) {
|
|
return false;
|
|
}
|
|
$i = 0;
|
|
$entries = $this->_list($path, true);
|
|
|
|
if ($entries === false) {
|
|
return $this->_setstat($path, $attr, false);
|
|
}
|
|
|
|
// normally $entries would have at least . and .. but it might not if the directories
|
|
// permissions didn't allow reading
|
|
if (empty($entries)) {
|
|
return false;
|
|
}
|
|
|
|
unset($entries['.'], $entries['..']);
|
|
foreach ($entries as $filename => $props) {
|
|
if (!isset($props['type'])) {
|
|
return false;
|
|
}
|
|
|
|
$temp = $path . '/' . $filename;
|
|
if ($props['type'] == NET_SFTP_TYPE_DIRECTORY) {
|
|
if (!$this->_setstat_recursive($temp, $attr, $i)) {
|
|
return false;
|
|
}
|
|
} else {
|
|
$packet = $this->version >= 4 ?
|
|
pack('Na*Ca*', strlen($temp), $temp, NET_SFTP_TYPE_UNKNOWN, $attr) :
|
|
pack('Na*a*', strlen($temp), $temp, $attr);
|
|
if (!$this->_send_sftp_packet(NET_SFTP_SETSTAT, $packet)) {
|
|
return false;
|
|
}
|
|
|
|
$i++;
|
|
|
|
if ($i >= NET_SFTP_QUEUE_SIZE) {
|
|
if (!$this->_read_put_responses($i)) {
|
|
return false;
|
|
}
|
|
$i = 0;
|
|
}
|
|
}
|
|
}
|
|
|
|
$packet = $this->version >= 4 ?
|
|
pack('Na*Ca*', strlen($temp), $temp, NET_SFTP_TYPE_UNKNOWN, $attr) :
|
|
pack('Na*a*', strlen($temp), $temp, $attr);
|
|
if (!$this->_send_sftp_packet(NET_SFTP_SETSTAT, $packet)) {
|
|
return false;
|
|
}
|
|
|
|
$i++;
|
|
|
|
if ($i >= NET_SFTP_QUEUE_SIZE) {
|
|
if (!$this->_read_put_responses($i)) {
|
|
return false;
|
|
}
|
|
$i = 0;
|
|
}
|
|
|
|
return true;
|
|
}
|
|
|
|
/**
|
|
* Return the target of a symbolic link
|
|
*
|
|
* @param string $link
|
|
* @return mixed
|
|
* @access public
|
|
*/
|
|
function readlink($link)
|
|
{
|
|
if (!$this->_precheck()) {
|
|
return false;
|
|
}
|
|
|
|
$link = $this->_realpath($link);
|
|
|
|
if (!$this->_send_sftp_packet(NET_SFTP_READLINK, pack('Na*', strlen($link), $link))) {
|
|
return false;
|
|
}
|
|
|
|
$response = $this->_get_sftp_packet();
|
|
switch ($this->packet_type) {
|
|
case NET_SFTP_NAME:
|
|
break;
|
|
case NET_SFTP_STATUS:
|
|
$this->_logError($response);
|
|
return false;
|
|
default:
|
|
user_error('Expected SSH_FXP_NAME or SSH_FXP_STATUS');
|
|
return false;
|
|
}
|
|
|
|
if (strlen($response) < 4) {
|
|
return false;
|
|
}
|
|
extract(unpack('Ncount', $this->_string_shift($response, 4)));
|
|
// the file isn't a symlink
|
|
if (!$count) {
|
|
return false;
|
|
}
|
|
|
|
if (strlen($response) < 4) {
|
|
return false;
|
|
}
|
|
extract(unpack('Nlength', $this->_string_shift($response, 4)));
|
|
return $this->_string_shift($response, $length);
|
|
}
|
|
|
|
/**
|
|
* Create a symlink
|
|
*
|
|
* symlink() creates a symbolic link to the existing target with the specified name link.
|
|
*
|
|
* @param string $target
|
|
* @param string $link
|
|
* @return bool
|
|
* @access public
|
|
*/
|
|
function symlink($target, $link)
|
|
{
|
|
if (!$this->_precheck()) {
|
|
return false;
|
|
}
|
|
|
|
//$target = $this->_realpath($target);
|
|
$link = $this->_realpath($link);
|
|
|
|
/* quoting https://datatracker.ietf.org/doc/html/draft-ietf-secsh-filexfer-09#section-12.1 :
|
|
|
|
Changed the SYMLINK packet to be LINK and give it the ability to
|
|
create hard links. Also change it's packet number because many
|
|
implementation implemented SYMLINK with the arguments reversed.
|
|
Hopefully the new argument names make it clear which way is which.
|
|
*/
|
|
if ($this->version == 6) {
|
|
$type = NET_SFTP_LINK;
|
|
$packet = pack('Na*Na*C', strlen($link), $link, strlen($target), $target, 1);
|
|
} else {
|
|
$type = NET_SFTP_SYMLINK;
|
|
/* quoting http://bxr.su/OpenBSD/usr.bin/ssh/PROTOCOL#347 :
|
|
|
|
3.1. sftp: Reversal of arguments to SSH_FXP_SYMLINK
|
|
|
|
When OpenSSH's sftp-server was implemented, the order of the arguments
|
|
to the SSH_FXP_SYMLINK method was inadvertently reversed. Unfortunately,
|
|
the reversal was not noticed until the server was widely deployed. Since
|
|
fixing this to follow the specification would cause incompatibility, the
|
|
current order was retained. For correct operation, clients should send
|
|
SSH_FXP_SYMLINK as follows:
|
|
|
|
uint32 id
|
|
string targetpath
|
|
string linkpath */
|
|
$packet = substr($this->server_identifier, 0, 15) == 'SSH-2.0-OpenSSH' ?
|
|
pack('Na*Na*', strlen($target), $target, strlen($link), $link) :
|
|
pack('Na*Na*', strlen($link), $link, strlen($target), $target);
|
|
}
|
|
if (!$this->_send_sftp_packet($type, $packet)) {
|
|
return false;
|
|
}
|
|
|
|
$response = $this->_get_sftp_packet();
|
|
if ($this->packet_type != NET_SFTP_STATUS) {
|
|
user_error('Expected SSH_FXP_STATUS');
|
|
return false;
|
|
}
|
|
|
|
if (strlen($response) < 4) {
|
|
return false;
|
|
}
|
|
extract(unpack('Nstatus', $this->_string_shift($response, 4)));
|
|
if ($status != NET_SFTP_STATUS_OK) {
|
|
$this->_logError($response, $status);
|
|
return false;
|
|
}
|
|
|
|
return true;
|
|
}
|
|
|
|
/**
|
|
* Creates a directory.
|
|
*
|
|
* @param string $dir
|
|
* @param int $mode
|
|
* @param bool $recursive
|
|
* @return bool
|
|
* @access public
|
|
*/
|
|
function mkdir($dir, $mode = -1, $recursive = false)
|
|
{
|
|
if (!$this->_precheck()) {
|
|
return false;
|
|
}
|
|
|
|
$dir = $this->_realpath($dir);
|
|
|
|
if ($recursive) {
|
|
$dirs = explode('/', preg_replace('#/(?=/)|/$#', '', $dir));
|
|
if (empty($dirs[0])) {
|
|
array_shift($dirs);
|
|
$dirs[0] = '/' . $dirs[0];
|
|
}
|
|
for ($i = 0; $i < count($dirs); $i++) {
|
|
$temp = array_slice($dirs, 0, $i + 1);
|
|
$temp = implode('/', $temp);
|
|
$result = $this->_mkdir_helper($temp, $mode);
|
|
}
|
|
return $result;
|
|
}
|
|
|
|
return $this->_mkdir_helper($dir, $mode);
|
|
}
|
|
|
|
/**
|
|
* Helper function for directory creation
|
|
*
|
|
* @param string $dir
|
|
* @param int $mode
|
|
* @return bool
|
|
* @access private
|
|
*/
|
|
function _mkdir_helper($dir, $mode)
|
|
{
|
|
// send SSH_FXP_MKDIR without any attributes (that's what the \0\0\0\0 is doing)
|
|
if (!$this->_send_sftp_packet(NET_SFTP_MKDIR, pack('Na*a*', strlen($dir), $dir, "\0\0\0\0"))) {
|
|
return false;
|
|
}
|
|
|
|
$response = $this->_get_sftp_packet();
|
|
if ($this->packet_type != NET_SFTP_STATUS) {
|
|
user_error('Expected SSH_FXP_STATUS');
|
|
return false;
|
|
}
|
|
|
|
if (strlen($response) < 4) {
|
|
return false;
|
|
}
|
|
extract(unpack('Nstatus', $this->_string_shift($response, 4)));
|
|
if ($status != NET_SFTP_STATUS_OK) {
|
|
$this->_logError($response, $status);
|
|
return false;
|
|
}
|
|
|
|
if ($mode !== -1) {
|
|
$this->chmod($mode, $dir);
|
|
}
|
|
|
|
return true;
|
|
}
|
|
|
|
/**
|
|
* Removes a directory.
|
|
*
|
|
* @param string $dir
|
|
* @return bool
|
|
* @access public
|
|
*/
|
|
function rmdir($dir)
|
|
{
|
|
if (!$this->_precheck()) {
|
|
return false;
|
|
}
|
|
|
|
$dir = $this->_realpath($dir);
|
|
if ($dir === false) {
|
|
return false;
|
|
}
|
|
|
|
if (!$this->_send_sftp_packet(NET_SFTP_RMDIR, pack('Na*', strlen($dir), $dir))) {
|
|
return false;
|
|
}
|
|
|
|
$response = $this->_get_sftp_packet();
|
|
if ($this->packet_type != NET_SFTP_STATUS) {
|
|
user_error('Expected SSH_FXP_STATUS');
|
|
return false;
|
|
}
|
|
|
|
if (strlen($response) < 4) {
|
|
return false;
|
|
}
|
|
extract(unpack('Nstatus', $this->_string_shift($response, 4)));
|
|
if ($status != NET_SFTP_STATUS_OK) {
|
|
// presumably SSH_FX_NO_SUCH_FILE or SSH_FX_PERMISSION_DENIED?
|
|
$this->_logError($response, $status);
|
|
return false;
|
|
}
|
|
|
|
$this->_remove_from_stat_cache($dir);
|
|
// the following will do a soft delete, which would be useful if you deleted a file
|
|
// and then tried to do a stat on the deleted file. the above, in contrast, does
|
|
// a hard delete
|
|
//$this->_update_stat_cache($dir, false);
|
|
|
|
return true;
|
|
}
|
|
|
|
/**
|
|
* Uploads a file to the SFTP server.
|
|
*
|
|
* By default, Net_SFTP::put() does not read from the local filesystem. $data is dumped directly into $remote_file.
|
|
* So, for example, if you set $data to 'filename.ext' and then do Net_SFTP::get(), you will get a file, twelve bytes
|
|
* long, containing 'filename.ext' as its contents.
|
|
*
|
|
* Setting $mode to NET_SFTP_LOCAL_FILE will change the above behavior. With NET_SFTP_LOCAL_FILE, $remote_file will
|
|
* contain as many bytes as filename.ext does on your local filesystem. If your filename.ext is 1MB then that is how
|
|
* large $remote_file will be, as well.
|
|
*
|
|
* If $data is a resource then it'll be used as a resource instead.
|
|
*
|
|
* Setting $mode to NET_SFTP_CALLBACK will use $data as callback function, which gets only one parameter -- number
|
|
* of bytes to return, and returns a string if there is some data or null if there is no more data
|
|
*
|
|
* Currently, only binary mode is supported. As such, if the line endings need to be adjusted, you will need to take
|
|
* care of that, yourself.
|
|
*
|
|
* $mode can take an additional two parameters - NET_SFTP_RESUME and NET_SFTP_RESUME_START. These are bitwise AND'd with
|
|
* $mode. So if you want to resume upload of a 300mb file on the local file system you'd set $mode to the following:
|
|
*
|
|
* NET_SFTP_LOCAL_FILE | NET_SFTP_RESUME
|
|
*
|
|
* If you wanted to simply append the full contents of a local file to the full contents of a remote file you'd replace
|
|
* NET_SFTP_RESUME with NET_SFTP_RESUME_START.
|
|
*
|
|
* If $mode & (NET_SFTP_RESUME | NET_SFTP_RESUME_START) then NET_SFTP_RESUME_START will be assumed.
|
|
*
|
|
* $start and $local_start give you more fine grained control over this process and take precident over NET_SFTP_RESUME
|
|
* when they're non-negative. ie. $start could let you write at the end of a file (like NET_SFTP_RESUME) or in the middle
|
|
* of one. $local_start could let you start your reading from the end of a file (like NET_SFTP_RESUME_START) or in the
|
|
* middle of one.
|
|
*
|
|
* Setting $local_start to > 0 or $mode | NET_SFTP_RESUME_START doesn't do anything unless $mode | NET_SFTP_LOCAL_FILE.
|
|
*
|
|
* @param string $remote_file
|
|
* @param string|resource $data
|
|
* @param int $mode
|
|
* @param int $start
|
|
* @param int $local_start
|
|
* @param callable|null $progressCallback
|
|
* @return bool
|
|
* @access public
|
|
* @internal ASCII mode for SFTPv4/5/6 can be supported by adding a new function - Net_SFTP::setMode().
|
|
*/
|
|
function put($remote_file, $data, $mode = NET_SFTP_STRING, $start = -1, $local_start = -1, $progressCallback = null)
|
|
{
|
|
if (!$this->_precheck()) {
|
|
return false;
|
|
}
|
|
|
|
$remote_file = $this->_realpath($remote_file);
|
|
if ($remote_file === false) {
|
|
return false;
|
|
}
|
|
|
|
$this->_remove_from_stat_cache($remote_file);
|
|
|
|
if ($this->version >= 5) {
|
|
$flags = NET_SFTP_OPEN_OPEN_OR_CREATE;
|
|
} else {
|
|
$flags = NET_SFTP_OPEN_WRITE | NET_SFTP_OPEN_CREATE;
|
|
// according to the SFTP specs, NET_SFTP_OPEN_APPEND should "force all writes to append data at the end of the file."
|
|
// in practice, it doesn't seem to do that.
|
|
//$flags|= ($mode & NET_SFTP_RESUME) ? NET_SFTP_OPEN_APPEND : NET_SFTP_OPEN_TRUNCATE;
|
|
}
|
|
|
|
if ($start >= 0) {
|
|
$offset = $start;
|
|
} elseif ($mode & NET_SFTP_RESUME) {
|
|
// if NET_SFTP_OPEN_APPEND worked as it should _size() wouldn't need to be called
|
|
$size = $this->size($remote_file);
|
|
$offset = $size !== false ? $size : 0;
|
|
} else {
|
|
$offset = 0;
|
|
if ($this->version >= 5) {
|
|
$flags = NET_SFTP_OPEN_CREATE_TRUNCATE;
|
|
} else {
|
|
$flags|= NET_SFTP_OPEN_TRUNCATE;
|
|
}
|
|
}
|
|
|
|
$packet = pack('Na*', strlen($remote_file), $remote_file);
|
|
$packet.= $this->version >= 5 ?
|
|
pack('N3', 0, $flags, 0) :
|
|
pack('N2', $flags, 0);
|
|
if (!$this->_send_sftp_packet(NET_SFTP_OPEN, $packet)) {
|
|
return false;
|
|
}
|
|
|
|
$response = $this->_get_sftp_packet();
|
|
switch ($this->packet_type) {
|
|
case NET_SFTP_HANDLE:
|
|
$handle = substr($response, 4);
|
|
break;
|
|
case NET_SFTP_STATUS:
|
|
$this->_logError($response);
|
|
return false;
|
|
default:
|
|
user_error('Expected SSH_FXP_HANDLE or SSH_FXP_STATUS');
|
|
return false;
|
|
}
|
|
|
|
// http://tools.ietf.org/html/draft-ietf-secsh-filexfer-13#section-8.2.3
|
|
$dataCallback = false;
|
|
switch (true) {
|
|
case $mode & NET_SFTP_CALLBACK:
|
|
if (!is_callable($data)) {
|
|
user_error("\$data should be is_callable if you set NET_SFTP_CALLBACK flag");
|
|
}
|
|
$dataCallback = $data;
|
|
// do nothing
|
|
break;
|
|
case is_resource($data):
|
|
$mode = $mode & ~NET_SFTP_LOCAL_FILE;
|
|
$info = stream_get_meta_data($data);
|
|
if ($info['wrapper_type'] == 'PHP' && $info['stream_type'] == 'Input') {
|
|
$fp = fopen('php://memory', 'w+');
|
|
stream_copy_to_stream($data, $fp);
|
|
rewind($fp);
|
|
} else {
|
|
$fp = $data;
|
|
}
|
|
break;
|
|
case $mode & NET_SFTP_LOCAL_FILE:
|
|
if (!is_file($data)) {
|
|
user_error("$data is not a valid file");
|
|
return false;
|
|
}
|
|
$fp = @fopen($data, 'rb');
|
|
if (!$fp) {
|
|
return false;
|
|
}
|
|
}
|
|
|
|
if (isset($fp)) {
|
|
$stat = fstat($fp);
|
|
$size = !empty($stat) ? $stat['size'] : 0;
|
|
|
|
if ($local_start >= 0) {
|
|
fseek($fp, $local_start);
|
|
$size-= $local_start;
|
|
}
|
|
} elseif ($dataCallback) {
|
|
$size = 0;
|
|
} else {
|
|
$size = strlen($data);
|
|
}
|
|
|
|
$sent = 0;
|
|
$size = $size < 0 ? ($size & 0x7FFFFFFF) + 0x80000000 : $size;
|
|
|
|
$sftp_packet_size = $this->max_sftp_packet;
|
|
// make the SFTP packet be exactly the SFTP packet size by including the bytes in the NET_SFTP_WRITE packets "header"
|
|
$sftp_packet_size-= strlen($handle) + 25;
|
|
$i = $j = 0;
|
|
while ($dataCallback || ($size === 0 || $sent < $size)) {
|
|
if ($dataCallback) {
|
|
$temp = call_user_func($dataCallback, $sftp_packet_size);
|
|
if (is_null($temp)) {
|
|
break;
|
|
}
|
|
} else {
|
|
$temp = isset($fp) ? fread($fp, $sftp_packet_size) : substr($data, $sent, $sftp_packet_size);
|
|
if ($temp === false || $temp === '') {
|
|
break;
|
|
}
|
|
}
|
|
|
|
$subtemp = $offset + $sent;
|
|
$packet = pack('Na*N3a*', strlen($handle), $handle, $subtemp / 4294967296, $subtemp, strlen($temp), $temp);
|
|
if (!$this->_send_sftp_packet(NET_SFTP_WRITE, $packet, $j)) {
|
|
if ($mode & NET_SFTP_LOCAL_FILE) {
|
|
fclose($fp);
|
|
}
|
|
return false;
|
|
}
|
|
$sent+= strlen($temp);
|
|
if (is_callable($progressCallback)) {
|
|
call_user_func($progressCallback, $sent);
|
|
}
|
|
|
|
$i++;
|
|
$j++;
|
|
|
|
if ($i == NET_SFTP_UPLOAD_QUEUE_SIZE) {
|
|
if (!$this->_read_put_responses($i)) {
|
|
$i = 0;
|
|
break;
|
|
}
|
|
$i = 0;
|
|
}
|
|
}
|
|
|
|
$result = $this->_close_handle($handle);
|
|
|
|
if (!$this->_read_put_responses($i)) {
|
|
if ($mode & NET_SFTP_LOCAL_FILE) {
|
|
fclose($fp);
|
|
}
|
|
$this->_close_handle($handle);
|
|
return false;
|
|
}
|
|
|
|
if ($mode & NET_SFTP_LOCAL_FILE) {
|
|
if (isset($fp) && is_resource($fp)) {
|
|
fclose($fp);
|
|
}
|
|
|
|
if ($this->preserveTime) {
|
|
$stat = stat($data);
|
|
if ($this->version < 4) {
|
|
$attr = pack('N3', NET_SFTP_ATTR_ACCESSTIME, $stat['atime'], $stat['mtime']);
|
|
} else {
|
|
$attr = pack(
|
|
'N5',
|
|
NET_SFTP_ATTR_ACCESSTIME | NET_SFTP_ATTR_MODIFYTIME,
|
|
$stat['atime'] / 4294967296,
|
|
$stat['atime'],
|
|
$stat['mtime'] / 4294967296,
|
|
$stat['mtime']
|
|
);
|
|
}
|
|
|
|
if (!$this->_setstat($remote_file, $attr, false)) {
|
|
user_error('Error setting file time');
|
|
}
|
|
}
|
|
}
|
|
|
|
return $result;
|
|
}
|
|
|
|
/**
|
|
* Reads multiple successive SSH_FXP_WRITE responses
|
|
*
|
|
* Sending an SSH_FXP_WRITE packet and immediately reading its response isn't as efficient as blindly sending out $i
|
|
* SSH_FXP_WRITEs, in succession, and then reading $i responses.
|
|
*
|
|
* @param int $i
|
|
* @return bool
|
|
* @access private
|
|
*/
|
|
function _read_put_responses($i)
|
|
{
|
|
while ($i--) {
|
|
$response = $this->_get_sftp_packet();
|
|
if ($this->packet_type != NET_SFTP_STATUS) {
|
|
user_error('Expected SSH_FXP_STATUS');
|
|
return false;
|
|
}
|
|
|
|
if (strlen($response) < 4) {
|
|
return false;
|
|
}
|
|
extract(unpack('Nstatus', $this->_string_shift($response, 4)));
|
|
if ($status != NET_SFTP_STATUS_OK) {
|
|
$this->_logError($response, $status);
|
|
break;
|
|
}
|
|
}
|
|
|
|
return $i < 0;
|
|
}
|
|
|
|
/**
|
|
* Close handle
|
|
*
|
|
* @param string $handle
|
|
* @return bool
|
|
* @access private
|
|
*/
|
|
function _close_handle($handle)
|
|
{
|
|
if (!$this->_send_sftp_packet(NET_SFTP_CLOSE, pack('Na*', strlen($handle), $handle))) {
|
|
return false;
|
|
}
|
|
|
|
// "The client MUST release all resources associated with the handle regardless of the status."
|
|
// -- http://tools.ietf.org/html/draft-ietf-secsh-filexfer-13#section-8.1.3
|
|
$response = $this->_get_sftp_packet();
|
|
if ($this->packet_type != NET_SFTP_STATUS) {
|
|
user_error('Expected SSH_FXP_STATUS');
|
|
return false;
|
|
}
|
|
|
|
if (strlen($response) < 4) {
|
|
return false;
|
|
}
|
|
extract(unpack('Nstatus', $this->_string_shift($response, 4)));
|
|
if ($status != NET_SFTP_STATUS_OK) {
|
|
$this->_logError($response, $status);
|
|
return false;
|
|
}
|
|
|
|
return true;
|
|
}
|
|
|
|
/**
|
|
* Downloads a file from the SFTP server.
|
|
*
|
|
* Returns a string containing the contents of $remote_file if $local_file is left undefined or a boolean false if
|
|
* the operation was unsuccessful. If $local_file is defined, returns true or false depending on the success of the
|
|
* operation.
|
|
*
|
|
* $offset and $length can be used to download files in chunks.
|
|
*
|
|
* @param string $remote_file
|
|
* @param string $local_file
|
|
* @param int $offset
|
|
* @param int $length
|
|
* @param callable|null $progressCallback
|
|
* @return mixed
|
|
* @access public
|
|
*/
|
|
function get($remote_file, $local_file = false, $offset = 0, $length = -1, $progressCallback = null)
|
|
{
|
|
if (!$this->_precheck()) {
|
|
return false;
|
|
}
|
|
|
|
$remote_file = $this->_realpath($remote_file);
|
|
if ($remote_file === false) {
|
|
return false;
|
|
}
|
|
|
|
$packet = pack('Na*', strlen($remote_file), $remote_file);
|
|
$packet.= $this->version >= 5 ?
|
|
pack('N3', 0, NET_SFTP_OPEN_OPEN_EXISTING, 0) :
|
|
pack('N2', NET_SFTP_OPEN_READ, 0);
|
|
if (!$this->_send_sftp_packet(NET_SFTP_OPEN, $packet)) {
|
|
return false;
|
|
}
|
|
|
|
$response = $this->_get_sftp_packet();
|
|
switch ($this->packet_type) {
|
|
case NET_SFTP_HANDLE:
|
|
$handle = substr($response, 4);
|
|
break;
|
|
case NET_SFTP_STATUS: // presumably SSH_FX_NO_SUCH_FILE or SSH_FX_PERMISSION_DENIED
|
|
$this->_logError($response);
|
|
return false;
|
|
default:
|
|
user_error('Expected SSH_FXP_HANDLE or SSH_FXP_STATUS');
|
|
return false;
|
|
}
|
|
|
|
if (is_resource($local_file)) {
|
|
$fp = $local_file;
|
|
$stat = fstat($fp);
|
|
$res_offset = $stat['size'];
|
|
} else {
|
|
$res_offset = 0;
|
|
if ($local_file !== false && !is_callable($local_file)) {
|
|
$fp = fopen($local_file, 'wb');
|
|
if (!$fp) {
|
|
return false;
|
|
}
|
|
} else {
|
|
$content = '';
|
|
}
|
|
}
|
|
|
|
$fclose_check = $local_file !== false && !is_callable($local_file) && !is_resource($local_file);
|
|
|
|
$start = $offset;
|
|
$read = 0;
|
|
while (true) {
|
|
$i = 0;
|
|
|
|
while ($i < NET_SFTP_QUEUE_SIZE && ($length < 0 || $read < $length)) {
|
|
$tempoffset = $start + $read;
|
|
|
|
$packet_size = $length > 0 ? min($this->max_sftp_packet, $length - $read) : $this->max_sftp_packet;
|
|
|
|
$packet = pack('Na*N3', strlen($handle), $handle, $tempoffset / 4294967296, $tempoffset, $packet_size);
|
|
if (!$this->_send_sftp_packet(NET_SFTP_READ, $packet, $i)) {
|
|
if ($fclose_check) {
|
|
fclose($fp);
|
|
}
|
|
return false;
|
|
}
|
|
$packet = null;
|
|
$read+= $packet_size;
|
|
$i++;
|
|
}
|
|
|
|
if (!$i) {
|
|
break;
|
|
}
|
|
|
|
$packets_sent = $i - 1;
|
|
|
|
$clear_responses = false;
|
|
while ($i > 0) {
|
|
$i--;
|
|
|
|
if ($clear_responses) {
|
|
$this->_get_sftp_packet($packets_sent - $i);
|
|
continue;
|
|
} else {
|
|
$response = $this->_get_sftp_packet($packets_sent - $i);
|
|
}
|
|
|
|
switch ($this->packet_type) {
|
|
case NET_SFTP_DATA:
|
|
$temp = substr($response, 4);
|
|
$offset+= strlen($temp);
|
|
if ($local_file === false) {
|
|
$content.= $temp;
|
|
} elseif (is_callable($local_file)) {
|
|
$local_file($temp);
|
|
} else {
|
|
fputs($fp, $temp);
|
|
}
|
|
if (is_callable($progressCallback)) {
|
|
call_user_func($progressCallback, $offset);
|
|
}
|
|
$temp = null;
|
|
break;
|
|
case NET_SFTP_STATUS:
|
|
// could, in theory, return false if !strlen($content) but we'll hold off for the time being
|
|
$this->_logError($response);
|
|
$clear_responses = true; // don't break out of the loop yet, so we can read the remaining responses
|
|
break;
|
|
default:
|
|
if ($fclose_check) {
|
|
fclose($fp);
|
|
}
|
|
// maybe the file was successfully transferred, maybe it wasn't
|
|
if ($this->channel_close) {
|
|
$this->partial_init = false;
|
|
$this->_init_sftp_connection();
|
|
return false;
|
|
} else {
|
|
user_error('Expected SSH_FX_DATA or SSH_FXP_STATUS');
|
|
}
|
|
}
|
|
$response = null;
|
|
}
|
|
|
|
if ($clear_responses) {
|
|
break;
|
|
}
|
|
}
|
|
|
|
if ($length > 0 && $length <= $offset - $start) {
|
|
if ($local_file === false) {
|
|
$content = substr($content, 0, $length);
|
|
} else {
|
|
ftruncate($fp, $length + $res_offset);
|
|
}
|
|
}
|
|
|
|
if ($fclose_check) {
|
|
fclose($fp);
|
|
|
|
if ($this->preserveTime) {
|
|
$stat = $this->stat($remote_file);
|
|
touch($local_file, $stat['mtime'], $stat['atime']);
|
|
}
|
|
}
|
|
|
|
if (!$this->_close_handle($handle)) {
|
|
return false;
|
|
}
|
|
|
|
// if $content isn't set that means a file was written to
|
|
return isset($content) ? $content : true;
|
|
}
|
|
|
|
/**
|
|
* Deletes a file on the SFTP server.
|
|
*
|
|
* @param string $path
|
|
* @param bool $recursive
|
|
* @return bool
|
|
* @access public
|
|
*/
|
|
function delete($path, $recursive = true)
|
|
{
|
|
if (!$this->_precheck()) {
|
|
return false;
|
|
}
|
|
|
|
if (is_object($path)) {
|
|
// It's an object. Cast it as string before we check anything else.
|
|
$path = (string) $path;
|
|
}
|
|
|
|
if (!is_string($path) || $path == '') {
|
|
return false;
|
|
}
|
|
|
|
$path = $this->_realpath($path);
|
|
if ($path === false) {
|
|
return false;
|
|
}
|
|
|
|
// http://tools.ietf.org/html/draft-ietf-secsh-filexfer-13#section-8.3
|
|
if (!$this->_send_sftp_packet(NET_SFTP_REMOVE, pack('Na*', strlen($path), $path))) {
|
|
return false;
|
|
}
|
|
|
|
$response = $this->_get_sftp_packet();
|
|
if ($this->packet_type != NET_SFTP_STATUS) {
|
|
user_error('Expected SSH_FXP_STATUS');
|
|
return false;
|
|
}
|
|
|
|
// if $status isn't SSH_FX_OK it's probably SSH_FX_NO_SUCH_FILE or SSH_FX_PERMISSION_DENIED
|
|
if (strlen($response) < 4) {
|
|
return false;
|
|
}
|
|
extract(unpack('Nstatus', $this->_string_shift($response, 4)));
|
|
if ($status != NET_SFTP_STATUS_OK) {
|
|
$this->_logError($response, $status);
|
|
if (!$recursive) {
|
|
return false;
|
|
}
|
|
$i = 0;
|
|
$result = $this->_delete_recursive($path, $i);
|
|
$this->_read_put_responses($i);
|
|
return $result;
|
|
}
|
|
|
|
$this->_remove_from_stat_cache($path);
|
|
|
|
return true;
|
|
}
|
|
|
|
/**
|
|
* Recursively deletes directories on the SFTP server
|
|
*
|
|
* Minimizes directory lookups and SSH_FXP_STATUS requests for speed.
|
|
*
|
|
* @param string $path
|
|
* @param int $i
|
|
* @return bool
|
|
* @access private
|
|
*/
|
|
function _delete_recursive($path, &$i)
|
|
{
|
|
if (!$this->_read_put_responses($i)) {
|
|
return false;
|
|
}
|
|
$i = 0;
|
|
$entries = $this->_list($path, true);
|
|
|
|
// normally $entries would have at least . and .. but it might not if the directories
|
|
// permissions didn't allow reading
|
|
if (empty($entries)) {
|
|
return false;
|
|
}
|
|
|
|
unset($entries['.'], $entries['..']);
|
|
foreach ($entries as $filename => $props) {
|
|
if (!isset($props['type'])) {
|
|
return false;
|
|
}
|
|
|
|
$temp = $path . '/' . $filename;
|
|
if ($props['type'] == NET_SFTP_TYPE_DIRECTORY) {
|
|
if (!$this->_delete_recursive($temp, $i)) {
|
|
return false;
|
|
}
|
|
} else {
|
|
if (!$this->_send_sftp_packet(NET_SFTP_REMOVE, pack('Na*', strlen($temp), $temp))) {
|
|
return false;
|
|
}
|
|
$this->_remove_from_stat_cache($temp);
|
|
|
|
$i++;
|
|
|
|
if ($i >= NET_SFTP_QUEUE_SIZE) {
|
|
if (!$this->_read_put_responses($i)) {
|
|
return false;
|
|
}
|
|
$i = 0;
|
|
}
|
|
}
|
|
}
|
|
|
|
if (!$this->_send_sftp_packet(NET_SFTP_RMDIR, pack('Na*', strlen($path), $path))) {
|
|
return false;
|
|
}
|
|
$this->_remove_from_stat_cache($path);
|
|
|
|
$i++;
|
|
|
|
if ($i >= NET_SFTP_QUEUE_SIZE) {
|
|
if (!$this->_read_put_responses($i)) {
|
|
return false;
|
|
}
|
|
$i = 0;
|
|
}
|
|
|
|
return true;
|
|
}
|
|
|
|
/**
|
|
* Checks whether a file or directory exists
|
|
*
|
|
* @param string $path
|
|
* @return bool
|
|
* @access public
|
|
*/
|
|
function file_exists($path)
|
|
{
|
|
if ($this->use_stat_cache) {
|
|
if (!$this->_precheck()) {
|
|
return false;
|
|
}
|
|
|
|
$path = $this->_realpath($path);
|
|
|
|
$result = $this->_query_stat_cache($path);
|
|
|
|
if (isset($result)) {
|
|
// return true if $result is an array or if it's an stdClass object
|
|
return $result !== false;
|
|
}
|
|
}
|
|
|
|
return $this->stat($path) !== false;
|
|
}
|
|
|
|
/**
|
|
* Tells whether the filename is a directory
|
|
*
|
|
* @param string $path
|
|
* @return bool
|
|
* @access public
|
|
*/
|
|
function is_dir($path)
|
|
{
|
|
$result = $this->_get_stat_cache_prop($path, 'type');
|
|
if ($result === false) {
|
|
return false;
|
|
}
|
|
return $result === NET_SFTP_TYPE_DIRECTORY;
|
|
}
|
|
|
|
/**
|
|
* Tells whether the filename is a regular file
|
|
*
|
|
* @param string $path
|
|
* @return bool
|
|
* @access public
|
|
*/
|
|
function is_file($path)
|
|
{
|
|
$result = $this->_get_stat_cache_prop($path, 'type');
|
|
if ($result === false) {
|
|
return false;
|
|
}
|
|
return $result === NET_SFTP_TYPE_REGULAR;
|
|
}
|
|
|
|
/**
|
|
* Tells whether the filename is a symbolic link
|
|
*
|
|
* @param string $path
|
|
* @return bool
|
|
* @access public
|
|
*/
|
|
function is_link($path)
|
|
{
|
|
$result = $this->_get_lstat_cache_prop($path, 'type');
|
|
if ($result === false) {
|
|
return false;
|
|
}
|
|
return $result === NET_SFTP_TYPE_SYMLINK;
|
|
}
|
|
|
|
/**
|
|
* Tells whether a file exists and is readable
|
|
*
|
|
* @param string $path
|
|
* @return bool
|
|
* @access public
|
|
*/
|
|
function is_readable($path)
|
|
{
|
|
if (!$this->_precheck()) {
|
|
return false;
|
|
}
|
|
|
|
$path = $this->_realpath($path);
|
|
|
|
$packet = pack('Na*N2', strlen($path), $path, NET_SFTP_OPEN_READ, 0);
|
|
if (!$this->_send_sftp_packet(NET_SFTP_OPEN, $packet)) {
|
|
return false;
|
|
}
|
|
|
|
$response = $this->_get_sftp_packet();
|
|
switch ($this->packet_type) {
|
|
case NET_SFTP_HANDLE:
|
|
return true;
|
|
case NET_SFTP_STATUS: // presumably SSH_FX_NO_SUCH_FILE or SSH_FX_PERMISSION_DENIED
|
|
return false;
|
|
default:
|
|
user_error('Expected SSH_FXP_HANDLE or SSH_FXP_STATUS');
|
|
return false;
|
|
}
|
|
}
|
|
|
|
/**
|
|
* Tells whether the filename is writable
|
|
*
|
|
* @param string $path
|
|
* @return bool
|
|
* @access public
|
|
*/
|
|
function is_writable($path)
|
|
{
|
|
if (!$this->_precheck()) {
|
|
return false;
|
|
}
|
|
|
|
$path = $this->_realpath($path);
|
|
|
|
$packet = pack('Na*N2', strlen($path), $path, NET_SFTP_OPEN_WRITE, 0);
|
|
if (!$this->_send_sftp_packet(NET_SFTP_OPEN, $packet)) {
|
|
return false;
|
|
}
|
|
|
|
$response = $this->_get_sftp_packet();
|
|
switch ($this->packet_type) {
|
|
case NET_SFTP_HANDLE:
|
|
return true;
|
|
case NET_SFTP_STATUS: // presumably SSH_FX_NO_SUCH_FILE or SSH_FX_PERMISSION_DENIED
|
|
return false;
|
|
default:
|
|
user_error('Expected SSH_FXP_HANDLE or SSH_FXP_STATUS');
|
|
return false;
|
|
}
|
|
}
|
|
|
|
/**
|
|
* Tells whether the filename is writeable
|
|
*
|
|
* Alias of is_writable
|
|
*
|
|
* @param string $path
|
|
* @return bool
|
|
* @access public
|
|
*/
|
|
function is_writeable($path)
|
|
{
|
|
return $this->is_writable($path);
|
|
}
|
|
|
|
/**
|
|
* Gets last access time of file
|
|
*
|
|
* @param string $path
|
|
* @return mixed
|
|
* @access public
|
|
*/
|
|
function fileatime($path)
|
|
{
|
|
return $this->_get_stat_cache_prop($path, 'atime');
|
|
}
|
|
|
|
/**
|
|
* Gets file modification time
|
|
*
|
|
* @param string $path
|
|
* @return mixed
|
|
* @access public
|
|
*/
|
|
function filemtime($path)
|
|
{
|
|
return $this->_get_stat_cache_prop($path, 'mtime');
|
|
}
|
|
|
|
/**
|
|
* Gets file permissions
|
|
*
|
|
* @param string $path
|
|
* @return mixed
|
|
* @access public
|
|
*/
|
|
function fileperms($path)
|
|
{
|
|
return $this->_get_stat_cache_prop($path, 'permissions');
|
|
}
|
|
|
|
/**
|
|
* Gets file owner
|
|
*
|
|
* @param string $path
|
|
* @return mixed
|
|
* @access public
|
|
*/
|
|
function fileowner($path)
|
|
{
|
|
return $this->_get_stat_cache_prop($path, 'uid');
|
|
}
|
|
|
|
/**
|
|
* Gets file group
|
|
*
|
|
* @param string $path
|
|
* @return mixed
|
|
* @access public
|
|
*/
|
|
function filegroup($path)
|
|
{
|
|
return $this->_get_stat_cache_prop($path, 'gid');
|
|
}
|
|
|
|
/**
|
|
* Gets file size
|
|
*
|
|
* @param string $path
|
|
* @return mixed
|
|
* @access public
|
|
*/
|
|
function filesize($path)
|
|
{
|
|
return $this->_get_stat_cache_prop($path, 'size');
|
|
}
|
|
|
|
/**
|
|
* Gets file type
|
|
*
|
|
* @param string $path
|
|
* @return mixed
|
|
* @access public
|
|
*/
|
|
function filetype($path)
|
|
{
|
|
$type = $this->_get_stat_cache_prop($path, 'type');
|
|
if ($type === false) {
|
|
return false;
|
|
}
|
|
|
|
switch ($type) {
|
|
case NET_SFTP_TYPE_BLOCK_DEVICE:
|
|
return 'block';
|
|
case NET_SFTP_TYPE_CHAR_DEVICE:
|
|
return 'char';
|
|
case NET_SFTP_TYPE_DIRECTORY:
|
|
return 'dir';
|
|
case NET_SFTP_TYPE_FIFO:
|
|
return 'fifo';
|
|
case NET_SFTP_TYPE_REGULAR:
|
|
return 'file';
|
|
case NET_SFTP_TYPE_SYMLINK:
|
|
return 'link';
|
|
default:
|
|
return false;
|
|
}
|
|
}
|
|
|
|
/**
|
|
* Return a stat properity
|
|
*
|
|
* Uses cache if appropriate.
|
|
*
|
|
* @param string $path
|
|
* @param string $prop
|
|
* @return mixed
|
|
* @access private
|
|
*/
|
|
function _get_stat_cache_prop($path, $prop)
|
|
{
|
|
return $this->_get_xstat_cache_prop($path, $prop, 'stat');
|
|
}
|
|
|
|
/**
|
|
* Return an lstat properity
|
|
*
|
|
* Uses cache if appropriate.
|
|
*
|
|
* @param string $path
|
|
* @param string $prop
|
|
* @return mixed
|
|
* @access private
|
|
*/
|
|
function _get_lstat_cache_prop($path, $prop)
|
|
{
|
|
return $this->_get_xstat_cache_prop($path, $prop, 'lstat');
|
|
}
|
|
|
|
/**
|
|
* Return a stat or lstat properity
|
|
*
|
|
* Uses cache if appropriate.
|
|
*
|
|
* @param string $path
|
|
* @param string $prop
|
|
* @param mixed $type
|
|
* @return mixed
|
|
* @access private
|
|
*/
|
|
function _get_xstat_cache_prop($path, $prop, $type)
|
|
{
|
|
if (!$this->_precheck()) {
|
|
return false;
|
|
}
|
|
|
|
if ($this->use_stat_cache) {
|
|
$path = $this->_realpath($path);
|
|
|
|
$result = $this->_query_stat_cache($path);
|
|
|
|
if (is_object($result) && isset($result->$type)) {
|
|
return $result->{$type}[$prop];
|
|
}
|
|
}
|
|
|
|
$result = $this->$type($path);
|
|
|
|
if ($result === false || !isset($result[$prop])) {
|
|
return false;
|
|
}
|
|
|
|
return $result[$prop];
|
|
}
|
|
|
|
/**
|
|
* Renames a file or a directory on the SFTP server.
|
|
*
|
|
* If the file already exists this will return false
|
|
*
|
|
* @param string $oldname
|
|
* @param string $newname
|
|
* @return bool
|
|
* @access public
|
|
*/
|
|
function rename($oldname, $newname)
|
|
{
|
|
if (!$this->_precheck()) {
|
|
return false;
|
|
}
|
|
|
|
$oldname = $this->_realpath($oldname);
|
|
$newname = $this->_realpath($newname);
|
|
if ($oldname === false || $newname === false) {
|
|
return false;
|
|
}
|
|
|
|
// http://tools.ietf.org/html/draft-ietf-secsh-filexfer-13#section-8.3
|
|
$packet = pack('Na*Na*', strlen($oldname), $oldname, strlen($newname), $newname);
|
|
if ($this->version >= 5) {
|
|
/* quoting https://datatracker.ietf.org/doc/html/draft-ietf-secsh-filexfer-05#section-6.5 ,
|
|
|
|
'flags' is 0 or a combination of:
|
|
|
|
SSH_FXP_RENAME_OVERWRITE 0x00000001
|
|
SSH_FXP_RENAME_ATOMIC 0x00000002
|
|
SSH_FXP_RENAME_NATIVE 0x00000004
|
|
|
|
(none of these are currently supported) */
|
|
$packet.= "\0\0\0\0";
|
|
}
|
|
if (!$this->_send_sftp_packet(NET_SFTP_RENAME, $packet)) {
|
|
return false;
|
|
}
|
|
|
|
$response = $this->_get_sftp_packet();
|
|
if ($this->packet_type != NET_SFTP_STATUS) {
|
|
user_error('Expected SSH_FXP_STATUS');
|
|
return false;
|
|
}
|
|
|
|
// if $status isn't SSH_FX_OK it's probably SSH_FX_NO_SUCH_FILE or SSH_FX_PERMISSION_DENIED
|
|
if (strlen($response) < 4) {
|
|
return false;
|
|
}
|
|
extract(unpack('Nstatus', $this->_string_shift($response, 4)));
|
|
if ($status != NET_SFTP_STATUS_OK) {
|
|
$this->_logError($response, $status);
|
|
return false;
|
|
}
|
|
|
|
// don't move the stat cache entry over since this operation could very well change the
|
|
// atime and mtime attributes
|
|
//$this->_update_stat_cache($newname, $this->_query_stat_cache($oldname));
|
|
$this->_remove_from_stat_cache($oldname);
|
|
$this->_remove_from_stat_cache($newname);
|
|
|
|
return true;
|
|
}
|
|
|
|
/**
|
|
* Parse Time
|
|
*
|
|
* See '7.7. Times' of draft-ietf-secsh-filexfer-13 for more info.
|
|
*
|
|
* @param string $key
|
|
* @param int $flags
|
|
* @param string $response
|
|
* @return array
|
|
* @access private
|
|
*/
|
|
function _parseTime($key, $flags, &$response)
|
|
{
|
|
if (strlen($response) < 8) {
|
|
user_error('Malformed file attributes');
|
|
return array();
|
|
}
|
|
$attr = array();
|
|
$attr[$key] = hexdec(bin2hex($this->_string_shift($response, 8)));
|
|
if ($flags & NET_SFTP_ATTR_SUBSECOND_TIMES) {
|
|
$attr+= extract(unpack('N' . $key . '_nseconds', $this->_string_shift($response, 4)));
|
|
}
|
|
return $attr;
|
|
}
|
|
|
|
/**
|
|
* Parse Attributes
|
|
*
|
|
* See '7. File Attributes' of draft-ietf-secsh-filexfer-13 for more info.
|
|
*
|
|
* @param string $response
|
|
* @return array
|
|
* @access private
|
|
*/
|
|
function _parseAttributes(&$response)
|
|
{
|
|
if ($this->version >= 4) {
|
|
$length = 5;
|
|
$format = 'Nflags/Ctype';
|
|
} else {
|
|
$length = 4;
|
|
$format = 'Nflags';
|
|
}
|
|
|
|
$attr = array();
|
|
if (strlen($response) < $length) {
|
|
user_error('Malformed file attributes');
|
|
return array();
|
|
}
|
|
extract(unpack($format, $this->_string_shift($response, $length)));
|
|
if (isset($type)) {
|
|
$attr['type'] = $type;
|
|
}
|
|
foreach ($this->attributes as $key => $value) {
|
|
switch ($flags & $key) {
|
|
case NET_SFTP_ATTR_UIDGID:
|
|
if ($this->version > 3) {
|
|
continue 2;
|
|
}
|
|
break;
|
|
case NET_SFTP_ATTR_CREATETIME:
|
|
case NET_SFTP_ATTR_MODIFYTIME:
|
|
case NET_SFTP_ATTR_ACL:
|
|
case NET_SFTP_ATTR_OWNERGROUP:
|
|
case NET_SFTP_ATTR_SUBSECOND_TIMES:
|
|
if ($this->version < 4) {
|
|
continue 2;
|
|
}
|
|
break;
|
|
case NET_SFTP_ATTR_BITS:
|
|
if ($this->version < 5) {
|
|
continue 2;
|
|
}
|
|
break;
|
|
case NET_SFTP_ATTR_ALLOCATION_SIZE:
|
|
case NET_SFTP_ATTR_TEXT_HINT:
|
|
case NET_SFTP_ATTR_MIME_TYPE:
|
|
case NET_SFTP_ATTR_LINK_COUNT:
|
|
case NET_SFTP_ATTR_UNTRANSLATED_NAME:
|
|
case NET_SFTP_ATTR_CTIME:
|
|
if ($this->version < 6) {
|
|
continue 2;
|
|
}
|
|
}
|
|
switch ($flags & $key) {
|
|
case NET_SFTP_ATTR_SIZE: // 0x00000001
|
|
// The size attribute is defined as an unsigned 64-bit integer.
|
|
// The following will use floats on 32-bit platforms, if necessary.
|
|
// As can be seen in the BigInteger class, floats are generally
|
|
// IEEE 754 binary64 "double precision" on such platforms and
|
|
// as such can represent integers of at least 2^50 without loss
|
|
// of precision. Interpreted in filesize, 2^50 bytes = 1024 TiB.
|
|
$attr['size'] = hexdec(bin2hex($this->_string_shift($response, 8)));
|
|
break;
|
|
case NET_SFTP_ATTR_UIDGID: // 0x00000002 (SFTPv3 or earlier)
|
|
if (strlen($response) < 8) {
|
|
user_error('Malformed file attributes');
|
|
return $attr;
|
|
}
|
|
$attr+= unpack('Nuid/Ngid', $this->_string_shift($response, 8));
|
|
break;
|
|
case NET_SFTP_ATTR_PERMISSIONS: // 0x00000004
|
|
if (strlen($response) < 4) {
|
|
user_error('Malformed file attributes');
|
|
return $attr;
|
|
}
|
|
$attr+= unpack('Npermissions', $this->_string_shift($response, 4));
|
|
// mode == permissions; permissions was the original array key and is retained for bc purposes.
|
|
// mode was added because that's the more industry standard terminology
|
|
$attr+= array('mode' => $attr['permissions']);
|
|
$fileType = $this->_parseMode($attr['permissions']);
|
|
if ($fileType !== false) {
|
|
$attr+= array('type' => $fileType);
|
|
}
|
|
break;
|
|
case NET_SFTP_ATTR_ACCESSTIME: // 0x00000008
|
|
if ($this->version >= 4) {
|
|
$attr+= $this->_parseTime('atime', $flags, $response);
|
|
break;
|
|
}
|
|
if (strlen($response) < 8) {
|
|
user_error('Malformed file attributes');
|
|
return $attr;
|
|
}
|
|
$attr+= unpack('Natime/Nmtime', $this->_string_shift($response, 8));
|
|
break;
|
|
case NET_SFTP_ATTR_CREATETIME: // 0x00000010 (SFTPv4+)
|
|
$attr+= $this->_parseTime('createtime', $flags, $response);
|
|
break;
|
|
case NET_SFTP_ATTR_MODIFYTIME: // 0x00000020
|
|
$attr+= $this->_parseTime('mtime', $flags, $response);
|
|
break;
|
|
case NET_SFTP_ATTR_ACL: // 0x00000040
|
|
// access control list
|
|
// see https://datatracker.ietf.org/doc/html/draft-ietf-secsh-filexfer-04#section-5.7
|
|
// currently unsupported
|
|
if (strlen($response) < 4) {
|
|
user_error('Malformed file attributes');
|
|
return $attr;
|
|
}
|
|
extract(unpack('Ncount', $this->_string_shift($response, 4)));
|
|
for ($i = 0; $i < $count; $i++) {
|
|
if (strlen($response) < 16) {
|
|
user_error('Malformed file attributes');
|
|
return $attr;
|
|
}
|
|
extract(unpack('Ntype/Nflag/Nmask/Nlength', $this->_string_shift($response, 16)));
|
|
if (strlen($response) < $length) {
|
|
user_error('Malformed file attributes');
|
|
return $attr;
|
|
}
|
|
$this->_string_shift($response, $length); // who
|
|
}
|
|
break;
|
|
case NET_SFTP_ATTR_OWNERGROUP: // 0x00000080
|
|
if (strlen($response) < 4) {
|
|
user_error('Malformed file attributes');
|
|
return $attr;
|
|
}
|
|
extract(unpack('Nlength', $this->_string_shift($response, 4)));
|
|
if (strlen($response) < $length) {
|
|
user_error('Malformed file attributes');
|
|
return $attr;
|
|
}
|
|
$attr['owner'] = $this->_string_shift($response, $length);
|
|
|
|
if (strlen($response) < 4) {
|
|
user_error('Malformed file attributes');
|
|
return $attr;
|
|
}
|
|
extract(unpack('Nlength', $this->_string_shift($response, 4)));
|
|
if (strlen($response) < $length) {
|
|
user_error('Malformed file attributes');
|
|
return $attr;
|
|
}
|
|
$attr['group'] = $this->_string_shift($response, $length);
|
|
break;
|
|
case NET_SFTP_ATTR_SUBSECOND_TIMES: // 0x00000100
|
|
break;
|
|
case NET_SFTP_ATTR_BITS: // 0x00000200 (SFTPv5+)
|
|
// see https://datatracker.ietf.org/doc/html/draft-ietf-secsh-filexfer-05#section-5.8
|
|
// currently unsupported
|
|
// tells if you file is:
|
|
// readonly, system, hidden, case inensitive, archive, encrypted, compressed, sparse
|
|
// append only, immutable, sync
|
|
if (strlen($response) < 8) {
|
|
user_error('Malformed file attributes');
|
|
return $attr;
|
|
}
|
|
extract(unpack('Nattrib-bits/Nattrib-bits-valid', $this->_string_shift($response, 8)));
|
|
break;
|
|
case NET_SFTP_ATTR_ALLOCATION_SIZE: // 0x00000400 (SFTPv6+)
|
|
// see https://datatracker.ietf.org/doc/html/draft-ietf-secsh-filexfer-13#section-7.4
|
|
// represents the number of bytes htat the file consumes on the disk. will
|
|
// usually be larger than the 'size' field
|
|
$attr['allocation-size'] = hexdec(bin2hex($this->_string_shift($response, 8)));
|
|
break;
|
|
case NET_SFTP_ATTR_TEXT_HINT: // 0x00000800
|
|
// https://datatracker.ietf.org/doc/html/draft-ietf-secsh-filexfer-13#section-7.10
|
|
// currently unsupported
|
|
// tells if file is "known text", "guessed text", "known binary", "guessed binary"
|
|
extract(unpack('Ctext-hint', $this->_string_shift($response)));
|
|
break;
|
|
case NET_SFTP_ATTR_MIME_TYPE: // 0x00001000
|
|
// see https://datatracker.ietf.org/doc/html/draft-ietf-secsh-filexfer-13#section-7.11
|
|
if (strlen($response) < 4) {
|
|
user_error('Malformed file attributes');
|
|
return $attr;
|
|
}
|
|
extract(unpack('Nlength', $this->_string_shift($response, 4)));
|
|
if (strlen($response) < $length) {
|
|
user_error('Malformed file attributes');
|
|
return $attr;
|
|
}
|
|
$attr['mime-type'] = $this->_string_shift($response, $length);
|
|
break;
|
|
case NET_SFTP_ATTR_LINK_COUNT: // 0x00002000
|
|
// see https://datatracker.ietf.org/doc/html/draft-ietf-secsh-filexfer-13#section-7.12
|
|
if (strlen($response) < 4) {
|
|
user_error('Malformed file attributes');
|
|
return $attr;
|
|
}
|
|
$attr+= unpack('Nlink-count', $this->_string_shift($response, 4));
|
|
break;
|
|
case NET_SFTP_ATTR_UNTRANSLATED_NAME:// 0x00004000
|
|
// see https://datatracker.ietf.org/doc/html/draft-ietf-secsh-filexfer-13#section-7.13
|
|
if (strlen($response) < 4) {
|
|
user_error('Malformed file attributes');
|
|
return $attr;
|
|
}
|
|
extract(unpack('Nlength', $this->_string_shift($response, 4)));
|
|
if (strlen($response) < $length) {
|
|
user_error('Malformed file attributes');
|
|
return $attr;
|
|
}
|
|
$attr['untranslated-name'] = $this->_string_shift($response, $length);
|
|
break;
|
|
case NET_SFTP_ATTR_CTIME: // 0x00008000
|
|
// 'ctime' contains the last time the file attributes were changed. The
|
|
// exact meaning of this field depends on the server.
|
|
$attr+= $this->_parseTime('ctime', $flags, $response);
|
|
break;
|
|
case NET_SFTP_ATTR_EXTENDED: // 0x80000000
|
|
if (strlen($response) < 4) {
|
|
user_error('Malformed file attributes');
|
|
return $attr;
|
|
}
|
|
extract(unpack('Ncount', $this->_string_shift($response, 4)));
|
|
for ($i = 0; $i < $count; $i++) {
|
|
if (strlen($response) < 4) {
|
|
user_error('Malformed file attributes');
|
|
return $attr;
|
|
}
|
|
extract(unpack('Nlength', $this->_string_shift($response, 4)));
|
|
$key = $this->_string_shift($response, $length);
|
|
if (strlen($response) < 4) {
|
|
user_error('Malformed file attributes');
|
|
return $attr;
|
|
}
|
|
extract(unpack('Nlength', $this->_string_shift($response, 4)));
|
|
$attr[$key] = $this->_string_shift($response, $length);
|
|
}
|
|
}
|
|
}
|
|
return $attr;
|
|
}
|
|
|
|
/**
|
|
* Attempt to identify the file type
|
|
*
|
|
* Quoting the SFTP RFC, "Implementations MUST NOT send bits that are not defined" but they seem to anyway
|
|
*
|
|
* @param int $mode
|
|
* @return int
|
|
* @access private
|
|
*/
|
|
function _parseMode($mode)
|
|
{
|
|
// values come from http://lxr.free-electrons.com/source/include/uapi/linux/stat.h#L12
|
|
// see, also, http://linux.die.net/man/2/stat
|
|
switch ($mode & 0170000) {// ie. 1111 0000 0000 0000
|
|
case 0000000: // no file type specified - figure out the file type using alternative means
|
|
return false;
|
|
case 0040000:
|
|
return NET_SFTP_TYPE_DIRECTORY;
|
|
case 0100000:
|
|
return NET_SFTP_TYPE_REGULAR;
|
|
case 0120000:
|
|
return NET_SFTP_TYPE_SYMLINK;
|
|
// new types introduced in SFTPv5+
|
|
// http://tools.ietf.org/html/draft-ietf-secsh-filexfer-05#section-5.2
|
|
case 0010000: // named pipe (fifo)
|
|
return NET_SFTP_TYPE_FIFO;
|
|
case 0020000: // character special
|
|
return NET_SFTP_TYPE_CHAR_DEVICE;
|
|
case 0060000: // block special
|
|
return NET_SFTP_TYPE_BLOCK_DEVICE;
|
|
case 0140000: // socket
|
|
return NET_SFTP_TYPE_SOCKET;
|
|
case 0160000: // whiteout
|
|
// "SPECIAL should be used for files that are of
|
|
// a known type which cannot be expressed in the protocol"
|
|
return NET_SFTP_TYPE_SPECIAL;
|
|
default:
|
|
return NET_SFTP_TYPE_UNKNOWN;
|
|
}
|
|
}
|
|
|
|
/**
|
|
* Parse Longname
|
|
*
|
|
* SFTPv3 doesn't provide any easy way of identifying a file type. You could try to open
|
|
* a file as a directory and see if an error is returned or you could try to parse the
|
|
* SFTPv3-specific longname field of the SSH_FXP_NAME packet. That's what this function does.
|
|
* The result is returned using the
|
|
* {@link http://tools.ietf.org/html/draft-ietf-secsh-filexfer-04#section-5.2 SFTPv4 type constants}.
|
|
*
|
|
* If the longname is in an unrecognized format bool(false) is returned.
|
|
*
|
|
* @param string $longname
|
|
* @return mixed
|
|
* @access private
|
|
*/
|
|
function _parseLongname($longname)
|
|
{
|
|
// http://en.wikipedia.org/wiki/Unix_file_types
|
|
// http://en.wikipedia.org/wiki/Filesystem_permissions#Notation_of_traditional_Unix_permissions
|
|
if (preg_match('#^[^/]([r-][w-][xstST-]){3}#', $longname)) {
|
|
switch ($longname[0]) {
|
|
case '-':
|
|
return NET_SFTP_TYPE_REGULAR;
|
|
case 'd':
|
|
return NET_SFTP_TYPE_DIRECTORY;
|
|
case 'l':
|
|
return NET_SFTP_TYPE_SYMLINK;
|
|
default:
|
|
return NET_SFTP_TYPE_SPECIAL;
|
|
}
|
|
}
|
|
|
|
return false;
|
|
}
|
|
|
|
/**
|
|
* Sends SFTP Packets
|
|
*
|
|
* See '6. General Packet Format' of draft-ietf-secsh-filexfer-13 for more info.
|
|
*
|
|
* @param int $type
|
|
* @param string $data
|
|
* @param int $request_id
|
|
* @see self::_get_sftp_packet()
|
|
* @see Net_SSH2::_send_channel_packet()
|
|
* @return bool
|
|
* @access private
|
|
*/
|
|
function _send_sftp_packet($type, $data, $request_id = 1)
|
|
{
|
|
// in SSH2.php the timeout is cumulative per function call. eg. exec() will
|
|
// timeout after 10s. but for SFTP.php it's cumulative per packet
|
|
$this->curTimeout = $this->timeout;
|
|
|
|
$packet = $this->use_request_id ?
|
|
pack('NCNa*', strlen($data) + 5, $type, $request_id, $data) :
|
|
pack('NCa*', strlen($data) + 1, $type, $data);
|
|
|
|
$start = strtok(microtime(), ' ') + strtok(''); // http://php.net/microtime#61838
|
|
$result = $this->_send_channel_packet(NET_SFTP_CHANNEL, $packet);
|
|
$stop = strtok(microtime(), ' ') + strtok('');
|
|
|
|
if (defined('NET_SFTP_LOGGING')) {
|
|
$packet_type = '-> ' . $this->packet_types[$type] .
|
|
' (' . round($stop - $start, 4) . 's)';
|
|
if (NET_SFTP_LOGGING == NET_SFTP_LOG_REALTIME) {
|
|
switch (PHP_SAPI) {
|
|
case 'cli':
|
|
$start = $stop = "\r\n";
|
|
break;
|
|
default:
|
|
$start = '<pre>';
|
|
$stop = '</pre>';
|
|
}
|
|
echo $start . $this->_format_log(array($data), array($packet_type)) . $stop;
|
|
@flush();
|
|
@ob_flush();
|
|
} else {
|
|
$this->packet_type_log[] = $packet_type;
|
|
if (NET_SFTP_LOGGING == NET_SFTP_LOG_COMPLEX) {
|
|
$this->packet_log[] = $data;
|
|
}
|
|
}
|
|
}
|
|
|
|
return $result;
|
|
}
|
|
|
|
/**
|
|
* Resets a connection for re-use
|
|
*
|
|
* @param int $reason
|
|
* @access private
|
|
*/
|
|
function _reset_connection($reason)
|
|
{
|
|
parent::_reset_connection($reason);
|
|
$this->use_request_id = false;
|
|
$this->pwd = false;
|
|
$this->requestBuffer = array();
|
|
}
|
|
|
|
/**
|
|
* Receives SFTP Packets
|
|
*
|
|
* See '6. General Packet Format' of draft-ietf-secsh-filexfer-13 for more info.
|
|
*
|
|
* Incidentally, the number of SSH_MSG_CHANNEL_DATA messages has no bearing on the number of SFTP packets present.
|
|
* There can be one SSH_MSG_CHANNEL_DATA messages containing two SFTP packets or there can be two SSH_MSG_CHANNEL_DATA
|
|
* messages containing one SFTP packet.
|
|
*
|
|
* @see self::_send_sftp_packet()
|
|
* @return string
|
|
* @access private
|
|
*/
|
|
function _get_sftp_packet($request_id = null)
|
|
{
|
|
$this->channel_close = false;
|
|
|
|
if (isset($request_id) && isset($this->requestBuffer[$request_id])) {
|
|
$this->packet_type = $this->requestBuffer[$request_id]['packet_type'];
|
|
$temp = $this->requestBuffer[$request_id]['packet'];
|
|
unset($this->requestBuffer[$request_id]);
|
|
return $temp;
|
|
}
|
|
|
|
// in SSH2.php the timeout is cumulative per function call. eg. exec() will
|
|
// timeout after 10s. but for SFTP.php it's cumulative per packet
|
|
$this->curTimeout = $this->timeout;
|
|
|
|
$start = strtok(microtime(), ' ') + strtok(''); // http://php.net/microtime#61838
|
|
|
|
// SFTP packet length
|
|
while (strlen($this->packet_buffer) < 4) {
|
|
$temp = $this->_get_channel_packet(NET_SFTP_CHANNEL, true);
|
|
if ($temp === true) {
|
|
if ($this->channel_status[NET_SFTP_CHANNEL] === NET_SSH2_MSG_CHANNEL_CLOSE) {
|
|
$this->channel_close = true;
|
|
}
|
|
$this->packet_type = false;
|
|
$this->packet_buffer = '';
|
|
return false;
|
|
}
|
|
if ($temp === false) {
|
|
return false;
|
|
}
|
|
$this->packet_buffer.= $temp;
|
|
}
|
|
if (strlen($this->packet_buffer) < 4) {
|
|
return false;
|
|
}
|
|
extract(unpack('Nlength', $this->_string_shift($this->packet_buffer, 4)));
|
|
$tempLength = $length;
|
|
$tempLength-= strlen($this->packet_buffer);
|
|
|
|
// 256 * 1024 is what SFTP_MAX_MSG_LENGTH is set to in OpenSSH's sftp-common.h
|
|
if (!$this->allow_arbitrary_length_packets && !$this->use_request_id && $tempLength > 256 * 1024) {
|
|
user_error('Invalid SFTP packet size');
|
|
return false;
|
|
}
|
|
|
|
// SFTP packet type and data payload
|
|
while ($tempLength > 0) {
|
|
$temp = $this->_get_channel_packet(NET_SFTP_CHANNEL, true);
|
|
if (is_bool($temp)) {
|
|
$this->packet_type = false;
|
|
$this->packet_buffer = '';
|
|
return false;
|
|
}
|
|
$this->packet_buffer.= $temp;
|
|
$tempLength-= strlen($temp);
|
|
}
|
|
|
|
$stop = strtok(microtime(), ' ') + strtok('');
|
|
|
|
$this->packet_type = ord($this->_string_shift($this->packet_buffer));
|
|
|
|
if ($this->use_request_id) {
|
|
extract(unpack('Npacket_id', $this->_string_shift($this->packet_buffer, 4))); // remove the request id
|
|
$length-= 5; // account for the request id and the packet type
|
|
} else {
|
|
$length-= 1; // account for the packet type
|
|
}
|
|
|
|
$packet = $this->_string_shift($this->packet_buffer, $length);
|
|
|
|
if (defined('NET_SFTP_LOGGING')) {
|
|
$packet_type = '<- ' . $this->packet_types[$this->packet_type] .
|
|
' (' . round($stop - $start, 4) . 's)';
|
|
if (NET_SFTP_LOGGING == NET_SFTP_LOG_REALTIME) {
|
|
switch (PHP_SAPI) {
|
|
case 'cli':
|
|
$start = $stop = "\r\n";
|
|
break;
|
|
default:
|
|
$start = '<pre>';
|
|
$stop = '</pre>';
|
|
}
|
|
echo $start . $this->_format_log(array($packet), array($packet_type)) . $stop;
|
|
@flush();
|
|
@ob_flush();
|
|
} else {
|
|
$this->packet_type_log[] = $packet_type;
|
|
if (NET_SFTP_LOGGING == NET_SFTP_LOG_COMPLEX) {
|
|
$this->packet_log[] = $packet;
|
|
}
|
|
}
|
|
}
|
|
|
|
if (isset($request_id) && $this->use_request_id && $packet_id != $request_id) {
|
|
$this->requestBuffer[$packet_id] = array(
|
|
'packet_type' => $this->packet_type,
|
|
'packet' => $packet
|
|
);
|
|
return $this->_get_sftp_packet($request_id);
|
|
}
|
|
|
|
return $packet;
|
|
}
|
|
|
|
/**
|
|
* Returns a log of the packets that have been sent and received.
|
|
*
|
|
* Returns a string if NET_SFTP_LOGGING == NET_SFTP_LOG_COMPLEX, an array if NET_SFTP_LOGGING == NET_SFTP_LOG_SIMPLE and false if !defined('NET_SFTP_LOGGING')
|
|
*
|
|
* @access public
|
|
* @return string or Array
|
|
*/
|
|
function getSFTPLog()
|
|
{
|
|
if (!defined('NET_SFTP_LOGGING')) {
|
|
return false;
|
|
}
|
|
|
|
switch (NET_SFTP_LOGGING) {
|
|
case NET_SFTP_LOG_COMPLEX:
|
|
return $this->_format_log($this->packet_log, $this->packet_type_log);
|
|
break;
|
|
//case NET_SFTP_LOG_SIMPLE:
|
|
default:
|
|
return $this->packet_type_log;
|
|
}
|
|
}
|
|
|
|
/**
|
|
* Returns all errors
|
|
*
|
|
* @return array
|
|
* @access public
|
|
*/
|
|
function getSFTPErrors()
|
|
{
|
|
return $this->sftp_errors;
|
|
}
|
|
|
|
/**
|
|
* Returns the last error
|
|
*
|
|
* @return string
|
|
* @access public
|
|
*/
|
|
function getLastSFTPError()
|
|
{
|
|
return count($this->sftp_errors) ? $this->sftp_errors[count($this->sftp_errors) - 1] : '';
|
|
}
|
|
|
|
/**
|
|
* Get supported SFTP versions
|
|
*
|
|
* @return array
|
|
* @access public
|
|
*/
|
|
function getSupportedVersions()
|
|
{
|
|
if (!($this->bitmap & NET_SSH2_MASK_LOGIN)) {
|
|
return false;
|
|
}
|
|
|
|
if (!$this->partial_init) {
|
|
$this->_partial_init_sftp_connection();
|
|
}
|
|
|
|
$temp = array('version' => $this->defaultVersion);
|
|
if (isset($this->extensions['versions'])) {
|
|
$temp['extensions'] = $this->extensions['versions'];
|
|
}
|
|
return $temp;
|
|
}
|
|
|
|
/**
|
|
* Get supported SFTP versions
|
|
*
|
|
* @return array
|
|
* @access public
|
|
*/
|
|
function getNegotiatedVersion()
|
|
{
|
|
if (!$this->_precheck()) {
|
|
return false;
|
|
}
|
|
|
|
return $this->version;
|
|
}
|
|
|
|
/**
|
|
* Set preferred version
|
|
*
|
|
* If you're preferred version isn't supported then the highest supported
|
|
* version of SFTP will be utilized. Set to null or false or int(0) to
|
|
* unset the preferred version
|
|
*
|
|
* @param int $version
|
|
* @access public
|
|
*/
|
|
function setPreferredVersion($version)
|
|
{
|
|
$this->preferredVersion = $version;
|
|
}
|
|
|
|
/**
|
|
* Disconnect
|
|
*
|
|
* @param int $reason
|
|
* @return bool
|
|
* @access private
|
|
*/
|
|
function _disconnect($reason)
|
|
{
|
|
$this->pwd = false;
|
|
parent::_disconnect($reason);
|
|
}
|
|
|
|
/**
|
|
* Enable Date Preservation
|
|
*
|
|
* @access public
|
|
*/
|
|
function enableDatePreservation()
|
|
{
|
|
$this->preserveTime = true;
|
|
}
|
|
|
|
/**
|
|
* Disable Date Preservation
|
|
*
|
|
* @access public
|
|
*/
|
|
function disableDatePreservation()
|
|
{
|
|
$this->preserveTime = false;
|
|
}
|
|
}
|