<?php

[0] Fix | Delete

/**

[1] Fix | Delete

* WordPress Filesystem Class for implementing SSH2

[2] Fix | Delete

*

[3] Fix | Delete

* To use this class you must follow these steps for PHP 5.2.6+

[4] Fix | Delete

*

[5] Fix | Delete

* {@link http://kevin.vanzonneveld.net/techblog/article/make_ssh_connections_with_php/ - Installation Notes}

[6] Fix | Delete

*

[7] Fix | Delete

* Compile libssh2 (Note: Only 0.14 is officially working with PHP 5.2.6+ right now, But many users have found the latest versions work)

[8] Fix | Delete

*

[9] Fix | Delete

* cd /usr/src

[10] Fix | Delete

* wget https://www.libssh2.org/download/libssh2-0.14.tar.gz

[11] Fix | Delete

* tar -zxvf libssh2-0.14.tar.gz

[12] Fix | Delete

* cd libssh2-0.14/

[13] Fix | Delete

* ./configure

[14] Fix | Delete

* make all install

[15] Fix | Delete

*

[16] Fix | Delete

* Note: Do not leave the directory yet!

[17] Fix | Delete

*

[18] Fix | Delete

* Enter: pecl install -f ssh2

[19] Fix | Delete

*

[20] Fix | Delete

* Copy the ssh.so file it creates to your PHP Module Directory.

[21] Fix | Delete

* Open up your PHP.INI file and look for where extensions are placed.

[22] Fix | Delete

* Add in your PHP.ini file: extension=ssh2.so

[23] Fix | Delete

*

[24] Fix | Delete

* Restart Apache!

[25] Fix | Delete

* Check phpinfo() streams to confirm that: ssh2.shell, ssh2.exec, ssh2.tunnel, ssh2.scp, ssh2.sftp exist.

[26] Fix | Delete

*

[27] Fix | Delete

* Note: As of WordPress 2.8, this utilizes the PHP5+ function `stream_get_contents()`.

[28] Fix | Delete

*

[29] Fix | Delete

* @since 2.7.0

[30] Fix | Delete

*

[31] Fix | Delete

* @package WordPress

[32] Fix | Delete

* @subpackage Filesystem

[33] Fix | Delete

*/

[34] Fix | Delete

