FM / includes

/home/techb158/public_html/wp-admin/includes/

/home/techb158/public_html/wp-admin/includes

Name	Size	Mode	Actions
admin-filters.php	8034	0666	edit dl rm
admin.php	3628	0666	edit dl rm
ajax-actions.php	153540	0666	edit dl rm
bookmark.php	11678	0666	edit dl rm
class-automatic-upgrader-skin.php	3663	0666	edit dl rm
class-bulk-plugin-upgrader-skin.php	2590	0666	edit dl rm
class-bulk-theme-upgrader-skin.php	2660	0666	edit dl rm
class-bulk-upgrader-skin.php	6661	0666	edit dl rm
class-core-upgrader.php	15198	0666	edit dl rm
class-custom-background.php	21750	0666	edit dl rm
class-custom-image-header.php	49249	0666	edit dl rm
class-file-upload-upgrader.php	4163	0666	edit dl rm
class-ftp-pure.php	5426	0666	edit dl rm
class-ftp-sockets.php	8479	0666	edit dl rm
class-ftp.php	27342	0666	edit dl rm
class-language-pack-upgrader-skin.php	2870	0666	edit dl rm
class-language-pack-upgrader.php	15528	0666	edit dl rm
class-pclzip.php	196667	0666	edit dl rm
class-plugin-installer-skin.php	11947	0666	edit dl rm
class-plugin-upgrader-skin.php	3278	0666	edit dl rm
class-plugin-upgrader.php	23249	0666	edit dl rm
class-theme-installer-skin.php	12974	0666	edit dl rm
class-theme-upgrader-skin.php	4176	0666	edit dl rm
class-theme-upgrader.php	26783	0666	edit dl rm
class-walker-category-checklist.php	5092	0666	edit dl rm
class-walker-nav-menu-checklist.php	5781	0666	edit dl rm
class-walker-nav-menu-edit.php	14298	0666	edit dl rm
class-wp-ajax-upgrader-skin.php	4193	0666	edit dl rm
class-wp-application-passwords-list-table.php	6949	0666	edit dl rm
class-wp-automatic-updater.php	61905	0666	edit dl rm
class-wp-comments-list-table.php	34620	0666	edit dl rm
class-wp-community-events.php	18647	0666	edit dl rm
class-wp-debug-data.php	71043	0666	edit dl rm
class-wp-filesystem-base.php	25622	0666	edit dl rm
class-wp-filesystem-direct.php	19166	0666	edit dl rm
class-wp-filesystem-ftpext.php	24926	0666	edit dl rm
class-wp-filesystem-ftpsockets.php	20356	0666	edit dl rm
class-wp-filesystem-ssh2.php	25815	0666	edit dl rm
class-wp-importer.php	8279	0666	edit dl rm
class-wp-internal-pointers.php	4593	0666	edit dl rm
class-wp-links-list-table.php	10103	0666	edit dl rm
class-wp-list-table-compat.php	1497	0666	edit dl rm
class-wp-list-table.php	54873	0666	edit dl rm
class-wp-media-list-table.php	27786	0666	edit dl rm
class-wp-ms-sites-list-table.php	23598	0666	edit dl rm
class-wp-ms-themes-list-table.php	30266	0666	edit dl rm
class-wp-ms-users-list-table.php	16188	0666	edit dl rm
class-wp-plugin-install-list-table.php	25076	0666	edit dl rm
class-wp-plugins-list-table.php	61549	0666	edit dl rm
class-wp-post-comments-list-table.php	1453	0666	edit dl rm
class-wp-posts-list-table.php	68457	0666	edit dl rm
class-wp-privacy-data-export-requests-list-table.php	6026	0666	edit dl rm
class-wp-privacy-data-removal-requests-list-table.php	6178	0666	edit dl rm
class-wp-privacy-policy-content.php	33021	0666	edit dl rm
class-wp-privacy-requests-table.php	14806	0666	edit dl rm
class-wp-screen.php	37566	0666	edit dl rm
class-wp-site-health-auto-updates.php	14337	0666	edit dl rm
class-wp-site-health.php	131168	0666	edit dl rm
class-wp-site-icon.php	6489	0666	edit dl rm
class-wp-terms-list-table.php	21584	0666	edit dl rm
class-wp-theme-install-list-table.php	15703	0666	edit dl rm
class-wp-themes-list-table.php	10339	0666	edit dl rm
class-wp-upgrader-skin.php	7064	0666	edit dl rm
class-wp-upgrader-skins.php	1477	0666	edit dl rm
class-wp-upgrader.php	48367	0666	edit dl rm
class-wp-users-list-table.php	19351	0666	edit dl rm
comment.php	9457	0666	edit dl rm
continents-cities.php	20540	0666	edit dl rm
credits.php	5832	0666	edit dl rm
dashboard.php	70616	0666	edit dl rm
deprecated.php	41960	0666	edit dl rm
edit-tag-messages.php	1478	0666	edit dl rm
export.php	25976	0666	edit dl rm
file.php	98424	0666	edit dl rm
image-edit.php	44147	0666	edit dl rm
image.php	45172	0666	edit dl rm
import.php	6617	0666	edit dl rm
list-table.php	3802	0666	edit dl rm
media.php	120188	0666	edit dl rm
menu.php	9640	0666	edit dl rm
meta-boxes.php	66857	0666	edit dl rm
misc.php	46443	0666	edit dl rm
ms-admin-filters.php	1296	0666	edit dl rm
ms-deprecated.php	3770	0666	edit dl rm
ms.php	35959	0666	edit dl rm
nav-menu.php	49136	0666	edit dl rm
network.php	27038	0666	edit dl rm
noop.php	1148	0666	edit dl rm
options.php	4303	0666	edit dl rm
plugin-install.php	39187	0666	edit dl rm
plugin.php	93295	0666	edit dl rm
post.php	82229	0666	edit dl rm
privacy-tools.php	33732	0666	edit dl rm
revision.php	16629	0666	edit dl rm
schema.php	45583	0666	edit dl rm
screen.php	6390	0666	edit dl rm
taxonomy.php	8483	0666	edit dl rm
template.php	99830	0666	edit dl rm
theme-install.php	7010	0666	edit dl rm
theme.php	47533	0666	edit dl rm
translation-install.php	11048	0666	edit dl rm
update-core.php	86142	0666	edit dl rm
update.php	34829	0666	edit dl rm
upgrade.php	116674	0666	edit dl rm
user.php	23913	0666	edit dl rm
widgets.php	10546	0666	edit dl rm

