Classe: Path  - X-Ref

This object represents a path as used by include_path or PATH
environment variable.

This class has been adopted from the Java Ant equivalent.  The ability have
path structures in Phing is important; however, because of how PHP classes interact
the ability to specify CLASSPATHs makes less sense than Java.Rather than providing
CLASSPATH for any tasks that take classes as parameters, perhaps a better
solution in PHP is to have an IncludePath task, which prepends paths to PHP's include_path
INI variable. This gets around the problem that simply using a path to load the initial
PHP class is not enough (in most cases the loaded class may assume that it is on the global
PHP include_path, and will try to load dependent classes accordingly).  The other option is
to provide a way for this class to add paths to the include path, if desired -- or to create
an IncludePath subclass.  Once added, though, when would a path be removed from the include path?

<p>
<code>
&lt;sometask&gt;<br>
&nbsp;&nbsp;&lt;somepath&gt;<br>
&nbsp;&nbsp;&nbsp;&nbsp;&lt;pathelement location="/path/to/file" /&gt;<br>
&nbsp;&nbsp;&nbsp;&nbsp;&lt;pathelement path="/path/to/class2;/path/to/class3" /&gt;<br>
&nbsp;&nbsp;&nbsp;&nbsp;&lt;pathelement location="/path/to/file3" /&gt;<br>
&nbsp;&nbsp;&lt;/somepath&gt;<br>
&lt;/sometask&gt;<br>
</code>
<p>
The object implemention <code>sometask</code> must provide a method called
<code>createSomepath</code> which returns an instance of <code>Path</code>.
Nested path definitions are handled by the Path object and must be labeled
<code>pathelement</code>.<p>

The path element takes a parameter <code>path</code> which will be parsed
and split into single elements. It will usually be used
to define a path from an environment variable.

Classe: PathElement  - X-Ref

Helper class, holds the nested <code>&lt;pathelement&gt;</code> values.