ꦫꦣꦺꦤ꧀ꦄꦤ꧀ꦠꦱꦺꦤ

PATH: home / thebhoeo / .trash / backwpup / inc

<?php

/**
 * Wraps directory functions in PHP.
 *
 * @since 3.4.0
 */
class BackWPup_Directory extends DirectoryIterator {

/**
	 * The folders list of the plugins to auto exclude
	 *
	 * @var array
	 */
	private static $auto_exclusion_plugins_folders = [];

/**
	 * The cache folder list of the plugins to auto exclude
	 *
	 * @var array
	 */
	private static $auto_exclusion_plugin_cache_folders = [];

/**
	 * Flag to check if auto exclusion folders are initialized
	 *
	 * @var bool
	 */
	private static $auto_exclusion_initialized = false;

/**
	 * Creates the iterator.
	 *
	 * Fixes the path before calling the parent constructor.
	 *
	 * @param string $path
	 */
	public function __construct( $path ) {
		parent::__construct( BackWPup_Path_Fixer::fix_path( $path ) );
	}

/**
	 * Override next to skip auto excluded folders.
	 *
	 * @return void
	 */
	public function next(): void {
		parent::next();
		while ( $this->valid() && $this->should_skip() ) {
			parent::next();
		}
	}

/**
	 * Override rewind to skip auto excluded folders.
	 *
	 * @return void
	 */
	public function rewind(): void {
		parent::rewind();
		while ( $this->valid() && $this->should_skip() ) {
			parent::next();
		}
	}

/**
	 * Check if the current item should be skipped.
	 *
	 * @return bool
	 */
	private function should_skip(): bool {
		$item = $this->current();

if ( $item->isDot() || ! $item->isDir() ) {
			return false;
		}

$pathname = self::sanitize_path( $item->getPathname() );

return isset( self::$auto_exclusion_plugin_cache_folders[ $pathname ] );
	}

/**
	 * Get the folders of the excluded plugins
	 *
	 * @return array
	 */
	public static function get_auto_exclusion_plugins_folders(): array {
		self::init_auto_exclusion_folders();

return array_keys( self::$auto_exclusion_plugins_folders );
	}

/**
	 * Get the cache folders of the excluded plugins
	 *
	 * @return array
	 */
	public static function get_auto_exclusion_plugin_cache_folders(): array {
		self::init_auto_exclusion_folders();

return array_keys( self::$auto_exclusion_plugin_cache_folders );
	}

/**
	 * Init the excluded folders
	 *
	 * @return void
	 */
	private static function init_auto_exclusion_folders() {
		if ( self::$auto_exclusion_initialized ) {
			return;
		}

/**
		 * Filter whether BackWPup will list the plugins in the excluded plugins list.
		 *
		 * @param array $excluded_folders List of excluded paths.
		 */
		$auto_exclusion_plugins_folders = wpm_apply_filters_typed(
			'array',
			'backwpup_exclusion_plugins_folders',
			[]
		);
		/**
		 * Filter whether BackWPup will list the cache folders to include in the backup.
		 *
		 * @param array $excluded_folders List of excluded paths.
		 */
		$auto_exclusion_plugins_cache_folders = wpm_apply_filters_typed(
			'array',
			'backwpup_exclusion_plugins_cache_folders',
			[]
		);

$auto_exclusion_plugins_folders       = ( ! is_array( $auto_exclusion_plugins_folders ) ? [] : $auto_exclusion_plugins_folders );
		$auto_exclusion_plugins_cache_folders = ( ! is_array( $auto_exclusion_plugins_cache_folders ) ? [] : $auto_exclusion_plugins_cache_folders );

foreach ( array_unique( $auto_exclusion_plugins_folders ) as $folder ) {
			self::$auto_exclusion_plugins_folders[ trailingslashit( self::sanitize_path( $folder ) ) ] = true;
		}

foreach ( array_unique( $auto_exclusion_plugins_cache_folders ) as $folder ) {
			self::$auto_exclusion_plugin_cache_folders[ trailingslashit( self::sanitize_path( $folder ) ) ] = true;
		}

self::$auto_exclusion_initialized = true;
	}

/**
	 * Get the list of folders with the exclude option.
	 *
	 * @param string $id_path The id of the path.
	 * @param string $path The path to get the folders to exclude.
	 * @param string $id_job The id of the job.
	 * @param bool   $size Whether to include the size of the folder (performance intensive).
	 *
	 * @return array
	 */
	public static function get_folder_list_to_exclude( $id_path, $path, $id_job, $size = true ) {
		$folder = realpath( BackWPup_Path_Fixer::fix_path( $path ) );

if ( ! $folder || ! is_dir( $folder ) ) {
			return [];
		}

$folder = trailingslashit( BackWPup_Path_Fixer::slashify( $folder ) );

// Prepare variables once.
		$folders_to_exclude = [];
		$excludes           = BackWPup_Option::get( $id_job, 'backup' . $id_path . 'excludedirs' );

if ( ! is_array( $excludes ) ) {
			$excludes = [];
		}

$excludes_flip = array_flip( $excludes );

// Initialize auto-exclusion folders.
		self::init_auto_exclusion_folders();
		$auto_excludes = self::get_exclude_dirs( $folder, self::$auto_exclusion_plugins_folders );

// use faster opendir() to get the list of folders.
		$dir = opendir( $folder );
		if ( ! $dir ) {
			return [];
		}
		$file = readdir( $dir );
		while ( false !== $file ) {
			if ( '.' === $file || '..' === $file || ! is_dir( $folder . $file ) ) {
				$file = readdir( $dir );
				continue;
			}

$pathname       = $folder . $file;
			$sanitized_path = self::sanitize_path( $pathname );

// Skip auto-excluded folders.
			if ( isset( $auto_excludes[ $sanitized_path ] ) ) {
				$file = readdir( $dir );
				continue;
			}

// Check for .donotbackup.
			if ( is_file( $pathname . '/.donotbackup' ) ) {
				$excludes_flip[ $file ] = true;
			}

$folders_to_exclude[] = [
				'name'     => $file,
				'path'     => $folder,
				'size'     => $size ? BackWPup_File::get_folder_size( $folder ) : '',
				'excluded' => isset( $excludes_flip[ $file ] ),
			];
			$file                 = readdir( $dir );
		}
		closedir( $dir );

// sort files alphabetically.
		usort(
			$folders_to_exclude,
			static function ( $a, $b ) {
				return strcmp( $a['name'], $b['name'] );
			}
		);

return $folders_to_exclude;
	}

/**
	 * Get folder to exclude from a given folder for file backups.
	 *
	 * @param string $folder Folder to check for excludes.
	 * @param array  $excludedir
	 *
	 * @return array of folder to exclude
	 */
	private static function get_exclude_dirs( $folder, $excludedir = [] ) {
		$folder = self::sanitize_path( BackWPup_Path_Fixer::fix_path( $folder ) );

$dirs_to_check = [
			WP_CONTENT_DIR,
			WP_PLUGIN_DIR,
			get_theme_root(),
			BackWPup_File::get_upload_dir(),
		];

foreach ( $dirs_to_check as $dir ) {
			$sanitized_dir = self::sanitize_path( $dir );
			if ( false !== strpos( $sanitized_dir, $folder ) && $sanitized_dir !== $folder ) {
				$excludedir[ $sanitized_dir ] = true;
			}
		}

return $excludedir;
	}

/**
	 * Sanitize a path.
	 *
	 * @param string $path The path to sanitize.
	 *
	 * @return string
	 */
	private static function sanitize_path( $path ) {
		return trailingslashit(
			BackWPup_Path_Fixer::slashify( $path )
		);
	}
}

