diogo/symfony
Archived
1
0
Fork 0
Code Issues Pull Requests Packages Projects Releases Wiki Activity

[Classloader] Added phpdoc with example usage + refactored unit tests fixtures

Browse Source
This commit is contained in:
Dustin Whittle 2011-04-24 06:59:28 -07:00
parent 29802faef4
commit e8bb64c17c
19 changed files with 316 additions and 139 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

51
src/Symfony/Component/ClassLoader/ApcUniversalClassLoader.php
View File

@ -12,8 +12,50 @@
namespace Symfony\Component\ClassLoader; namespace Symfony\Component\ClassLoader;
/** /**
* Class loader utilizing APC to remember where files are. * ApcUniversalClassLoader implements a "universal" autoloader cached in APC for PHP 5.3.
* *
* It is able to load classes that use either:
*
* * The technical interoperability standards for PHP 5.3 namespaces and
* class names (http://groups.google.com/group/php-standards/web/psr-0-final-proposal);
*
* * The PEAR naming convention for classes (http://pear.php.net/).
*
* Classes from a sub-namespace or a sub-hierarchy of PEAR classes can be
* looked for in a list of locations to ease the vendoring of a sub-set of
* classes for large projects.
*
* Example usage:
*
* require 'vendor/symfony/src/Symfony/Component/ClassLoader/UniversalClassLoader.php';
* require 'vendor/symfony/src/Symfony/Component/ClassLoader/ApcUniversalClassLoader.php';
*
* use Symfony\Component\ClassLoader\ApcUniversalClassLoader;
*
* $loader = new ApcUniversalClassLoader('apc.prefix.');
*
* // register classes with namespaces
* $loader->registerNamespaces(array(
* 'Symfony\Component' => __DIR__.'/component',
* 'Symfony' => __DIR__.'/framework',
* 'Sensio' => array(__DIR__.'/src', __DIR__.'/vendor'),
* ));
*
* // register a library using the PEAR naming convention
* $loader->registerPrefixes(array(
* 'Swift_' => __DIR__.'/Swift',
* ));
*
* // activate the autoloader
* $loader->register();
*
* In this example, if you try to use a class in the Symfony\Component
* namespace or one of its children (Symfony\Component\Console for instance),
* the autoloader will first look for the class under the component/
* directory, and it will then fallback to the framework/ directory if not
* found before giving up.
*
* @author Fabien Potencier <fabien@symfony.com>
* @author Kris Wallsmith <kris.wallsmith@symfony.com> * @author Kris Wallsmith <kris.wallsmith@symfony.com>
* *
* @api * @api
@ -34,6 +76,13 @@ class ApcUniversalClassLoader extends UniversalClassLoader
$this->prefix = $prefix; $this->prefix = $prefix;
} }
/**
* Finds a file by class name while caching lookups to APC.
*
* @param string $class A class name to resolve to file
*
* @api
*/
public function findFile($class) public function findFile($class)
{ {
if (false === $file = apc_fetch($this->prefix.$class)) { if (false === $file = apc_fetch($this->prefix.$class)) {

284
tests/Symfony/Tests/Component/ClassLoader/ApcUniversalClassLoaderTest.php
View File

@ -25,160 +25,168 @@ class ApcUniversalClassLoaderTest extends \PHPUnit_Framework_TestCase
if (!(ini_get('apc.enabled') && ini_get('apc.enable_cli'))) { if (!(ini_get('apc.enabled') && ini_get('apc.enable_cli'))) {
$this->markTestSkipped('The apc extension is available, but not enabled.'); $this->markTestSkipped('The apc extension is available, but not enabled.');
} }
apc_clear_cache('user');
} }
protected function tearDown()
{
apc_clear_cache('user');
}
public function testConstructor() public function testConstructor()
{ {
$loader = new ApcUniversalClassLoader('test.prefix.'); $loader = new ApcUniversalClassLoader('test.prefix.');
$loader->registerNamespace('Namespaced', __DIR__.DIRECTORY_SEPARATOR.'Fixtures'); $loader->registerNamespace('Apc\Namespaced', __DIR__.DIRECTORY_SEPARATOR.'Fixtures');
$this->assertEquals($loader->findFile('\Namespaced\Bar'), apc_fetch('test.prefix.\Namespaced\Bar'), '__construct() takes a prefix as its first argument'); $this->assertEquals($loader->findFile('\Apc\Namespaced\FooBar'), apc_fetch('test.prefix.\Apc\Namespaced\FooBar'), '__construct() takes a prefix as its first argument');
} }
/** /**
* @dataProvider getLoadClassTests * @dataProvider getLoadClassTests
*/ */
public function testLoadClass($className, $testClassName, $message) public function testLoadClass($className, $testClassName, $message)
{ {
$loader = new ApcUniversalClassLoader('test.prefix.'); $loader = new ApcUniversalClassLoader('test.prefix.');
$loader->registerNamespace('Namespaced', __DIR__.DIRECTORY_SEPARATOR.'Fixtures'); $loader->registerNamespace('Apc\Namespaced', __DIR__.DIRECTORY_SEPARATOR.'Fixtures');
$loader->registerPrefix('Pearlike_', __DIR__.DIRECTORY_SEPARATOR.'Fixtures'); $loader->registerPrefix('Apc_Pearlike_', __DIR__.DIRECTORY_SEPARATOR.'Fixtures');
$loader->loadClass($testClassName); $loader->loadClass($testClassName);
$this->assertTrue(class_exists($className), $message); $this->assertTrue(class_exists($className), $message);
} }
public function getLoadClassTests() public function getLoadClassTests()
{ {
return array( return array(
array('\\Namespaced\\Foo', 'Namespaced\\Foo', '->loadClass() loads Namespaced\Foo class'), array('\\Apc\\Namespaced\\Foo', '\\Apc\\Namespaced\\Foo', '->loadClass() loads Apc\Namespaced\Foo class'),
array('\\Pearlike_Foo', 'Pearlike_Foo', '->loadClass() loads Pearlike_Foo class'), array('Apc_Pearlike_Foo', 'Apc_Pearlike_Foo', '->loadClass() loads Apc_Pearlike_Foo class'),
array('\\Namespaced\\Bar', '\\Namespaced\\Bar', '->loadClass() loads Namespaced\Bar class with a leading slash'), array('\\Apc\\Namespaced\\Bar', '\\Apc\\Namespaced\\Bar', '->loadClass() loads Apc\Namespaced\Bar class with a leading slash'),
array('\\Pearlike_Bar', '\\Pearlike_Bar', '->loadClass() loads Pearlike_Bar class with a leading slash'), array('Apc_Pearlike_Bar', '\\Apc_Pearlike_Bar', '->loadClass() loads Apc_Pearlike_Bar class with a leading slash'),
); );
} }
/** /**
* @dataProvider getLoadClassFromFallbackTests * @dataProvider getLoadClassFromFallbackTests
*/ */
public function testLoadClassFromFallback($className, $testClassName, $message) public function testLoadClassFromFallback($className, $testClassName, $message)
{ {
$loader = new ApcUniversalClassLoader('test.prefix.'); $loader = new ApcUniversalClassLoader('test.prefix.fallback');
$loader->registerNamespace('Namespaced', __DIR__.DIRECTORY_SEPARATOR.'Fixtures'); $loader->registerNamespace('Apc\Namespaced', __DIR__.DIRECTORY_SEPARATOR.'Fixtures');
$loader->registerPrefix('Pearlike_', __DIR__.DIRECTORY_SEPARATOR.'Fixtures'); $loader->registerPrefix('Apc_Pearlike_', __DIR__.DIRECTORY_SEPARATOR.'Fixtures');
$loader->registerNamespaceFallback(__DIR__.DIRECTORY_SEPARATOR.'Fixtures/fallback'); $loader->registerNamespaceFallback(__DIR__.DIRECTORY_SEPARATOR.'Fixtures/Apc/fallback');
$loader->registerPrefixFallback(__DIR__.DIRECTORY_SEPARATOR.'Fixtures/fallback'); $loader->registerPrefixFallback(__DIR__.DIRECTORY_SEPARATOR.'Fixtures/Apc/fallback');
$loader->loadClass($testClassName); $loader->loadClass($testClassName);
$this->assertTrue(class_exists($className), $message); $this->assertTrue(class_exists($className), $message);
} }
public function getLoadClassFromFallbackTests() public function getLoadClassFromFallbackTests()
{ {
return array( return array(
array('\\Namespaced\\Baz', 'Namespaced\\Baz', '->loadClass() loads Namespaced\Baz class'), array('\\Apc\\Namespaced\\Baz', '\\Apc\\Namespaced\\Baz', '->loadClass() loads Apc\Namespaced\Baz class'),
array('\\Pearlike_Baz', 'Pearlike_Baz', '->loadClass() loads Pearlike_Baz class'), array('Apc_Pearlike_Baz', 'Apc_Pearlike_Baz', '->loadClass() loads Apc_Pearlike_Baz class'),
array('\\Namespaced\\FooBar', 'Namespaced\\FooBar', '->loadClass() loads Namespaced\Baz class from fallback dir'), array('\\Apc\\Namespaced\\FooBar', '\\Apc\\Namespaced\\FooBar', '->loadClass() loads Apc\Namespaced\Baz class from fallback dir'),
array('\\Pearlike_FooBar', 'Pearlike_FooBar', '->loadClass() loads Pearlike_Baz class from fallback dir'), array('Apc_Pearlike_FooBar', 'Apc_Pearlike_FooBar', '->loadClass() loads Apc_Pearlike_Baz class from fallback dir'),
); );
} }
/** /**
* @dataProvider getLoadClassNamespaceCollisionTests * @dataProvider getLoadClassNamespaceCollisionTests
*/ */
public function testLoadClassNamespaceCollision($namespaces, $className, $message) public function testLoadClassNamespaceCollision($namespaces, $className, $message)
{ {
$loader = new ApcUniversalClassLoader('test.prefix.'); $loader = new ApcUniversalClassLoader('test.prefix.collision.');
$loader->registerNamespaces($namespaces); $loader->registerNamespaces($namespaces);
$loader->loadClass($className); $loader->loadClass($className);
$this->assertTrue(class_exists($className), $message);
}
public function getLoadClassNamespaceCollisionTests() $this->assertTrue(class_exists($className), $message);
{ }
return array(
array(
array(
'NamespaceCollision\\A' => __DIR__.DIRECTORY_SEPARATOR.'Fixtures/alpha',
'NamespaceCollision\\A\\B' => __DIR__.DIRECTORY_SEPARATOR.'Fixtures/beta',
),
'NamespaceCollision\A\Foo',
'->loadClass() loads NamespaceCollision\A\Foo from alpha.',
),
array(
array(
'NamespaceCollision\\A\\B' => __DIR__.DIRECTORY_SEPARATOR.'Fixtures/beta',
'NamespaceCollision\\A' => __DIR__.DIRECTORY_SEPARATOR.'Fixtures/alpha',
),
'NamespaceCollision\A\Bar',
'->loadClass() loads NamespaceCollision\A\Bar from alpha.',
),
array(
array(
'NamespaceCollision\\A' => __DIR__.DIRECTORY_SEPARATOR.'Fixtures/alpha',
'NamespaceCollision\\A\\B' => __DIR__.DIRECTORY_SEPARATOR.'Fixtures/beta',
),
'NamespaceCollision\A\B\Foo',
'->loadClass() loads NamespaceCollision\A\B\Foo from beta.',
),
array(
array(
'NamespaceCollision\\A\\B' => __DIR__.DIRECTORY_SEPARATOR.'Fixtures/beta',
'NamespaceCollision\\A' => __DIR__.DIRECTORY_SEPARATOR.'Fixtures/alpha',
),
'NamespaceCollision\A\B\Bar',
'->loadClass() loads NamespaceCollision\A\B\Bar from beta.',
),
);
}
/** public function getLoadClassNamespaceCollisionTests()
* @dataProvider getLoadClassPrefixCollisionTests {
*/ return array(
public function testLoadClassPrefixCollision($prefixes, $className, $message) array(
{ array(
$loader = new ApcUniversalClassLoader('test.prefix.'); 'Apc\\NamespaceCollision\\A' => __DIR__.DIRECTORY_SEPARATOR.'Fixtures/Apc/alpha',
$loader->registerPrefixes($prefixes); 'Apc\\NamespaceCollision\\A\\B' => __DIR__.DIRECTORY_SEPARATOR.'Fixtures/Apc/beta',
),
'\Apc\NamespaceCollision\A\Foo',
'->loadClass() loads NamespaceCollision\A\Foo from alpha.',
),
array(
array(
'Apc\\NamespaceCollision\\A\\B' => __DIR__.DIRECTORY_SEPARATOR.'Fixtures/Apc/beta',
'Apc\\NamespaceCollision\\A' => __DIR__.DIRECTORY_SEPARATOR.'Fixtures/Apc/alpha',
),
'\Apc\NamespaceCollision\A\Bar',
'->loadClass() loads NamespaceCollision\A\Bar from alpha.',
),
array(
array(
'Apc\\NamespaceCollision\\A' => __DIR__.DIRECTORY_SEPARATOR.'Fixtures/Apc/alpha',
'Apc\\NamespaceCollision\\A\\B' => __DIR__.DIRECTORY_SEPARATOR.'Fixtures/Apc/beta',
),
'\Apc\NamespaceCollision\A\B\Foo',
'->loadClass() loads NamespaceCollision\A\B\Foo from beta.',
),
array(
array(
'Apc\\NamespaceCollision\\A\\B' => __DIR__.DIRECTORY_SEPARATOR.'Fixtures/Apc/beta',
'Apc\\NamespaceCollision\\A' => __DIR__.DIRECTORY_SEPARATOR.'Fixtures/Apc/alpha',
),
'\Apc\NamespaceCollision\A\B\Bar',
'->loadClass() loads NamespaceCollision\A\B\Bar from beta.',
),
);
}
$loader->loadClass($className); /**
$this->assertTrue(class_exists($className), $message); * @dataProvider getLoadClassPrefixCollisionTests
} */
public function testLoadClassPrefixCollision($prefixes, $className, $message)
{
$loader = new ApcUniversalClassLoader('test.prefix.collision.');
$loader->registerPrefixes($prefixes);
public function getLoadClassPrefixCollisionTests() $loader->loadClass($className);
{ $this->assertTrue(class_exists($className), $message);
return array( }
array(
array( public function getLoadClassPrefixCollisionTests()
'PrefixCollision_A_' => __DIR__.DIRECTORY_SEPARATOR.'Fixtures/alpha', {
'PrefixCollision_A_B_' => __DIR__.DIRECTORY_SEPARATOR.'Fixtures/beta', return array(
), array(
'PrefixCollision_A_Foo', array(
'->loadClass() loads PrefixCollision_A_Foo from alpha.', 'ApcPrefixCollision_A_' => __DIR__.DIRECTORY_SEPARATOR.'Fixtures/Apc/alpha/Apc',
), 'ApcPrefixCollision_A_B_' => __DIR__.DIRECTORY_SEPARATOR.'Fixtures/Apc/beta/Apc',
array( ),
array( 'ApcPrefixCollision_A_Foo',
'PrefixCollision_A_B_' => __DIR__.DIRECTORY_SEPARATOR.'Fixtures/beta', '->loadClass() loads ApcPrefixCollision_A_Foo from alpha.',
'PrefixCollision_A_' => __DIR__.DIRECTORY_SEPARATOR.'Fixtures/alpha', ),
), array(
'PrefixCollision_A_Bar', array(
'->loadClass() loads PrefixCollision_A_Bar from alpha.', 'ApcPrefixCollision_A_B_' => __DIR__.DIRECTORY_SEPARATOR.'Fixtures/Apc/beta/Apc',
), 'ApcPrefixCollision_A_' => __DIR__.DIRECTORY_SEPARATOR.'Fixtures/Apc/alpha/Apc',
array( ),
array( 'ApcPrefixCollision_A_Bar',
'PrefixCollision_A_' => __DIR__.DIRECTORY_SEPARATOR.'Fixtures/alpha', '->loadClass() loads ApcPrefixCollision_A_Bar from alpha.',
'PrefixCollision_A_B_' => __DIR__.DIRECTORY_SEPARATOR.'Fixtures/beta', ),
), array(
'PrefixCollision_A_B_Foo', array(
'->loadClass() loads PrefixCollision_A_B_Foo from beta.', 'ApcPrefixCollision_A_' => __DIR__.DIRECTORY_SEPARATOR.'Fixtures/Apc/alpha/Apc',
), 'ApcPrefixCollision_A_B_' => __DIR__.DIRECTORY_SEPARATOR.'Fixtures/Apc/beta/Apc',
array( ),
array( 'ApcPrefixCollision_A_B_Foo',
'PrefixCollision_A_B_' => __DIR__.DIRECTORY_SEPARATOR.'Fixtures/beta', '->loadClass() loads ApcPrefixCollision_A_B_Foo from beta.',
'PrefixCollision_A_' => __DIR__.DIRECTORY_SEPARATOR.'Fixtures/alpha', ),
), array(
'PrefixCollision_A_B_Bar', array(
'->loadClass() loads PrefixCollision_A_B_Bar from beta.', 'ApcPrefixCollision_A_B_' => __DIR__.DIRECTORY_SEPARATOR.'Fixtures/Apc/beta/Apc',
), 'ApcPrefixCollision_A_' => __DIR__.DIRECTORY_SEPARATOR.'Fixtures/Apc/alpha/Apc',
); ),
} 'ApcPrefixCollision_A_B_Bar',
'->loadClass() loads ApcPrefixCollision_A_B_Bar from beta.',
),
);
}
} }

