Bearsampp 2026.9.23
Loading...
Searching...
No Matches
PEAR_REST_10 Class Reference
Inheritance diagram for PEAR_REST_10:

Public Member Functions

 __construct ($config, $options=array())
 _returnDownloadURL ($base, $package, $release, $info, $found, $phpversion=false, $channel=false)
 _sortReleasesByVersionNumber ($a, $b)
 betterStates ($state, $include=false)
 getDepDownloadURL ($base, $xsdversion, $dependency, $deppackage, $prefstate='stable', $installed=false, $channel=false)
 getDownloadURL ($base, $packageinfo, $prefstate, $installed, $channel=false)
 listAll ($base, $dostable, $basic=true, $searchpackage=false, $searchsummary=false, $channel=false)
 listCategories ($base, $channel=false)
 listCategory ($base, $category, $info=false, $channel=false)
 listLatestUpgrades ($base, $pref_state, $installed, $channel, &$reg)
 listPackages ($base, $channel=false)
 packageInfo ($base, $package, $channel=false)

Data Fields

 $_rest

Detailed Description

Definition at line 33 of file 10.php.

Constructor & Destructor Documentation

◆ __construct()

__construct ( $config,
$options = array() )

Definition at line 39 of file 10.php.

40 {
41 $this->_rest = new PEAR_REST($config, $options);
42 }
$options
$options
Definition pearcmd.php:145
$config
$config
Definition pearcmd.php:182

References $config, and $options.

Member Function Documentation

◆ _returnDownloadURL()

_returnDownloadURL ( $base,
$package,
$release,
$info,
$found,
$phpversion = false,
$channel = false )

Take raw data and return the array needed for processing a download URL

Parameters
string$baseREST base uri
string$packagePackage name
array$releasean array of format array('v' => version, 's' => state) describing the release to download
array$infolist of all releases as defined by allreleases.xml
bool | null$founddetermines whether the release was found or this is the next best alternative. If null, then versions were skipped because of PHP dependency
Returns
array|PEAR_Error @access private

Definition at line 259 of file 10.php.

260 {
261 if (!$found) {
262 $release = $info['r'][0];
263 }
264
265 $packageLower = strtolower($package);
266 $pinfo = $this->_rest->retrieveCacheFirst($base . 'p/' . $packageLower . '/' .
267 'info.xml', false, false, $channel);
268 if (PEAR::isError($pinfo)) {
269 return PEAR::raiseError('Package "' . $package .
270 '" does not have REST info xml available');
271 }
272
273 $releaseinfo = $this->_rest->retrieveCacheFirst($base . 'r/' . $packageLower . '/' .
274 $release['v'] . '.xml', false, false, $channel);
275 if (PEAR::isError($releaseinfo)) {
276 return PEAR::raiseError('Package "' . $package . '" Version "' . $release['v'] .
277 '" does not have REST xml available');
278 }
279
280 $packagexml = $this->_rest->retrieveCacheFirst($base . 'r/' . $packageLower . '/' .
281 'deps.' . $release['v'] . '.txt', false, true, $channel);
282 if (PEAR::isError($packagexml)) {
283 return PEAR::raiseError('Package "' . $package . '" Version "' . $release['v'] .
284 '" does not have REST dependency information available');
285 }
286
287 $packagexml = unserialize($packagexml);
288 if (!$packagexml) {
289 $packagexml = array();
290 }
291
292 $allinfo = $this->_rest->retrieveData($base . 'r/' . $packageLower .
293 '/allreleases.xml', false, false, $channel);
294 if (PEAR::isError($allinfo)) {
295 return $allinfo;
296 }
297
298 if (!is_array($allinfo['r']) || !isset($allinfo['r'][0])) {
299 $allinfo['r'] = array($allinfo['r']);
300 }
301
302 $compatible = false;
303 foreach ($allinfo['r'] as $release) {
304 if ($release['v'] != $releaseinfo['v']) {
305 continue;
306 }
307
308 if (!isset($release['co'])) {
309 break;
310 }
311
312 $compatible = array();
313 if (!is_array($release['co']) || !isset($release['co'][0])) {
314 $release['co'] = array($release['co']);
315 }
316
317 foreach ($release['co'] as $entry) {
318 $comp = array();
319 $comp['name'] = $entry['p'];
320 $comp['channel'] = $entry['c'];
321 $comp['min'] = $entry['min'];
322 $comp['max'] = $entry['max'];
323 if (isset($entry['x']) && !is_array($entry['x'])) {
324 $comp['exclude'] = $entry['x'];
325 }
326
327 $compatible[] = $comp;
328 }
329
330 if (count($compatible) == 1) {
331 $compatible = $compatible[0];
332 }
333
334 break;
335 }
336
337 $deprecated = false;
338 if (isset($pinfo['dc']) && isset($pinfo['dp'])) {
339 if (is_array($pinfo['dp'])) {
340 $deprecated = array('channel' => (string) $pinfo['dc'],
341 'package' => trim($pinfo['dp']['_content']));
342 } else {
343 $deprecated = array('channel' => (string) $pinfo['dc'],
344 'package' => trim($pinfo['dp']));
345 }
346 }
347
348 $return = array(
349 'version' => $releaseinfo['v'],
350 'info' => $packagexml,
351 'package' => $releaseinfo['p']['_content'],
352 'stability' => $releaseinfo['st'],
353 'compatible' => $compatible,
354 'deprecated' => $deprecated,
355 );
356
357 if ($found) {
358 $return['url'] = $releaseinfo['g'];
359 return $return;
360 }
361
362 $return['php'] = $phpversion;
363 return $return;
364 }

