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

713	public function dirlist( $path = '.', $include_hidden = true, $recursive = false ) {714		if ( $this->is_file( $path ) ) {715			$limit_file = basename( $path );716			$path       = dirname( $path ) . '/';717		} else {718			$limit_file = false;719		}720 721		mbstring_binary_safe_encoding();722 723		/** @var array<string, FileListing>|false $list */724		$list = $this->ftp->dirlist( $path );725 726		if ( ! is_array( $list ) || ( empty( $list ) && ! $this->exists( $path ) ) ) {727 728			reset_mbstring_encoding();729 730			return false;731		}732 733		$path = trailingslashit( $path );734		$ret  = array();735 736		foreach ( $list as $struc ) {737 738			if ( '.' === $struc['name'] || '..' === $struc['name'] ) {739				continue;740			}741 742			if ( ! $include_hidden && '.' === $struc['name'][0] ) {743				continue;744			}745 746			if ( $limit_file && $struc['name'] !== $limit_file ) {747				continue;748			}749 750			if ( 'd' === $struc['type'] ) {751				if ( $recursive ) {752					$struc['files'] = $this->dirlist( $path . $struc['name'], $include_hidden, $recursive );753				} else {754					$struc['files'] = array();755				}756			}757 758			// Replace symlinks formatted as "source -> target" with just the source name.759			if ( $struc['islink'] ?? false ) {760				$struc['name'] = (string) preg_replace( '/(\s*->\s*.*)$/', '', $struc['name'] );761			}762 763			// Add the octal representation of the file permissions.764			if ( isset( $struc['perms'] ) ) {765				$struc['permsn'] = $this->getnumchmodfromh( $struc['perms'] );766			}767 768			$ret[ $struc['name'] ] = $struc;769		}770 771		reset_mbstring_encoding();772 773		return $ret;774	}