8
tests/Symfony/Tests/Component/ClassLoader/Fixtures/Apc/Namespaced/Bar.php Normal file
View File

@ -0,0 +1,8 @@
<?php
namespace Apc\Namespaced;
class Bar
{
public static $loaded = true;
}

8
tests/Symfony/Tests/Component/ClassLoader/Fixtures/Apc/Namespaced/Baz.php Normal file
View File

@ -0,0 +1,8 @@
<?php
namespace Apc\Namespaced;
class Baz
{
public static $loaded = true;
}

8
tests/Symfony/Tests/Component/ClassLoader/Fixtures/Apc/Namespaced/Foo.php Normal file
View File

@ -0,0 +1,8 @@
<?php
namespace Apc\Namespaced;
class Foo
{
public static $loaded = true;
}

8
tests/Symfony/Tests/Component/ClassLoader/Fixtures/Apc/Namespaced/FooBar.php Normal file
View File

@ -0,0 +1,8 @@
<?php
namespace Apc\Namespaced;
class FooBar
{
public static $loaded = true;
}

6
tests/Symfony/Tests/Component/ClassLoader/Fixtures/Apc/Pearlike/Bar.php Normal file
View File

@ -0,0 +1,6 @@
<?php
class Apc_Pearlike_Bar
{
public static $loaded = true;
}