class WP_Filesystem_SSH2 extends WP_Filesystem_Base {

[35] Fix | Delete

[36] Fix | Delete

/**

[37] Fix | Delete

* @since 2.7.0

[38] Fix | Delete

* @var resource

[39] Fix | Delete

*/

[40] Fix | Delete

public $link = false;

[41] Fix | Delete

[42] Fix | Delete

/**

[43] Fix | Delete

* @since 2.7.0

[44] Fix | Delete

* @var resource

[45] Fix | Delete

*/

[46] Fix | Delete

public $sftp_link;

[47] Fix | Delete

[48] Fix | Delete

/**

[49] Fix | Delete

* @since 2.7.0

[50] Fix | Delete

* @var bool

[51] Fix | Delete

*/

[52] Fix | Delete

public $keys = false;

[53] Fix | Delete

[54] Fix | Delete

/**

[55] Fix | Delete

* Constructor.

[56] Fix | Delete

*

[57] Fix | Delete

* @since 2.7.0

[58] Fix | Delete

*

[59] Fix | Delete

* @param array $opt

[60] Fix | Delete

*/

[61] Fix | Delete

public function __construct( $opt = '' ) {

[62] Fix | Delete

$this->method = 'ssh2';

[63] Fix | Delete

$this->errors = new WP_Error();

[64] Fix | Delete

[65] Fix | Delete

// Check if possible to use ssh2 functions.

[66] Fix | Delete

if ( ! extension_loaded( 'ssh2' ) ) {

[67] Fix | Delete

$this->errors->add( 'no_ssh2_ext', __( 'The ssh2 PHP extension is not available' ) );

[68] Fix | Delete

return;

[69] Fix | Delete

}

[70] Fix | Delete

[71] Fix | Delete

// Set defaults:

[72] Fix | Delete

if ( empty( $opt['port'] ) ) {

[73] Fix | Delete

$this->options['port'] = 22;

[74] Fix | Delete

} else {

[75] Fix | Delete

$this->options['port'] = $opt['port'];

[76] Fix | Delete

}

[77] Fix | Delete

[78] Fix | Delete

if ( empty( $opt['hostname'] ) ) {

[79] Fix | Delete

$this->errors->add( 'empty_hostname', __( 'SSH2 hostname is required' ) );

[80] Fix | Delete

} else {

[81] Fix | Delete

$this->options['hostname'] = $opt['hostname'];

[82] Fix | Delete

}

[83] Fix | Delete

[84] Fix | Delete

// Check if the options provided are OK.

[85] Fix | Delete

if ( ! empty( $opt['public_key'] ) && ! empty( $opt['private_key'] ) ) {

[86] Fix | Delete

$this->options['public_key'] = $opt['public_key'];

[87] Fix | Delete

$this->options['private_key'] = $opt['private_key'];

[88] Fix | Delete

[89] Fix | Delete

$this->options['hostkey'] = array( 'hostkey' => 'ssh-rsa,ssh-ed25519' );

[90] Fix | Delete

[91] Fix | Delete

$this->keys = true;

[92] Fix | Delete

} elseif ( empty( $opt['username'] ) ) {

[93] Fix | Delete

$this->errors->add( 'empty_username', __( 'SSH2 username is required' ) );

[94] Fix | Delete

}

[95] Fix | Delete

[96] Fix | Delete

if ( ! empty( $opt['username'] ) ) {

[97] Fix | Delete

$this->options['username'] = $opt['username'];

[98] Fix | Delete

}

[99] Fix | Delete

[100] Fix | Delete

if ( empty( $opt['password'] ) ) {

[101] Fix | Delete

// Password can be blank if we are using keys.

[102] Fix | Delete

if ( ! $this->keys ) {

[103] Fix | Delete

$this->errors->add( 'empty_password', __( 'SSH2 password is required' ) );

[104] Fix | Delete

} else {

[105] Fix | Delete

$this->options['password'] = null;

[106] Fix | Delete

}

[107] Fix | Delete

} else {

[108] Fix | Delete

$this->options['password'] = $opt['password'];

[109] Fix | Delete

}

[110] Fix | Delete

}

[111] Fix | Delete

[112] Fix | Delete

/**

[113] Fix | Delete

* Connects filesystem.

[114] Fix | Delete

*

[115] Fix | Delete

* @since 2.7.0

[116] Fix | Delete

*

[117] Fix | Delete

* @return bool True on success, false on failure.

[118] Fix | Delete

*/

[119] Fix | Delete

public function connect() {

[120] Fix | Delete

if ( ! $this->keys ) {

[121] Fix | Delete

$this->link = @ssh2_connect( $this->options['hostname'], $this->options['port'] );

[122] Fix | Delete

} else {

[123] Fix | Delete

$this->link = @ssh2_connect( $this->options['hostname'], $this->options['port'], $this->options['hostkey'] );

[124] Fix | Delete

}

[125] Fix | Delete

[126] Fix | Delete

if ( ! $this->link ) {

[127] Fix | Delete

$this->errors->add(

[128] Fix | Delete

'connect',

[129] Fix | Delete

sprintf(

[130] Fix | Delete

/* translators: %s: hostname:port */

[131] Fix | Delete

__( 'Failed to connect to SSH2 Server %s' ),

[132] Fix | Delete

$this->options['hostname'] . ':' . $this->options['port']

[133] Fix | Delete

)

[134] Fix | Delete

);

[135] Fix | Delete

[136] Fix | Delete

return false;

[137] Fix | Delete

}

[138] Fix | Delete

[139] Fix | Delete

if ( ! $this->keys ) {

[140] Fix | Delete

if ( ! @ssh2_auth_password( $this->link, $this->options['username'], $this->options['password'] ) ) {

[141] Fix | Delete

$this->errors->add(

[142] Fix | Delete

'auth',

[143] Fix | Delete

sprintf(

[144] Fix | Delete

/* translators: %s: Username. */

[145] Fix | Delete

__( 'Username/Password incorrect for %s' ),

[146] Fix | Delete

$this->options['username']

[147] Fix | Delete

)

[148] Fix | Delete

);

[149] Fix | Delete

[150] Fix | Delete

return false;

[151] Fix | Delete

}

[152] Fix | Delete

} else {

[153] Fix | Delete

if ( ! @ssh2_auth_pubkey_file( $this->link, $this->options['username'], $this->options['public_key'], $this->options['private_key'], $this->options['password'] ) ) {

[154] Fix | Delete

$this->errors->add(

[155] Fix | Delete

'auth',

[156] Fix | Delete

sprintf(

[157] Fix | Delete

/* translators: %s: Username. */

[158] Fix | Delete

__( 'Public and Private keys incorrect for %s' ),

[159] Fix | Delete

$this->options['username']

[160] Fix | Delete

)

[161] Fix | Delete

);

[162] Fix | Delete

[163] Fix | Delete

return false;

[164] Fix | Delete

}

[165] Fix | Delete

}

[166] Fix | Delete

[167] Fix | Delete

$this->sftp_link = ssh2_sftp( $this->link );

[168] Fix | Delete

[169] Fix | Delete

if ( ! $this->sftp_link ) {

[170] Fix | Delete

$this->errors->add(

[171] Fix | Delete

'connect',

[172] Fix | Delete

sprintf(

[173] Fix | Delete

/* translators: %s: hostname:port */

[174] Fix | Delete

__( 'Failed to initialize a SFTP subsystem session with the SSH2 Server %s' ),

[175] Fix | Delete

$this->options['hostname'] . ':' . $this->options['port']

[176] Fix | Delete

)

[177] Fix | Delete

);

[178] Fix | Delete

[179] Fix | Delete

return false;

[180] Fix | Delete

}

[181] Fix | Delete

[182] Fix | Delete

return true;

[183] Fix | Delete

}

[184] Fix | Delete

[185] Fix | Delete

/**

[186] Fix | Delete

* Gets the ssh2.sftp PHP stream wrapper path to open for the given file.

[187] Fix | Delete

*

[188] Fix | Delete

* This method also works around a PHP bug where the root directory (/) cannot

[189] Fix | Delete

* be opened by PHP functions, causing a false failure. In order to work around

[190] Fix | Delete

* this, the path is converted to /./ which is semantically the same as /

[191] Fix | Delete

* See https://bugs.php.net/bug.php?id=64169 for more details.

[192] Fix | Delete

*

[193] Fix | Delete

* @since 4.4.0

[194] Fix | Delete

*

[195] Fix | Delete

* @param string $path The File/Directory path on the remote server to return

[196] Fix | Delete

* @return string The ssh2.sftp:// wrapped path to use.

[197] Fix | Delete

*/

[198] Fix | Delete

public function sftp_path( $path ) {

[199] Fix | Delete

if ( '/' === $path ) {

[200] Fix | Delete

$path = '/./';

[201] Fix | Delete

}

[202] Fix | Delete

[203] Fix | Delete

return 'ssh2.sftp://' . $this->sftp_link . '/' . ltrim( $path, '/' );

[204] Fix | Delete

}

[205] Fix | Delete

[206] Fix | Delete

/**

[207] Fix | Delete

* @since 2.7.0

[208] Fix | Delete

*

[209] Fix | Delete

* @param string $command

[210] Fix | Delete

* @param bool $returnbool

[211] Fix | Delete

* @return bool|string True on success, false on failure. String if the command was executed, `$returnbool`

[212] Fix | Delete

* is false (default), and data from the resulting stream was retrieved.

[213] Fix | Delete

*/

[214] Fix | Delete

public function run_command( $command, $returnbool = false ) {

[215] Fix | Delete

if ( ! $this->link ) {

[216] Fix | Delete

return false;

[217] Fix | Delete

}

[218] Fix | Delete

[219] Fix | Delete

$stream = ssh2_exec( $this->link, $command );

[220] Fix | Delete

[221] Fix | Delete

if ( ! $stream ) {

[222] Fix | Delete

$this->errors->add(

[223] Fix | Delete

'command',

[224] Fix | Delete

sprintf(

[225] Fix | Delete

/* translators: %s: Command. */

[226] Fix | Delete

__( 'Unable to perform command: %s' ),

[227] Fix | Delete

$command

[228] Fix | Delete

)

[229] Fix | Delete

);

[230] Fix | Delete

} else {

[231] Fix | Delete

stream_set_blocking( $stream, true );

[232] Fix | Delete

stream_set_timeout( $stream, FS_TIMEOUT );

[233] Fix | Delete

$data = stream_get_contents( $stream );

[234] Fix | Delete

fclose( $stream );

[235] Fix | Delete

[236] Fix | Delete

if ( $returnbool ) {

[237] Fix | Delete

return ( false === $data ) ? false : '' !== trim( $data );

[238] Fix | Delete

} else {

[239] Fix | Delete

return $data;

[240] Fix | Delete

}

[241] Fix | Delete

}

[242] Fix | Delete

[243] Fix | Delete

return false;

[244] Fix | Delete

}

[245] Fix | Delete

[246] Fix | Delete

/**

[247] Fix | Delete

* Reads entire file into a string.

[248] Fix | Delete

*

[249] Fix | Delete

* @since 2.7.0

[250] Fix | Delete

*

[251] Fix | Delete

* @param string $file Name of the file to read.

[252] Fix | Delete

* @return string|false Read data on success, false if no temporary file could be opened,

[253] Fix | Delete

* or if the file couldn't be retrieved.

[254] Fix | Delete

*/

[255] Fix | Delete

public function get_contents( $file ) {

[256] Fix | Delete

return file_get_contents( $this->sftp_path( $file ) );

[257] Fix | Delete

}

[258] Fix | Delete

[259] Fix | Delete

/**

[260] Fix | Delete

* Reads entire file into an array.

[261] Fix | Delete

*

[262] Fix | Delete

* @since 2.7.0

[263] Fix | Delete

*

[264] Fix | Delete

* @param string $file Path to the file.

[265] Fix | Delete

* @return array|false File contents in an array on success, false on failure.

[266] Fix | Delete

*/

[267] Fix | Delete

public function get_contents_array( $file ) {

[268] Fix | Delete

return file( $this->sftp_path( $file ) );

[269] Fix | Delete

}

[270] Fix | Delete

[271] Fix | Delete

/**

[272] Fix | Delete

* Writes a string to a file.

[273] Fix | Delete

*

[274] Fix | Delete

* @since 2.7.0

[275] Fix | Delete

*

[276] Fix | Delete

* @param string $file Remote path to the file where to write the data.

[277] Fix | Delete

* @param string $contents The data to write.

[278] Fix | Delete

* @param int|false $mode Optional. The file permissions as octal number, usually 0644.

[279] Fix | Delete

* Default false.

[280] Fix | Delete

* @return bool True on success, false on failure.

[281] Fix | Delete

*/

[282] Fix | Delete

public function put_contents( $file, $contents, $mode = false ) {

[283] Fix | Delete

$ret = file_put_contents( $this->sftp_path( $file ), $contents );

[284] Fix | Delete

[285] Fix | Delete

if ( strlen( $contents ) !== $ret ) {

[286] Fix | Delete

return false;

[287] Fix | Delete

}

[288] Fix | Delete

[289] Fix | Delete

$this->chmod( $file, $mode );

[290] Fix | Delete

[291] Fix | Delete

return true;

[292] Fix | Delete

}

[293] Fix | Delete

[294] Fix | Delete

/**

[295] Fix | Delete

* Gets the current working directory.

[296] Fix | Delete

*

[297] Fix | Delete

* @since 2.7.0

[298] Fix | Delete

*

[299] Fix | Delete

* @return string|false The current working directory on success, false on failure.

[300] Fix | Delete

*/

[301] Fix | Delete

public function cwd() {

[302] Fix | Delete

$cwd = ssh2_sftp_realpath( $this->sftp_link, '.' );

[303] Fix | Delete

[304] Fix | Delete

if ( $cwd ) {

[305] Fix | Delete

$cwd = trailingslashit( trim( $cwd ) );

[306] Fix | Delete

}

[307] Fix | Delete

[308] Fix | Delete

return $cwd;

[309] Fix | Delete

}

[310] Fix | Delete

[311] Fix | Delete

/**

[312] Fix | Delete

* Changes current directory.

[313] Fix | Delete

*

[314] Fix | Delete

* @since 2.7.0

[315] Fix | Delete

*

[316] Fix | Delete

* @param string $dir The new current directory.

[317] Fix | Delete

* @return bool True on success, false on failure.

[318] Fix | Delete

*/

[319] Fix | Delete

public function chdir( $dir ) {

[320] Fix | Delete

return $this->run_command( 'cd ' . $dir, true );

[321] Fix | Delete

}

[322] Fix | Delete

[323] Fix | Delete

/**

[324] Fix | Delete

* Changes the file group.

[325] Fix | Delete

*

[326] Fix | Delete

* @since 2.7.0

[327] Fix | Delete

*

[328] Fix | Delete

* @param string $file Path to the file.

[329] Fix | Delete

* @param string|int $group A group name or number.

[330] Fix | Delete

* @param bool $recursive Optional. If set to true, changes file group recursively.

[331] Fix | Delete

* Default false.

[332] Fix | Delete

* @return bool True on success, false on failure.

[333] Fix | Delete

*/

[334] Fix | Delete

public function chgrp( $file, $group, $recursive = false ) {

[335] Fix | Delete

if ( ! $this->exists( $file ) ) {

[336] Fix | Delete

return false;

[337] Fix | Delete

}

[338] Fix | Delete

[339] Fix | Delete

if ( ! $recursive || ! $this->is_dir( $file ) ) {

[340] Fix | Delete

return $this->run_command( sprintf( 'chgrp %s %s', escapeshellarg( $group ), escapeshellarg( $file ) ), true );

[341] Fix | Delete

}

[342] Fix | Delete

[343] Fix | Delete

return $this->run_command( sprintf( 'chgrp -R %s %s', escapeshellarg( $group ), escapeshellarg( $file ) ), true );

[344] Fix | Delete

}

[345] Fix | Delete

[346] Fix | Delete

/**

[347] Fix | Delete

* Changes filesystem permissions.

[348] Fix | Delete

*

[349] Fix | Delete

* @since 2.7.0

[350] Fix | Delete

*

[351] Fix | Delete

* @param string $file Path to the file.

[352] Fix | Delete

* @param int|false $mode Optional. The permissions as octal number, usually 0644 for files,

[353] Fix | Delete

* 0755 for directories. Default false.

[354] Fix | Delete

* @param bool $recursive Optional. If set to true, changes file permissions recursively.

[355] Fix | Delete

* Default false.

[356] Fix | Delete

* @return bool True on success, false on failure.

[357] Fix | Delete

*/

[358] Fix | Delete

public function chmod( $file, $mode = false, $recursive = false ) {

[359] Fix | Delete

if ( ! $this->exists( $file ) ) {

[360] Fix | Delete

return false;

[361] Fix | Delete

}

[362] Fix | Delete

[363] Fix | Delete

if ( ! $mode ) {

[364] Fix | Delete

if ( $this->is_file( $file ) ) {

[365] Fix | Delete

$mode = FS_CHMOD_FILE;

[366] Fix | Delete

} elseif ( $this->is_dir( $file ) ) {

[367] Fix | Delete

$mode = FS_CHMOD_DIR;

[368] Fix | Delete

} else {

[369] Fix | Delete

return false;

[370] Fix | Delete

}

[371] Fix | Delete

}

[372] Fix | Delete

[373] Fix | Delete

if ( ! $recursive || ! $this->is_dir( $file ) ) {

[374] Fix | Delete

return $this->run_command( sprintf( 'chmod %o %s', $mode, escapeshellarg( $file ) ), true );

[375] Fix | Delete

}

[376] Fix | Delete

[377] Fix | Delete

return $this->run_command( sprintf( 'chmod -R %o %s', $mode, escapeshellarg( $file ) ), true );

[378] Fix | Delete

}

[379] Fix | Delete

[380] Fix | Delete

/**

[381] Fix | Delete

* Changes the owner of a file or directory.

[382] Fix | Delete

*

[383] Fix | Delete

* @since 2.7.0

[384] Fix | Delete

*

[385] Fix | Delete

* @param string $file Path to the file or directory.

[386] Fix | Delete

* @param string|int $owner A user name or number.

[387] Fix | Delete

* @param bool $recursive Optional. If set to true, changes file owner recursively.

[388] Fix | Delete

* Default false.

[389] Fix | Delete

* @return bool True on success, false on failure.

[390] Fix | Delete

*/

[391] Fix | Delete

public function chown( $file, $owner, $recursive = false ) {

[392] Fix | Delete

if ( ! $this->exists( $file ) ) {

[393] Fix | Delete

return false;

[394] Fix | Delete

}

[395] Fix | Delete

[396] Fix | Delete

if ( ! $recursive || ! $this->is_dir( $file ) ) {

[397] Fix | Delete

return $this->run_command( sprintf( 'chown %s %s', escapeshellarg( $owner ), escapeshellarg( $file ) ), true );

[398] Fix | Delete

}

[399] Fix | Delete

[400] Fix | Delete

return $this->run_command( sprintf( 'chown -R %s %s', escapeshellarg( $owner ), escapeshellarg( $file ) ), true );

[401] Fix | Delete

}

[402] Fix | Delete

[403] Fix | Delete

/**

[404] Fix | Delete

* Gets the file owner.

[405] Fix | Delete

*

[406] Fix | Delete

* @since 2.7.0

[407] Fix | Delete

*

[408] Fix | Delete

* @param string $file Path to the file.

[409] Fix | Delete

* @return string|false Username of the owner on success, false on failure.

[410] Fix | Delete

*/

[411] Fix | Delete

public function owner( $file ) {

[412] Fix | Delete

$owneruid = @fileowner( $this->sftp_path( $file ) );

[413] Fix | Delete

[414] Fix | Delete

if ( ! $owneruid ) {

[415] Fix | Delete

return false;

[416] Fix | Delete

}

[417] Fix | Delete

[418] Fix | Delete

if ( ! function_exists( 'posix_getpwuid' ) ) {

[419] Fix | Delete

return $owneruid;

[420] Fix | Delete

}

[421] Fix | Delete

[422] Fix | Delete

$ownerarray = posix_getpwuid( $owneruid );

[423] Fix | Delete

[424] Fix | Delete

if ( ! $ownerarray ) {

[425] Fix | Delete

return false;

[426] Fix | Delete

}

[427] Fix | Delete

[428] Fix | Delete

return $ownerarray['name'];

[429] Fix | Delete

}

[430] Fix | Delete

[431] Fix | Delete

/**

[432] Fix | Delete

* Gets the permissions of the specified file or filepath in their octal format.

[433] Fix | Delete

*

[434] Fix | Delete

* @since 2.7.0

[435] Fix | Delete

*

[436] Fix | Delete

* @param string $file Path to the file.

[437] Fix | Delete

* @return string Mode of the file (the last 3 digits).

[438] Fix | Delete

*/

[439] Fix | Delete

public function getchmod( $file ) {

[440] Fix | Delete

return substr( decoct( @fileperms( $this->sftp_path( $file ) ) ), -3 );

[441] Fix | Delete

}

[442] Fix | Delete

[443] Fix | Delete

/**

[444] Fix | Delete

* Gets the file's group.

[445] Fix | Delete

*

[446] Fix | Delete

* @since 2.7.0

[447] Fix | Delete

*

[448] Fix | Delete

* @param string $file Path to the file.

[449] Fix | Delete

* @return string|false The group on success, false on failure.

[450] Fix | Delete

*/

[451] Fix | Delete

public function group( $file ) {

[452] Fix | Delete

$gid = @filegroup( $this->sftp_path( $file ) );

[453] Fix | Delete

[454] Fix | Delete

if ( ! $gid ) {

[455] Fix | Delete

return false;

[456] Fix | Delete

}

[457] Fix | Delete

[458] Fix | Delete

if ( ! function_exists( 'posix_getgrgid' ) ) {

[459] Fix | Delete

return $gid;

[460] Fix | Delete

}

[461] Fix | Delete

[462] Fix | Delete

$grouparray = posix_getgrgid( $gid );

[463] Fix | Delete

[464] Fix | Delete

if ( ! $grouparray ) {

[465] Fix | Delete

return false;

[466] Fix | Delete

}

[467] Fix | Delete

[468] Fix | Delete

return $grouparray['name'];

[469] Fix | Delete

}

[470] Fix | Delete

[471] Fix | Delete

/**

[472] Fix | Delete

* Copies a file.

[473] Fix | Delete

*

[474] Fix | Delete

* @since 2.7.0

[475] Fix | Delete

*

[476] Fix | Delete

* @param string $source Path to the source file.

[477] Fix | Delete

* @param string $destination Path to the destination file.

[478] Fix | Delete

* @param bool $overwrite Optional. Whether to overwrite the destination file if it exists.

[479] Fix | Delete

* Default false.

[480] Fix | Delete

* @param int|false $mode Optional. The permissions as octal number, usually 0644 for files,

[481] Fix | Delete

* 0755 for dirs. Default false.

[482] Fix | Delete

* @return bool True on success, false on failure.

[483] Fix | Delete

*/

[484] Fix | Delete

public function copy( $source, $destination, $overwrite = false, $mode = false ) {

[485] Fix | Delete

if ( ! $overwrite && $this->exists( $destination ) ) {

[486] Fix | Delete

return false;

[487] Fix | Delete

}

[488] Fix | Delete

[489] Fix | Delete

$content = $this->get_contents( $source );

[490] Fix | Delete

[491] Fix | Delete

if ( false === $content ) {

[492] Fix | Delete

return false;

[493] Fix | Delete

}

[494] Fix | Delete

[495] Fix | Delete

return $this->put_contents( $destination, $content, $mode );

[496] Fix | Delete

}

[497] Fix | Delete

[498] Fix | Delete

/**

[499] Fix | Delete