Gecko [ naturenectar.co.uk ]

Name	Size	Permission	Date
UnixVisibility	[ DIR ]	drwxr-xr-x	2025-05-10 05:15
UrlGeneration	[ DIR ]	drwxr-xr-x	2025-05-10 05:15
CalculateChecksumFromStream.php	793 B	-rw-r--r--	2025-05-10 05:15
ChecksumAlgoIsNotSupported.php	169 B	-rw-r--r--	2025-05-10 05:15
ChecksumProvider.php	291 B	-rw-r--r--	2025-05-10 05:15
Config.php	1.39 KB	-rw-r--r--	2025-05-10 05:15
CorruptedPathDetected.php	316 B	-rw-r--r--	2025-05-10 05:15
DecoratedAdapter.php	2.36 KB	-rw-r--r--	2025-05-10 05:15
DirectoryAttributes.php	2.02 KB	-rw-r--r--	2025-05-10 05:15
DirectoryListing.php	2.03 KB	-rw-r--r--	2025-05-10 05:15
FileAttributes.php	2.5 KB	-rw-r--r--	2025-05-10 05:15
Filesystem.php	9.62 KB	-rw-r--r--	2025-05-10 05:15
FilesystemAdapter.php	2.72 KB	-rw-r--r--	2025-05-10 05:15
FilesystemException.php	130 B	-rw-r--r--	2025-05-10 05:15
FilesystemOperationFailed.php	954 B	-rw-r--r--	2025-05-10 05:15
FilesystemOperator.php	138 B	-rw-r--r--	2025-05-10 05:15
FilesystemReader.php	2.12 KB	-rw-r--r--	2025-05-10 05:15
FilesystemWriter.php	1.41 KB	-rw-r--r--	2025-05-10 05:15
InvalidStreamProvided.php	225 B	-rw-r--r--	2025-05-10 05:15
InvalidVisibilityProvided.php	553 B	-rw-r--r--	2025-05-10 05:15
MountManager.php	15 KB	-rw-r--r--	2025-05-10 05:15
PathNormalizer.php	148 B	-rw-r--r--	2025-05-10 05:15
PathPrefixer.php	1.13 KB	-rw-r--r--	2025-05-10 05:15
PathTraversalDetected.php	482 B	-rw-r--r--	2025-05-10 05:15
PortableVisibilityGuard.php	511 B	-rw-r--r--	2025-05-10 05:15
ProxyArrayAccessToProperties.php	1.2 KB	-rw-r--r--	2025-05-10 05:15
ResolveIdenticalPathConflict.php	198 B	-rw-r--r--	2025-05-10 05:15
StorageAttributes.php	1.01 KB	-rw-r--r--	2025-05-10 05:15
SymbolicLinkEncountered.php	531 B	-rw-r--r--	2025-05-10 05:15
UnableToCheckDirectoryExistence.php	257 B	-rw-r--r--	2025-05-10 05:15
UnableToCheckExistence.php	678 B	-rw-r--r--	2025-05-10 05:15
UnableToCheckFileExistence.php	247 B	-rw-r--r--	2025-05-10 05:15
UnableToCopyFile.php	1.49 KB	-rw-r--r--	2025-05-10 05:15
UnableToCreateDirectory.php	1.33 KB	-rw-r--r--	2025-05-10 05:15
UnableToDeleteDirectory.php	974 B	-rw-r--r--	2025-05-10 05:15
UnableToDeleteFile.php	923 B	-rw-r--r--	2025-05-10 05:15
UnableToGeneratePublicUrl.php	754 B	-rw-r--r--	2025-05-10 05:15
UnableToGenerateTemporaryUrl.php	760 B	-rw-r--r--	2025-05-10 05:15
UnableToListContents.php	650 B	-rw-r--r--	2025-05-10 05:15
UnableToMountFilesystem.php	915 B	-rw-r--r--	2025-05-10 05:15
UnableToMoveFile.php	1.6 KB	-rw-r--r--	2025-05-10 05:15
UnableToProvideChecksum.php	387 B	-rw-r--r--	2025-05-10 05:15
UnableToReadFile.php	925 B	-rw-r--r--	2025-05-10 05:15
UnableToResolveFilesystemMount.php	723 B	-rw-r--r--	2025-05-10 05:15
UnableToRetrieveMetadata.php	1.98 KB	-rw-r--r--	2025-05-10 05:15
UnableToSetVisibility.php	982 B	-rw-r--r--	2025-05-10 05:15
UnableToWriteFile.php	920 B	-rw-r--r--	2025-05-10 05:15
UnreadableFileEncountered.php	556 B	-rw-r--r--	2025-05-10 05:15
Visibility.php	163 B	-rw-r--r--	2025-05-10 05:15
WhitespacePathNormalizer.php	1.13 KB	-rw-r--r--	2025-05-10 05:15

