Skip to content

Library for searching for classes in a specific root directory and namespace, including add-on to search all bundles in a Symfony application.

License

Notifications You must be signed in to change notification settings

darsyn/class-finder

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

64 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

Darsyn's Class Finder Build Status

A library for searching for classes in a specific root directory and namespace. Originally intended for searching for classes in all registered Symfony bundles (similar to finding bundle commands), it can find classes that stick to a standard without having to manually register each of those classes. Various filters can be specified, such as:

  • In a sub-directory/namespace.
  • Have a specific file extension.
  • End with custom suffix.
  • Implement or extend a parent class or interface.

Usually an array containing fully-qualified class names (as strings) is returned, but passing true as the fourth parameter to the findClasses() method will return an array of ReflectionClass instances instead. Very useful in certain situations.

License

This project is licensed under MIT.

Dependencies

This project uses Symfony's Finder component to search for classes, and PHP's Reflection extension to process class definitions. It also assumes you are using Composer or a similar autoloader.

If you plan to use this library with the Symfony framework, it also utilises the HTTP Kernel component; this will already be a dependency of your project however.

Example

<?php

use Darsyn\ClassFinder\ClassFinder;

$finder = new ClassFinder;
$finder->setRootDirectory(__DIR__);

$subDir = 'Models';
$suffix = 'Entity';
$parent = 'Framework\\ActiveRecordEntity';

$classes = $finder->findClasses($subDir, $suffix, $parent);
foreach ($classes as $class) {
	echo $class . "\n";
}

/**
 * Example Output:
 *
 * Models\UserEntity
 * Models\GroupEntity
 * Models\CustomerEntity
 */

Symfony Integration

<?php

use Darsyn\ClassFinder\BundleClassFinder;
use Symfony\Bundle\FrameworkBundle\Controller\Controller;

class DefaultController extends Controller
{
	public function indexAction()
	{
		$kernel = $this->container->get('kernel');
		$finder = new BundleClassFinder($kernel);
		// Find all container-aware commands across all bundles:
		$containerAwareCommands = $finder->findClasses(
			'Command',
			'Command',
			'Symfony\\Bundle\\FrameworkBundle\\Command\\ContainerAwareCommand'
		);
	}
}

You may also register this library as a service. To do so, add the following to app/config/services.yml (or in the bundle that uses this library in your preferred configuration format):

services:

    darsyn.class_finder:
        class: Darsyn\ClassFinder\BundleClassFinder
        arguments: [ @kernel ]

Note: Remember that the kernel service is synthetic, and cannot be used until Symfony injects the correct kernel instance into the container.

Authors and Contributing

Current authors include:

All contributions are welcome, don't forget to add your name here in the pull request!

About

Library for searching for classes in a specific root directory and namespace, including add-on to search all bundles in a Symfony application.

Resources

License

Stars

Watchers

Forks

Packages

No packages published

Languages