<file>
Вернуться к: Detailed Tag Reference for package.xml version 2.0
<file>
The <file> tag describes a file in a directory in the package sources. File tags may only occur as children of <dir> tags.
File Tasks can be used to modify files at package time or at installation.
Attributes
| Attribute name | Description |
|---|---|
| name | Name of the file in the sources |
| role | Type of the file. See roles. |
| Attribute name | Description |
|---|---|
| baseinstalldir | Relative location where all files and subdirectories will be installed |
| md5sum | MD5 hash about file contents.This is automatically generated when executing pear package, so you should never set it manually. |
Previous optional attributes (package.xml v1)
<platform>and<install-as>have been replaced by the release tags.Specifically,
<install>is used to specify<install-as>, and the<ignore>tag can be used in conjunction with<installconditions>to exclude packages from being installed on particular platforms.
Roles
The <role> attribute in the <file> tag defines what type the file has and in which location it should be installed.
| Role value | Description | Destination dir |
|---|---|---|
<php> | PHP source file | $php_dir (your include path) |
<doc> | Documentation or example file | $doc_dir/Package_Name/ |
<data> | Package related data files (graphics, data tables, CSS etc.) | $data_dir/Package_Name/ |
<www> | Files for the HTTPd document root | $www_dir/ |
<test> | Package related test files (unit-tests etc) | $test_dir/Package_Name/ |
<script> | Package related shell scripts | the PHP binary directory ($bin_dir) or PHP_PEAR_BIN_DIR if defined |
<ext> | Extension, dynamically loadable library | the PHP extension directory ($ext_dir) or PHP_PEAR_EXTENSION_DIR if defined |
<src> / <extsrc> | C or C++ source code | not copied directly - used to build a extension |
Directory locations like $php_dir are configurable in PEAR. You can use pear config-show or pear config-get php_dir to retrieve their values.
Examples
<dir name="/">
<dir name="examples">
<!-- gets installed as $doc_dir/Package_Name/examples/authors.php -->
<file name="authors.php" role="doc" />
<file name="authors.tpl" role="doc" />
<file name="README" role="doc" />
</dir>
<dir name="HTML">
<dir name="Template">
<!-- gets installed as $php_dir/HTML/Template/PHPLIB.php -->
<file name="PHPLIB.php" role="php" />
<dir name="PHPLIB">
<file name="Generator.php" role="php" />
<file name="Helper.php" role="php" />
<file name="Tool.php" role="php" />
<file name="Validator.php" role="php" />
</dir>
</dir>
</dir>
<dir name="tests">
<file name="AllTests.php" role="test" />
<file name="GeneratorTest.php" role="test" />
<file name="HelperTest.php" role="test" />
<file name="ValidatorTest.php" role="test" />
</dir>
</dir>
</contents>
Вернуться к: Detailed Tag Reference for package.xml version 2.0