9 * @author Greg Beaver <cellog@php.net>
10 * @copyright 1997-2009 The Authors
11 * @license http://opensource.org/licenses/bsd-license.php New BSD License
12 * @version CVS: $Id: 13.php 313023 2011-07-06 19:17:11Z dufuz $
13 * @link http://pear.php.net/package/PEAR
14 * @since File available since Release 1.4.0a12
18 * For downloading REST xml/txt files
20 require_once 'PEAR/REST.php';
21 require_once 'PEAR/REST/10.php';
28 * @author Greg Beaver <cellog@php.net>
29 * @copyright 1997-2009 The Authors
30 * @license http://opensource.org/licenses/bsd-license.php New BSD License
31 * @version Release: 1.9.4
32 * @link http://pear.php.net/package/PEAR
33 * @since Class available since Release 1.4.0a12
35 class PEAR_REST_13 extends PEAR_REST_10
38 * Retrieve information about a remote package to be downloaded from a REST server
40 * This is smart enough to resolve the minimum PHP version dependency prior to download
41 * @param string $base The uri to prepend to all REST calls
42 * @param array $packageinfo an array of format:
45 * 'package' => 'packagename',
46 * 'channel' => 'channelname',
47 * ['state' => 'alpha' (or valid state),]
49 * ['version' => '1.whatever']
51 * @param string $prefstate Current preferred_state config variable value
52 * @param bool $installed the installed version of this package to compare against
53 * @return array|false|PEAR_Error see {@link _returnDownloadURL()}
55 function getDownloadURL($base, $packageinfo, $prefstate, $installed, $channel = false)
57 $states = $this->betterStates($prefstate, true);
59 return PEAR::raiseError('"' . $prefstate . '" is not a valid state');
62 $channel = $packageinfo['channel'];
63 $package = $packageinfo['package'];
64 $state = isset($packageinfo['state']) ? $packageinfo['state'] : null;
65 $version = isset($packageinfo['version']) ? $packageinfo['version'] : null;
66 $restFile = $base . 'r/' . strtolower($package) . '/allreleases2.xml';
68 $info = $this->_rest->retrieveData($restFile, false, false, $channel);
69 if (PEAR::isError($info)) {
70 return PEAR::raiseError('No releases available for package "' .
71 $channel . '/' . $package . '"');
74 if (!isset($info['r'])) {
78 $release = $found = false;
79 if (!is_array($info['r']) || !isset($info['r'][0])) {
80 $info['r'] = array($info['r']);
84 foreach ($info['r'] as $release) {
85 if (!isset($this->_rest->_options['force']) && ($installed &&
86 version_compare($release['v'], $installed, '<'))) {
91 // try our preferred state first
92 if ($release['s'] == $state) {
93 if (!isset($version) && version_compare($release['m'], phpversion(), '>')) {
94 // skip releases that require a PHP version newer than our PHP version
95 $skippedphp = $release;
102 // see if there is something newer and more stable
104 if (in_array($release['s'], $this->betterStates($state), true)) {
105 if (!isset($version) && version_compare($release['m'], phpversion(), '>')) {
106 // skip releases that require a PHP version newer than our PHP version
107 $skippedphp = $release;
113 } elseif (isset($version)) {
114 if ($release['v'] == $version) {
115 if (!isset($this->_rest->_options['force']) &&
117 version_compare($release['m'], phpversion(), '>')) {
118 // skip releases that require a PHP version newer than our PHP version
119 $skippedphp = $release;
126 if (in_array($release['s'], $states)) {
127 if (version_compare($release['m'], phpversion(), '>')) {
128 // skip releases that require a PHP version newer than our PHP version
129 $skippedphp = $release;
138 if (!$found && $skippedphp) {
142 return $this->_returnDownloadURL($base, $package, $release, $info, $found, $skippedphp, $channel);
145 function getDepDownloadURL($base, $xsdversion, $dependency, $deppackage,
146 $prefstate = 'stable', $installed = false, $channel = false)
148 $states = $this->betterStates($prefstate, true);
150 return PEAR::raiseError('"' . $prefstate . '" is not a valid state');
153 $channel = $dependency['channel'];
154 $package = $dependency['name'];
155 $state = isset($dependency['state']) ? $dependency['state'] : null;
156 $version = isset($dependency['version']) ? $dependency['version'] : null;
157 $restFile = $base . 'r/' . strtolower($package) .'/allreleases2.xml';
159 $info = $this->_rest->retrieveData($restFile, false, false, $channel);
160 if (PEAR::isError($info)) {
161 return PEAR::raiseError('Package "' . $deppackage['channel'] . '/' . $deppackage['package']
162 . '" dependency "' . $channel . '/' . $package . '" has no releases');
165 if (!is_array($info) || !isset($info['r'])) {
170 $min = $max = $recommended = false;
171 if ($xsdversion == '1.0') {
172 $pinfo['package'] = $dependency['name'];
173 $pinfo['channel'] = 'pear.php.net'; // this is always true - don't change this
174 switch ($dependency['rel']) {
176 $min = $dependency['version'];
179 $min = $dependency['version'];
180 $exclude = array($dependency['version']);
183 $recommended = $dependency['version'];
186 $max = $dependency['version'];
187 $exclude = array($dependency['version']);
190 $max = $dependency['version'];
193 $exclude = array($dependency['version']);
197 $pinfo['package'] = $dependency['name'];
198 $min = isset($dependency['min']) ? $dependency['min'] : false;
199 $max = isset($dependency['max']) ? $dependency['max'] : false;
200 $recommended = isset($dependency['recommended']) ?
201 $dependency['recommended'] : false;
202 if (isset($dependency['exclude'])) {
203 if (!isset($dependency['exclude'][0])) {
204 $exclude = array($dependency['exclude']);
209 $skippedphp = $found = $release = false;
210 if (!is_array($info['r']) || !isset($info['r'][0])) {
211 $info['r'] = array($info['r']);
214 foreach ($info['r'] as $release) {
215 if (!isset($this->_rest->_options['force']) && ($installed &&
216 version_compare($release['v'], $installed, '<'))) {
220 if (in_array($release['v'], $exclude)) { // skip excluded versions
224 // allow newer releases to say "I'm OK with the dependent package"
225 if ($xsdversion == '2.0' && isset($release['co'])) {
226 if (!is_array($release['co']) || !isset($release['co'][0])) {
227 $release['co'] = array($release['co']);
230 foreach ($release['co'] as $entry) {
231 if (isset($entry['x']) && !is_array($entry['x'])) {
232 $entry['x'] = array($entry['x']);
233 } elseif (!isset($entry['x'])) {
234 $entry['x'] = array();
237 if ($entry['c'] == $deppackage['channel'] &&
238 strtolower($entry['p']) == strtolower($deppackage['package']) &&
239 version_compare($deppackage['version'], $entry['min'], '>=') &&
240 version_compare($deppackage['version'], $entry['max'], '<=') &&
241 !in_array($release['v'], $entry['x'])) {
242 if (version_compare($release['m'], phpversion(), '>')) {
243 // skip dependency releases that require a PHP version
244 // newer than our PHP version
245 $skippedphp = $release;
249 $recommended = $release['v'];
256 if ($release['v'] != $recommended) { // if we want a specific
257 // version, then skip all others
261 if (!in_array($release['s'], $states)) {
262 // the stability is too low, but we must return the
263 // recommended version if possible
264 return $this->_returnDownloadURL($base, $package, $release, $info, true, false, $channel);
268 if ($min && version_compare($release['v'], $min, 'lt')) { // skip too old versions
272 if ($max && version_compare($release['v'], $max, 'gt')) { // skip too new versions
276 if ($installed && version_compare($release['v'], $installed, '<')) {
280 if (in_array($release['s'], $states)) { // if in the preferred state...
281 if (version_compare($release['m'], phpversion(), '>')) {
282 // skip dependency releases that require a PHP version
283 // newer than our PHP version
284 $skippedphp = $release;
288 $found = true; // ... then use it
293 if (!$found && $skippedphp) {
297 return $this->_returnDownloadURL($base, $package, $release, $info, $found, $skippedphp, $channel);