Canonic_Classmap
Canonic_Classmap
implements the php script traversal, tokenization and map building process.
Usually it's run via the static ::update()
method. If run from the default Canonic_Autoloader
mechanism, it just cares about the directory tree it resides in.
It can however map multiple source repositories. For instance:
Canonic_Classmap::update(
"phar://./shared.phar/autoload.map.php",
array(__DIR__, "/usr/share/php")
);
Will read in the surrounding tree, but also the global path. An identifier map of both will be stored within the phar.
It's important to understand that only file references from the first directory will be converted into relative paths. The /usr/share/php/*
filenames will stay absolute.
If such a manual updating procedure is in place, automatic updating via shared.phar
itself shouldn't be utilized further. It would still just default to handling only the directory tree it's contained in.
More specific
You can also forgo the static ::update
approach, and handle the details yourself:
$cm = new Canonic_Classmap;
And read in directories yourself:
$cm->process_dir("./vendor");
$cm->process_dir("../includes");
$cm->process_dir("/usr/share/php");
None of the mapped paths will be relative then.
You then have to write the results somewhere yourself in a format that shared.phar
or its stub can use:
$cm->write("./autoload.map.php");
Or update it also within the phar://