* * For the full copyright and license information, please view the LICENSE * file that was distributed with this source code. */ namespace Symfony\Bundle\FrameworkBundle\Command; use Symfony\Component\Console\Exception\InvalidArgumentException; use Symfony\Component\Console\Input\InputArgument; use Symfony\Component\Console\Input\InputInterface; use Symfony\Component\Console\Input\InputOption; use Symfony\Component\Console\Output\OutputInterface; use Symfony\Component\Console\Style\SymfonyStyle; use Symfony\Component\DependencyInjection\ContainerInterface; use Symfony\Component\Filesystem\Exception\IOException; use Symfony\Component\Filesystem\Filesystem; use Symfony\Component\Finder\Finder; use Symfony\Component\HttpKernel\Bundle\BundleInterface; /** * Command that places bundle web assets into a given directory. * * @author Fabien Potencier * @author Gábor Egyed * * @final since version 3.4 */ class AssetsInstallCommand extends ContainerAwareCommand { const METHOD_COPY = 'copy'; const METHOD_ABSOLUTE_SYMLINK = 'absolute symlink'; const METHOD_RELATIVE_SYMLINK = 'relative symlink'; protected static $defaultName = 'assets:install'; private $filesystem; /** * @param Filesystem $filesystem */ public function __construct($filesystem = null) { if (!$filesystem instanceof Filesystem) { @trigger_error(sprintf('%s() expects an instance of "%s" as first argument since Symfony 3.4. Not passing it is deprecated and will throw a TypeError in 4.0.', __METHOD__, Filesystem::class), \E_USER_DEPRECATED); parent::__construct($filesystem); return; } parent::__construct(); $this->filesystem = $filesystem; } /** * {@inheritdoc} */ protected function configure() { $this ->setDefinition([ new InputArgument('target', InputArgument::OPTIONAL, 'The target directory', null), ]) ->addOption('symlink', null, InputOption::VALUE_NONE, 'Symlinks the assets instead of copying it') ->addOption('relative', null, InputOption::VALUE_NONE, 'Make relative symlinks') ->setDescription('Installs bundles web assets under a public directory') ->setHelp(<<<'EOT' The %command.name% command installs bundle assets into a given directory (e.g. the public directory). php %command.full_name% public A "bundles" directory will be created inside the target directory and the "Resources/public" directory of each bundle will be copied into it. To create a symlink to each bundle instead of copying its assets, use the --symlink option (will fall back to hard copies when symbolic links aren't possible: php %command.full_name% public --symlink To make symlink relative, add the --relative option: php %command.full_name% public --symlink --relative EOT ) ; } /** * {@inheritdoc} */ protected function execute(InputInterface $input, OutputInterface $output) { // BC to be removed in 4.0 if (null === $this->filesystem) { $this->filesystem = $this->getContainer()->get('filesystem'); $baseDir = $this->getContainer()->getParameter('kernel.project_dir'); } $kernel = $this->getApplication()->getKernel(); $targetArg = rtrim($input->getArgument('target'), '/'); if (!$targetArg) { $targetArg = $this->getPublicDirectory($this->getContainer()); } if (!is_dir($targetArg)) { $targetArg = (isset($baseDir) ? $baseDir : $kernel->getContainer()->getParameter('kernel.project_dir')).'/'.$targetArg; if (!is_dir($targetArg)) { // deprecated, logic to be removed in 4.0 // this allows the commands to work out of the box with web/ and public/ if (is_dir(\dirname($targetArg).'/web')) { $targetArg = \dirname($targetArg).'/web'; } else { throw new InvalidArgumentException(sprintf('The target directory "%s" does not exist.', $targetArg)); } } } $bundlesDir = $targetArg.'/bundles/'; $io = new SymfonyStyle($input, $output); $io->newLine(); if ($input->getOption('relative')) { $expectedMethod = self::METHOD_RELATIVE_SYMLINK; $io->text('Trying to install assets as relative symbolic links.'); } elseif ($input->getOption('symlink')) { $expectedMethod = self::METHOD_ABSOLUTE_SYMLINK; $io->text('Trying to install assets as absolute symbolic links.'); } else { $expectedMethod = self::METHOD_COPY; $io->text('Installing assets as hard copies.'); } $io->newLine(); $rows = []; $copyUsed = false; $exitCode = 0; $validAssetDirs = []; /** @var BundleInterface $bundle */ foreach ($kernel->getBundles() as $bundle) { if (!is_dir($originDir = $bundle->getPath().'/Resources/public')) { continue; } $assetDir = preg_replace('/bundle$/', '', strtolower($bundle->getName())); $targetDir = $bundlesDir.$assetDir; $validAssetDirs[] = $assetDir; if (OutputInterface::VERBOSITY_VERBOSE <= $output->getVerbosity()) { $message = sprintf("%s\n-> %s", $bundle->getName(), $targetDir); } else { $message = $bundle->getName(); } try { $this->filesystem->remove($targetDir); if (self::METHOD_RELATIVE_SYMLINK === $expectedMethod) { $method = $this->relativeSymlinkWithFallback($originDir, $targetDir); } elseif (self::METHOD_ABSOLUTE_SYMLINK === $expectedMethod) { $method = $this->absoluteSymlinkWithFallback($originDir, $targetDir); } else { $method = $this->hardCopy($originDir, $targetDir); } if (self::METHOD_COPY === $method) { $copyUsed = true; } if ($method === $expectedMethod) { $rows[] = [sprintf('%s', '\\' === \DIRECTORY_SEPARATOR ? 'OK' : "\xE2\x9C\x94" /* HEAVY CHECK MARK (U+2714) */), $message, $method]; } else { $rows[] = [sprintf('%s', '\\' === \DIRECTORY_SEPARATOR ? 'WARNING' : '!'), $message, $method]; } } catch (\Exception $e) { $exitCode = 1; $rows[] = [sprintf('%s', '\\' === \DIRECTORY_SEPARATOR ? 'ERROR' : "\xE2\x9C\x98" /* HEAVY BALLOT X (U+2718) */), $message, $e->getMessage()]; } } // remove the assets of the bundles that no longer exist if (is_dir($bundlesDir)) { $dirsToRemove = Finder::create()->depth(0)->directories()->exclude($validAssetDirs)->in($bundlesDir); $this->filesystem->remove($dirsToRemove); } if ($rows) { $io->table(['', 'Bundle', 'Method / Error'], $rows); } if (0 !== $exitCode) { $io->error('Some errors occurred while installing assets.'); } else { if ($copyUsed) { $io->note('Some assets were installed via copy. If you make changes to these assets you have to run this command again.'); } $io->success($rows ? 'All assets were successfully installed.' : 'No assets were provided by any bundle.'); } return $exitCode; } /** * Try to create relative symlink. * * Falling back to absolute symlink and finally hard copy. * * @param string $originDir * @param string $targetDir * * @return string */ private function relativeSymlinkWithFallback($originDir, $targetDir) { try { $this->symlink($originDir, $targetDir, true); $method = self::METHOD_RELATIVE_SYMLINK; } catch (IOException $e) { $method = $this->absoluteSymlinkWithFallback($originDir, $targetDir); } return $method; } /** * Try to create absolute symlink. * * Falling back to hard copy. * * @param string $originDir * @param string $targetDir * * @return string */ private function absoluteSymlinkWithFallback($originDir, $targetDir) { try { $this->symlink($originDir, $targetDir); $method = self::METHOD_ABSOLUTE_SYMLINK; } catch (IOException $e) { // fall back to copy $method = $this->hardCopy($originDir, $targetDir); } return $method; } /** * Creates symbolic link. * * @param string $originDir * @param string $targetDir * @param bool $relative * * @throws IOException if link can not be created */ private function symlink($originDir, $targetDir, $relative = false) { if ($relative) { $this->filesystem->mkdir(\dirname($targetDir)); $originDir = $this->filesystem->makePathRelative($originDir, realpath(\dirname($targetDir))); } $this->filesystem->symlink($originDir, $targetDir); if (!file_exists($targetDir)) { throw new IOException(sprintf('Symbolic link "%s" was created but appears to be broken.', $targetDir), 0, null, $targetDir); } } /** * Copies origin to target. * * @param string $originDir * @param string $targetDir * * @return string */ private function hardCopy($originDir, $targetDir) { $this->filesystem->mkdir($targetDir, 0777); // We use a custom iterator to ignore VCS files $this->filesystem->mirror($originDir, $targetDir, Finder::create()->ignoreDotFiles(false)->in($originDir)); return self::METHOD_COPY; } private function getPublicDirectory(ContainerInterface $container) { $defaultPublicDir = 'public'; if (!$container->hasParameter('kernel.project_dir')) { return $defaultPublicDir; } $composerFilePath = $container->getParameter('kernel.project_dir').'/composer.json'; if (!file_exists($composerFilePath)) { return $defaultPublicDir; } $composerConfig = json_decode(file_get_contents($composerFilePath), true); if (isset($composerConfig['extra']['public-dir'])) { return $composerConfig['extra']['public-dir']; } return $defaultPublicDir; } }