Rename

<?php

declare(strict_types=1);

namespace League\Flysystem;

use DateTimeInterface;
use Generator;
use League\Flysystem\UrlGeneration\PrefixPublicUrlGenerator;
use League\Flysystem\UrlGeneration\PublicUrlGenerator;
use League\Flysystem\UrlGeneration\ShardedPrefixPublicUrlGenerator;
use League\Flysystem\UrlGeneration\TemporaryUrlGenerator;
use Throwable;

use function array_key_exists;
use function is_array;

class Filesystem implements FilesystemOperator
{
    use CalculateChecksumFromStream;

private Config $config;
    private PathNormalizer $pathNormalizer;

public function __construct(
        private FilesystemAdapter $adapter,
        array $config = [],
        ?PathNormalizer $pathNormalizer = null,
        private ?PublicUrlGenerator $publicUrlGenerator = null,
        private ?TemporaryUrlGenerator $temporaryUrlGenerator = null,
    ) {
        $this->config = new Config($config);
        $this->pathNormalizer = $pathNormalizer ?? new WhitespacePathNormalizer();
    }

public function fileExists(string $location): bool
    {
        return $this->adapter->fileExists($this->pathNormalizer->normalizePath($location));
    }

public function directoryExists(string $location): bool
    {
        return $this->adapter->directoryExists($this->pathNormalizer->normalizePath($location));
    }

public function has(string $location): bool
    {
        $path = $this->pathNormalizer->normalizePath($location);

return $this->adapter->fileExists($path) || $this->adapter->directoryExists($path);
    }

public function write(string $location, string $contents, array $config = []): void
    {
        $this->adapter->write(
            $this->pathNormalizer->normalizePath($location),
            $contents,
            $this->config->extend($config)
        );
    }

public function writeStream(string $location, $contents, array $config = []): void
    {
        /* @var resource $contents */
        $this->assertIsResource($contents);
        $this->rewindStream($contents);
        $this->adapter->writeStream(
            $this->pathNormalizer->normalizePath($location),
            $contents,
            $this->config->extend($config)
        );
    }

public function read(string $location): string
    {
        return $this->adapter->read($this->pathNormalizer->normalizePath($location));
    }

public function readStream(string $location)
    {
        return $this->adapter->readStream($this->pathNormalizer->normalizePath($location));
    }

public function delete(string $location): void
    {
        $this->adapter->delete($this->pathNormalizer->normalizePath($location));
    }

public function deleteDirectory(string $location): void
    {
        $this->adapter->deleteDirectory($this->pathNormalizer->normalizePath($location));
    }

public function createDirectory(string $location, array $config = []): void
    {
        $this->adapter->createDirectory(
            $this->pathNormalizer->normalizePath($location),
            $this->config->extend($config)
        );
    }

public function listContents(string $location, bool $deep = self::LIST_SHALLOW): DirectoryListing
    {
        $path = $this->pathNormalizer->normalizePath($location);
        $listing = $this->adapter->listContents($path, $deep);

return new DirectoryListing($this->pipeListing($location, $deep, $listing));
    }

private function pipeListing(string $location, bool $deep, iterable $listing): Generator
    {
        try {
            foreach ($listing as $item) {
                yield $item;
            }
        } catch (Throwable $exception) {
            throw UnableToListContents::atLocation($location, $deep, $exception);
        }
    }

public function move(string $source, string $destination, array $config = []): void
    {
        $config = $this->resolveConfigForMoveAndCopy($config);
        $from = $this->pathNormalizer->normalizePath($source);
        $to = $this->pathNormalizer->normalizePath($destination);

if ($from === $to) {
            $resolutionStrategy = $config->get(Config::OPTION_MOVE_IDENTICAL_PATH, ResolveIdenticalPathConflict::TRY);

if ($resolutionStrategy === ResolveIdenticalPathConflict::FAIL) {
                throw UnableToMoveFile::sourceAndDestinationAreTheSame($source, $destination);
            } elseif ($resolutionStrategy === ResolveIdenticalPathConflict::IGNORE) {
                return;
            }
        }

$this->adapter->move($from, $to, $config);
    }

public function copy(string $source, string $destination, array $config = []): void
    {
        $config = $this->resolveConfigForMoveAndCopy($config);
        $from = $this->pathNormalizer->normalizePath($source);
        $to = $this->pathNormalizer->normalizePath($destination);

if ($from === $to) {
            $resolutionStrategy = $config->get(Config::OPTION_COPY_IDENTICAL_PATH, ResolveIdenticalPathConflict::TRY);

if ($resolutionStrategy === ResolveIdenticalPathConflict::FAIL) {
                throw UnableToCopyFile::sourceAndDestinationAreTheSame($source, $destination);
            } elseif ($resolutionStrategy === ResolveIdenticalPathConflict::IGNORE) {
                return;
            }
        }

$this->adapter->copy($from, $to, $config);
    }

public function lastModified(string $path): int
    {
        return $this->adapter->lastModified($this->pathNormalizer->normalizePath($path))->lastModified();
    }

public function fileSize(string $path): int
    {
        return $this->adapter->fileSize($this->pathNormalizer->normalizePath($path))->fileSize();
    }

public function mimeType(string $path): string
    {
        return $this->adapter->mimeType($this->pathNormalizer->normalizePath($path))->mimeType();
    }

public function setVisibility(string $path, string $visibility): void
    {
        $this->adapter->setVisibility($this->pathNormalizer->normalizePath($path), $visibility);
    }

public function visibility(string $path): string
    {
        return $this->adapter->visibility($this->pathNormalizer->normalizePath($path))->visibility();
    }

public function publicUrl(string $path, array $config = []): string
    {
        $this->publicUrlGenerator ??= $this->resolvePublicUrlGenerator()
            ?? throw UnableToGeneratePublicUrl::noGeneratorConfigured($path);
        $config = $this->config->extend($config);

return $this->publicUrlGenerator->publicUrl(
            $this->pathNormalizer->normalizePath($path),
            $config,
        );
    }

public function temporaryUrl(string $path, DateTimeInterface $expiresAt, array $config = []): string
    {
        $generator = $this->temporaryUrlGenerator ?? $this->adapter;

if ($generator instanceof TemporaryUrlGenerator) {
            return $generator->temporaryUrl(
                $this->pathNormalizer->normalizePath($path),
                $expiresAt,
                $this->config->extend($config)
            );
        }

throw UnableToGenerateTemporaryUrl::noGeneratorConfigured($path);
    }

public function checksum(string $path, array $config = []): string
    {
        $config = $this->config->extend($config);

if ( ! $this->adapter instanceof ChecksumProvider) {
            return $this->calculateChecksumFromStream($path, $config);
        }

try {
            return $this->adapter->checksum(
                $this->pathNormalizer->normalizePath($path),
                $config,
            );
        } catch (ChecksumAlgoIsNotSupported) {
            return $this->calculateChecksumFromStream(
                $this->pathNormalizer->normalizePath($path),
                $config,
            );
        }
    }

private function resolvePublicUrlGenerator(): ?PublicUrlGenerator
    {
        if ($publicUrl = $this->config->get('public_url')) {
            return match (true) {
                is_array($publicUrl) => new ShardedPrefixPublicUrlGenerator($publicUrl),
                default => new PrefixPublicUrlGenerator($publicUrl),
            };
        }

if ($this->adapter instanceof PublicUrlGenerator) {
            return $this->adapter;
        }

return null;
    }

/**
     * @param mixed $contents
     */
    private function assertIsResource($contents): void
    {
        if (is_resource($contents) === false) {
            throw new InvalidStreamProvided(
                "Invalid stream provided, expected stream resource, received " . gettype($contents)
            );
        } elseif ($type = get_resource_type($contents) !== 'stream') {
            throw new InvalidStreamProvided(
                "Invalid stream provided, expected stream resource, received resource of type " . $type
            );
        }
    }

/**
     * @param resource $resource
     */
    private function rewindStream($resource): void
    {
        if (ftell($resource) !== 0 && stream_get_meta_data($resource)['seekable']) {
            rewind($resource);
        }
    }

private function resolveConfigForMoveAndCopy(array $config): Config
    {
        $retainVisibility = $this->config->get(Config::OPTION_RETAIN_VISIBILITY, $config[Config::OPTION_RETAIN_VISIBILITY] ?? true);
        $fullConfig = $this->config->extend($config);

/*
         * By default, we retain visibility. When we do not retain visibility, the visibility setting
         * from the default configuration is ignored. Only when it is set explicitly, we propagate the
         * setting.
         */
        if ($retainVisibility && ! array_key_exists(Config::OPTION_VISIBILITY, $config)) {
            $fullConfig = $fullConfig->withoutSettings(Config::OPTION_VISIBILITY)->extend($config);
        }

return $fullConfig;
    }
}