Referenced by getDepDownloadURL(), PEAR_REST_13\getDepDownloadURL(), getDownloadURL(), and PEAR_REST_13\getDownloadURL().

Here is the caller graph for this function:

◆ _sortReleasesByVersionNumber()

_sortReleasesByVersionNumber ( $a,
$b )

Sort releases by version number

@access private

Definition at line 856 of file 10.php.

857 {
858 if (version_compare($a['v'], $b['v'], '=')) {
859 return 0;
860 }
861
862 if (version_compare($a['v'], $b['v'], '>')) {
863 return -1;
864 }
865
866 if (version_compare($a['v'], $b['v'], '<')) {
867 return 1;
868 }
869 }

◆ betterStates()

betterStates ( $state,
$include = false )

Return an array containing all of the states that are more stable than or equal to the passed in state

Parameters
stringRelease state
booleanDetermines whether to include $state in the list
Returns
false|array False if $state is not a valid release state

Definition at line 836 of file 10.php.

837 {
838 static $states = array('snapshot', 'devel', 'alpha', 'beta', 'stable');
839 $i = array_search($state, $states);
840 if ($i === false) {
841 return false;
842 }
843
844 if ($include) {
845 $i--;
846 }
847
848 return array_slice($states, $i + 1);
849 }

Referenced by getDepDownloadURL(), PEAR_REST_13\getDepDownloadURL(), getDownloadURL(), PEAR_REST_13\getDownloadURL(), listLatestUpgrades(), and PEAR_REST_13\listLatestUpgrades().

Here is the caller graph for this function:

◆ getDepDownloadURL()

getDepDownloadURL ( $base,
$xsdversion,
$dependency,
$deppackage,
$prefstate = 'stable',
$installed = false,
$channel = false )

Reimplemented in PEAR_REST_13.

Definition at line 123 of file 10.php.

