%PDF- %PDF-
Direktori : /opt/alt/php54/usr/share/pear/Symfony/Component/Templating/Helper/ |
Current File : //opt/alt/php54/usr/share/pear/Symfony/Component/Templating/Helper/CoreAssetsHelper.php |
<?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\Templating\Helper; use Symfony\Component\Templating\Asset\PackageInterface; /** * CoreAssetsHelper helps manage asset URLs. * * Usage: * * <code> * <img src="<?php echo $view['assets']->getUrl('foo.png') ?>" /> * </code> * * @author Fabien Potencier <fabien@symfony.com> * @author Kris Wallsmith <kris@symfony.com> */ class CoreAssetsHelper extends Helper implements PackageInterface { protected $defaultPackage; protected $namedPackages = array(); /** * Constructor. * * @param PackageInterface $defaultPackage The default package * @param array $namedPackages Additional packages indexed by name */ public function __construct(PackageInterface $defaultPackage, array $namedPackages = array()) { $this->defaultPackage = $defaultPackage; foreach ($namedPackages as $name => $package) { $this->addPackage($name, $package); } } /** * Sets the default package. * * @param PackageInterface $defaultPackage The default package */ public function setDefaultPackage(PackageInterface $defaultPackage) { $this->defaultPackage = $defaultPackage; } /** * Adds an asset package to the helper. * * @param string $name The package name * @param PackageInterface $package The package */ public function addPackage($name, PackageInterface $package) { $this->namedPackages[$name] = $package; } /** * Returns an asset package. * * @param string $name The name of the package or null for the default package * * @return PackageInterface An asset package * * @throws \InvalidArgumentException If there is no package by that name */ public function getPackage($name = null) { if (null === $name) { return $this->defaultPackage; } if (!isset($this->namedPackages[$name])) { throw new \InvalidArgumentException(sprintf('There is no "%s" asset package.', $name)); } return $this->namedPackages[$name]; } /** * Gets the version to add to public URL. * * @param string $packageName A package name * * @return string The current version */ public function getVersion($packageName = null) { return $this->getPackage($packageName)->getVersion(); } /** * Returns the public path. * * Absolute paths (i.e. http://...) are returned unmodified. * * @param string $path A public path * @param string $packageName The name of the asset package to use * * @return string A public path which takes into account the base path and URL path */ public function getUrl($path, $packageName = null) { return $this->getPackage($packageName)->getUrl($path); } /** * Returns the canonical name of this helper. * * @return string The canonical name */ public function getName() { return 'assets'; } }