Edit: /home/techb158/public_html/wp-admin/includes/class-wp-filesystem-ftpext.php (24926B)

<?php
/**
 * WordPress FTP Filesystem.
 *
 * @package WordPress
 * @subpackage Filesystem
 */

/**
 * WordPress Filesystem Class for implementing FTP.
 *
 * @since 2.5.0
 *
 * @see WP_Filesystem_Base
 * @phpstan-type Options array{
 *     hostname: string,
 *     username: string,
 *     password: string,
 *     port: non-negative-int,
 *     ssl: bool,
 * }
 * @phpstan-import-type FileListing from WP_Filesystem_Base
 */
class WP_Filesystem_FTPext extends WP_Filesystem_Base {

/**
	 * @since 2.5.0
	 * @var FTP\Connection|resource|false
	 */
	public $link;

/**
	 * @since 7.1.0
	 * @var array
	 * @phpstan-var Options
	 */
	public $options;

/**
	 * Constructor.
	 *
	 * @since 2.5.0
	 *
	 * @param array $opt {
	 *     Array of connection options.
	 *
	 *     @type string $hostname        Required. FTP server hostname.
	 *     @type string $username        Required. FTP username.
	 *     @type string $password        Required. FTP password.
	 *     @type int    $port            Optional. FTP server port. Default 21.
	 *     @type string $connection_type Optional. Connection type. Use 'ftps' to enable SSL.
	 * }
	 * @phpstan-param array{
	 *     hostname: non-empty-string,
	 *     username: non-empty-string,
	 *     password: string,
	 *     port?: non-negative-int,
	 *     connection_type?: 'ftps',
	 * }|null $opt
	 */
	public function __construct( $opt = null ) {
		$this->method  = 'ftpext';
		$this->errors  = new WP_Error();
		$this->options = array(
			'port'     => 21,
			'hostname' => '',
			'username' => '',
			'password' => '',
			'ssl'      => false,
		);

// Check if possible to use ftp functions.
		if ( ! extension_loaded( 'ftp' ) ) {
			$this->errors->add( 'no_ftp_ext', __( 'The ftp PHP extension is not available' ) );
			return;
		}

// This class uses the timeout on a per-connection basis, others use it on a per-action basis.
		if ( ! defined( 'FS_TIMEOUT' ) ) {
			define( 'FS_TIMEOUT', 4 * MINUTE_IN_SECONDS );
		}

if ( ! is_array( $opt ) ) {
			$opt = array();
		}

if ( ! empty( $opt['port'] ) ) {
			$this->options['port'] = $opt['port'];
		}

if ( empty( $opt['hostname'] ) ) {
			$this->errors->add( 'empty_hostname', __( 'FTP hostname is required' ) );
		} else {
			$this->options['hostname'] = $opt['hostname'];
		}

// Check if the options provided are OK.
		if ( empty( $opt['username'] ) ) {
			$this->errors->add( 'empty_username', __( 'FTP username is required' ) );
		} else {
			$this->options['username'] = $opt['username'];
		}

if ( empty( $opt['password'] ) ) {
			$this->errors->add( 'empty_password', __( 'FTP password is required' ) );
		} else {
			$this->options['password'] = $opt['password'];
		}

if ( isset( $opt['connection_type'] ) && 'ftps' === $opt['connection_type'] ) {
			$this->options['ssl'] = true;
		}
	}

/**
	 * Connects filesystem.
	 *
	 * @since 2.5.0
	 *
	 * @return bool True on success, false on failure.
	 */
	public function connect() {
		/*
		 * Bail if the constructor recorded a configuration error. Connection and
		 * authentication errors are excluded so that a failed connection attempt
		 * can be retried on the same instance.
		 */
		if ( $this->errors->has_errors() && ! array_intersect( array( 'connect', 'auth' ), $this->errors->get_error_codes() ) ) {
			return false;
		}

if ( isset( $this->options['ssl'] ) && $this->options['ssl'] && function_exists( 'ftp_ssl_connect' ) ) {
			$this->link = @ftp_ssl_connect( $this->options['hostname'], $this->options['port'], FS_CONNECT_TIMEOUT );
		} else {
			$this->link = @ftp_connect( $this->options['hostname'], $this->options['port'], FS_CONNECT_TIMEOUT );
		}

if ( ! $this->link ) {
			$this->errors->add(
				'connect',
				sprintf(
					/* translators: %s: hostname:port */
					__( 'Failed to connect to FTP Server %s' ),
					$this->options['hostname'] . ':' . $this->options['port']
				)
			);

return false;
		}

if ( ! @ftp_login( $this->link, $this->options['username'], $this->options['password'] ) ) {
			$this->errors->add(
				'auth',
				sprintf(
					/* translators: %s: Username. */
					__( 'Username/Password incorrect for %s' ),
					$this->options['username']
				)
			);

return false;
		}

// Set the connection to use Passive FTP.
		ftp_pasv( $this->link, true );

if ( @ftp_get_option( $this->link, FTP_TIMEOUT_SEC ) < FS_TIMEOUT ) {
			@ftp_set_option( $this->link, FTP_TIMEOUT_SEC, FS_TIMEOUT );
		}

return true;
	}

/**
	 * Reads entire file into a string.
	 *
	 * @since 2.5.0
	 *
	 * @param string $file Name of the file to read.
	 * @return string|false Read data on success, false if no temporary file could be opened,
	 *                      or if the file couldn't be retrieved.
	 */
	public function get_contents( $file ) {
		if ( ! $this->link ) {
			return false;
		}

$tempfile   = wp_tempnam( $file );
		$temphandle = fopen( $tempfile, 'w+' );

if ( ! $temphandle ) {
			unlink( $tempfile );
			return false;
		}

if ( ! ftp_fget( $this->link, $temphandle, $file, FTP_BINARY ) ) {
			fclose( $temphandle );
			unlink( $tempfile );
			return false;
		}

fseek( $temphandle, 0 ); // Skip back to the start of the file being written to.
		$contents = '';

while ( ! feof( $temphandle ) ) {
			$contents .= fread( $temphandle, 8 * KB_IN_BYTES );
		}

fclose( $temphandle );
		unlink( $tempfile );

return $contents;
	}

/**
	 * Reads entire file into an array.
	 *
	 * @since 2.5.0
	 *
	 * @param string $file Path to the file.
	 * @return string[]|false File contents in an array on success, false on failure.
	 */
	public function get_contents_array( $file ) {
		$contents = $this->get_contents( $file );
		if ( is_string( $contents ) ) {
			return explode( "\n", $contents );
		}
		return false;
	}

/**
	 * Writes a string to a file.
	 *
	 * @since 2.5.0
	 *
	 * @param string    $file     Remote path to the file where to write the data.
	 * @param string    $contents The data to write.
	 * @param int|false $mode     Optional. The file permissions as octal number, usually 0644.
	 *                            Default false.
	 * @return bool True on success, false on failure.
	 */
	public function put_contents( $file, $contents, $mode = false ) {
		$tempfile   = wp_tempnam( $file );
		$temphandle = fopen( $tempfile, 'wb+' );

if ( ! $temphandle ) {
			unlink( $tempfile );
			return false;
		}

mbstring_binary_safe_encoding();

$data_length   = strlen( $contents );
		$bytes_written = fwrite( $temphandle, $contents );

reset_mbstring_encoding();

if ( $data_length !== $bytes_written ) {
			fclose( $temphandle );
			unlink( $tempfile );
			return false;
		}

fseek( $temphandle, 0 ); // Skip back to the start of the file being written to.

$ret = ftp_fput( $this->link, $file, $temphandle, FTP_BINARY );

fclose( $temphandle );
		unlink( $tempfile );

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

return $ret;
	}

/**
	 * Gets the current working directory.
	 *
	 * @since 2.5.0
	 *
	 * @return string|false The current working directory on success, false on failure.
	 */
	public function cwd() {
		$cwd = ftp_pwd( $this->link );

if ( $cwd ) {
			$cwd = trailingslashit( $cwd );
		}

return $cwd;
	}

/**
	 * Changes current directory.
	 *
	 * @since 2.5.0
	 *
	 * @param string $dir The new current directory.
	 * @return bool True on success, false on failure.
	 */
	public function chdir( $dir ) {
		return @ftp_chdir( $this->link, $dir );
	}

/**
	 * Changes filesystem permissions.
	 *
	 * @since 2.5.0
	 *
	 * @param string    $file      Path to the file.
	 * @param int|false $mode      Optional. The permissions as octal number, usually 0644 for files,
	 *                             0755 for directories. Default false.
	 * @param bool      $recursive Optional. If set to true, changes file permissions recursively.
	 *                             Default false.
	 * @return bool True on success, false on failure.
	 */
	public function chmod( $file, $mode = false, $recursive = false ) {
		if ( ! $mode ) {
			if ( $this->is_file( $file ) ) {
				$mode = FS_CHMOD_FILE;
			} elseif ( $this->is_dir( $file ) ) {
				$mode = FS_CHMOD_DIR;
			} else {
				return false;
			}
		}

// chmod any sub-objects if recursive.
		if ( $recursive && $this->is_dir( $file ) ) {
			$filelist = $this->dirlist( $file );

foreach ( (array) $filelist as $filename => $filemeta ) {
				$this->chmod( $file . '/' . $filename, $mode, $recursive );
			}
		}

// chmod the file or directory.
		if ( ! function_exists( 'ftp_chmod' ) ) {
			return (bool) ftp_site( $this->link, sprintf( 'CHMOD %o %s', $mode, $file ) );
		}

return (bool) ftp_chmod( $this->link, $mode, $file );
	}

/**
	 * Gets the file owner.
	 *
	 * @since 2.5.0
	 *
	 * @param string $file Path to the file.
	 * @return string|int<1, max>|false Username of the owner on success, false on failure.
	 */
	public function owner( $file ) {
		$dir = $this->dirlist( $file );

return $dir[ $file ]['owner'] ?? '';
	}

/**
	 * Gets the permissions of the specified file or filepath in their octal format.
	 *
	 * @since 2.5.0
	 *
	 * @param string $file Path to the file.
	 * @return string Mode of the file (the last 3 digits).
	 */
	public function getchmod( $file ) {
		$dir = $this->dirlist( $file );

return $dir[ $file ]['permsn'] ?? '';
	}

/**
	 * Gets the file's group.
	 *
	 * @since 2.5.0
	 *
	 * @param string $file Path to the file.
	 * @return string|int<1, max>|false The group on success, false on failure.
	 */
	public function group( $file ) {
		$dir = $this->dirlist( $file );

return $dir[ $file ]['group'] ?? '';
	}

/**
	 * Copies a file.
	 *
	 * @since 2.5.0
	 *
	 * @param string    $source      Path to the source file.
	 * @param string    $destination Path to the destination file.
	 * @param bool      $overwrite   Optional. Whether to overwrite the destination file if it exists.
	 *                               Default false.
	 * @param int|false $mode        Optional. The permissions as octal number, usually 0644 for files,
	 *                               0755 for dirs. Default false.
	 * @return bool True on success, false on failure.
	 */
	public function copy( $source, $destination, $overwrite = false, $mode = false ) {
		if ( ! $overwrite && $this->exists( $destination ) ) {
			return false;
		}

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

if ( false === $content ) {
			return false;
		}

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

/**
	 * Moves a file or directory.
	 *
	 * After moving files or directories, OPcache will need to be invalidated.
	 *
	 * If moving a directory fails, `copy_dir()` can be used for a recursive copy.
	 *
	 * Use `move_dir()` for moving directories with OPcache invalidation and a
	 * fallback to `copy_dir()`.
	 *
	 * @since 2.5.0
	 *
	 * @param string $source      Path to the source file or directory.
	 * @param string $destination Path to the destination file or directory.
	 * @param bool   $overwrite   Optional. Whether to overwrite the destination if it exists.
	 *                            Default false.
	 * @return bool True on success, false on failure.
	 */
	public function move( $source, $destination, $overwrite = false ) {
		return ftp_rename( $this->link, $source, $destination );
	}

/**
	 * Deletes a file or directory.
	 *
	 * @since 2.5.0
	 *
	 * @param string       $file      Path to the file or directory.
	 * @param bool         $recursive Optional. If set to true, deletes files and folders recursively.
	 *                                Default false.
	 * @param string|false $type      Type of resource. 'f' for file, 'd' for directory.
	 *                                Default false.
	 * @return bool True on success, false on failure.
	 */
	public function delete( $file, $recursive = false, $type = false ) {
		if ( empty( $file ) ) {
			return false;
		}

if ( 'f' === $type || $this->is_file( $file ) ) {
			return ftp_delete( $this->link, $file );
		}

if ( ! $recursive ) {
			return ftp_rmdir( $this->link, $file );
		}

$filelist = $this->dirlist( trailingslashit( $file ) );

if ( ! empty( $filelist ) ) {
			foreach ( $filelist as $delete_file ) {
				$this->delete( trailingslashit( $file ) . $delete_file['name'], $recursive, $delete_file['type'] );
			}
		}

return ftp_rmdir( $this->link, $file );
	}

/**
	 * Checks if a file or directory exists.
	 *
	 * @since 2.5.0
	 * @since 6.3.0 Returns false for an empty path.
	 *
	 * @param string $path Path to file or directory.
	 * @return bool Whether $path exists or not.
	 */
	public function exists( $path ) {
		/*
		 * Check for empty path. If ftp_nlist() receives an empty path,
		 * it checks the current working directory and may return true.
		 *
		 * See https://core.trac.wordpress.org/ticket/33058.
		 */
		if ( '' === $path ) {
			return false;
		}

$list = ftp_nlist( $this->link, $path );

if ( empty( $list ) && $this->is_dir( $path ) ) {
			return true; // File is an empty directory.
		}

return ! empty( $list ); // Empty list = no file, so invert.
	}

/**
	 * Checks if resource is a file.
	 *
	 * @since 2.5.0
	 *
	 * @param string $file File path.
	 * @return bool Whether $file is a file.
	 */
	public function is_file( $file ) {
		return $this->exists( $file ) && ! $this->is_dir( $file );
	}

/**
	 * Checks if resource is a directory.
	 *
	 * @since 2.5.0
	 *
	 * @param string $path Directory path.
	 * @return bool Whether $path is a directory.
	 */
	public function is_dir( $path ) {
		$cwd = $this->cwd();
		if ( false === $cwd ) {
			return false;
		}

$result = @ftp_chdir( $this->link, trailingslashit( $path ) );

if ( ! $this->link ) {
			return false;
		}

if ( $result && $path === $this->cwd() || $this->cwd() !== $cwd ) {
			@ftp_chdir( $this->link, $cwd );
			return true;
		}

return false;
	}

/**
	 * Checks if a file is readable.
	 *
	 * @since 2.5.0
	 *
	 * @param string $file Path to file.
	 * @return bool Whether $file is readable.
	 */
	public function is_readable( $file ) {
		return true;
	}

/**
	 * Checks if a file or directory is writable.
	 *
	 * @since 2.5.0
	 *
	 * @param string $path Path to file or directory.
	 * @return bool Whether $path is writable.
	 */
	public function is_writable( $path ) {
		return true;
	}

/**
	 * Gets the file's last access time.
	 *
	 * @since 2.5.0
	 *
	 * @param string $file Path to file.
	 * @return int|false Unix timestamp representing last access time, false on failure.
	 */
	public function atime( $file ) {
		return false;
	}

/**
	 * Gets the file modification time.
	 *
	 * @since 2.5.0
	 *
	 * @param string $file Path to file.
	 * @return int|false Unix timestamp representing modification time, false on failure.
	 */
	public function mtime( $file ) {
		return ftp_mdtm( $this->link, $file );
	}

/**
	 * Gets the file size (in bytes).
	 *
	 * @since 2.5.0
	 *
	 * @param string $file Path to file.
	 * @return int|false Size of the file in bytes on success, false on failure.
	 */
	public function size( $file ) {
		$size = ftp_size( $this->link, $file );

return ( $size > -1 ) ? $size : false;
	}

/**
	 * Sets the access and modification times of a file.
	 *
	 * Note: If $file doesn't exist, it will be created.
	 *
	 * @since 2.5.0
	 *
	 * @param string $file  Path to file.
	 * @param int    $time  Optional. Modified time to set for file.
	 *                      Default 0.
	 * @param int    $atime Optional. Access time to set for file.
	 *                      Default 0.
	 * @return bool True on success, false on failure.
	 */
	public function touch( $file, $time = 0, $atime = 0 ) {
		return false;
	}

/**
	 * Creates a directory.
	 *
	 * @since 2.5.0
	 *
	 * @param string           $path  Path for new directory.
	 * @param int|false        $chmod Optional. The permissions as octal number (or false to skip chmod).
	 *                                Default false.
	 * @param string|int|false $chown Optional. A user name or number (or false to skip chown).
	 *                                Default false.
	 * @param string|int|false $chgrp Optional. A group name or number (or false to skip chgrp).
	 *                                Default false.
	 * @return bool True on success, false on failure.
	 */
	public function mkdir( $path, $chmod = false, $chown = false, $chgrp = false ) {
		$path = untrailingslashit( $path );

if ( empty( $path ) ) {
			return false;
		}

if ( ! ftp_mkdir( $this->link, $path ) ) {
			return false;
		}

$this->chmod( $path, $chmod );

return true;
	}

/**
	 * Deletes a directory.
	 *
	 * @since 2.5.0
	 *
	 * @param string $path      Path to directory.
	 * @param bool   $recursive Optional. Whether to recursively remove files/directories.
	 *                          Default false.
	 * @return bool True on success, false on failure.
	 */
	public function rmdir( $path, $recursive = false ) {
		return $this->delete( $path, $recursive );
	}

/**
	 * Parses an individual entry from the FTP LIST command output.
	 *
	 * @param string $line A line from the directory listing.
	 * @return array|string {
	 *     Array of file information. Empty string if the line could not be parsed.
	 *
	 *     @type string       $name        Name of the file or directory.
	 *     @type string       $perms       *nix representation of permissions.
	 *     @type string       $permsn      Octal representation of permissions.
	 *     @type string|false $number      File number as a string, or false if not available.
	 *     @type string|false $owner       Owner name or ID, or false if not available.
	 *     @type string|false $group       File permissions group, or false if not available.
	 *     @type string|false $size        Size of file in bytes as a string, or false if not available.
	 *     @type string|false $lastmodunix Last modified unix timestamp as a string, or false if not available.
	 *     @type string|false $lastmod     Last modified month (3 letters) and day (without leading 0), or
	 *                                     false if not available.
	 *     @type string|false $time        Last modified time, or false if not available.
	 *     @type string       $type        Type of resource. 'f' for file, 'd' for directory, 'l' for link.
	 *     @type array|false  $files       If a directory and `$recursive` is true, contains another array of files.
	 *                                     False if unable to list directory contents.
	 * }
	 * @phpstan-return FileListing|''
	 */
	public function parselisting( $line ) {
		static $is_windows = null;

if ( is_null( $is_windows ) ) {
			$is_windows = stripos( ftp_systype( $this->link ), 'win' ) !== false;
		}

if ( $is_windows && preg_match( '/([0-9]{2})-([0-9]{2})-([0-9]{2}) +([0-9]{2}):([0-9]{2})(AM|PM) +([0-9]+|<DIR>) +(.+)/', $line, $lucifer ) ) {
			$b = array();

if ( $lucifer[3] < 70 ) {
				$lucifer[3] += 2000;
			} else {
				$lucifer[3] += 1900; // 4-digit year fix.
			}

$b['isdir'] = ( '<DIR>' === $lucifer[7] );

if ( $b['isdir'] ) {
				$b['type'] = 'd';
			} else {
				$b['type'] = 'f';
			}

$b['size'] = $lucifer[7];
			$b['time'] = mktime( (int) $lucifer[4] + ( strcasecmp( $lucifer[6], 'PM' ) === 0 ? 12 : 0 ), (int) $lucifer[5], 0, (int) $lucifer[1], (int) $lucifer[2], (int) $lucifer[3] );
			$b['name'] = $lucifer[8];
		} elseif ( ! $is_windows ) {
			$lucifer = preg_split( '/[ ]/', $line, 9, PREG_SPLIT_NO_EMPTY );

if ( $lucifer ) {
				$lcount = count( $lucifer );

if ( $lcount < 8 ) {
					return '';
				}

$b           = array();
				$b['isdir']  = 'd' === $lucifer[0][0];
				$b['islink'] = 'l' === $lucifer[0][0];

if ( $b['isdir'] ) {
					$b['type'] = 'd';
				} elseif ( $b['islink'] ) {
					$b['type'] = 'l';
				} else {
					$b['type'] = 'f';
				}

$b['perms']  = $lucifer[0];
				$b['permsn'] = $this->getnumchmodfromh( $b['perms'] );
				$b['number'] = $lucifer[1];
				$b['owner']  = $lucifer[2];
				$b['group']  = $lucifer[3];
				$b['size']   = $lucifer[4];

if ( 8 === $lcount ) {
					sscanf( $lucifer[5], '%d-%d-%d', $year, $month, $day );
					sscanf( $lucifer[6], '%d:%d', $hour, $minute );

$b['time'] = mktime( (int) $hour, (int) $minute, 0, (int) $month, (int) $day, (int) $year );
					$b['name'] = $lucifer[7];
				} else {
					$month = $lucifer[5];
					$day   = $lucifer[6];

if ( preg_match( '/([0-9]{2}):([0-9]{2})/', $lucifer[7], $l2 ) ) {
						$year   = gmdate( 'Y' );
						$hour   = $l2[1];
						$minute = $l2[2];
					} else {
						$year   = $lucifer[7];
						$hour   = 0;
						$minute = 0;
					}

$b['time'] = strtotime( sprintf( '%d %s %d %02d:%02d', $day, $month, $year, $hour, $minute ) );
					$b['name'] = $lucifer[8];
				}
			}
		}

// Replace symlinks formatted as "source -> target" with just the source name.
		if ( isset( $b['islink'] ) && $b['islink'] ) {
			$b['name'] = (string) preg_replace( '/(\s*->\s*.*)$/', '', $b['name'] );
		}

return $b ?? '';
	}

/**
	 * Gets details for files in a directory or a specific file.
	 *
	 * @since 2.5.0
	 *
	 * @param string $path           Path to directory or file.
	 * @param bool   $include_hidden Optional. Whether to include details of hidden ("." prefixed) files.
	 *                               Default true.
	 * @param bool   $recursive      Optional. Whether to recursively include file details in nested directories.
	 *                               Default false.
	 * @return array|false {
	 *     Array of arrays containing file information. False if unable to list directory contents.
	 *
	 *     @type array ...$0 {
	 *         Array of file information. Note that some elements may not be available on all filesystems.
	 *
	 *         @type string           $name        Name of the file or directory.
	 *         @type string           $perms       *nix representation of permissions.
	 *         @type string           $permsn      Octal representation of permissions.
	 *         @type int|string|false $number      File number. May be a numeric string. False if not available.
	 *         @type string|false     $owner       Owner name or ID, or false if not available.
	 *         @type string|false     $group       File permissions group, or false if not available.
	 *         @type int|string|false $size        Size of file in bytes. May be a numeric string.
	 *                                             False if not available.
	 *         @type int|string|false $lastmodunix Last modified unix timestamp. May be a numeric string.
	 *                                             False if not available.
	 *         @type string|false     $lastmod     Last modified month (3 letters) and day (without leading 0), or
	 *                                             false if not available.
	 *         @type int|string|false $time        Last modified time as a Unix timestamp, or false if not available.
	 *         @type string           $type        Type of resource. 'f' for file, 'd' for directory, 'l' for link.
	 *         @type array|false      $files       If a directory and `$recursive` is true, contains another array of
	 *                                             files. False if unable to list directory contents.
	 *     }
	 * }
	 * @phpstan-return array<string, FileListing>|false
	 */
	public function dirlist( $path = '.', $include_hidden = true, $recursive = false ) {
		if ( ! $this->link ) {
			return false;
		}

if ( $this->is_file( $path ) ) {
			$limit_file = basename( $path );
			$path       = dirname( $path ) . '/';
		} else {
			$limit_file = false;
		}

$pwd = ftp_pwd( $this->link );
		if ( ! is_string( $pwd ) ) {
			return false;
		}

if ( ! @ftp_chdir( $this->link, $path ) ) { // Can't change to folder = folder doesn't exist.
			return false;
		}

/** @var string[]|false $list */
		$list = ftp_rawlist( $this->link, '-a', false );

@ftp_chdir( $this->link, $pwd );

if ( empty( $list ) ) { // Empty array = non-existent folder (real folder will show . at least).
			return false;
		}

$dirlist = array();

foreach ( $list as $k => $v ) {
			$entry = $this->parselisting( $v );

if ( empty( $entry ) ) {
				continue;
			}

if ( '.' === $entry['name'] || '..' === $entry['name'] ) {
				continue;
			}

if ( ! $include_hidden && '.' === $entry['name'][0] ) {
				continue;
			}

if ( $limit_file && $entry['name'] !== $limit_file ) {
				continue;
			}

$dirlist[ $entry['name'] ] = $entry;
		}

$path = trailingslashit( $path );
		$ret  = array();

foreach ( (array) $dirlist as $struc ) {
			if ( 'd' === $struc['type'] ) {
				if ( $recursive ) {
					$struc['files'] = $this->dirlist( $path . $struc['name'], $include_hidden, $recursive );
				} else {
					$struc['files'] = array();
				}
			}

$ret[ $struc['name'] ] = $struc;
		}

return $ret;
	}

/**
	 * Destructor.
	 *
	 * @since 2.5.0
	 */
	public function __destruct() {
		if ( $this->link ) {
			ftp_close( $this->link );
		}
	}
}

cmd: