123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214215216217218219220221222223224225226227228229230231232233234235236237238239240241242243244245246247248249250251252253254255256257258259260261262263264265266267268269270271272273274275276277278279280281282283284285286287288289290291292293294295296297298299300301302303304305306307308309310311312313314315316317318319320321322323324325326327328329330331332333334335336337338339340341342343344345346347348349350351352353354355356357358359360361362363364365366367368369370371372373374375376377378379380381382383384385386387388389390391392393394395396397398399400401402403404405406407408409410411412413414415416417418419420421422423424425426427428429430431432433434435436437438439440441442443444445446447448449450451452453454455456457458459460461462463464465466467468469470471472473474475476477478479480481482483484485486487488489490491492493494495496497498499500501502503504505506507508509510511512513514515516517518519520521522523524525526527528529530531532533534535536537538539540541542543544545546547548549550551552553554555556557558559560561562563564565566567568569570571572573574575576577578579580581582583584585586587588589590591592593594595596597598599600601602603604605606607608609610611612613614615616617618619620621622623624625626627628629630631632633634635636637638639640641642643644645646647648649650651652653654655656657658659660661662663664665666667668669670671672673674675676677678679680681682683684685686687688689690691692693694695696697698699700701702703704705706707708709710711712713714715716717718719720721722723724725726727728729730731732733734735736737738739740741742743744745746747 |
- <?php
- /*
- * This file is part of the Symfony package.
- *
- * (c) Fabien Potencier <fabien@symfony.com>
- *
- * For the full copyright and license information, please view the LICENSE
- * file that was distributed with this source code.
- */
- namespace Symfony\Component\Filesystem;
- use Symfony\Component\Filesystem\Exception\FileNotFoundException;
- use Symfony\Component\Filesystem\Exception\InvalidArgumentException;
- use Symfony\Component\Filesystem\Exception\IOException;
- /**
- * Provides basic utility to manipulate the file system.
- *
- * @author Fabien Potencier <fabien@symfony.com>
- */
- class Filesystem
- {
- private static $lastError;
- /**
- * Copies a file.
- *
- * If the target file is older than the origin file, it's always overwritten.
- * If the target file is newer, it is overwritten only when the
- * $overwriteNewerFiles option is set to true.
- *
- * @throws FileNotFoundException When originFile doesn't exist
- * @throws IOException When copy fails
- */
- public function copy(string $originFile, string $targetFile, bool $overwriteNewerFiles = false)
- {
- $originIsLocal = stream_is_local($originFile) || 0 === stripos($originFile, 'file://');
- if ($originIsLocal && !is_file($originFile)) {
- throw new FileNotFoundException(sprintf('Failed to copy "%s" because file does not exist.', $originFile), 0, null, $originFile);
- }
- $this->mkdir(\dirname($targetFile));
- $doCopy = true;
- if (!$overwriteNewerFiles && null === parse_url($originFile, \PHP_URL_HOST) && is_file($targetFile)) {
- $doCopy = filemtime($originFile) > filemtime($targetFile);
- }
- if ($doCopy) {
- // https://bugs.php.net/64634
- if (false === $source = @fopen($originFile, 'r')) {
- throw new IOException(sprintf('Failed to copy "%s" to "%s" because source file could not be opened for reading.', $originFile, $targetFile), 0, null, $originFile);
- }
- // Stream context created to allow files overwrite when using FTP stream wrapper - disabled by default
- if (false === $target = @fopen($targetFile, 'w', null, stream_context_create(['ftp' => ['overwrite' => true]]))) {
- throw new IOException(sprintf('Failed to copy "%s" to "%s" because target file could not be opened for writing.', $originFile, $targetFile), 0, null, $originFile);
- }
- $bytesCopied = stream_copy_to_stream($source, $target);
- fclose($source);
- fclose($target);
- unset($source, $target);
- if (!is_file($targetFile)) {
- throw new IOException(sprintf('Failed to copy "%s" to "%s".', $originFile, $targetFile), 0, null, $originFile);
- }
- if ($originIsLocal) {
- // Like `cp`, preserve executable permission bits
- @chmod($targetFile, fileperms($targetFile) | (fileperms($originFile) & 0111));
- if ($bytesCopied !== $bytesOrigin = filesize($originFile)) {
- throw new IOException(sprintf('Failed to copy the whole content of "%s" to "%s" (%g of %g bytes copied).', $originFile, $targetFile, $bytesCopied, $bytesOrigin), 0, null, $originFile);
- }
- }
- }
- }
- /**
- * Creates a directory recursively.
- *
- * @param string|iterable $dirs The directory path
- *
- * @throws IOException On any directory creation failure
- */
- public function mkdir($dirs, int $mode = 0777)
- {
- foreach ($this->toIterable($dirs) as $dir) {
- if (is_dir($dir)) {
- continue;
- }
- if (!self::box('mkdir', $dir, $mode, true)) {
- if (!is_dir($dir)) {
- // The directory was not created by a concurrent process. Let's throw an exception with a developer friendly error message if we have one
- if (self::$lastError) {
- throw new IOException(sprintf('Failed to create "%s": ', $dir).self::$lastError, 0, null, $dir);
- }
- throw new IOException(sprintf('Failed to create "%s".', $dir), 0, null, $dir);
- }
- }
- }
- }
- /**
- * Checks the existence of files or directories.
- *
- * @param string|iterable $files A filename, an array of files, or a \Traversable instance to check
- *
- * @return bool true if the file exists, false otherwise
- */
- public function exists($files)
- {
- $maxPathLength = \PHP_MAXPATHLEN - 2;
- foreach ($this->toIterable($files) as $file) {
- if (\strlen($file) > $maxPathLength) {
- throw new IOException(sprintf('Could not check if file exist because path length exceeds %d characters.', $maxPathLength), 0, null, $file);
- }
- if (!file_exists($file)) {
- return false;
- }
- }
- return true;
- }
- /**
- * Sets access and modification time of file.
- *
- * @param string|iterable $files A filename, an array of files, or a \Traversable instance to create
- * @param int|null $time The touch time as a Unix timestamp, if not supplied the current system time is used
- * @param int|null $atime The access time as a Unix timestamp, if not supplied the current system time is used
- *
- * @throws IOException When touch fails
- */
- public function touch($files, int $time = null, int $atime = null)
- {
- foreach ($this->toIterable($files) as $file) {
- $touch = $time ? @touch($file, $time, $atime) : @touch($file);
- if (true !== $touch) {
- throw new IOException(sprintf('Failed to touch "%s".', $file), 0, null, $file);
- }
- }
- }
- /**
- * Removes files or directories.
- *
- * @param string|iterable $files A filename, an array of files, or a \Traversable instance to remove
- *
- * @throws IOException When removal fails
- */
- public function remove($files)
- {
- if ($files instanceof \Traversable) {
- $files = iterator_to_array($files, false);
- } elseif (!\is_array($files)) {
- $files = [$files];
- }
- $files = array_reverse($files);
- foreach ($files as $file) {
- if (is_link($file)) {
- // See https://bugs.php.net/52176
- if (!(self::box('unlink', $file) || '\\' !== \DIRECTORY_SEPARATOR || self::box('rmdir', $file)) && file_exists($file)) {
- throw new IOException(sprintf('Failed to remove symlink "%s": ', $file).self::$lastError);
- }
- } elseif (is_dir($file)) {
- $this->remove(new \FilesystemIterator($file, \FilesystemIterator::CURRENT_AS_PATHNAME | \FilesystemIterator::SKIP_DOTS));
- if (!self::box('rmdir', $file) && file_exists($file)) {
- throw new IOException(sprintf('Failed to remove directory "%s": ', $file).self::$lastError);
- }
- } elseif (!self::box('unlink', $file) && (false !== strpos(self::$lastError, 'Permission denied') || file_exists($file))) {
- throw new IOException(sprintf('Failed to remove file "%s": ', $file).self::$lastError);
- }
- }
- }
- /**
- * Change mode for an array of files or directories.
- *
- * @param string|iterable $files A filename, an array of files, or a \Traversable instance to change mode
- * @param int $mode The new mode (octal)
- * @param int $umask The mode mask (octal)
- * @param bool $recursive Whether change the mod recursively or not
- *
- * @throws IOException When the change fails
- */
- public function chmod($files, int $mode, int $umask = 0000, bool $recursive = false)
- {
- foreach ($this->toIterable($files) as $file) {
- if ((\PHP_VERSION_ID < 80000 || \is_int($mode)) && true !== @chmod($file, $mode & ~$umask)) {
- throw new IOException(sprintf('Failed to chmod file "%s".', $file), 0, null, $file);
- }
- if ($recursive && is_dir($file) && !is_link($file)) {
- $this->chmod(new \FilesystemIterator($file), $mode, $umask, true);
- }
- }
- }
- /**
- * Change the owner of an array of files or directories.
- *
- * @param string|iterable $files A filename, an array of files, or a \Traversable instance to change owner
- * @param string|int $user A user name or number
- * @param bool $recursive Whether change the owner recursively or not
- *
- * @throws IOException When the change fails
- */
- public function chown($files, $user, bool $recursive = false)
- {
- foreach ($this->toIterable($files) as $file) {
- if ($recursive && is_dir($file) && !is_link($file)) {
- $this->chown(new \FilesystemIterator($file), $user, true);
- }
- if (is_link($file) && \function_exists('lchown')) {
- if (true !== @lchown($file, $user)) {
- throw new IOException(sprintf('Failed to chown file "%s".', $file), 0, null, $file);
- }
- } else {
- if (true !== @chown($file, $user)) {
- throw new IOException(sprintf('Failed to chown file "%s".', $file), 0, null, $file);
- }
- }
- }
- }
- /**
- * Change the group of an array of files or directories.
- *
- * @param string|iterable $files A filename, an array of files, or a \Traversable instance to change group
- * @param string|int $group A group name or number
- * @param bool $recursive Whether change the group recursively or not
- *
- * @throws IOException When the change fails
- */
- public function chgrp($files, $group, bool $recursive = false)
- {
- foreach ($this->toIterable($files) as $file) {
- if ($recursive && is_dir($file) && !is_link($file)) {
- $this->chgrp(new \FilesystemIterator($file), $group, true);
- }
- if (is_link($file) && \function_exists('lchgrp')) {
- if (true !== @lchgrp($file, $group)) {
- throw new IOException(sprintf('Failed to chgrp file "%s".', $file), 0, null, $file);
- }
- } else {
- if (true !== @chgrp($file, $group)) {
- throw new IOException(sprintf('Failed to chgrp file "%s".', $file), 0, null, $file);
- }
- }
- }
- }
- /**
- * Renames a file or a directory.
- *
- * @throws IOException When target file or directory already exists
- * @throws IOException When origin cannot be renamed
- */
- public function rename(string $origin, string $target, bool $overwrite = false)
- {
- // we check that target does not exist
- if (!$overwrite && $this->isReadable($target)) {
- throw new IOException(sprintf('Cannot rename because the target "%s" already exists.', $target), 0, null, $target);
- }
- if (true !== @rename($origin, $target)) {
- if (is_dir($origin)) {
- // See https://bugs.php.net/54097 & https://php.net/rename#113943
- $this->mirror($origin, $target, null, ['override' => $overwrite, 'delete' => $overwrite]);
- $this->remove($origin);
- return;
- }
- throw new IOException(sprintf('Cannot rename "%s" to "%s".', $origin, $target), 0, null, $target);
- }
- }
- /**
- * Tells whether a file exists and is readable.
- *
- * @throws IOException When windows path is longer than 258 characters
- */
- private function isReadable(string $filename): bool
- {
- $maxPathLength = \PHP_MAXPATHLEN - 2;
- if (\strlen($filename) > $maxPathLength) {
- throw new IOException(sprintf('Could not check if file is readable because path length exceeds %d characters.', $maxPathLength), 0, null, $filename);
- }
- return is_readable($filename);
- }
- /**
- * Creates a symbolic link or copy a directory.
- *
- * @throws IOException When symlink fails
- */
- public function symlink(string $originDir, string $targetDir, bool $copyOnWindows = false)
- {
- if ('\\' === \DIRECTORY_SEPARATOR) {
- $originDir = strtr($originDir, '/', '\\');
- $targetDir = strtr($targetDir, '/', '\\');
- if ($copyOnWindows) {
- $this->mirror($originDir, $targetDir);
- return;
- }
- }
- $this->mkdir(\dirname($targetDir));
- if (is_link($targetDir)) {
- if (readlink($targetDir) === $originDir) {
- return;
- }
- $this->remove($targetDir);
- }
- if (!self::box('symlink', $originDir, $targetDir)) {
- $this->linkException($originDir, $targetDir, 'symbolic');
- }
- }
- /**
- * Creates a hard link, or several hard links to a file.
- *
- * @param string|string[] $targetFiles The target file(s)
- *
- * @throws FileNotFoundException When original file is missing or not a file
- * @throws IOException When link fails, including if link already exists
- */
- public function hardlink(string $originFile, $targetFiles)
- {
- if (!$this->exists($originFile)) {
- throw new FileNotFoundException(null, 0, null, $originFile);
- }
- if (!is_file($originFile)) {
- throw new FileNotFoundException(sprintf('Origin file "%s" is not a file.', $originFile));
- }
- foreach ($this->toIterable($targetFiles) as $targetFile) {
- if (is_file($targetFile)) {
- if (fileinode($originFile) === fileinode($targetFile)) {
- continue;
- }
- $this->remove($targetFile);
- }
- if (!self::box('link', $originFile, $targetFile)) {
- $this->linkException($originFile, $targetFile, 'hard');
- }
- }
- }
- /**
- * @param string $linkType Name of the link type, typically 'symbolic' or 'hard'
- */
- private function linkException(string $origin, string $target, string $linkType)
- {
- if (self::$lastError) {
- if ('\\' === \DIRECTORY_SEPARATOR && false !== strpos(self::$lastError, 'error code(1314)')) {
- throw new IOException(sprintf('Unable to create "%s" link due to error code 1314: \'A required privilege is not held by the client\'. Do you have the required Administrator-rights?', $linkType), 0, null, $target);
- }
- }
- throw new IOException(sprintf('Failed to create "%s" link from "%s" to "%s".', $linkType, $origin, $target), 0, null, $target);
- }
- /**
- * Resolves links in paths.
- *
- * With $canonicalize = false (default)
- * - if $path does not exist or is not a link, returns null
- * - if $path is a link, returns the next direct target of the link without considering the existence of the target
- *
- * With $canonicalize = true
- * - if $path does not exist, returns null
- * - if $path exists, returns its absolute fully resolved final version
- *
- * @return string|null
- */
- public function readlink(string $path, bool $canonicalize = false)
- {
- if (!$canonicalize && !is_link($path)) {
- return null;
- }
- if ($canonicalize) {
- if (!$this->exists($path)) {
- return null;
- }
- if ('\\' === \DIRECTORY_SEPARATOR) {
- $path = readlink($path);
- }
- return realpath($path);
- }
- if ('\\' === \DIRECTORY_SEPARATOR) {
- return realpath($path);
- }
- return readlink($path);
- }
- /**
- * Given an existing path, convert it to a path relative to a given starting path.
- *
- * @return string Path of target relative to starting path
- */
- public function makePathRelative(string $endPath, string $startPath)
- {
- if (!$this->isAbsolutePath($startPath)) {
- throw new InvalidArgumentException(sprintf('The start path "%s" is not absolute.', $startPath));
- }
- if (!$this->isAbsolutePath($endPath)) {
- throw new InvalidArgumentException(sprintf('The end path "%s" is not absolute.', $endPath));
- }
- // Normalize separators on Windows
- if ('\\' === \DIRECTORY_SEPARATOR) {
- $endPath = str_replace('\\', '/', $endPath);
- $startPath = str_replace('\\', '/', $startPath);
- }
- $splitDriveLetter = function ($path) {
- return (\strlen($path) > 2 && ':' === $path[1] && '/' === $path[2] && ctype_alpha($path[0]))
- ? [substr($path, 2), strtoupper($path[0])]
- : [$path, null];
- };
- $splitPath = function ($path) {
- $result = [];
- foreach (explode('/', trim($path, '/')) as $segment) {
- if ('..' === $segment) {
- array_pop($result);
- } elseif ('.' !== $segment && '' !== $segment) {
- $result[] = $segment;
- }
- }
- return $result;
- };
- [$endPath, $endDriveLetter] = $splitDriveLetter($endPath);
- [$startPath, $startDriveLetter] = $splitDriveLetter($startPath);
- $startPathArr = $splitPath($startPath);
- $endPathArr = $splitPath($endPath);
- if ($endDriveLetter && $startDriveLetter && $endDriveLetter != $startDriveLetter) {
- // End path is on another drive, so no relative path exists
- return $endDriveLetter.':/'.($endPathArr ? implode('/', $endPathArr).'/' : '');
- }
- // Find for which directory the common path stops
- $index = 0;
- while (isset($startPathArr[$index]) && isset($endPathArr[$index]) && $startPathArr[$index] === $endPathArr[$index]) {
- ++$index;
- }
- // Determine how deep the start path is relative to the common path (ie, "web/bundles" = 2 levels)
- if (1 === \count($startPathArr) && '' === $startPathArr[0]) {
- $depth = 0;
- } else {
- $depth = \count($startPathArr) - $index;
- }
- // Repeated "../" for each level need to reach the common path
- $traverser = str_repeat('../', $depth);
- $endPathRemainder = implode('/', \array_slice($endPathArr, $index));
- // Construct $endPath from traversing to the common path, then to the remaining $endPath
- $relativePath = $traverser.('' !== $endPathRemainder ? $endPathRemainder.'/' : '');
- return '' === $relativePath ? './' : $relativePath;
- }
- /**
- * Mirrors a directory to another.
- *
- * Copies files and directories from the origin directory into the target directory. By default:
- *
- * - existing files in the target directory will be overwritten, except if they are newer (see the `override` option)
- * - files in the target directory that do not exist in the source directory will not be deleted (see the `delete` option)
- *
- * @param \Traversable|null $iterator Iterator that filters which files and directories to copy, if null a recursive iterator is created
- * @param array $options An array of boolean options
- * Valid options are:
- * - $options['override'] If true, target files newer than origin files are overwritten (see copy(), defaults to false)
- * - $options['copy_on_windows'] Whether to copy files instead of links on Windows (see symlink(), defaults to false)
- * - $options['delete'] Whether to delete files that are not in the source directory (defaults to false)
- *
- * @throws IOException When file type is unknown
- */
- public function mirror(string $originDir, string $targetDir, \Traversable $iterator = null, array $options = [])
- {
- $targetDir = rtrim($targetDir, '/\\');
- $originDir = rtrim($originDir, '/\\');
- $originDirLen = \strlen($originDir);
- if (!$this->exists($originDir)) {
- throw new IOException(sprintf('The origin directory specified "%s" was not found.', $originDir), 0, null, $originDir);
- }
- // Iterate in destination folder to remove obsolete entries
- if ($this->exists($targetDir) && isset($options['delete']) && $options['delete']) {
- $deleteIterator = $iterator;
- if (null === $deleteIterator) {
- $flags = \FilesystemIterator::SKIP_DOTS;
- $deleteIterator = new \RecursiveIteratorIterator(new \RecursiveDirectoryIterator($targetDir, $flags), \RecursiveIteratorIterator::CHILD_FIRST);
- }
- $targetDirLen = \strlen($targetDir);
- foreach ($deleteIterator as $file) {
- $origin = $originDir.substr($file->getPathname(), $targetDirLen);
- if (!$this->exists($origin)) {
- $this->remove($file);
- }
- }
- }
- $copyOnWindows = $options['copy_on_windows'] ?? false;
- if (null === $iterator) {
- $flags = $copyOnWindows ? \FilesystemIterator::SKIP_DOTS | \FilesystemIterator::FOLLOW_SYMLINKS : \FilesystemIterator::SKIP_DOTS;
- $iterator = new \RecursiveIteratorIterator(new \RecursiveDirectoryIterator($originDir, $flags), \RecursiveIteratorIterator::SELF_FIRST);
- }
- $this->mkdir($targetDir);
- $filesCreatedWhileMirroring = [];
- foreach ($iterator as $file) {
- if ($file->getPathname() === $targetDir || $file->getRealPath() === $targetDir || isset($filesCreatedWhileMirroring[$file->getRealPath()])) {
- continue;
- }
- $target = $targetDir.substr($file->getPathname(), $originDirLen);
- $filesCreatedWhileMirroring[$target] = true;
- if (!$copyOnWindows && is_link($file)) {
- $this->symlink($file->getLinkTarget(), $target);
- } elseif (is_dir($file)) {
- $this->mkdir($target);
- } elseif (is_file($file)) {
- $this->copy($file, $target, $options['override'] ?? false);
- } else {
- throw new IOException(sprintf('Unable to guess "%s" file type.', $file), 0, null, $file);
- }
- }
- }
- /**
- * Returns whether the file path is an absolute path.
- *
- * @return bool
- */
- public function isAbsolutePath(string $file)
- {
- return '' !== $file && (strspn($file, '/\\', 0, 1)
- || (\strlen($file) > 3 && ctype_alpha($file[0])
- && ':' === $file[1]
- && strspn($file, '/\\', 2, 1)
- )
- || null !== parse_url($file, \PHP_URL_SCHEME)
- );
- }
- /**
- * Creates a temporary file with support for custom stream wrappers.
- *
- * @param string $prefix The prefix of the generated temporary filename
- * Note: Windows uses only the first three characters of prefix
- * @param string $suffix The suffix of the generated temporary filename
- *
- * @return string The new temporary filename (with path), or throw an exception on failure
- */
- public function tempnam(string $dir, string $prefix/*, string $suffix = ''*/)
- {
- $suffix = \func_num_args() > 2 ? func_get_arg(2) : '';
- [$scheme, $hierarchy] = $this->getSchemeAndHierarchy($dir);
- // If no scheme or scheme is "file" or "gs" (Google Cloud) create temp file in local filesystem
- if ((null === $scheme || 'file' === $scheme || 'gs' === $scheme) && '' === $suffix) {
- $tmpFile = @tempnam($hierarchy, $prefix);
- // If tempnam failed or no scheme return the filename otherwise prepend the scheme
- if (false !== $tmpFile) {
- if (null !== $scheme && 'gs' !== $scheme) {
- return $scheme.'://'.$tmpFile;
- }
- return $tmpFile;
- }
- throw new IOException('A temporary file could not be created.');
- }
- // Loop until we create a valid temp file or have reached 10 attempts
- for ($i = 0; $i < 10; ++$i) {
- // Create a unique filename
- $tmpFile = $dir.'/'.$prefix.uniqid(mt_rand(), true).$suffix;
- // Use fopen instead of file_exists as some streams do not support stat
- // Use mode 'x+' to atomically check existence and create to avoid a TOCTOU vulnerability
- $handle = @fopen($tmpFile, 'x+');
- // If unsuccessful restart the loop
- if (false === $handle) {
- continue;
- }
- // Close the file if it was successfully opened
- @fclose($handle);
- return $tmpFile;
- }
- throw new IOException('A temporary file could not be created.');
- }
- /**
- * Atomically dumps content into a file.
- *
- * @param string|resource $content The data to write into the file
- *
- * @throws IOException if the file cannot be written to
- */
- public function dumpFile(string $filename, $content)
- {
- if (\is_array($content)) {
- throw new \TypeError(sprintf('Argument 2 passed to "%s()" must be string or resource, array given.', __METHOD__));
- }
- $dir = \dirname($filename);
- if (!is_dir($dir)) {
- $this->mkdir($dir);
- }
- if (!is_writable($dir)) {
- throw new IOException(sprintf('Unable to write to the "%s" directory.', $dir), 0, null, $dir);
- }
- // Will create a temp file with 0600 access rights
- // when the filesystem supports chmod.
- $tmpFile = $this->tempnam($dir, basename($filename));
- try {
- if (false === @file_put_contents($tmpFile, $content)) {
- throw new IOException(sprintf('Failed to write file "%s".', $filename), 0, null, $filename);
- }
- @chmod($tmpFile, file_exists($filename) ? fileperms($filename) : 0666 & ~umask());
- $this->rename($tmpFile, $filename, true);
- } finally {
- if (file_exists($tmpFile)) {
- @unlink($tmpFile);
- }
- }
- }
- /**
- * Appends content to an existing file.
- *
- * @param string|resource $content The content to append
- *
- * @throws IOException If the file is not writable
- */
- public function appendToFile(string $filename, $content)
- {
- if (\is_array($content)) {
- throw new \TypeError(sprintf('Argument 2 passed to "%s()" must be string or resource, array given.', __METHOD__));
- }
- $dir = \dirname($filename);
- if (!is_dir($dir)) {
- $this->mkdir($dir);
- }
- if (!is_writable($dir)) {
- throw new IOException(sprintf('Unable to write to the "%s" directory.', $dir), 0, null, $dir);
- }
- if (false === @file_put_contents($filename, $content, \FILE_APPEND)) {
- throw new IOException(sprintf('Failed to write file "%s".', $filename), 0, null, $filename);
- }
- }
- private function toIterable($files): iterable
- {
- return \is_array($files) || $files instanceof \Traversable ? $files : [$files];
- }
- /**
- * Gets a 2-tuple of scheme (may be null) and hierarchical part of a filename (e.g. file:///tmp -> [file, tmp]).
- */
- private function getSchemeAndHierarchy(string $filename): array
- {
- $components = explode('://', $filename, 2);
- return 2 === \count($components) ? [$components[0], $components[1]] : [null, $components[0]];
- }
- /**
- * @param mixed ...$args
- *
- * @return mixed
- */
- private static function box(callable $func, ...$args)
- {
- self::$lastError = null;
- set_error_handler(__CLASS__.'::handleError');
- try {
- $result = $func(...$args);
- restore_error_handler();
- return $result;
- } catch (\Throwable $e) {
- }
- restore_error_handler();
- throw $e;
- }
- /**
- * @internal
- */
- public static function handleError($type, $msg)
- {
- self::$lastError = $msg;
- }
- }
|