6
tests/Symfony/Tests/Component/ClassLoader/Fixtures/Apc/Pearlike/Baz.php Normal file
View File

@ -0,0 +1,6 @@
<?php
class Apc_Pearlike_Baz
{
public static $loaded = true;
}

6
tests/Symfony/Tests/Component/ClassLoader/Fixtures/Apc/Pearlike/Foo.php Normal file
View File

@ -0,0 +1,6 @@
<?php
class Apc_Pearlike_Foo
{
public static $loaded = true;
}

6
tests/Symfony/Tests/Component/ClassLoader/Fixtures/Apc/alpha/Apc/ApcPrefixCollision/A/Bar.php Normal file
View File

@ -0,0 +1,6 @@
<?php
class ApcPrefixCollision_A_Bar
{
public static $loaded = true;
}

6
tests/Symfony/Tests/Component/ClassLoader/Fixtures/Apc/alpha/Apc/ApcPrefixCollision/A/Foo.php Normal file
View File

@ -0,0 +1,6 @@
<?php
class ApcPrefixCollision_A_Foo
{
public static $loaded = true;
}

8
tests/Symfony/Tests/Component/ClassLoader/Fixtures/Apc/alpha/Apc/NamespaceCollision/A/Bar.php Normal file
View File

@ -0,0 +1,8 @@
<?php
namespace Apc\NamespaceCollision\A;
class Bar
{
public static $loaded = true;
}