125 {
126 $states = $this->betterStates($prefstate, true);
127 if (!$states) {
128 return PEAR::raiseError('"' . $prefstate . '" is not a valid state');
129 }
130
131 $channel = $dependency['channel'];
132 $package = $dependency['name'];
133 $state = isset($dependency['state']) ? $dependency['state'] : null;
134 $version = isset($dependency['version']) ? $dependency['version'] : null;
135 $restFile = $base . 'r/' . strtolower($package) . '/allreleases.xml';
136
137 $info = $this->_rest->retrieveData($restFile, false, false, $channel);
138 if (PEAR::isError($info)) {
139 return PEAR::raiseError('Package "' . $deppackage['channel'] . '/' . $deppackage['package']
140 . '" dependency "' . $channel . '/' . $package . '" has no releases');
141 }
142
143 if (!is_array($info) || !isset($info['r'])) {
144 return false;
145 }
146
147 $exclude = array();
148 $min = $max = $recommended = false;
149 if ($xsdversion == '1.0') {
150 switch ($dependency['rel']) {
151 case 'ge' :
152 $min = $dependency['version'];
153 break;
154 case 'gt' :
155 $min = $dependency['version'];
156 $exclude = array($dependency['version']);
157 break;
158 case 'eq' :
159 $recommended = $dependency['version'];
160 break;
161 case 'lt' :
162 $max = $dependency['version'];
163 $exclude = array($dependency['version']);
164 break;
165 case 'le' :
166 $max = $dependency['version'];
167 break;
168 case 'ne' :
169 $exclude = array($dependency['version']);
170 break;
171 }
172 } else {
173 $min = isset($dependency['min']) ? $dependency['min'] : false;
174 $max = isset($dependency['max']) ? $dependency['max'] : false;
175 $recommended = isset($dependency['recommended']) ?
176 $dependency['recommended'] : false;
177 if (isset($dependency['exclude'])) {
178 if (!isset($dependency['exclude'][0])) {
179 $exclude = array($dependency['exclude']);
180 }
181 }
182 }
183 $release = $found = false;
184 if (!is_array($info['r']) || !isset($info['r'][0])) {
185 $info['r'] = array($info['r']);
186 }
187 foreach ($info['r'] as $release) {
188 if (!isset($this->_rest->_options['force']) && ($installed &&
189 version_compare($release['v'], $installed, '<'))) {
190 continue;
191 }
192 if (in_array($release['v'], $exclude)) { // skip excluded versions
193 continue;
194 }
195 // allow newer releases to say "I'm OK with the dependent package"
196 if ($xsdversion == '2.0' && isset($release['co'])) {
197 if (!is_array($release['co']) || !isset($release['co'][0])) {
198 $release['co'] = array($release['co']);
199 }
200 foreach ($release['co'] as $entry) {
201 if (isset($entry['x']) && !is_array($entry['x'])) {
202 $entry['x'] = array($entry['x']);
203 } elseif (!isset($entry['x'])) {
204 $entry['x'] = array();
205 }
206 if ($entry['c'] == $deppackage['channel'] &&
207 strtolower($entry['p']) == strtolower($deppackage['package']) &&
208 version_compare($deppackage['version'], $entry['min'], '>=') &&
209 version_compare($deppackage['version'], $entry['max'], '<=') &&
210 !in_array($release['v'], $entry['x'])) {
211 $recommended = $release['v'];
212 break;
213 }
214 }
215 }
216 if ($recommended) {
217 if ($release['v'] != $recommended) { // if we want a specific
218 // version, then skip all others
219 continue;
220 } else {
221 if (!in_array($release['s'], $states)) {
222 // the stability is too low, but we must return the
223 // recommended version if possible
224 return $this->_returnDownloadURL($base, $package, $release, $info, true, false, $channel);
225 }
226 }
227 }
228 if ($min && version_compare($release['v'], $min, 'lt')) { // skip too old versions
229 continue;
230 }
231 if ($max && version_compare($release['v'], $max, 'gt')) { // skip too new versions
232 continue;
233 }
234 if ($installed && version_compare($release['v'], $installed, '<')) {
235 continue;
236 }
237 if (in_array($release['s'], $states)) { // if in the preferred state...
238 $found = true; // ... then use it
239 break;
240 }
241 }
242 return $this->_returnDownloadURL($base, $package, $release, $info, $found, false, $channel);
243 }
PEAR_REST_10\betterStates
betterStates($state, $include=false)
Definition 10.php:836
PEAR_REST_10\_returnDownloadURL
_returnDownloadURL($base, $package, $release, $info, $found, $phpversion=false, $channel=false)
Definition 10.php:259

