123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133 |
- <?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;
- /**
- * SlotsHelper manages template slots.
- *
- * @author Fabien Potencier <fabien@symfony.com>
- */
- class SlotsHelper extends Helper
- {
- protected $slots = array();
- protected $openSlots = array();
- /**
- * Starts a new slot.
- *
- * This method starts an output buffer that will be
- * closed when the stop() method is called.
- *
- * @param string $name The slot name
- *
- * @throws \InvalidArgumentException if a slot with the same name is already started
- */
- public function start($name)
- {
- if (in_array($name, $this->openSlots)) {
- throw new \InvalidArgumentException(sprintf('A slot named "%s" is already started.', $name));
- }
- $this->openSlots[] = $name;
- $this->slots[$name] = '';
- ob_start();
- ob_implicit_flush(0);
- }
- /**
- * Stops a slot.
- *
- * @throws \LogicException if no slot has been started
- */
- public function stop()
- {
- if (!$this->openSlots) {
- throw new \LogicException('No slot started.');
- }
- $name = array_pop($this->openSlots);
- $this->slots[$name] = ob_get_clean();
- }
- /**
- * Returns true if the slot exists.
- *
- * @param string $name The slot name
- *
- * @return bool
- */
- public function has($name)
- {
- return isset($this->slots[$name]);
- }
- /**
- * Gets the slot value.
- *
- * @param string $name The slot name
- * @param bool|string $default The default slot content
- *
- * @return string The slot content
- */
- public function get($name, $default = false)
- {
- return isset($this->slots[$name]) ? $this->slots[$name] : $default;
- }
- /**
- * Sets a slot value.
- *
- * @param string $name The slot name
- * @param string $content The slot content
- */
- public function set($name, $content)
- {
- $this->slots[$name] = $content;
- }
- /**
- * Outputs a slot.
- *
- * @param string $name The slot name
- * @param bool|string $default The default slot content
- *
- * @return bool true if the slot is defined or if a default content has been provided, false otherwise
- */
- public function output($name, $default = false)
- {
- if (!isset($this->slots[$name])) {
- if (false !== $default) {
- echo $default;
- return true;
- }
- return false;
- }
- echo $this->slots[$name];
- return true;
- }
- /**
- * Returns the canonical name of this helper.
- *
- * @return string The canonical name
- */
- public function getName()
- {
- return 'slots';
- }
- }
|