unzip_file( string $file, string $to ): true|WP_Error

1591function unzip_file( $file, $to ) {1592	global $wp_filesystem;1593 1594	if ( ! $wp_filesystem || ! is_object( $wp_filesystem ) ) {1595		return new WP_Error( 'fs_unavailable', __( 'Could not access filesystem.' ) );1596	}1597 1598	// Unzip can use a lot of memory, but not this much hopefully.1599	wp_raise_memory_limit( 'admin' );1600 1601	$needed_dirs = array();1602	$to          = trailingslashit( $to );1603 1604	// Determine any parent directories needed (of the upgrade directory).1605	if ( ! $wp_filesystem->is_dir( $to ) ) { // Only do parents if no children exist.1606		$path = preg_split( '![/\\\]!', untrailingslashit( $to ) );1607		for ( $i = count( $path ); $i >= 0; $i-- ) {1608			if ( empty( $path[ $i ] ) ) {1609				continue;1610			}1611 1612			$dir = implode( '/', array_slice( $path, 0, $i + 1 ) );1613			if ( preg_match( '!^[a-z]:$!i', $dir ) ) { // Skip it if it looks like a Windows Drive letter.1614				continue;1615			}1616 1617			if ( ! $wp_filesystem->is_dir( $dir ) ) {1618				$needed_dirs[] = $dir;1619			} else {1620				break; // A folder exists, therefore we don't need to check the levels below this.1621			}1622		}1623	}1624 1625	/**1626	 * Filters whether to use ZipArchive to unzip archives.1627	 *1628	 * @since 3.0.01629	 *1630	 * @param bool $ziparchive Whether to use ZipArchive. Default true.1631	 */1632	if ( class_exists( 'ZipArchive', false ) && apply_filters( 'unzip_file_use_ziparchive', true ) ) {1633		$result = _unzip_file_ziparchive( $file, $to, $needed_dirs );1634		if ( true === $result ) {1635			return $result;1636		} elseif ( is_wp_error( $result ) ) {1637			if ( 'incompatible_archive' !== $result->get_error_code() ) {1638				return $result;1639			}1640		}1641	}1642	// Fall through to PclZip if ZipArchive is not available, or encountered an error opening the file.1643	return _unzip_file_pclzip( $file, $to, $needed_dirs );1644}