[-] class-system-tests-runner.php [edit]
[-] class-jobtype-dbdump.php [edit]
[-] class-destination-rsc.php [edit]
[-] class-encryption.php [edit]
[-] class-destination-downloader-factory.php [edit]
[-] class-destination-downloader-interface.php [edit]
[-] class-destination-ftp-type-ftp.php [edit]
[-] class-path-fixer.php [edit]
[-] class-message-box.php [edit]
[-] class-destination-dropbox-api.php [edit]
[-] class-option.php [edit]
[-] class-destination-dropbox-api-request-exception.php [edit]
[-] class-page-about.php [edit]
[-] class-migrate.php [edit]
[-] class-system-requirements.php [edit]
[-] class-adminbar.php [edit]
[-] class-msazure-destination-configuration.php [edit]
[-] class-job.php [edit]
[-] class-destination-ftp-type-exception.php [edit]
[-] class-destination-sugarsync-api.php [edit]
[-] class-download-file-interface.php [edit]
[-] class-encryption-fallback.php [edit]
[-] BackWPup.php [edit]
[-] class-page-backwpup.php [edit]
[-] class-destination-downloader-data.php [edit]
[-] class-mysqldump-exception.php [edit]
[-] class-s3-destination.php [edit]
[-] class-destination-ftp.php [edit]
[-] class-cron.php [edit]
[+] Notice
[-] class-destination-downloader.php [edit]
[-] class-destinations.php [edit]
[-] class-destination-ftp-downloader.php [edit]
[-] class-destination-dropbox-downloader.php [edit]
[-] class-download-handler.php [edit]
[-] class-destination-dropbox.php [edit]
[-] class-system-tests.php [edit]
[-] class-destination-folder-downloader.php [edit]
[-] class-destination-ftp-type.php [edit]
[-] class-thirdparties.php [edit]
[-] class-jobtype-wpplugin.php [edit]
[-] class-directory.php [edit]
[-] class-recursive-directory.php [edit]
[-] class-destination-msazure-downloader.php [edit]
[-] class-destination-connect-interface.php [edit]
[-] class-install.php [edit]
[-] class-admin.php [edit]
[-] class-jobtype-file.php [edit]
[-] functions.php [edit]
[+] Utils
[+] ThirdParty
[-] class-destination-s3-downloader.php [edit]
[-] class-destination-rsc-downloader.php [edit]
[-] class-destination-sugarsync-downloader.php [edit]
[-] class-destination-email.php [edit]
[+] ..
[-] class-mysqldump.php [edit]
[-] class-page-firstbackup.php [edit]
[-] class-jobtype-wpexp.php [edit]
[-] class-jobtype-dbcheck.php [edit]
[-] class-file.php [edit]
[-] class-sanitize-path.php [edit]
[+] Settings
[-] class-destination-s3.php [edit]
[-] class-page-logs.php [edit]
[-] class-factory-exception.php [edit]
[-] class-page-restore.php [edit]
[+] dependencies
[-] class-create-archive-exception.php [edit]
[-] class-page-editjob.php [edit]
[-] class-page-backups.php [edit]
[-] class-destination-dropbox-api-exception.php [edit]
[-] class-create-archive.php [edit]
[-] class-encryption-openssl.php [edit]
[-] class-destination-onedrive-config-trait.php [edit]
[-] class-destination-download-exception.php [edit]
[-] class-download-file.php [edit]
[-] class-page-settings.php [edit]
[-] class-destination-msazure.php [edit]
[-] class-page-onboarding.php [edit]
[-] class-destination-folder.php [edit]
[-] class-jobtypes.php [edit]
[-] class-destination-connect-exception.php [edit]
[-] class-destination-sugarsync.php [edit]
[-] class-page-jobs.php [edit]
[-] class-destination-sugarsync-api-exception.php [edit]
[-] class-encryption-mcrypt.php [edit]