Directory structure
A REST channel server simply delivers files in a certain directory structure. The content of those files is static. Their location is relative to the URLs given in the channel.xml baseurl tags.
Note: All files are static - you do not need a scripting language installed on your server.
The following table lists all known files, a tiny description as well as the version they appeared in first.
Table 33-1. Directory- and file structure
| Level 0 | Level 1 | Level 2 | Description | REST version |
|---|---|---|---|---|
| c/ | Categories | 1.0 | ||
| categories.xml | List of all categories | 1.1 | ||
| $CategoryName/ | 1.0 | |||
| info.xml | Info about the category | 1.0 | ||
| packages.xml | List of packages in category | 1.0 | ||
| packagesinfo.xml | Info about all packages | 1.1 | ||
| m/ | Maintainers | 1.0 | ||
| allmaintainers.xml | List of all maintainers | 1.1 | ||
| $maintainernick/ | 1.0 | |||
| info.xml | Info about the maintainer | 1.0 | ||
| p/ | Packages | 1.0 | ||
| packages.xml | List of all packages | 1.0 | ||
| $packagename/ | 1.0 | |||
| info.xml | General package information | 1.0 | ||
| maintainers.xml | List of package maintainers | 1.0 | ||
| maintainers2.xml | List of developers and their roles | 1.2 | ||
| r/ | Releases | 1.0 | ||
| $packagename/ | 1.0 | |||
| allreleases.xml | List of all releases | 1.0 | ||
| allreleases2.xml | List of all releases including minimum PHP version | 1.3 | ||
| latest.txt | Latest version number | 1.0 | ||
| stable.txt | Latest stable version number | 1.0 | ||
| beta.txt | Latest beta version number | 1.0 | ||
| alpha.txt | Latest alpha version number | 1.0 | ||
| devel.txt | Latest development version number | 1.0 | ||
| 0.1.2.xml | Short package info for version 0.1.2 | 1.0 | ||
| v2.0.1.2.xml | Short version of package.xml, version 2 | 1.3 | ||
| package.0.1.2.xml | package.xml for version 0.1.2 | 1.0 | ||
| deps.0.1.2.txt | Serialized dependencies for version 0.1.2 | 1.0 | ||