8
tests/Symfony/Tests/Component/ClassLoader/Fixtures/Apc/alpha/Apc/NamespaceCollision/A/Foo.php Normal file
View File

@ -0,0 +1,8 @@
<?php
namespace Apc\NamespaceCollision\A;
class Foo
{
public static $loaded = true;
}

6
tests/Symfony/Tests/Component/ClassLoader/Fixtures/Apc/beta/Apc/ApcPrefixCollision/A/B/Bar.php Normal file
View File

@ -0,0 +1,6 @@
<?php
class ApcPrefixCollision_A_B_Bar
{
public static $loaded = true;
}

6
tests/Symfony/Tests/Component/ClassLoader/Fixtures/Apc/beta/Apc/ApcPrefixCollision/A/B/Foo.php Normal file
View File

@ -0,0 +1,6 @@
<?php
class ApcPrefixCollision_A_B_Foo
{
public static $loaded = true;
}

8
tests/Symfony/Tests/Component/ClassLoader/Fixtures/Apc/beta/Apc/NamespaceCollision/A/B/Bar.php Normal file
View File

@ -0,0 +1,8 @@
<?php
namespace Apc\NamespaceCollision\A\B;
class Bar
{
public static $loaded = true;
}

8
tests/Symfony/Tests/Component/ClassLoader/Fixtures/Apc/beta/Apc/NamespaceCollision/A/B/Foo.php Normal file
View File

@ -0,0 +1,8 @@
<?php
namespace Apc\NamespaceCollision\A\B;
class Foo
{
public static $loaded = true;
}

6
tests/Symfony/Tests/Component/ClassLoader/Fixtures/Apc/fallback/Apc/Pearlike/FooBar.php Normal file
View File

@ -0,0 +1,6 @@
<?php
class Apc_Pearlike_FooBar
{
public static $loaded = true;
}

8
tests/Symfony/Tests/Component/ClassLoader/Fixtures/Apc/fallback/Namespaced/FooBar.php Normal file
View File

@ -0,0 +1,8 @@
<?php
namespace Apc\Namespaced;
class FooBar
{
public static $loaded = true;
}