References _returnDownloadURL(), and betterStates().

Here is the call graph for this function:

◆ getDownloadURL()

getDownloadURL ( $base,
$packageinfo,
$prefstate,
$installed,
$channel = false )

Retrieve information about a remote package to be downloaded from a REST server

Parameters
string$baseThe uri to prepend to all REST calls
array$packageinfoan array of format: 
 array(
  'package' => 'packagename',
  'channel' => 'channelname',
 ['state' => 'alpha' (or valid state),]
 -or-
 ['version' => '1.whatever']
string$prefstateCurrent preferred_state config variable value
bool$installedthe installed version of this package to compare against
Returns
array|false|PEAR_Error see _returnDownloadURL()

Reimplemented in PEAR_REST_13.

Definition at line 61 of file 10.php.

62 {
63 $states = $this->betterStates($prefstate, true);
64 if (!$states) {
65 return PEAR::raiseError('"' . $prefstate . '" is not a valid state');
66 }
67
68 $channel = $packageinfo['channel'];
69 $package = $packageinfo['package'];
70 $state = isset($packageinfo['state']) ? $packageinfo['state'] : null;
71 $version = isset($packageinfo['version']) ? $packageinfo['version'] : null;
72 $restFile = $base . 'r/' . strtolower($package) . '/allreleases.xml';
73
74 $info = $this->_rest->retrieveData($restFile, false, false, $channel);
75 if (PEAR::isError($info)) {
76 return PEAR::raiseError('No releases available for package "' .
77 $channel . '/' . $package . '"');
78 }
79
80 if (!isset($info['r'])) {
81 return false;
82 }
83
84 $release = $found = false;
85 if (!is_array($info['r']) || !isset($info['r'][0])) {
86 $info['r'] = array($info['r']);
87 }
88
89 foreach ($info['r'] as $release) {
90 if (!isset($this->_rest->_options['force']) && ($installed &&
91 version_compare($release['v'], $installed, '<'))) {
92 continue;
93 }
94
95 if (isset($state)) {
96 // try our preferred state first
97 if ($release['s'] == $state) {
98 $found = true;
99 break;
100 }
101 // see if there is something newer and more stable
102 // bug #7221
103 if (in_array($release['s'], $this->betterStates($state), true)) {
104 $found = true;
105 break;
106 }
107 } elseif (isset($version)) {
108 if ($release['v'] == $version) {
109 $found = true;
110 break;
111 }
112 } else {
113 if (in_array($release['s'], $states)) {
114 $found = true;
115 break;
116 }
117 }
118 }
119
120 return $this->_returnDownloadURL($base, $package, $release, $info, $found, false, $channel);
121 }

References _returnDownloadURL(), and betterStates().

Here is the call graph for this function:

◆ listAll()

listAll ( $base,
$dostable,
$basic = true,
$searchpackage = false,
$searchsummary = false,
$channel = false )

Definition at line 482 of file 10.php.

483 {
484 $packagelist = $this->_rest->retrieveData($base . 'p/packages.xml', false, false, $channel);
485 if (PEAR::isError($packagelist)) {
486 return $packagelist;
487 }
488 if ($this->_rest->config->get('verbose') > 0) {
489 $ui = &PEAR_Frontend::singleton();
490 $ui->log('Retrieving data...0%', true);
491 }
492 $ret = array();
493 if (!is_array($packagelist) || !isset($packagelist['p'])) {
494 return $ret;
495 }
496 if (!is_array($packagelist['p'])) {
497 $packagelist['p'] = array($packagelist['p']);
498 }
499
500 // only search-packagename = quicksearch !
501 if ($searchpackage && (!$searchsummary || empty($searchpackage))) {
502 $newpackagelist = array();
503 foreach ($packagelist['p'] as $package) {
504 if (!empty($searchpackage) && stristr($package, $searchpackage) !== false) {
505 $newpackagelist[] = $package;
506 }
507 }
508 $packagelist['p'] = $newpackagelist;
509 }
510 PEAR::pushErrorHandling(PEAR_ERROR_RETURN);
511 $next = .1;
512 foreach ($packagelist['p'] as $progress => $package) {
513 if ($this->_rest->config->get('verbose') > 0) {
514 if ($progress / count($packagelist['p']) >= $next) {
515 if ($next == .5) {
516 $ui->log('50%', false);
517 } else {
518 $ui->log('.', false);
519 }
520 $next += .1;
521 }
522 }
523
524 if ($basic) { // remote-list command
525 if ($dostable) {
526 $latest = $this->_rest->retrieveData($base . 'r/' . strtolower($package) .
527 '/stable.txt', false, false, $channel);
528 } else {
529 $latest = $this->_rest->retrieveData($base . 'r/' . strtolower($package) .
530 '/latest.txt', false, false, $channel);
531 }
532 if (PEAR::isError($latest)) {
533 $latest = false;
534 }
535 $info = array('stable' => $latest);
536 } else { // list-all command
537 $inf = $this->_rest->retrieveData($base . 'p/' . strtolower($package) . '/info.xml', false, false, $channel);
538 if (PEAR::isError($inf)) {
539 PEAR::popErrorHandling();
540 return $inf;
541 }
542 if ($searchpackage) {
543 $found = (!empty($searchpackage) && stristr($package, $searchpackage) !== false);
544 if (!$found && !(isset($searchsummary) && !empty($searchsummary)
545 && (stristr($inf['s'], $searchsummary) !== false
546 || stristr($inf['d'], $searchsummary) !== false)))
547 {
548 continue;
549 };
550 }
551 $releases = $this->_rest->retrieveData($base . 'r/' . strtolower($package) .
552 '/allreleases.xml', false, false, $channel);
553 if (PEAR::isError($releases)) {
554 continue;
555 }
556 if (!isset($releases['r'][0])) {
557 $releases['r'] = array($releases['r']);
558 }
559 unset($latest);
560 unset($unstable);
561 unset($stable);
562 unset($state);
563 foreach ($releases['r'] as $release) {
564 if (!isset($latest)) {
565 if ($dostable && $release['s'] == 'stable') {
566 $latest = $release['v'];
567 $state = 'stable';
568 }
569 if (!$dostable) {
570 $latest = $release['v'];
571 $state = $release['s'];
572 }
573 }
574 if (!isset($stable) && $release['s'] == 'stable') {
575 $stable = $release['v'];
576 if (!isset($unstable)) {
577 $unstable = $stable;
578 }
579 }
580 if (!isset($unstable) && $release['s'] != 'stable') {
581 $latest = $unstable = $release['v'];
582 $state = $release['s'];
583 }
584 if (isset($latest) && !isset($state)) {
585 $state = $release['s'];
586 }
587 if (isset($latest) && isset($stable) && isset($unstable)) {
588 break;
589 }
590 }
591 $deps = array();
592 if (!isset($unstable)) {
593 $unstable = false;
594 $state = 'stable';
595 if (isset($stable)) {
596 $latest = $unstable = $stable;
597 }
598 } else {
599 $latest = $unstable;
600 }
601 if (!isset($latest)) {
602 $latest = false;
603 }
604 if ($latest) {
605 $d = $this->_rest->retrieveCacheFirst($base . 'r/' . strtolower($package) . '/deps.' .
606 $latest . '.txt', false, false, $channel);
607 if (!PEAR::isError($d)) {
608 $d = unserialize($d);
609 if ($d) {
610 if (isset($d['required'])) {
611 if (!class_exists('PEAR_PackageFile_v2')) {
612 require_once 'PEAR/PackageFile/v2.php';
613 }
614 if (!isset($pf)) {
615 $pf = new PEAR_PackageFile_v2;
616 }
617 $pf->setDeps($d);
618 $tdeps = $pf->getDeps();
619 } else {
620 $tdeps = $d;
621 }
622 foreach ($tdeps as $dep) {
623 if ($dep['type'] !== 'pkg') {
624 continue;
625 }
626 $deps[] = $dep;
627 }
628 }
629 }
630 }
631 if (!isset($stable)) {
632 $stable = '-n/a-';
633 }
634 if (!$searchpackage) {
635 $info = array('stable' => $latest, 'summary' => $inf['s'], 'description' =>
636 $inf['d'], 'deps' => $deps, 'category' => $inf['ca']['_content'],
637 'unstable' => $unstable, 'state' => $state);
638 } else {
639 $info = array('stable' => $stable, 'summary' => $inf['s'], 'description' =>
640 $inf['d'], 'deps' => $deps, 'category' => $inf['ca']['_content'],
641 'unstable' => $unstable, 'state' => $state);
642 }
643 }
644 $ret[$package] = $info;
645 }
646 PEAR::popErrorHandling();
647 return $ret;
648 }
PEAR_ERROR_RETURN
const PEAR_ERROR_RETURN
Definition PEAR.php:24
PEAR_Frontend\singleton
static & singleton($type=null)
Definition Frontend.php:51
$ui
$ui
Definition pearcmd.php:181

References $ui, PEAR_ERROR_RETURN, and PEAR_Frontend\singleton().

Here is the call graph for this function:

◆ listCategories()

listCategories ( $base,
$channel = false )

List all categories of a REST server

Parameters
string$basebase URL of the server
Returns
array of categorynames

Definition at line 390 of file 10.php.

391 {
392 $categories = array();
393
394 // c/categories.xml does not exist;
395 // check for every package its category manually
396 // This is SLOOOWWWW : ///
397 $packagelist = $this->_rest->retrieveData($base . 'p/packages.xml', false, false, $channel);
398 if (PEAR::isError($packagelist)) {
399 return $packagelist;
400 }
401
402 if (!is_array($packagelist) || !isset($packagelist['p'])) {
403 $ret = array();
404 return $ret;
405 }
406
407 if (!is_array($packagelist['p'])) {
408 $packagelist['p'] = array($packagelist['p']);
409 }
410
411 PEAR::pushErrorHandling(PEAR_ERROR_RETURN);
412 foreach ($packagelist['p'] as $package) {
413 $inf = $this->_rest->retrieveData($base . 'p/' . strtolower($package) . '/info.xml', false, false, $channel);
414 if (PEAR::isError($inf)) {
415 PEAR::popErrorHandling();
416 return $inf;
417 }
418 $cat = $inf['ca']['_content'];
419 if (!isset($categories[$cat])) {
420 $categories[$cat] = $inf['ca'];
421 }
422 }
423
424 return array_values($categories);
425 }

References PEAR_ERROR_RETURN.

◆ listCategory()

listCategory ( $base,
$category,
$info = false,
$channel = false )

List a category of a REST server

Parameters
string$basebase URL of the server
string$categoryname of the category
boolean$infoalso download full package info
Returns
array of packagenames

Definition at line 435 of file 10.php.

436 {
437 // gives '404 Not Found' error when category doesn't exist
438 $packagelist = $this->_rest->retrieveData($base.'c/'.urlencode($category).'/packages.xml', false, false, $channel);
439 if (PEAR::isError($packagelist)) {
440 return $packagelist;
441 }
442
443 if (!is_array($packagelist) || !isset($packagelist['p'])) {
444 return array();
445 }
446
447 if (!is_array($packagelist['p']) ||
448 !isset($packagelist['p'][0])) { // only 1 pkg
449 $packagelist = array($packagelist['p']);
450 } else {
451 $packagelist = $packagelist['p'];
452 }
453
454 if ($info == true) {
455 // get individual package info
456 PEAR::pushErrorHandling(PEAR_ERROR_RETURN);
457 foreach ($packagelist as $i => $packageitem) {
458 $url = sprintf('%s'.'r/%s/latest.txt',
459 $base,
460 strtolower($packageitem['_content']));
461 $version = $this->_rest->retrieveData($url, false, false, $channel);
462 if (PEAR::isError($version)) {
463 break; // skipit
464 }
465 $url = sprintf('%s'.'r/%s/%s.xml',
466 $base,
467 strtolower($packageitem['_content']),
468 $version);
469 $info = $this->_rest->retrieveData($url, false, false, $channel);
470 if (PEAR::isError($info)) {
471 break; // skipit
472 }
473 $packagelist[$i]['info'] = $info;
474 }
475 PEAR::popErrorHandling();
476 }
477
478 return $packagelist;
479 }

References PEAR_ERROR_RETURN.

◆ listLatestUpgrades()

listLatestUpgrades ( $base,
$pref_state,
$installed,
$channel,
& $reg )

Reimplemented in PEAR_REST_13.

Definition at line 650 of file 10.php.

651 {
652 $packagelist = $this->_rest->retrieveData($base . 'p/packages.xml', false, false, $channel);
653 if (PEAR::isError($packagelist)) {
654 return $packagelist;
655 }
656
657 $ret = array();
658 if (!is_array($packagelist) || !isset($packagelist['p'])) {
659 return $ret;
660 }
661
662 if (!is_array($packagelist['p'])) {
663 $packagelist['p'] = array($packagelist['p']);
664 }
665
666 foreach ($packagelist['p'] as $package) {
667 if (!isset($installed[strtolower($package)])) {
668 continue;
669 }
670
671 $inst_version = $reg->packageInfo($package, 'version', $channel);
672 $inst_state = $reg->packageInfo($package, 'release_state', $channel);
673 PEAR::pushErrorHandling(PEAR_ERROR_RETURN);
674 $info = $this->_rest->retrieveData($base . 'r/' . strtolower($package) .
675 '/allreleases.xml', false, false, $channel);
676 PEAR::popErrorHandling();
677 if (PEAR::isError($info)) {
678 continue; // no remote releases
679 }
680
681 if (!isset($info['r'])) {
682 continue;
683 }
684
685 $release = $found = false;
686 if (!is_array($info['r']) || !isset($info['r'][0])) {
687 $info['r'] = array($info['r']);
688 }
689
690 // $info['r'] is sorted by version number
691 usort($info['r'], array($this, '_sortReleasesByVersionNumber'));
692 foreach ($info['r'] as $release) {
693 if ($inst_version && version_compare($release['v'], $inst_version, '<=')) {
694 // not newer than the one installed
695 break;
696 }
697
698 // new version > installed version
699 if (!$pref_state) {
700 // every state is a good state
701 $found = true;
702 break;
703 } else {
704 $new_state = $release['s'];
705 // if new state >= installed state: go
706 if (in_array($new_state, $this->betterStates($inst_state, true))) {
707 $found = true;
708 break;
709 } else {
710 // only allow to lower the state of package,
711 // if new state >= preferred state: go
712 if (in_array($new_state, $this->betterStates($pref_state, true))) {
713 $found = true;
714 break;
715 }
716 }
717 }
718 }
719
720 if (!$found) {
721 continue;
722 }
723
724 $relinfo = $this->_rest->retrieveCacheFirst($base . 'r/' . strtolower($package) . '/' .
725 $release['v'] . '.xml', false, false, $channel);
726 if (PEAR::isError($relinfo)) {
727 return $relinfo;
728 }
729
730 $ret[$package] = array(
731 'version' => $release['v'],
732 'state' => $release['s'],
733 'filesize' => $relinfo['f'],
734 );
735 }
736
737 return $ret;
738 }

References betterStates(), and PEAR_ERROR_RETURN.

Here is the call graph for this function:

◆ listPackages()

listPackages ( $base,
$channel = false )

Definition at line 366 of file 10.php.

367 {
368 $packagelist = $this->_rest->retrieveData($base . 'p/packages.xml', false, false, $channel);
369 if (PEAR::isError($packagelist)) {
370 return $packagelist;
371 }
372
373 if (!is_array($packagelist) || !isset($packagelist['p'])) {
374 return array();
375 }
376
377 if (!is_array($packagelist['p'])) {
378 $packagelist['p'] = array($packagelist['p']);
379 }
380
381 return $packagelist['p'];
382 }

◆ packageInfo()

packageInfo ( $base,
$package,
$channel = false )

Definition at line 740 of file 10.php.

741 {
742 PEAR::pushErrorHandling(PEAR_ERROR_RETURN);
743 $pinfo = $this->_rest->retrieveData($base . 'p/' . strtolower($package) . '/info.xml', false, false, $channel);
744 if (PEAR::isError($pinfo)) {
745 PEAR::popErrorHandling();
746 return PEAR::raiseError('Unknown package: "' . $package . '" in channel "' . $channel . '"' . "\n". 'Debug: ' .
747 $pinfo->getMessage());
748 }
749
750 $releases = array();
751 $allreleases = $this->_rest->retrieveData($base . 'r/' . strtolower($package) .
752 '/allreleases.xml', false, false, $channel);
753 if (!PEAR::isError($allreleases)) {
754 if (!class_exists('PEAR_PackageFile_v2')) {
755 require_once 'PEAR/PackageFile/v2.php';
756 }
757
758 if (!is_array($allreleases['r']) || !isset($allreleases['r'][0])) {
759 $allreleases['r'] = array($allreleases['r']);
760 }
761
762 $pf = new PEAR_PackageFile_v2;
763 foreach ($allreleases['r'] as $release) {
764 $ds = $this->_rest->retrieveCacheFirst($base . 'r/' . strtolower($package) . '/deps.' .
765 $release['v'] . '.txt', false, false, $channel);
766 if (PEAR::isError($ds)) {
767 continue;
768 }
769
770 if (!isset($latest)) {
771 $latest = $release['v'];
772 }
773
774 $pf->setDeps(unserialize($ds));
775 $ds = $pf->getDeps();
776 $info = $this->_rest->retrieveCacheFirst($base . 'r/' . strtolower($package)
777 . '/' . $release['v'] . '.xml', false, false, $channel);
778
779 if (PEAR::isError($info)) {
780 continue;
781 }
782
783 $releases[$release['v']] = array(
784 'doneby' => $info['m'],
785 'license' => $info['l'],
786 'summary' => $info['s'],
787 'description' => $info['d'],
788 'releasedate' => $info['da'],
789 'releasenotes' => $info['n'],
790 'state' => $release['s'],
791 'deps' => $ds ? $ds : array(),
792 );
793 }
794 } else {
795 $latest = '';
796 }
797
798 PEAR::popErrorHandling();
799 if (isset($pinfo['dc']) && isset($pinfo['dp'])) {
800 if (is_array($pinfo['dp'])) {
801 $deprecated = array('channel' => (string) $pinfo['dc'],
802 'package' => trim($pinfo['dp']['_content']));
803 } else {
804 $deprecated = array('channel' => (string) $pinfo['dc'],
805 'package' => trim($pinfo['dp']));
806 }
807 } else {
808 $deprecated = false;
809 }
810
811 if (!isset($latest)) {
812 $latest = '';
813 }
814
815 return array(
816 'name' => $pinfo['n'],
817 'channel' => $pinfo['c'],
818 'category' => $pinfo['ca']['_content'],
819 'stable' => $latest,
820 'license' => $pinfo['l'],
821 'summary' => $pinfo['s'],
822 'description' => $pinfo['d'],
823 'releases' => $releases,
824 'deprecated' => $deprecated,
825 );
826 }

References PEAR_ERROR_RETURN.

Field Documentation

◆ $_rest

$_rest

Definition at line 38 of file 10.php.

The documentation for this class was generated from the following file:
  • E:/Bearsampp-development/sandbox/core/libs/php/pear/pear/PEAR/REST/10.php