mirror of
https://github.com/Karaka-Management/phpOMS.git
synced 2026-01-11 09:48:40 +00:00
638 lines
14 KiB
PHP
638 lines
14 KiB
PHP
<?php
|
|
/**
|
|
* Orange Management
|
|
*
|
|
* PHP Version 7.4
|
|
*
|
|
* @package phpOMS\System\File\Local
|
|
* @copyright Dennis Eichhorn
|
|
* @license OMS License 1.0
|
|
* @version 1.0.0
|
|
* @link https://orange-management.org
|
|
*/
|
|
declare(strict_types=1);
|
|
|
|
namespace phpOMS\System\File\Local;
|
|
|
|
use phpOMS\System\File\ContainerInterface;
|
|
use phpOMS\System\File\DirectoryInterface;
|
|
use phpOMS\System\File\PathException;
|
|
use phpOMS\Utils\StringUtils;
|
|
|
|
/**
|
|
* Filesystem class.
|
|
*
|
|
* Performing operations on the file system
|
|
*
|
|
* @package phpOMS\System\File\Local
|
|
* @license OMS License 1.0
|
|
* @link https://orange-management.org
|
|
* @since 1.0.0
|
|
*/
|
|
final class Directory extends FileAbstract implements DirectoryInterface, LocalContainerInterface
|
|
{
|
|
/**
|
|
* Directory list filter.
|
|
*
|
|
* @var string
|
|
* @since 1.0.0
|
|
*/
|
|
private string $filter = '*';
|
|
|
|
/**
|
|
* Directory nodes (files and directories).
|
|
*
|
|
* @var FileAbstract[]
|
|
* @since 1.0.0
|
|
*/
|
|
private array $nodes = [];
|
|
|
|
/**
|
|
* Constructor.
|
|
*
|
|
* @param string $path Path
|
|
* @param string $filter Filter
|
|
*
|
|
* @since 1.0.0
|
|
*/
|
|
public function __construct(string $path, string $filter = '*')
|
|
{
|
|
$this->filter = \ltrim($filter, '\\/');
|
|
parent::__construct($path);
|
|
|
|
if (\file_exists($this->path)) {
|
|
$this->index();
|
|
}
|
|
}
|
|
|
|
/**
|
|
* List all files in directory recursively.
|
|
*
|
|
* @param string $path Path
|
|
* @param string $filter Filter
|
|
*
|
|
* @return string[] Array of files and directory with relative path to $path
|
|
*
|
|
* @since 1.0.0
|
|
*/
|
|
public static function list(string $path, string $filter = '*') : array
|
|
{
|
|
if (!\file_exists($path)) {
|
|
return [];
|
|
}
|
|
|
|
$list = [];
|
|
$path = \rtrim($path, '\\/');
|
|
$iterator = new \RecursiveIteratorIterator(
|
|
new \RecursiveDirectoryIterator($path, \RecursiveDirectoryIterator::SKIP_DOTS),
|
|
\RecursiveIteratorIterator::SELF_FIRST);
|
|
|
|
if ($filter !== '*') {
|
|
$iterator = new \RegexIterator($iterator, '/' . $filter . '/i', \RecursiveRegexIterator::GET_MATCH);
|
|
}
|
|
|
|
foreach ($iterator as $item) {
|
|
$list[] = \str_replace('\\', '/', $iterator->getSubPathname());
|
|
}
|
|
|
|
/** @var string[] $list */
|
|
return $list;
|
|
}
|
|
|
|
/**
|
|
* List all files by extension directory.
|
|
*
|
|
* @param string $path Path
|
|
* @param string $extension Extension
|
|
* @param string $exclude Pattern to exclude
|
|
*
|
|
* @return array<array|string>
|
|
*
|
|
* @since 1.0.0
|
|
*/
|
|
public static function listByExtension(string $path, string $extension = '', string $exclude = '') : array
|
|
{
|
|
$list = [];
|
|
$path = \rtrim($path, '\\/');
|
|
|
|
if (!\file_exists($path)) {
|
|
return $list;
|
|
}
|
|
|
|
foreach ($iterator = new \RecursiveIteratorIterator(
|
|
new \RecursiveDirectoryIterator($path, \RecursiveDirectoryIterator::SKIP_DOTS),
|
|
\RecursiveIteratorIterator::SELF_FIRST) as $item
|
|
) {
|
|
if ((empty($extension) || $item->getExtension() === $extension)
|
|
&& (empty($exclude) || (!(bool) \preg_match('/' . $exclude . '/', $iterator->getSubPathname())))
|
|
) {
|
|
$list[] = \str_replace('\\', '/', $iterator->getSubPathname());
|
|
}
|
|
}
|
|
|
|
return $list;
|
|
}
|
|
|
|
/**
|
|
* {@inheritdoc}
|
|
*/
|
|
public function index() : void
|
|
{
|
|
parent::index();
|
|
|
|
foreach (\glob($this->path . \DIRECTORY_SEPARATOR . $this->filter) as $filename) {
|
|
if (!StringUtils::endsWith(\trim($filename), '.')) {
|
|
$file = \is_dir($filename) ? new self($filename) : new File($filename);
|
|
|
|
$this->addNode($file);
|
|
}
|
|
}
|
|
}
|
|
|
|
/**
|
|
* {@inheritdoc}
|
|
*/
|
|
public function addNode($file) : bool
|
|
{
|
|
$this->count += $file->getCount();
|
|
$this->size += $file->getSize();
|
|
$this->nodes[$file->getName()] = $file;
|
|
|
|
return $file->createNode();
|
|
}
|
|
|
|
/**
|
|
* {@inheritdoc}
|
|
*/
|
|
public static function size(string $dir, bool $recursive = true) : int
|
|
{
|
|
if (!\file_exists($dir) || !\is_readable($dir)) {
|
|
return -1;
|
|
}
|
|
|
|
$countSize = 0;
|
|
$directories = \scandir($dir);
|
|
|
|
if ($directories === false) {
|
|
return $countSize;
|
|
}
|
|
|
|
foreach ($directories as $key => $filename) {
|
|
if ($filename === '..' || $filename === '.') {
|
|
continue;
|
|
}
|
|
|
|
$path = $dir . '/' . $filename;
|
|
if (\is_dir($path) && $recursive) {
|
|
$countSize += self::size($path, $recursive);
|
|
} elseif (\is_file($path)) {
|
|
$countSize += \filesize($path);
|
|
}
|
|
}
|
|
|
|
return $countSize;
|
|
}
|
|
|
|
/**
|
|
* Get amount of sub-resources.
|
|
*
|
|
* A file will always return 1 as it doesn't have any sub-resources.
|
|
*
|
|
* @param string $path Path of the resource
|
|
* @param bool $recursive Should count also sub-sub-resources
|
|
* @param string[] $ignore Ignore files
|
|
*
|
|
* @return int
|
|
*
|
|
* @since 1.0.0
|
|
*/
|
|
public static function count(string $path, bool $recursive = true, array $ignore = []) : int
|
|
{
|
|
if (!\file_exists($path)) {
|
|
return -1;
|
|
}
|
|
|
|
$size = 0;
|
|
$files = \scandir($path);
|
|
$ignore[] = '.';
|
|
$ignore[] = '..';
|
|
|
|
if ($files === false) {
|
|
return $size;
|
|
}
|
|
|
|
foreach ($files as $t) {
|
|
if (\in_array($t, $ignore)) {
|
|
continue;
|
|
}
|
|
if (\is_dir(\rtrim($path, '/') . '/' . $t)) {
|
|
if ($recursive) {
|
|
$size += self::count(\rtrim($path, '/') . '/' . $t, true, $ignore);
|
|
}
|
|
} else {
|
|
++$size;
|
|
}
|
|
}
|
|
|
|
return $size;
|
|
}
|
|
|
|
/**
|
|
* {@inheritdoc}
|
|
*/
|
|
public static function delete(string $path) : bool
|
|
{
|
|
if (empty($path) || !\file_exists($path)) {
|
|
return false;
|
|
}
|
|
|
|
$files = \scandir($path);
|
|
|
|
if ($files === false) {
|
|
return false;
|
|
}
|
|
|
|
/* Removing . and .. */
|
|
unset($files[1]);
|
|
unset($files[0]);
|
|
|
|
foreach ($files as $file) {
|
|
if (\is_dir($path . '/' . $file)) {
|
|
self::delete($path . '/' . $file);
|
|
} else {
|
|
\unlink($path . '/' . $file);
|
|
}
|
|
}
|
|
|
|
\rmdir($path);
|
|
|
|
return true;
|
|
}
|
|
|
|
/**
|
|
* {@inheritdoc}
|
|
*/
|
|
public static function parent(string $path) : string
|
|
{
|
|
$path = \explode('/', \str_replace('\\', '/', $path));
|
|
\array_pop($path);
|
|
|
|
return \implode('/', $path);
|
|
}
|
|
|
|
/**
|
|
* {@inheritdoc}
|
|
*
|
|
* @todo Orange-Management/phpOMS#??? [p:low] [t:optimization] [d:beginner] [t:question]
|
|
* Consider to move this to fileAbastract since it should be the same for file and directory?
|
|
*/
|
|
public static function created(string $path) : \DateTime
|
|
{
|
|
if (!\file_exists($path)) {
|
|
throw new PathException($path);
|
|
}
|
|
|
|
$created = new \DateTime('now');
|
|
$time = \filemtime($path);
|
|
|
|
$created->setTimestamp($time === false ? 0 : $time);
|
|
|
|
return $created;
|
|
}
|
|
|
|
/**
|
|
* {@inheritdoc}
|
|
*/
|
|
public static function changed(string $path) : \DateTime
|
|
{
|
|
if (!\file_exists($path)) {
|
|
throw new PathException($path);
|
|
}
|
|
|
|
$changed = new \DateTime();
|
|
$time = \filectime($path);
|
|
|
|
$changed->setTimestamp($time === false ? 0 : $time);
|
|
|
|
return $changed;
|
|
}
|
|
|
|
/**
|
|
* {@inheritdoc}
|
|
*/
|
|
public static function owner(string $path) : int
|
|
{
|
|
if (!\file_exists($path)) {
|
|
throw new PathException($path);
|
|
}
|
|
|
|
return (int) \fileowner($path);
|
|
}
|
|
|
|
/**
|
|
* {@inheritdoc}
|
|
*/
|
|
public static function permission(string $path) : int
|
|
{
|
|
if (!\file_exists($path)) {
|
|
return -1;
|
|
}
|
|
|
|
return (int) \fileperms($path);
|
|
}
|
|
|
|
/**
|
|
* {@inheritdoc}
|
|
*/
|
|
public static function copy(string $from, string $to, bool $overwrite = false) : bool
|
|
{
|
|
if (!\is_dir($from)) {
|
|
return false;
|
|
}
|
|
|
|
if (!\file_exists($to)) {
|
|
self::create($to, 0755, true);
|
|
} elseif ($overwrite && \file_exists($to)) {
|
|
self::delete($to);
|
|
} else {
|
|
return false;
|
|
}
|
|
|
|
foreach ($iterator = new \RecursiveIteratorIterator(
|
|
new \RecursiveDirectoryIterator($from, \RecursiveDirectoryIterator::SKIP_DOTS),
|
|
\RecursiveIteratorIterator::SELF_FIRST) as $item
|
|
) {
|
|
if ($item->isDir()) {
|
|
\mkdir($to . '/' . $iterator->getSubPathname());
|
|
} else {
|
|
\copy($from . '/' . $iterator->getSubPathname(), $to . '/' . $iterator->getSubPathname());
|
|
}
|
|
}
|
|
|
|
return true;
|
|
}
|
|
|
|
/**
|
|
* {@inheritdoc}
|
|
*/
|
|
public static function move(string $from, string $to, bool $overwrite = false) : bool
|
|
{
|
|
if (!\is_dir($from)) {
|
|
return false;
|
|
}
|
|
|
|
if (!$overwrite && \file_exists($to)) {
|
|
return false;
|
|
} elseif ($overwrite && \file_exists($to)) {
|
|
self::delete($to);
|
|
}
|
|
|
|
if (!self::exists(self::parent($to))) {
|
|
self::create(self::parent($to), 0755, true);
|
|
}
|
|
|
|
\rename($from, $to);
|
|
|
|
return true;
|
|
}
|
|
|
|
/**
|
|
* {@inheritdoc}
|
|
*/
|
|
public static function exists(string $path) : bool
|
|
{
|
|
return \file_exists($path);
|
|
}
|
|
|
|
/**
|
|
* {@inheritdoc}
|
|
*/
|
|
public static function sanitize(string $path, string $replace = '', string $invalid = '/[^\w\s\d\.\-_~,;:\[\]\(\]\/]/') : string
|
|
{
|
|
return \preg_replace($invalid, $replace, $path) ?? '';
|
|
}
|
|
|
|
/**
|
|
* {@inheritdoc}
|
|
*/
|
|
public function getNode(string $name) : ?ContainerInterface
|
|
{
|
|
return $this->nodes[$name] ?? null;
|
|
}
|
|
|
|
/**
|
|
* {@inheritdoc}
|
|
*/
|
|
public function createNode() : bool
|
|
{
|
|
return self::create($this->path, $this->permission, true);
|
|
/**
|
|
* @todo Orange-Management/phpOMS#??? [p:low] [t:todo] [d:medium]
|
|
* Add node to current node list
|
|
*/
|
|
}
|
|
|
|
/**
|
|
* Create directory
|
|
*
|
|
* @param string $path Path of the resource
|
|
* @param int $permission Permission
|
|
* @param bool $recursive Create recursive in case of subdirectories
|
|
*
|
|
* @return bool
|
|
*
|
|
* @since 1.0.0
|
|
*/
|
|
public static function create(string $path, int $permission = 0755, bool $recursive = false) : bool
|
|
{
|
|
if (!\file_exists($path)) {
|
|
if (!$recursive && !\file_exists(self::parent($path))) {
|
|
return false;
|
|
}
|
|
|
|
try {
|
|
\mkdir($path, $permission, $recursive);
|
|
} catch (\Throwable $t) {
|
|
return false;
|
|
}
|
|
|
|
return true;
|
|
}
|
|
|
|
return false;
|
|
}
|
|
|
|
/**
|
|
* {@inheritdoc}
|
|
*/
|
|
public function remove(string $name) : bool
|
|
{
|
|
if (isset($this->nodes[$name])) {
|
|
$this->count -= $this->nodes[$name]->getCount();
|
|
$this->size -= $this->nodes[$name]->getSize();
|
|
|
|
unset($this->nodes[$name]);
|
|
|
|
/**
|
|
* @todo Orange-Management/phpOMS#??? [p:low] [t:question] [d:medium]
|
|
* Should this also remove the resource? \unlink();
|
|
*/
|
|
|
|
return true;
|
|
}
|
|
|
|
return false;
|
|
}
|
|
|
|
/**
|
|
* {@inheritdoc}
|
|
*/
|
|
public function rewind() : void
|
|
{
|
|
\reset($this->nodes);
|
|
}
|
|
|
|
/**
|
|
* {@inheritdoc}
|
|
*/
|
|
public function current()
|
|
{
|
|
return \current($this->nodes);
|
|
}
|
|
|
|
/**
|
|
* {@inheritdoc}
|
|
*/
|
|
public function key()
|
|
{
|
|
return \key($this->nodes);
|
|
}
|
|
|
|
/**
|
|
* {@inheritdoc}
|
|
*/
|
|
public function next()
|
|
{
|
|
return \next($this->nodes);
|
|
}
|
|
|
|
/**
|
|
* {@inheritdoc}
|
|
*/
|
|
public function valid()
|
|
{
|
|
$key = \key($this->nodes);
|
|
|
|
return ($key !== null && $key !== false);
|
|
}
|
|
|
|
/**
|
|
* {@inheritdoc}
|
|
*/
|
|
public function offsetSet($offset, $value) : void
|
|
{
|
|
if ($offset === null) {
|
|
$this->addNode($value);
|
|
} else {
|
|
$this->nodes[$offset] = $value;
|
|
}
|
|
}
|
|
|
|
/**
|
|
* {@inheritdoc}
|
|
*/
|
|
public function offsetExists($offset)
|
|
{
|
|
return isset($this->nodes[$offset]);
|
|
}
|
|
|
|
/**
|
|
* {@inheritdoc}
|
|
*/
|
|
public function offsetUnset($offset) : void
|
|
{
|
|
if (isset($this->nodes[$offset])) {
|
|
unset($this->nodes[$offset]);
|
|
}
|
|
}
|
|
|
|
/**
|
|
* {@inheritdoc}
|
|
*/
|
|
public static function name(string $path) : string
|
|
{
|
|
return \basename($path);
|
|
}
|
|
|
|
/**
|
|
* {@inheritdoc}
|
|
*/
|
|
public static function dirname(string $path) : string
|
|
{
|
|
return \basename($path);
|
|
}
|
|
|
|
/**
|
|
* {@inheritdoc}
|
|
*/
|
|
public static function dirpath(string $path) : string
|
|
{
|
|
return $path;
|
|
}
|
|
|
|
/**
|
|
* {@inheritdoc}
|
|
*/
|
|
public static function basename(string $path) : string
|
|
{
|
|
return \basename($path);
|
|
}
|
|
|
|
/**
|
|
* {@inheritdoc}
|
|
*/
|
|
public function getParent() : ContainerInterface
|
|
{
|
|
return new self(self::parent($this->path));
|
|
}
|
|
|
|
/**
|
|
* {@inheritdoc}
|
|
*/
|
|
public function copyNode(string $to, bool $overwrite = false) : bool
|
|
{
|
|
return self::copy($this->path, $to, $overwrite);
|
|
}
|
|
|
|
/**
|
|
* {@inheritdoc}
|
|
*/
|
|
public function moveNode(string $to, bool $overwrite = false) : bool
|
|
{
|
|
return self::move($this->path, $to, $overwrite);
|
|
}
|
|
|
|
/**
|
|
* {@inheritdoc}
|
|
*/
|
|
public function deleteNode() : bool
|
|
{
|
|
return self::delete($this->path);
|
|
/**
|
|
* @todo Orange-Management/phpOMS#??? [p:low] [t:todo] [d:medium]
|
|
* Remove node from node list
|
|
*/
|
|
}
|
|
|
|
/**
|
|
* {@inheritdoc}
|
|
*/
|
|
public function offsetGet($offset) : void
|
|
{
|
|
/**
|
|
* @todo Orange-Management/phpOMS#??? [p:low] [t:todo] [d:medium]
|
|
* Implement offsetGet()
|
|
*/
|
|
}
|
|
}
|