README

Forked from https://github.com/hanneskod/classtools

Find, extract and process classes from the file system.

Installation

Install using composer. Exists as uzbek/classtools in the packagist repository. From the command line use:

composer require uzbek/classtools

Using the iterator

ClassIterator consumes a symfony finder and scans files for php classes, interfaces and traits.

Access the class map

getClassMap() returns a map of class names to SplFileInfo objects.

$finder = new Symfony\Component\Finder\Finder;
$iter = new Uzbek\ClassTools\Iterator\ClassIterator($finder->in('src'));

// Print the file names of classes, interfaces and traits in 'src'
foreach ($iter->getClassMap() as $classname => $splFileInfo) {
    echo $classname.': '.$splFileInfo->getRealPath();
}

Find syntax errors

Source files containing syntax errors can not be parsed and hence no information on contained classes can be retrieved. Use getErrors() to read the list of encountered errors.

$finder = new Symfony\Component\Finder\Finder;
$iter = new Uzbek\ClassTools\Iterator\ClassIterator($finder->in('src'));

print_r($iter->getErrors());

Iterate over ReflectionClass objects

ClassIterator is also a Traversable, that on iteration yields class names as keys and ReflectionClass objects as values.

Note that to use reflection the classes found in filesystem must be included in the environment. Enable autoloading to dynamically load classes from a ClassIterator.

$finder = new Symfony\Component\Finder\Finder();
$iter = new Uzbek\ClassTools\Iterator\ClassIterator($finder->in('src'));

// Enable reflection by autoloading found classes
$iter->enableAutoloading();

// Print all classes, interfaces and traits in 'src'
foreach ($iter as $class) {
    echo $class->getName();
}

Filter based on class properties

ClassIterator is filterable and filters are chainable.

$finder = new Symfony\Component\Finder\Finder();
$iter = new Uzbek\ClassTools\Iterator\ClassIterator($finder->in('src'));
$iter->enableAutoloading();

// Print all Filter types (including the interface itself)
foreach ($iter->type('uzbek\ClassTools\Iterator\Filter') as $class) {
    echo $class->getName();
}

// Print definitions in the Iterator namespace whose name contains 'Class'
foreach ($iter->inNamespace('uzbek\ClassTools\Iterator\Filter')->name('/type/i') as $class) {
    echo $class->getName();
}

// Print implementations of the Filter interface
foreach ($iter->type('uzbek\ClassTools\Iterator\Filter')->where('isInstantiable') as $class) {
    echo $class->getName();
}

Negate filters

Filters can also be negated by wrapping them in not() method calls.

$finder = new Symfony\Component\Finder\Finder();
$iter = new Uzbek\ClassTools\Iterator\ClassIterator($finder->in('src'));
$iter->enableAutoloading();

// Print all classes, interfaces and traits NOT instantiable
foreach ($iter->not($iter->where('isInstantiable')) as $class) {
    echo $class->getName();
}

Transforming classes

Found class, interface and trait definitions can be transformed and written to a single file.

$finder = new Symfony\Component\Finder\Finder();
$iter = new Uzbek\ClassTools\Iterator\ClassIterator($finder->in('src'));
$iter->enableAutoloading();

// Print all found definitions in one snippet
echo $iter->minimize();

// The same can be done using
echo $iter->transform(new Uzbek\ClassTools\Transformer\MinimizingWriter);

Using the transformer

Wrap code in namespace

$reader = new Reader("<?php class Bar {}");
$writer = new Writer;
$writer->apply(new Action\NamespaceWrapper('Foo'));

// Outputs class Bar wrapped in namespace Foo
echo $writer->write($reader->read('Bar'));