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 * @link http://pear.php.net/package/PEAR
13 * @since File available since Release 1.4.0a12
17 * For downloading REST xml/txt files
19 require_once 'PEAR/REST.php';
20 require_once 'PEAR/REST/10.php';
27 * @author Greg Beaver <cellog@php.net>
28 * @copyright 1997-2009 The Authors
29 * @license http://opensource.org/licenses/bsd-license.php New BSD License
30 * @version Release: 1.10.1
31 * @link http://pear.php.net/package/PEAR
32 * @since Class available since Release 1.4.0a12
34 class PEAR_REST_13 extends PEAR_REST_10
37 * Retrieve information about a remote package to be downloaded from a REST server
39 * This is smart enough to resolve the minimum PHP version dependency prior to download
40 * @param string $base The uri to prepend to all REST calls
41 * @param array $packageinfo an array of format:
44 * 'package' => 'packagename',
45 * 'channel' => 'channelname',
46 * ['state' => 'alpha' (or valid state),]
48 * ['version' => '1.whatever']
50 * @param string $prefstate Current preferred_state config variable value
51 * @param bool $installed the installed version of this package to compare against
52 * @return array|false|PEAR_Error see {@link _returnDownloadURL()}
54 function getDownloadURL($base, $packageinfo, $prefstate, $installed, $channel = false)
56 $states = $this->betterStates($prefstate, true);
58 return PEAR::raiseError('"' . $prefstate . '" is not a valid state');
61 $channel = $packageinfo['channel'];
62 $package = $packageinfo['package'];
63 $state = isset($packageinfo['state']) ? $packageinfo['state'] : null;
64 $version = isset($packageinfo['version']) ? $packageinfo['version'] : null;
65 $restFile = $base . 'r/' . strtolower($package) . '/allreleases2.xml';
67 $info = $this->_rest->retrieveData($restFile, false, false, $channel);
68 if (PEAR::isError($info)) {
69 return PEAR::raiseError('No releases available for package "' .
70 $channel . '/' . $package . '"');
73 if (!isset($info['r'])) {
77 $release = $found = false;
78 if (!is_array($info['r']) || !isset($info['r'][0])) {
79 $info['r'] = array($info['r']);
83 foreach ($info['r'] as $release) {
84 if (!isset($this->_rest->_options['force']) && ($installed &&
85 version_compare($release['v'], $installed, '<'))) {
90 // try our preferred state first
91 if ($release['s'] == $state) {
92 if (!isset($version) && version_compare($release['m'], phpversion(), '>')) {
93 // skip releases that require a PHP version newer than our PHP version
94 $skippedphp = $release;
101 // see if there is something newer and more stable
103 if (in_array($release['s'], $this->betterStates($state), true)) {
104 if (!isset($version) && version_compare($release['m'], phpversion(), '>')) {
105 // skip releases that require a PHP version newer than our PHP version
106 $skippedphp = $release;
112 } elseif (isset($version)) {
113 if ($release['v'] == $version) {
114 if (!isset($this->_rest->_options['force']) &&
116 version_compare($release['m'], phpversion(), '>')) {
117 // skip releases that require a PHP version newer than our PHP version
118 $skippedphp = $release;
125 if (in_array($release['s'], $states)) {
126 if (version_compare($release['m'], phpversion(), '>')) {
127 // skip releases that require a PHP version newer than our PHP version
128 $skippedphp = $release;
137 if (!$found && $skippedphp) {
141 return $this->_returnDownloadURL($base, $package, $release, $info, $found, $skippedphp, $channel);
144 function getDepDownloadURL($base, $xsdversion, $dependency, $deppackage,
145 $prefstate = 'stable', $installed = false, $channel = false)
147 $states = $this->betterStates($prefstate, true);
149 return PEAR::raiseError('"' . $prefstate . '" is not a valid state');
152 $channel = $dependency['channel'];
153 $package = $dependency['name'];
154 $state = isset($dependency['state']) ? $dependency['state'] : null;
155 $version = isset($dependency['version']) ? $dependency['version'] : null;
156 $restFile = $base . 'r/' . strtolower($package) .'/allreleases2.xml';
158 $info = $this->_rest->retrieveData($restFile, false, false, $channel);
159 if (PEAR::isError($info)) {
160 return PEAR::raiseError('Package "' . $deppackage['channel'] . '/' . $deppackage['package']
161 . '" dependency "' . $channel . '/' . $package . '" has no releases');
164 if (!is_array($info) || !isset($info['r'])) {
169 $min = $max = $recommended = false;
170 if ($xsdversion == '1.0') {
171 $pinfo['package'] = $dependency['name'];
172 $pinfo['channel'] = 'pear.php.net'; // this is always true - don't change this
173 switch ($dependency['rel']) {
175 $min = $dependency['version'];
178 $min = $dependency['version'];
179 $exclude = array($dependency['version']);
182 $recommended = $dependency['version'];
185 $max = $dependency['version'];
186 $exclude = array($dependency['version']);
189 $max = $dependency['version'];
192 $exclude = array($dependency['version']);
196 $pinfo['package'] = $dependency['name'];
197 $min = isset($dependency['min']) ? $dependency['min'] : false;
198 $max = isset($dependency['max']) ? $dependency['max'] : false;
199 $recommended = isset($dependency['recommended']) ?
200 $dependency['recommended'] : false;
201 if (isset($dependency['exclude'])) {
202 if (!isset($dependency['exclude'][0])) {
203 $exclude = array($dependency['exclude']);
208 $skippedphp = $found = $release = false;
209 if (!is_array($info['r']) || !isset($info['r'][0])) {
210 $info['r'] = array($info['r']);
213 foreach ($info['r'] as $release) {
214 if (!isset($this->_rest->_options['force']) && ($installed &&
215 version_compare($release['v'], $installed, '<'))) {
219 if (in_array($release['v'], $exclude)) { // skip excluded versions
223 // allow newer releases to say "I'm OK with the dependent package"
224 if ($xsdversion == '2.0' && isset($release['co'])) {
225 if (!is_array($release['co']) || !isset($release['co'][0])) {
226 $release['co'] = array($release['co']);
229 foreach ($release['co'] as $entry) {
230 if (isset($entry['x']) && !is_array($entry['x'])) {
231 $entry['x'] = array($entry['x']);
232 } elseif (!isset($entry['x'])) {
233 $entry['x'] = array();
236 if ($entry['c'] == $deppackage['channel'] &&
237 strtolower($entry['p']) == strtolower($deppackage['package']) &&
238 version_compare($deppackage['version'], $entry['min'], '>=') &&
239 version_compare($deppackage['version'], $entry['max'], '<=') &&
240 !in_array($release['v'], $entry['x'])) {
241 if (version_compare($release['m'], phpversion(), '>')) {
242 // skip dependency releases that require a PHP version
243 // newer than our PHP version
244 $skippedphp = $release;
248 $recommended = $release['v'];
255 if ($release['v'] != $recommended) { // if we want a specific
256 // version, then skip all others
260 if (!in_array($release['s'], $states)) {
261 // the stability is too low, but we must return the
262 // recommended version if possible
263 return $this->_returnDownloadURL($base, $package, $release, $info, true, false, $channel);
267 if ($min && version_compare($release['v'], $min, 'lt')) { // skip too old versions
271 if ($max && version_compare($release['v'], $max, 'gt')) { // skip too new versions
275 if ($installed && version_compare($release['v'], $installed, '<')) {
279 if (in_array($release['s'], $states)) { // if in the preferred state...
280 if (version_compare($release['m'], phpversion(), '>')) {
281 // skip dependency releases that require a PHP version
282 // newer than our PHP version
283 $skippedphp = $release;
287 $found = true; // ... then use it
292 if (!$found && $skippedphp) {
296 return $this->_returnDownloadURL($base, $package, $release, $info, $found, $skippedphp, $channel);
300 * List package upgrades but take the PHP version into account.
302 function listLatestUpgrades($base, $pref_state, $installed, $channel, &$reg)
304 $packagelist = $this->_rest->retrieveData($base . 'p/packages.xml', false, false, $channel);
305 if (PEAR::isError($packagelist)) {
310 if (!is_array($packagelist) || !isset($packagelist['p'])) {
314 if (!is_array($packagelist['p'])) {
315 $packagelist['p'] = array($packagelist['p']);
318 foreach ($packagelist['p'] as $package) {
319 if (!isset($installed[strtolower($package)])) {
323 $inst_version = $reg->packageInfo($package, 'version', $channel);
324 $inst_state = $reg->packageInfo($package, 'release_state', $channel);
325 PEAR::pushErrorHandling(PEAR_ERROR_RETURN);
326 $info = $this->_rest->retrieveData($base . 'r/' . strtolower($package) .
327 '/allreleases2.xml', false, false, $channel);
328 PEAR::popErrorHandling();
329 if (PEAR::isError($info)) {
330 continue; // no remote releases
333 if (!isset($info['r'])) {
337 $release = $found = false;
338 if (!is_array($info['r']) || !isset($info['r'][0])) {
339 $info['r'] = array($info['r']);
342 // $info['r'] is sorted by version number
343 usort($info['r'], array($this, '_sortReleasesByVersionNumber'));
344 foreach ($info['r'] as $release) {
345 if ($inst_version && version_compare($release['v'], $inst_version, '<=')) {
346 // not newer than the one installed
349 if (version_compare($release['m'], phpversion(), '>')) {
350 // skip dependency releases that require a PHP version
351 // newer than our PHP version
355 // new version > installed version
357 // every state is a good state
361 $new_state = $release['s'];
362 // if new state >= installed state: go
363 if (in_array($new_state, $this->betterStates($inst_state, true))) {
367 // only allow to lower the state of package,
368 // if new state >= preferred state: go
369 if (in_array($new_state, $this->betterStates($pref_state, true))) {
381 $relinfo = $this->_rest->retrieveCacheFirst($base . 'r/' . strtolower($package) . '/' .
382 $release['v'] . '.xml', false, false, $channel);
383 if (PEAR::isError($relinfo)) {
387 $ret[$package] = array(
388 'version' => $release['v'],
389 'state' => $release['s'],
390 'filesize' => $relinfo['f'],