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 | ||