composer · BrianHenryIE · May 2, 2025 · May 2, 2025 · May 2, 2025 · May 2, 2025
diff --git a/src/Composer/Autoload/AutoloadGenerator.php b/src/Composer/Autoload/AutoloadGenerator.php
@@ -211,18 +211,15 @@ public function dump(Config $config, InstalledRepositoryInterface $localRepo, Ro
 
         $filesystem = new Filesystem();
         $filesystem->ensureDirectoryExists($config->get('vendor-dir'));
-        // Do not remove double realpath() calls.
-        // Fixes failing Windows realpath() implementation.
-        // See https://bugs.php.net/bug.php?id=72738
-        $basePath = $filesystem->normalizePath(realpath(realpath(Platform::getCwd())));
-        $vendorPath = $filesystem->normalizePath(realpath(realpath($config->get('vendor-dir'))));
+        $basePath = $filesystem->normalizePath(Platform::realpath(Platform::getCwd()));
+        $vendorPath = $filesystem->normalizePath(Platform::realpath($config->get('vendor-dir')));
         $useGlobalIncludePath = $config->get('use-include-path');
         $prependAutoloader = $config->get('prepend-autoloader') === false ? 'false' : 'true';
         $targetDir = $vendorPath.'/'.$targetDir;
         $filesystem->ensureDirectoryExists($targetDir);
 
-        $vendorPathCode = $filesystem->findShortestPathCode(realpath($targetDir), $vendorPath, true);
-        $vendorPathToTargetDirCode = $filesystem->findShortestPathCode($vendorPath, realpath($targetDir), true);
+        $vendorPathCode = $filesystem->findShortestPathCode(Platform::realpath($targetDir), $vendorPath, true);
+        $vendorPathToTargetDirCode = $filesystem->findShortestPathCode($vendorPath, Platform::realpath($targetDir), true);
 
         $appBaseDirCode = $filesystem->findShortestPathCode($vendorPath, $basePath, true);
         $appBaseDirCode = str_replace('__DIR__', '$vendorDir', $appBaseDirCode);
@@ -493,7 +490,7 @@ private function buildExclusionRegex(string $dir, array $excluded): ?string
         // if $dir does not exist, it should anyway not find anything there so no trouble
         if (file_exists($dir)) {
             // transform $dir in the same way that exclude-from-classmap patterns are transformed so we can match them against each other
-            $dirMatch = preg_quote(strtr(realpath($dir), '\\', '/'));
+            $dirMatch = preg_quote(strtr(Platform::realpath($dir), '\\', '/'));
             foreach ($excluded as $index => $pattern) {
                 // extract the constant string prefix of the pattern here, until we reach a non-escaped regex special character
                 $pattern = Preg::replace('{^(([^.+*?\[^\]$(){}=!<>|:\\\\#-]+|\\\\[.+*?\[^\]$(){}=!<>|:#-])*).*}', '$1', $pattern);
@@ -1165,10 +1162,10 @@ class ComposerStaticInit$suffix
 
         $filesystem = new Filesystem();
 
-        $vendorPathCode = ' => ' . $filesystem->findShortestPathCode(realpath($targetDir), $vendorPath, true, true) . " . '/";
-        $vendorPharPathCode = ' => \'phar://\' . ' . $filesystem->findShortestPathCode(realpath($targetDir), $vendorPath, true, true) . " . '/";
-        $appBaseDirCode = ' => ' . $filesystem->findShortestPathCode(realpath($targetDir), $basePath, true, true) . " . '/";
-        $appBaseDirPharCode = ' => \'phar://\' . ' . $filesystem->findShortestPathCode(realpath($targetDir), $basePath, true, true) . " . '/";
+        $vendorPathCode = ' => ' . $filesystem->findShortestPathCode(Platform::realpath($targetDir), $vendorPath, true, true) . " . '/";
+        $vendorPharPathCode = ' => \'phar://\' . ' . $filesystem->findShortestPathCode(Platform::realpath($targetDir), $vendorPath, true, true) . " . '/";
+        $appBaseDirCode = ' => ' . $filesystem->findShortestPathCode(Platform::realpath($targetDir), $basePath, true, true) . " . '/";
+        $appBaseDirPharCode = ' => \'phar://\' . ' . $filesystem->findShortestPathCode(Platform::realpath($targetDir), $basePath, true, true) . " . '/";
 
         $absoluteVendorPathCode = ' => ' . substr(var_export(rtrim($vendorDir, '\\/') . '/', true), 0, -1);
         $absoluteVendorPharPathCode = ' => ' . substr(var_export(rtrim('phar://' . $vendorDir, '\\/') . '/', true), 0, -1);
@@ -1291,10 +1288,12 @@ static function ($matches) use (&$updir): string {
                             $installPath = strtr(Platform::getCwd(), '\\', '/');
                         }
 
-                        $resolvedPath = realpath($installPath . '/' . $updir);
-                        if (false === $resolvedPath) {
+                        try {
+                            $resolvedPath = Platform::realpath($installPath . '/' . $updir);
+                        } catch (\RuntimeException $e) {
                             continue;
                         }
+
                         $autoloads[] = preg_quote(strtr($resolvedPath, '\\', '/')) . '/' . $path . '($|/)';
                         continue;
                     }

diff --git a/src/Composer/Command/ClearCacheCommand.php b/src/Composer/Command/ClearCacheCommand.php
@@ -14,6 +14,7 @@
 
 use Composer\Cache;
 use Composer\Factory;
+use Composer\Util\Platform;
 use Symfony\Component\Console\Input\InputInterface;
 use Symfony\Component\Console\Input\InputOption;
 use Symfony\Component\Console\Output\OutputInterface;
@@ -67,8 +68,9 @@ protected function execute(InputInterface $input, OutputInterface $output): int
                 continue;
             }
 
-            $cachePath = realpath($cachePath);
-            if (!$cachePath) {
+            try {
+                $cachePath = Platform::realpath($cachePath);
+            } catch (\RuntimeException $e) {
                 $io->writeError("<info>Cache directory does not exist ($key): $cachePath</info>");
 
                 continue;

diff --git a/src/Composer/Command/ConfigCommand.php b/src/Composer/Command/ConfigCommand.php
@@ -189,7 +189,7 @@ protected function initialize(InputInterface $input, OutputInterface $output): v
         if (
             ($configFile === 'composer.json' || $configFile === './composer.json')
             && !file_exists($configFile)
-            && realpath(Platform::getCwd()) === realpath($this->config->get('home'))
+            && Platform::realpath(Platform::getCwd()) === Platform::realpath($this->config->get('home'))
         ) {
             file_put_contents($configFile, "{\n}\n");
         }

diff --git a/src/Composer/Command/CreateProjectCommand.php b/src/Composer/Command/CreateProjectCommand.php
@@ -432,13 +432,15 @@ protected function installRootPackage(InputInterface $input, IOInterface $io, Co
 
         // handler Ctrl+C aborts gracefully
         @mkdir($directory, 0777, true);
-        if (false !== ($realDir = realpath($directory))) {
+        try {
+            $realDir = Platform::realpath($directory);
             $signalHandler = SignalHandler::create([SignalHandler::SIGINT, SignalHandler::SIGTERM, SignalHandler::SIGHUP], function (string $signal, SignalHandler $handler) use ($realDir) {
                 $this->getIO()->writeError('Received '.$signal.', aborting', true, IOInterface::DEBUG);
                 $fs = new Filesystem();
                 $fs->removeDirectory($realDir);
                 $handler->exitWithLastSignal();
             });
+        } catch (\RuntimeException $exception) {
         }
 
         // avoid displaying 9999999-dev as version if default-branch was selected

diff --git a/src/Composer/Command/InitCommand.php b/src/Composer/Command/InitCommand.php
@@ -23,6 +23,7 @@
 use Composer\Repository\RepositoryFactory;
 use Composer\Spdx\SpdxLicenses;
 use Composer\Util\Filesystem;
+use Composer\Util\Platform;
 use Composer\Util\Silencer;
 use Symfony\Component\Console\Input\ArrayInput;
 use Symfony\Component\Console\Input\InputInterface;
@@ -181,10 +182,10 @@ protected function execute(InputInterface $input, OutputInterface $output): int
         }
 
         if ($input->isInteractive() && is_dir('.git')) {
-            $ignoreFile = realpath('.gitignore');
-
-            if (false === $ignoreFile) {
-                $ignoreFile = realpath('.') . '/.gitignore';
+            try {
+                $ignoreFile = Platform::realpath('.gitignore');
+            } catch (\RuntimeException $exception) {
+                $ignoreFile = Platform::realpath('.') . '/.gitignore';
             }
 
             if (!$this->hasVendorIgnore($ignoreFile)) {
@@ -269,10 +270,9 @@ protected function interact(InputInterface $input, OutputInterface $output)
             '',
         ]);
 
-        $cwd = realpath(".");
-
         $name = $input->getOption('name');
         if (null === $name) {
+            $cwd = Platform::realpath(".");
             $name = basename($cwd);
             $name = $this->sanitizePackageNameComponent($name);
 

diff --git a/src/Composer/Command/ShowCommand.php b/src/Composer/Command/ShowCommand.php
@@ -43,6 +43,7 @@
 use Composer\Semver\Semver;
 use Composer\Spdx\SpdxLicenses;
 use Composer\Util\PackageInfo;
+use Composer\Util\Platform;
 use DateTimeInterface;
 use Symfony\Component\Console\Completion\CompletionInput;
 use Symfony\Component\Console\Formatter\OutputFormatter;
@@ -359,7 +360,7 @@ protected function execute(InputInterface $input, OutputInterface $output): int
                 $io->write($package->getName(), false);
                 $path = $composer->getInstallationManager()->getInstallPath($package);
                 if (is_string($path)) {
-                    $io->write(' ' . strtok(realpath($path), "\r\n"));
+                    $io->write(' ' . strtok(Platform::realpath($path), "\r\n"));
                 } else {
                     $io->write(' null');
                 }
@@ -581,7 +582,7 @@ protected function execute(InputInterface $input, OutputInterface $output): int
                         if ($writePath) {
                             $path = $composer->getInstallationManager()->getInstallPath($package);
                             if (is_string($path)) {
-                                $packageViewData['path'] = strtok(realpath($path), "\r\n");
+                                $packageViewData['path'] = strtok(Platform::realpath($path), "\r\n");
                             } else {
                                 $packageViewData['path'] = null;
                             }
@@ -903,7 +904,11 @@ protected function printMeta(CompletePackageInterface $package, array $versions,
         if ($isInstalledPackage) {
             $path = $this->requireComposer()->getInstallationManager()->getInstallPath($package);
             if (is_string($path)) {
-                $io->write('<info>path</info>     : ' . realpath($path));
+                try {
+                    $io->write('<info>path</info>     : ' . Platform::realpath($path));
+                } catch (\RuntimeException $exception) {
+                    $io->write('<info>path</info>     : ');
+                }
             } else {
                 $io->write('<info>path</info>     : null');
             }
@@ -1063,13 +1068,12 @@ protected function printPackageInfoAsJson(CompletePackageInterface $package, arr
 
         if (!PlatformRepository::isPlatformPackage($package->getName()) && $installedRepo->hasPackage($package)) {
             $path = $this->requireComposer()->getInstallationManager()->getInstallPath($package);
+            $json['path'] = null;
             if (is_string($path)) {
-                $path = realpath($path);
-                if ($path !== false) {
-                    $json['path'] = $path;
+                try {
+                    $json['path'] = Platform::realpath($path);
+                } catch (\RuntimeException $exception) {
                 }
-            } else {
-                $json['path'] = null;
             }
 
             if ($package->getReleaseDate() !== null) {

diff --git a/src/Composer/Compiler.php b/src/Composer/Compiler.php
@@ -15,6 +15,7 @@
 use Composer\Json\JsonFile;
 use Composer\CaBundle\CaBundle;
 use Composer\Pcre\Preg;
+use Composer\Util\Platform;
 use Composer\Util\ProcessExecutor;
 use Symfony\Component\Finder\Finder;
 use Symfony\Component\Process\Process;
@@ -142,8 +143,9 @@ public function compile(string $pharFile = 'composer.phar'): void
             __DIR__ . '/../../vendor/symfony/console/Resources/bin/hiddeninput.exe',
             __DIR__ . '/../../vendor/symfony/console/Resources/completion.bash',
         ] as $file) {
-            $extraFiles[$file] = realpath($file);
-            if (!file_exists($file)) {
+            try {
+                $extraFiles[$file] = Platform::realpath($file);
+            } catch (\RuntimeException $e) {
                 throw new \RuntimeException('Extra file listed is missing from the filesystem: '.$file);
             }
         }

diff --git a/src/Composer/Console/Application.php b/src/Composer/Console/Application.php
@@ -199,7 +199,7 @@ public function doRun(InputInterface $input, OutputInterface $output): int
             && $input->hasParameterOption('-h', true) === false
         ) {
             $dir = dirname(Platform::getCwd(true));
-            $home = realpath(Platform::getEnv('HOME') ?: Platform::getEnv('USERPROFILE') ?: '/');
+            $home = Platform::realpath(Platform::getEnv('HOME') ?: Platform::getEnv('USERPROFILE') ?: '/');
 
             // abort when we reach the home dir or top of the filesystem
             while (dirname($dir) !== $dir && $dir !== $home) {
@@ -288,7 +288,7 @@ public function doRun(InputInterface $input, OutputInterface $output): int
             } catch (ParsingException $e) {
                 $details = $e->getDetails();
 
-                $file = realpath(Factory::getComposerFile());
+                $file = Platform::realpath(Factory::getComposerFile());
 
                 $line = null;
                 if ($details && isset($details['line'])) {

diff --git a/src/Composer/Downloader/ArchiveDownloader.php b/src/Composer/Downloader/ArchiveDownloader.php
@@ -74,7 +74,7 @@ public function install(PackageInterface $package, string $path, bool $output =
         $this->addCleanupPath($package, $temporaryDir);
         // avoid cleaning up $path if installing in "." for eg create-project as we can not
         // delete the directory we are currently in on windows
-        if (!is_dir($path) || realpath($path) !== Platform::getCwd()) {
+        if (!is_dir($path) || Platform::realpath($path) !== Platform::getCwd()) {
             $this->addCleanupPath($package, $path);
         }
 
@@ -89,14 +89,12 @@ public function install(PackageInterface $package, string $path, bool $output =
 
             // clean up
             $filesystem->removeDirectory($temporaryDir);
-            if (is_dir($path) && realpath($path) !== Platform::getCwd()) {
+            if (is_dir($path) && Platform::realpath($path) !== Platform::getCwd()) {
                 $filesystem->removeDirectory($path);
             }
             $this->removeCleanupPath($package, $temporaryDir);
-            $realpath = realpath($path);
-            if ($realpath !== false) {
-                $this->removeCleanupPath($package, $realpath);
-            }
+            $realpath = Platform::realpath($path);
+            $this->removeCleanupPath($package, $realpath);
         };
 
         try {

diff --git a/src/Composer/Downloader/FileDownloader.php b/src/Composer/Downloader/FileDownloader.php
@@ -333,7 +333,7 @@ public function cleanup(string $type, PackageInterface $package, string $path, ?
         }
 
         foreach ($dirsToCleanUp as $dir) {
-            if (is_dir($dir) && $this->filesystem->isDirEmpty($dir) && realpath($dir) !== Platform::getCwd()) {
+            if (is_dir($dir) && $this->filesystem->isDirEmpty($dir) && Platform::realpath($dir) !== Platform::getCwd()) {
                 $this->filesystem->removeDirectoryPhp($dir);
             }
         }

diff --git a/src/Composer/Downloader/GitDownloader.php b/src/Composer/Downloader/GitDownloader.php
@@ -607,7 +607,7 @@ protected function normalizePath(string $path): string
                 return $path;
             }
 
-            $path = rtrim(realpath($basePath) . '/' . implode('/', $removed), '/');
+            $path = rtrim(Platform::realpath($basePath) . '/' . implode('/', $removed), '/');
         }
 
         return $path;

diff --git a/src/Composer/Downloader/HgDownloader.php b/src/Composer/Downloader/HgDownloader.php
@@ -12,6 +12,7 @@
 
 namespace Composer\Downloader;
 
+use Composer\Util\Platform;
 use React\Promise\PromiseInterface;
 use Composer\Package\PackageInterface;
 use Composer\Util\ProcessExecutor;
@@ -48,7 +49,7 @@ protected function doInstall(PackageInterface $package, string $path, string $ur
         $hgUtils->runCommand($cloneCommand, $url, $path);
 
         $command = ['hg', 'up', '--', (string) $package->getSourceReference()];
-        if (0 !== $this->process->execute($command, $ignoredOutput, realpath($path))) {
+        if (0 !== $this->process->execute($command, $ignoredOutput, Platform::realpath($path))) {
             throw new \RuntimeException('Failed to execute ' . implode(' ', $command) . "\n\n" . $this->process->getErrorOutput());
         }
 
@@ -91,7 +92,7 @@ public function getLocalChanges(PackageInterface $package, string $path): ?strin
             return null;
         }
 
-        $this->process->execute(['hg', 'st'], $output, realpath($path));
+        $this->process->execute(['hg', 'st'], $output, Platform::realpath($path));
 
         $output = trim($output);
 
@@ -105,7 +106,7 @@ protected function getCommitLogs(string $fromReference, string $toReference, str
     {
         $command = ['hg', 'log', '-r', $fromReference.':'.$toReference, '--style', 'compact'];
 
-        if (0 !== $this->process->execute($command, $output, realpath($path))) {
+        if (0 !== $this->process->execute($command, $output, Platform::realpath($path))) {
             throw new \RuntimeException('Failed to execute ' . implode(' ', $command) . "\n\n" . $this->process->getErrorOutput());
         }
 

diff --git a/src/Composer/Downloader/PathDownloader.php b/src/Composer/Downloader/PathDownloader.php
@@ -46,28 +46,30 @@ public function download(PackageInterface $package, string $path, ?PackageInterf
         if (null === $url) {
             throw new \RuntimeException('The package '.$package->getPrettyName().' has no dist url configured, cannot download.');
         }
-        $realUrl = realpath($url);
-        if (false === $realUrl || !file_exists($realUrl) || !is_dir($realUrl)) {
+        try {
+            $realUrl = Platform::realpath($url);
+        } catch (\RuntimeException $exception) {
             throw new \RuntimeException(sprintf(
                 'Source path "%s" is not found for package %s',
                 $url,
                 $package->getName()
             ));
         }
 
-        if (realpath($path) === $realUrl) {
+        $realPath = Platform::realpath($path);
+        if ($realPath === $realUrl) {
             return \React\Promise\resolve(null);
         }
 
-        if (strpos(realpath($path) . DIRECTORY_SEPARATOR, $realUrl . DIRECTORY_SEPARATOR) === 0) {
+        if (strpos($realPath . DIRECTORY_SEPARATOR, $realUrl . DIRECTORY_SEPARATOR) === 0) {
             // IMPORTANT NOTICE: If you wish to change this, don't. You are wasting your time and ours.
             //
             // Please see https://github.com/composer/composer/pull/5974 and https://github.com/composer/composer/pull/6174
             // for previous attempts that were shut down because they did not work well enough or introduced too many risks.
             throw new \RuntimeException(sprintf(
                 'Package %s cannot install to "%s" inside its source at "%s"',
                 $package->getName(),
-                realpath($path),
+                $realPath,
                 $realUrl
             ));
         }
@@ -85,12 +87,9 @@ public function install(PackageInterface $package, string $path, bool $output =
         if (null === $url) {
             throw new \RuntimeException('The package '.$package->getPrettyName().' has no dist url configured, cannot install.');
         }
-        $realUrl = realpath($url);
-        if (false === $realUrl) {
-            throw new \RuntimeException('Failed to realpath '.$url);
-        }
+        $realUrl = Platform::realpath($url);
 
-        if (realpath($path) === $realUrl) {
+        if (Platform::realpath($path) === $realUrl) {
             if ($output) {
                 $this->io->writeError("  - " . InstallOperation::format($package) . $this->getInstallOperationAppendix($package, $path));
             }
@@ -245,12 +244,9 @@ protected function getInstallOperationAppendix(PackageInterface $package, string
         if (null === $url) {
             throw new \RuntimeException('The package '.$package->getPrettyName().' has no dist url configured, cannot install.');
         }
-        $realUrl = realpath($url);
-        if (false === $realUrl) {
-            throw new \RuntimeException('Failed to realpath '.$url);
-        }
+        $realUrl = Platform::realpath($url);
 
-        if (realpath($path) === $realUrl) {
+        if (Platform::realpath($path) === $realUrl) {
             return ': Source already present';
         }