Filesystem::ensureParentDirectoryExists() - Code Metrics - Inspection of "Merge pull request #2293 from hydephp/feat/ensure-..." - hydephp/develop - Measure and Improve Code Quality continuously with Scrutinizer

Passed
Push — master ( 7ad0e3...3ff727 )

by Caen
created 2025-09-27 15:35 UTC
Filesystem::ensureParentDirectoryExists() A

↳ Parent: Filesystem
Complexity

Conditions	1
Paths	1
Size

Total Lines	3
Code Lines	1
Duplication

Lines	0
Ratio	0 %
Importance

Changes
Metric	Value
cc	1
eloc	1
nc	1
nop	3
dl	0
loc	3
rs	10
c	0
b	0
f	0
<?php

declare(strict_types=1);

namespace Hyde\Facades;

use Hyde\Foundation\HydeKernel;
use Hyde\Framework\Concerns\Internal\ForwardsIlluminateFilesystem;
use Illuminate\Support\Collection;

use function app;

/**
 * Proxies the Laravel File facade with extra features and helpers tailored for HydePHP.
 *
 * For maximum compatability and interoperability, all path references in HydePHP are relative to the root of the project.
 * The helpers here will then prepend the project root to the path before actually interacting with the filesystem.
 *
 * @see \Hyde\Foundation\Kernel\Filesystem
 * @see \Illuminate\Filesystem\Filesystem
 */
class Filesystem
{
    use ForwardsIlluminateFilesystem;

    /**
     * Get the base path of the HydePHP project.
     *
     * @return string
     */
    public static function basePath(): string
    {
        return self::kernel()->path();
    }

    /**
     * Format the given project path to be absolute. Already absolute paths are normalized.
     *
     * @param  string  $path
     * @return string
     */
    public static function absolutePath(string $path): string
    {
        return self::kernel()->pathToAbsolute(self::relativePath($path));
    }

    /**
     * Remove the absolute path from the given project path so that it becomes relative.
     *
     * @param  string  $path
     * @return string
     */
    public static function relativePath(string $path): string
    {
        return self::kernel()->pathToRelative($path);
    }

    /**
     * A smarter glob function that will run the specified glob pattern a bit more intelligently.
     * While this method will use the absolute path when interacting with the filesystem,
     * the returned collection will only contain relative paths.
     *
     * @param  string  $pattern
     * @param  int  $flags
     * @return \Illuminate\Support\Collection<int, string>
     */
    public static function smartGlob(string $pattern, int $flags = 0): Collection
    {
        return self::kernel()->filesystem()->smartGlob($pattern, $flags);
    }

    /**
     * Find files in the project's directory, with optional filtering by extension and recursion.
     *
     * The returned collection will be a list of paths relative to the project root.
     *
     * @param  string  $directory
     * @param  string|array<string>|false  $matchExtensions  The file extension(s) to match, or false to match all files.
     * @param  bool  $recursive  Whether to search recursively or not.
     * @return \Illuminate\Support\Collection<int, string>
     */
    public static function findFiles(string $directory, string|array|false $matchExtensions = false, bool $recursive = false): Collection
    {
        return self::kernel()->filesystem()->findFiles($directory, $matchExtensions, $recursive);
    }

    /**
     * Touch one or more files in the project's directory.
     *
     * @param  string|array  $path
     * @return bool
     */
    public static function touch(string|array $path): bool
    {
        return self::kernel()->filesystem()->touch($path);
    }

    /**
     * Unlink one or more files in the project's directory.
     *
     * @param  string|array  $path
     * @return bool
     */
    public static function unlink(string|array $path): bool
    {
        return self::kernel()->filesystem()->unlink($path);
    }

    /**
     * Unlink a file in the project's directory, but only if it exists.
     *
     * @param  string  $path
     * @return bool True if the file was unlinked, false if it did not exist or failed to unlink.
     */
    public static function unlinkIfExists(string $path): bool
    {
        return self::kernel()->filesystem()->unlinkIfExists($path);
    }

    /**
     * Ensure that the parent directory of the given file path exists.
     *
     * @param  string  $path
     * @param  int  $mode
     * @param  bool  $recursive
     * @return void
     */
    public static function ensureParentDirectoryExists(string $path, int $mode = 0755, bool $recursive = true): void
    {
        self::ensureDirectoryExists(self::dirname($path), $mode, $recursive);
    }

    /**
     * Get the contents of a file.
     *
     * @param  string  $path
     * @param  bool  $lock
     * @return string
     *
     * @throws \Illuminate\Contracts\Filesystem\FileNotFoundException
     */
    public static function getContents(string $path, bool $lock = false): string
    {
        return self::get(...func_get_args());
        return self::get(/** @scrutinizer ignore-type */ ...func_get_args());
    }

    /**
     * Write the contents of a file.
     *
     * @param  string  $path
     * @param  string  $contents
     * @param  bool  $lock
     * @return int|bool
     */
    public static function putContents(string $path, string $contents, bool $lock = false): bool|int
    {
        return self::put(...func_get_args());
    }

    /**
     * Improved mime type detection for the given path that can be relative to the project root,
     * or a remote URL where this will try to guess the mime type based on the file extension.
     *
     * @param  string  $path  The path to the file, relative to the project root or a remote URL.
     */
    public static function findMimeType(string $path): string
    {
        $extension = self::extension($path);

        $lookup = [
            'txt' => 'text/plain',
            'md' => 'text/markdown',
            'html' => 'text/html',
            'css' => 'text/css',
            'svg' => 'image/svg+xml',
            'png' => 'image/png',
            'jpg' => 'image/jpeg',
            'jpeg' => 'image/jpeg',
            'gif' => 'image/gif',
            'json' => 'application/json',
            'js' => 'application/javascript',
            'xml' => 'application/xml',
        ];

        if (isset($lookup[$extension])) {
            return $lookup[$extension];
        }

        if (extension_loaded('fileinfo') && self::exists($path)) {
            return self::mimeType($path);

        }

        return 'text/plain';
    }

    protected static function filesystem(): \Illuminate\Filesystem\Filesystem
    {
        return app(\Illuminate\Filesystem\Filesystem::class);
    }

    protected static function kernel(): HydeKernel
    {
        return HydeKernel::getInstance();
    }
}

hydephp / develop

Push — master ( 7ad0e3...3ff727 )

Filesystem::ensureParentDirectoryExists() A

Complexity

Size

Duplication

Importance

Duplication Side-by-Side

Filter issues like
