*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace Symfony\Tests\Component\OutputEscaper;
use Symfony\Component\OutputEscaper\Escaper;
use Symfony\Component\OutputEscaper\SafeDecorator;
use Symfony\Component\OutputEscaper\IteratorDecorator;
use Symfony\Component\OutputEscaper\ArrayDecorator;
use Symfony\Component\OutputEscaper\ObjectDecorator;
class EscaperTest extends \PHPUnit_Framework_TestCase
{
public function testEscapeDoesNotEscapeSpecialValues()
{
$this->assertNull(Escaper::escape('entities', null), '::escape() returns null if the value to escape is null');
$this->assertFalse(Escaper::escape('entities', false), '::escape() returns false if the value to escape is false');
$this->assertTrue(Escaper::escape('entities', true), '::escape() returns true if the value to escape is true');
}
public function testEscapeDoesNotEscapeAValueWhenEscapingMethodIsRAW()
{
$this->assertEquals('escaped!', Escaper::escape('raw', 'escaped!'), '::escape() takes an escaping strategy function name as its first argument');
}
public function testEscapeEscapesStrings()
{
$this->assertEquals('<strong>escaped!</strong>', Escaper::escape('entities', 'escaped!'), '::escape() returns an escaped string if the value to escape is a string');
$this->assertEquals('<strong>échappé</strong>', Escaper::escape('entities', 'échappé'), '::escape() returns an escaped string if the value to escape is a string');
}
public function testEscapeEscapesArrays()
{
$input = array(
'foo' => 'escaped!',
'bar' => array('foo' => 'escaped!'),
);
$output = Escaper::escape('entities', $input);
$this->assertInstanceOf('Symfony\Component\OutputEscaper\ArrayDecorator', $output, '::escape() returns a ArrayDecorator object if the value to escape is an array');
$this->assertEquals('<strong>escaped!</strong>', $output['foo'], '::escape() escapes all elements of the original array');
$this->assertEquals('<strong>escaped!</strong>', $output['bar']['foo'], '::escape() is recursive');
$this->assertEquals($input, $output->getRawValue(), '->getRawValue() returns the unescaped value');
}
public function testEscapeEscapesObjects()
{
$input = new OutputEscaperTestClass();
$output = Escaper::escape('entities', $input);
$this->assertInstanceOf('Symfony\Component\OutputEscaper\ObjectDecorator', $output, '::escape() returns a ObjectDecorator object if the value to escape is an object');
$this->assertEquals('<strong>escaped!</strong>', $output->getTitle(), '::escape() escapes all methods of the original object');
$this->assertEquals('<strong>escaped!</strong>', $output->title, '::escape() escapes all properties of the original object');
$this->assertEquals('<strong>escaped!</strong>', $output->getTitleTitle(), '::escape() is recursive');
$this->assertEquals($input, $output->getRawValue(), '->getRawValue() returns the unescaped value');
$this->assertEquals('<strong>escaped!</strong>', Escaper::escape('entities', $output)->getTitle(), '::escape() does not double escape an object');
$this->assertInstanceOf('Symfony\Component\OutputEscaper\IteratorDecorator', Escaper::escape('entities', new \DirectoryIterator('.')), '::escape() returns a IteratorDecorator object if the value to escape is an object that implements the ArrayAccess interface');
}
public function testEscapeDoesNotEscapeObjectMarkedAsBeingSafe()
{
$this->assertInstanceOf('Symfony\Tests\Component\OutputEscaper\OutputEscaperTestClass', Escaper::escape('entities', new SafeDecorator(new OutputEscaperTestClass())), '::escape() returns the original value if it is marked as being safe');
Escaper::markClassAsSafe('Symfony\Tests\Component\OutputEscaper\OutputEscaperTestClass');
$this->assertInstanceOf('Symfony\Tests\Component\OutputEscaper\OutputEscaperTestClass', Escaper::escape('entities', new OutputEscaperTestClass()), '::escape() returns the original value if the object class is marked as being safe');
$this->assertInstanceOf('Symfony\Tests\Component\OutputEscaper\OutputEscaperTestClass', Escaper::escape('entities', new OutputEscaperTestClassChild()), '::escape() returns the original value if one of the object parent class is marked as being safe');
}
public function testEscapeCannotEscapeResources()
{
$fh = fopen(__FILE__, 'r');
try {
Escaper::escape('entities', $fh);
$this->fail('::escape() throws an InvalidArgumentException if the value cannot be escaped');
} catch (\InvalidArgumentException $e) {
}
fclose($fh);
}
public function testUnescapeDoesNotUnescapeSpecialValues()
{
$this->assertNull(Escaper::unescape(null), '::unescape() returns null if the value to unescape is null');
$this->assertFalse(Escaper::unescape(false), '::unescape() returns false if the value to unescape is false');
$this->assertTrue(Escaper::unescape(true), '::unescape() returns true if the value to unescape is true');
}
public function testUnescapeUnescapesStrings()
{
$this->assertEquals('escaped!', Escaper::unescape('<strong>escaped!</strong>'), '::unescape() returns an unescaped string if the value to unescape is a string');
$this->assertEquals('échappé', Escaper::unescape('<strong>échappé</strong>'), '::unescape() returns an unescaped string if the value to unescape is a string');
}
public function testUnescapeUnescapesArrays()
{
$input = Escaper::escape('entities', array(
'foo' => 'escaped!',
'bar' => array('foo' => 'escaped!'),
));
$output = Escaper::unescape($input);
$this->assertType('array', $output, '::unescape() returns an array if the input is a ArrayDecorator object');
$this->assertEquals('escaped!', $output['foo'], '::unescape() unescapes all elements of the original array');
$this->assertEquals('escaped!', $output['bar']['foo'], '::unescape() is recursive');
}
public function testUnescapeUnescapesObjects()
{
$object = new OutputEscaperTestClass();
$input = Escaper::escape('entities', $object);
$output = Escaper::unescape($input);
$this->assertInstanceOf('Symfony\Tests\Component\OutputEscaper\OutputEscaperTestClass', $output, '::unescape() returns the original object when a ObjectDecorator object is passed');
$this->assertEquals('escaped!', $output->getTitle(), '::unescape() unescapes all methods of the original object');
$this->assertEquals('escaped!', $output->title, '::unescape() unescapes all properties of the original object');
$this->assertEquals('escaped!', $output->getTitleTitle(), '::unescape() is recursive');
$this->assertInstanceOf('\DirectoryIterator', Escaper::unescape(Escaper::escape('entities', new \DirectoryIterator('.'))), '::unescape() unescapes IteratorDecorator objects');
}
public function testUnescapeDoesNotUnescapeObjectMarkedAsBeingSafe()
{
$this->assertInstanceOf('Symfony\Tests\Component\OutputEscaper\OutputEscaperTestClass', Escaper::unescape(Escaper::escape('entities', new SafeDecorator(new OutputEscaperTestClass()))), '::unescape() returns the original value if it is marked as being safe');
Escaper::markClassAsSafe('OutputEscaperTestClass');
$this->assertInstanceOf('Symfony\Tests\Component\OutputEscaper\OutputEscaperTestClass', Escaper::unescape(Escaper::escape('entities', new OutputEscaperTestClass())), '::unescape() returns the original value if the object class is marked as being safe');
$this->assertInstanceOf('Symfony\Tests\Component\OutputEscaper\OutputEscaperTestClass', Escaper::unescape(Escaper::escape('entities', new OutputEscaperTestClassChild())), '::unescape() returns the original value if one of the object parent class is marked as being safe');
}
public function testUnescapeDoesNothingToResources()
{
$fh = fopen(__FILE__, 'r');
$this->assertEquals($fh, Escaper::unescape($fh), '::unescape() do nothing to resources');
}
public function testUnescapeUnescapesMixedArrays()
{
$object = new OutputEscaperTestClass();
$input = array(
'foo' => 'bar',
'bar' => Escaper::escape('entities', 'bar'),
'foobar' => Escaper::escape('entities', $object),
);
$output = array(
'foo' => 'bar',
'bar' => 'bar',
'foobar' => $object,
);
$this->assertEquals($output, Escaper::unescape($input), '::unescape() unescapes values with some escaped and unescaped values');
}
public function testEscaperRememberSafeDecoratedObjects()
{
$object = new \stdClass();
$object->foo = '
';
$var = new SafeDecorator($object);
Escaper::escape('entities', $var);
$escaped = Escaper::escape('entities', $object);
$this->assertEquals('
', $escaped->foo);
}
}
class OutputEscaperTestClass
{
public $title = 'escaped!';
public function getTitle()
{
return $this->title;
}
public function getTitleTitle()
{
$o = new self;
return $o->getTitle();
}
}
class OutputEscaperTestClassChild extends OutputEscaperTestClass
{
}