uzbek / classtools
Find, extract and process classes from file system
Requires
- php: >=8.1
- nikic/php-parser: ^4
- symfony/finder: ^4|^5|^6
Requires (Dev)
- friendsofphp/php-cs-fixer: >=v2.19.3
- rector/rector: ^0.14.0
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'));