| Server IP : 160.25.81.117 / Your IP : 216.73.216.137 Web Server : Apache/2 System : Linux sv05.hilab.cloud 3.10.0-1160.119.1.el7.x86_64 #1 SMP Tue Jun 4 14:43:51 UTC 2024 x86_64 User : bellizen ( 1045) PHP Version : 7.2.34 Disable Function : NONE MySQL : OFF | cURL : ON | WGET : OFF | Perl : OFF | Python : OFF | Sudo : OFF | Pkexec : OFF Directory : /home/bellizen/public_html/vendor/laradic/support/src/ |
Upload File : |
<?php
/**
* Part of the Laradic PHP packages.
*
* MIT License and copyright information bundled with this package in the LICENSE file
*/
namespace Laradic\Support;
/**
* This is the class Path.
*
* @package Laradic\Support
* @author Laradic
* @copyright Copyright (c) 2015, Laradic. All rights reserved
*/
final class Path
{
public static function isPhar($path = null)
{
$path = $path === null ? __FILE__ : $path;
return Str::startsWith($path, 'phar://');
}
/**
* Equivalent of realpath() accept for Phar paths
* @param $path
* @return string
*/
public static function real($path)
{
return static::isPhar($path) ? $path : realpath($path);
}
/**
* Joins a split file system path.
*
* @param array|string $path
*
* @return string
*/
public static function join()
{
$arguments = func_get_args();
if (func_num_args() === 1 and is_array($arguments[ 0 ])) {
$arguments = $arguments[ 0 ];
}
foreach ($arguments as $key => &$argument) {
if (is_array($argument)) {
$argument = static::join($argument);
}
$argument = Str::removeRight($argument, '/');
if ($key > 0) {
$argument = Str::removeLeft($argument, '/');
}
#$arguments[ $key ] = $argument;
}
return implode(DIRECTORY_SEPARATOR, $arguments);
}
/**
* Similar to the join() method, but also normalize()'s the result
*
* @return string
*/
public static function njoin()
{
return static::canonicalize(static::join(func_get_args()));
}
/**
* Get the directory path
* @param $path
* @return mixed|string
*/
public static function getDirectoryName($path)
{
$path = static::real($path);
if (is_dir($path)) {
return last(explode(DIRECTORY_SEPARATOR, $path));
} else {
return static::getDirectory($path);
}
}
/**
* normalize method
* @param $path
* @return mixed
*/
public static function normalize($path)
{
return static::canonicalize($path);
}
/**
* Return the user's home directory.
*/
public static function getHome()
{
// Cannot use $_SERVER superglobal since that's empty during UnitUnishTestCase
// getenv('HOME') isn't set on Windows and generates a Notice.
$home = getenv('HOME');
if (!empty($home)) {
// home should never end with a trailing slash.
$home = rtrim($home, '/');
} elseif (!empty($_SERVER[ 'HOMEDRIVE' ]) && !empty($_SERVER[ 'HOMEPATH' ])) {
// home on windows
$home = $_SERVER[ 'HOMEDRIVE' ] . $_SERVER[ 'HOMEPATH' ];
// If HOMEPATH is a root directory the path can end with a slash. Make sure
// that doesn't happen.
$home = rtrim($home, '\\/');
}
return empty($home) ? null : $home;
}
/**
* Canonicalizes the given path.
*
* During normalization, all slashes are replaced by forward slashes ("/").
* Furthermore, all "." and ".." segments are removed as far as possible.
* ".." segments at the beginning of relative paths are not removed.
*
* ```php
* echo Path::canonicalize("\webmozart\puli\..\css\style.css");
* // => /webmozart/style.css
*
* echo Path::canonicalize("../css/./style.css");
* // => ../css/style.css
* ```
*
* This method is able to deal with both UNIX and Windows paths.
*
* @param string $path A path string
*
* @return string The canonical path
*/
public static function canonicalize($path)
{
$path = (string)$path;
if ('' === $path) {
return '';
}
$path = str_replace('\\', '/', $path);
list ($root, $path) = self::split($path);
$parts = array_filter(explode('/', $path), 'strlen');
$canonicalParts = [ ];
// Collapse "." and "..", if possible
foreach ($parts as $part) {
if ('.' === $part) {
continue;
}
// Collapse ".." with the previous part, if one exists
// Don't collapse ".." if the previous part is also ".."
if ('..' === $part && count($canonicalParts) > 0
&& '..' !== $canonicalParts[ count($canonicalParts) - 1 ]
) {
array_pop($canonicalParts);
continue;
}
// Only add ".." prefixes for relative paths
if ('..' !== $part || '' === $root) {
$canonicalParts[] = $part;
}
}
// Add the root directory again
return $root . implode('/', $canonicalParts);
}
/**
* Returns the directory part of the path.
*
* This method is similar to PHP's dirname(), but handles various cases
* where dirname() returns a weird result:
*
* - dirname() does not accept backslashes on UNIX
* - dirname("C:/webmozart") returns "C:", not "C:/"
* - dirname("C:/") returns ".", not "C:/"
* - dirname("C:") returns ".", not "C:/"
* - dirname("webmozart") returns ".", not ""
* - dirname() does not canonicalize the result
*
* This method fixes these shortcomings and behaves like dirname()
* otherwise.
*
* The result is a canonical path.
*
* @param string $path A path string
*
* @return string The canonical directory part. Returns the root directory
* if the root directory is passed. Returns an empty string
* if a relative path is passed that contains no slashes.
* Returns an empty string if an empty string is passed
*/
public static function getDirectory($path)
{
if ('' === $path) {
return '';
}
$path = static::canonicalize($path);
if (false !== ($pos = strrpos($path, '/'))) {
// Directory equals root directory "/"
if (0 === $pos) {
return '/';
}
// Directory equals Windows root "C:/"
if (2 === $pos && ctype_alpha($path[ 0 ]) && ':' === $path[ 1 ]) {
return substr($path, 0, 3);
}
return substr($path, 0, $pos);
}
return '';
}
/**
* Returns the root directory of a path.
*
* The result is a canonical path.
*
* @param string $path A path string
*
* @return string The canonical root directory. Returns an empty string if
* the given path is relative or empty
*/
public static function getRoot($path)
{
if ('' === $path) {
return '';
}
// UNIX root "/" or "\" (Windows style)
if ('/' === $path[ 0 ] || '\\' === $path[ 0 ]) {
return '/';
}
$length = strlen($path);
// Windows root
if ($length > 1 && ctype_alpha($path[ 0 ]) && ':' === $path[ 1 ]) {
// Special case: "C:"
if (2 === $length) {
return $path . '/';
}
// Normal case: "C:/ or "C:\"
if ('/' === $path[ 2 ] || '\\' === $path[ 2 ]) {
return $path[ 0 ] . $path[ 1 ] . '/';
}
}
return '';
}
/**
* Returns the filename from a file path.
*
* @param string $path The path string
*
* @return string Filename
*
* @since 1.1
*/
public static function getFilename($path)
{
if ('' === $path) {
return '';
}
return basename($path);
}
/**
* Returns the filename without the extension from a file path.
*
* @param string $path The path string
* @param string|null $extension If specified, only that extension is cut off
* (may contain leading dot)
*
* @return string Filename without extension
*
* @since 1.1
*/
public static function getFilenameWithoutExtension($path, $extension = null)
{
if ('' === $path) {
return '';
}
if (null !== $extension) {
// remove extension and trailing dot
return rtrim(basename($path, $extension), '.');
}
return pathinfo($path, PATHINFO_FILENAME);
}
/**
* Returns the extension from a file path.
*
* @param string $path The path string
* @param bool $forceLowerCase Forces the extension to be lower-case
* (Requires mbstring extension for correct
* multi-byte character handling in extension)
*
* @return string Extension from a file path (without leading dot)
*
* @since 1.1
*/
public static function getExtension($path, $forceLowerCase = false)
{
if ('' === $path) {
return '';
}
$extension = pathinfo($path, PATHINFO_EXTENSION);
if ($forceLowerCase) {
$extension = self::toLower($extension);
}
return $extension;
}
/**
* Returns whether the path has an extension.
*
* @param string $path The path string
* @param string|array|null $extensions If null or not provided, checks if an
* extension exists, otherwise checks for
* the specified extension or array of extensions
* (with or without leading dot)
* @param bool $ignoreCase Whether to ignore case-sensitivity
* (Requires mbstring extension for correct
* multi-byte character handling in extension)
*
* @return bool true if the path has an (or the specified) extension, otherwise false
*
* @since 1.1
*/
public static function hasExtension($path, $extensions = null, $ignoreCase = false)
{
if ('' === $path) {
return false;
}
$actualExtension = self::getExtension($path, $ignoreCase);
// Only check if path has any extension
if (null === $extensions) {
return !empty($actualExtension);
}
// Make an array of extensions
if (!is_array($extensions)) {
$extensions = [ $extensions ];
}
foreach ($extensions as $key => $extension) {
if ($ignoreCase) {
$extension = self::toLower($extension);
}
// remove leading '.' in extensions array
$extensions[ $key ] = ltrim($extension, '.');
}
return in_array($actualExtension, $extensions);
}
/**
* Changes the extension of a path string.
*
* @param string $path The path string with filename.ext to change
* @param string $extension New extension (with or without leading dot)
*
* @return string The path string with new file extension
*
* @since 1.1
*/
public static function changeExtension($path, $extension)
{
if ('' === $path) {
return '';
}
$actualExtension = self::getExtension($path);
$extension = ltrim($extension, '.');
// No extension for paths
if ('/' == substr($path, -1)) {
return $path;
}
// No actual extension in path
if (empty($actualExtension)) {
return $path . ('.' == substr($path, -1) ? '' : '.') . $extension;
}
return substr($path, 0, -strlen($actualExtension)) . $extension;
}
/**
* Returns whether a path is absolute.
*
* @param string $path A path string
*
* @return boolean Returns true if the path is absolute, false if it is
* relative or empty
*/
public static function isAbsolute($path)
{
if ('' === $path) {
return false;
}
// UNIX root "/" or "\" (Windows style)
if ('/' === $path[ 0 ] || '\\' === $path[ 0 ]) {
return true;
}
// Windows root
if (strlen($path) > 1 && ctype_alpha($path[ 0 ]) && ':' === $path[ 1 ]) {
// Special case: "C:"
if (2 === strlen($path)) {
return true;
}
// Normal case: "C:/ or "C:\"
if ('/' === $path[ 2 ] || '\\' === $path[ 2 ]) {
return true;
}
}
return false;
}
/**
* Returns whether a path is relative.
*
* @param string $path A path string
*
* @return boolean Returns true if the path is relative or empty, false if
* it is absolute
*/
public static function isRelative($path)
{
return !static::isAbsolute($path);
}
/**
* Turns a relative path into an absolute path.
*
* Usually, the relative path is appended to the given base path. Dot
* segments ("." and "..") are removed/collapsed and all slashes turned
* into forward slashes.
*
* ```php
* echo Path::makeAbsolute("../style.css", "/webmozart/puli/css");
* // => /webmozart/puli/style.css
* ```
*
* If an absolute path is passed, that path is returned unless its root
* directory is different than the one of the base path. In that case, an
* exception is thrown.
*
* ```php
* Path::makeAbsolute("/style.css", "/webmozart/puli/css");
* // => /style.css
*
* Path::makeAbsolute("C:/style.css", "C:/webmozart/puli/css");
* // => C:/style.css
*
* Path::makeAbsolute("C:/style.css", "/webmozart/puli/css");
* // InvalidArgumentException
* ```
*
* If the base path is not an absolute path, an exception is thrown.
*
* The result is a canonical path.
*
* @param string $path A path to make absolute
* @param string $basePath An absolute base path
*
* @return string An absolute path in canonical form
*
* @throws \InvalidArgumentException If the base path is not absolute or if
* the given path is an absolute path with
* a different root than the base path
*/
public static function makeAbsolute($path, $basePath)
{
$basePath = (string)$basePath;
if (!static::isAbsolute($basePath)) {
throw new \InvalidArgumentException(sprintf(
'The base path "%s" is not an absolute path.',
$basePath
));
}
if (static::isAbsolute($path)) {
$root = static::getRoot($path);
$baseRoot = static::getRoot($basePath);
if ($root !== $baseRoot) {
throw new \InvalidArgumentException(sprintf(
'The path "%s" cannot be made absolute based on "%s", ' .
'because their roots are different ("%s" and "%s").',
$path,
$basePath,
$root,
$baseRoot
));
}
return static::canonicalize($path);
}
return static::canonicalize($basePath . '/' . $path);
}
/**
* Turns a path into a relative path.
*
* The relative path is created relative to the given base path:
*
* ```php
* echo Path::makeRelative("/webmozart/style.css", "/webmozart/puli");
* // => ../style.css
* ```
*
* If a relative path is passed and the base path is absolute, the relative
* path is returned unchanged:
*
* ```php
* Path::makeRelative("style.css", "/webmozart/puli/css");
* // => style.css
* ```
*
* If both paths are relative, the relative path is created with the
* assumption that both paths are relative to the same directory:
*
* ```php
* Path::makeRelative("style.css", "webmozart/puli/css");
* // => ../../../style.css
* ```
*
* If both paths are absolute, their root directory must be the same,
* otherwise an exception is thrown:
*
* ```php
* Path::makeRelative("C:/webmozart/style.css", "/webmozart/puli");
* // InvalidArgumentException
* ```
*
* If the passed path is absolute, but the base path is not, an exception
* is thrown as well:
*
* ```php
* Path::makeRelative("/webmozart/style.css", "webmozart/puli");
* // InvalidArgumentException
* ```
*
* If the base path is not an absolute path, an exception is thrown.
*
* The result is a canonical path.
*
* @param string $path A path to make relative
* @param string $basePath An base path
*
* @return string A relative path in canonical form
*
* @throws \InvalidArgumentException If the base path is not absolute or if
* the given path has a different root
* than the base path
*/
public static function makeRelative($path, $basePath)
{
$path = static::canonicalize($path);
$basePath = static::canonicalize($basePath);
list ($root, $relativePath) = self::split($path);
list ($baseRoot, $relativeBasePath) = self::split($basePath);
// If the base path is given as absolute path and the path is already
// relative, consider it to be relative to the given absolute path
// already
if ('' === $root && '' !== $baseRoot) {
return $relativePath;
}
// If the passed path is absolute, but the base path is not, we
// cannot generate a relative path
if ('' !== $root && '' === $baseRoot) {
throw new \InvalidArgumentException(sprintf(
'The absolute path "%s" cannot be made relative to the ' .
'relative path "%s". You should provide an absolute base ' .
'path instead.',
$path,
$basePath
));
}
// Fail if the roots of the two paths are different
if ($baseRoot && $root !== $baseRoot) {
throw new \InvalidArgumentException(sprintf(
'The path "%s" cannot be made relative to "%s", because they ' .
'have different roots ("%s" and "%s").',
$path,
$basePath,
$root,
$baseRoot
));
}
if ('' === $relativeBasePath) {
return $relativePath;
}
// Build a "../../" prefix with as many "../" parts as necessary
$parts = explode('/', $relativePath);
$baseParts = explode('/', $relativeBasePath);
$dotDotPrefix = '';
// Once we found a non-matching part in the prefix, we need to add
// "../" parts for all remaining parts
$match = true;
foreach ($baseParts as $i => $basePart) {
if ($match && isset($parts[ $i ]) && $basePart === $parts[ $i ]) {
unset($parts[ $i ]);
continue;
}
$match = false;
$dotDotPrefix .= '../';
}
return $dotDotPrefix . implode('/', $parts);
}
/**
* Returns whether the given path is on the local filesystem.
*
* @param string $path A path string
*
* @return boolean Returns true if the path is local, false for a URL
*/
public static function isLocal($path)
{
return is_string($path) && '' !== $path && false === strpos($path, '://');
}
/**
* Returns the longest common base path of a set of paths.
*
* Dot segments ("." and "..") are removed/collapsed and all slashes turned
* into forward slashes.
*
* ```php
* $basePath = Path::getLongestCommonBasePath(array(
* '/webmozart/css/style.css',
* '/webmozart/css/..'
* ));
* // => /webmozart
* ```
*
* The root is returned if no common base path can be found:
*
* ```php
* $basePath = Path::getLongestCommonBasePath(array(
* '/webmozart/css/style.css',
* '/puli/css/..'
* ));
* // => /
* ```
*
* If the paths are located on different Windows partitions, `null` is
* returned.
*
* ```php
* $basePath = Path::getLongestCommonBasePath(array(
* 'C:/webmozart/css/style.css',
* 'D:/webmozart/css/..'
* ));
* // => null
* ```
*
* @param array $paths A list of paths.
*
* @return string The longest common base path in canonical form or `null`
* if the paths are on different Windows partitions.
*/
public static function getLongestCommonBasePath(array $paths)
{
list ($bpRoot, $basePath) = self::split(self::canonicalize(reset($paths)));
for (next($paths); null !== key($paths) && '' !== $basePath; next($paths)) {
list ($root, $path) = self::split(self::canonicalize(current($paths)));
// If we deal with different roots (e.g. C:/ vs. D:/), it's time
// to quit
if ($root !== $bpRoot) {
return null;
}
// Make the base path shorter until it fits into path
while (true) {
if ('.' === $basePath) {
// No more base paths
$basePath = '';
// Next path
continue 2;
}
// Prevent false positives for common prefixes
// see isBasePath()
if (0 === strpos($path . '/', $basePath . '/')) {
// Next path
continue 2;
}
$basePath = dirname($basePath);
}
}
return $bpRoot . $basePath;
}
/**
* Returns whether a path is a base path of another path.
*
* Dot segments ("." and "..") are removed/collapsed and all slashes turned
* into forward slashes.
*
* ```php
* Path::isBasePath('/webmozart', '/webmozart/css');
* // => true
*
* Path::isBasePath('/webmozart', '/webmozart');
* // => true
*
* Path::isBasePath('/webmozart', '/webmozart/..');
* // => false
*
* Path::isBasePath('/webmozart', '/puli');
* // => false
* ```
*
* @param string $basePath The base path to test.
* @param string $ofPath The other path.
*
* @return bool Whether the base path is a base path of the other path.
*/
public static function isBasePath($basePath, $ofPath)
{
$basePath = self::canonicalize($basePath);
$ofPath = self::canonicalize($ofPath);
// Append slashes to prevent false positives when two paths have
// a common prefix, for example /base/foo and /base/foobar.
// Don't append a slash for the root "/", because then that root
// won't be discovered as common prefix ("//" is not a prefix of
// "/foobar/").
return 0 === strpos($ofPath . '/', rtrim($basePath, '/') . '/');
}
/**
* Splits a part into its root directory and the remainder.
*
* If the path has no root directory, an empty root directory will be
* returned.
*
* If the root directory is a Windows style partition, the resulting root
* will always contain a trailing slash.
*
* list ($root, $path) = Path::split("C:/webmozart")
* // => array("C:/", "webmozart")
*
* list ($root, $path) = Path::split("C:")
* // => array("C:/", "")
*
* @param string $path The canonical path to split
*
* @return array An array with the root directory and the remaining relative
* path
*/
private static function split($path)
{
if ('' === $path) {
return [ '', '' ];
}
$root = '';
$length = strlen($path);
// Remove and remember root directory
if ('/' === $path[ 0 ]) {
$root = '/';
$path = $length > 1 ? substr($path, 1) : '';
} elseif ($length > 1 && ctype_alpha($path[ 0 ]) && ':' === $path[ 1 ]) {
if (2 === $length) {
// Windows special case: "C:"
$root = $path . '/';
$path = '';
} elseif ('/' === $path[ 2 ]) {
// Windows normal case: "C:/"..
$root = substr($path, 0, 3);
$path = $length > 3 ? substr($path, 3) : '';
}
}
return [ $root, $path ];
}
/**
* Converts string to lower-case (multi-byte safe if mbstring is installed).
*
* @param string $str The string
*
* @return string Lower case string
*/
private static function toLower($str)
{
if (function_exists('mb_strtolower')) {
return mb_strtolower($str, mb_detect_encoding($str));
}
return strtolower($str);
}
private function __construct()
{
throw new \BadMethodCallException('Path should not be instanciated');
}
}