Phar is PHP's unique way of packing libraries or applications into a single file. The support for the Phar archives is built in the compiler and supported by the runtime.
File with the extension
.phar can be included into the compilation within the project file, like any other source file.
<Compile Include="**/*.phar" />
In compile time,
.phar files are opened and containing scripts compiled separately.
Non-script entries, content files, are stored within the resulting assembly as an embedded resource. In result, the original phar file is not needed for the purpose of running the compiled application.
Phar's stub code can be specified as the application's startup object. In case a
.phar file is specified as the first source file being compiled, it is automatically used as the application's entry point. Phar entries (files contained in the archive except for the phar stub) cannot be used as the application's startup object.
Phar content files#
Any Phar entry that is not recognized as a source file is compiled as a resource. Source files are determined using following rules:
- entry has an extension
- entry has no extension and starts with
- entry has a well known extension (
.module) and contains the opening tag
Note, this behaviour may change.
Phar support allows for compilation, inclusion, mapping Phar aliases and retrieving Phar content files.
The support for modifying or creating of Phar archives is not supported.