WP_Filesystem_FTPext::dirlist( string $path = '.', bool $include_hidden = true, bool $recursive = false ): array|false

815	public function dirlist( $path = '.', $include_hidden = true, $recursive = false ) {816		if ( ! $this->link ) {817			return false;818		}819 820		if ( $this->is_file( $path ) ) {821			$limit_file = basename( $path );822			$path       = dirname( $path ) . '/';823		} else {824			$limit_file = false;825		}826 827		$pwd = ftp_pwd( $this->link );828		if ( ! is_string( $pwd ) ) {829			return false;830		}831 832		if ( ! @ftp_chdir( $this->link, $path ) ) { // Can't change to folder = folder doesn't exist.833			return false;834		}835 836		/** @var string[]|false $list */837		$list = ftp_rawlist( $this->link, '-a', false );838 839		@ftp_chdir( $this->link, $pwd );840 841		if ( empty( $list ) ) { // Empty array = non-existent folder (real folder will show . at least).842			return false;843		}844 845		$dirlist = array();846 847		foreach ( $list as $k => $v ) {848			$entry = $this->parselisting( $v );849 850			if ( empty( $entry ) ) {851				continue;852			}853 854			if ( '.' === $entry['name'] || '..' === $entry['name'] ) {855				continue;856			}857 858			if ( ! $include_hidden && '.' === $entry['name'][0] ) {859				continue;860			}861 862			if ( $limit_file && $entry['name'] !== $limit_file ) {863				continue;864			}865 866			$dirlist[ $entry['name'] ] = $entry;867		}868 869		$path = trailingslashit( $path );870		$ret  = array();871 872		foreach ( (array) $dirlist as $struc ) {873			if ( 'd' === $struc['type'] ) {874				if ( $recursive ) {875					$struc['files'] = $this->dirlist( $path . $struc['name'], $include_hidden, $recursive );876				} else {877					$struc['files'] = array();878				}879			}880 881			$ret[ $struc['name'] ] = $struc;882		}883 884		return $ret;885	}