Subversion Repositories Applications.gtt

Rev

Go to most recent revision | Details | Last modification | View Log | RSS feed

Rev Author Line No. Line
94 jpm 1
<?php
2
/**
3
 * PEAR_REST_10
4
 *
5
 * PHP versions 4 and 5
6
 *
7
 * LICENSE: This source file is subject to version 3.0 of the PHP license
8
 * that is available through the world-wide-web at the following URI:
9
 * http://www.php.net/license/3_0.txt.  If you did not receive a copy of
10
 * the PHP License and are unable to obtain it through the web, please
11
 * send a note to license@php.net so we can mail you a copy immediately.
12
 *
13
 * @category   pear
14
 * @package    PEAR
15
 * @author     Greg Beaver <cellog@php.net>
16
 * @copyright  1997-2006 The PHP Group
17
 * @license    http://www.php.net/license/3_0.txt  PHP License 3.0
18
 * @version    CVS: $Id: 10.php,v 1.43 2006/11/01 05:09:05 cellog Exp $
19
 * @link       http://pear.php.net/package/PEAR
20
 * @since      File available since Release 1.4.0a12
21
 */
22
 
23
/**
24
 * For downloading REST xml/txt files
25
 */
26
require_once 'PEAR/REST.php';
27
 
28
/**
29
 * Implement REST 1.0
30
 *
31
 * @category   pear
32
 * @package    PEAR
33
 * @author     Greg Beaver <cellog@php.net>
34
 * @copyright  1997-2006 The PHP Group
35
 * @license    http://www.php.net/license/3_0.txt  PHP License 3.0
36
 * @version    Release: 1.5.1
37
 * @link       http://pear.php.net/package/PEAR
38
 * @since      Class available since Release 1.4.0a12
39
 */
40
class PEAR_REST_10
41
{
42
    /**
43
     * @var PEAR_REST
44
     */
45
    var $_rest;
46
    function PEAR_REST_10($config, $options = array())
47
    {
48
        $this->_rest = &new PEAR_REST($config, $options);
49
    }
50
 
51
    /**
52
     * Retrieve information about a remote package to be downloaded from a REST server
53
     *
54
     * @param string $base The uri to prepend to all REST calls
55
     * @param array $packageinfo an array of format:
56
     * <pre>
57
     *  array(
58
     *   'package' => 'packagename',
59
     *   'channel' => 'channelname',
60
     *  ['state' => 'alpha' (or valid state),]
61
     *  -or-
62
     *  ['version' => '1.whatever']
63
     * </pre>
64
     * @param string $prefstate Current preferred_state config variable value
65
     * @param bool $installed the installed version of this package to compare against
66
     * @return array|false|PEAR_Error see {@link _returnDownloadURL()}
67
     */
68
    function getDownloadURL($base, $packageinfo, $prefstate, $installed)
69
    {
70
        $channel = $packageinfo['channel'];
71
        $package = $packageinfo['package'];
72
        $states = $this->betterStates($prefstate, true);
73
        if (!$states) {
74
            return PEAR::raiseError('"' . $prefstate . '" is not a valid state');
75
        }
76
        $state = $version = null;
77
        if (isset($packageinfo['state'])) {
78
            $state = $packageinfo['state'];
79
        }
80
        if (isset($packageinfo['version'])) {
81
            $version = $packageinfo['version'];
82
        }
83
        $info = $this->_rest->retrieveData($base . 'r/' . strtolower($package) . '/allreleases.xml');
84
        if (PEAR::isError($info)) {
85
            return PEAR::raiseError('No releases available for package "' .
86
                $channel . '/' . $package . '"');
87
        }
88
        if (!isset($info['r'])) {
89
            return false;
90
        }
91
        $found = false;
92
        $release = false;
93
        if (!is_array($info['r']) || !isset($info['r'][0])) {
94
            $info['r'] = array($info['r']);
95
        }
96
        foreach ($info['r'] as $release) {
97
            if (!isset($this->_rest->_options['force']) && ($installed &&
98
                  version_compare($release['v'], $installed, '<'))) {
99
                continue;
100
            }
101
            if (isset($state)) {
102
                // try our preferred state first
103
                if ($release['s'] == $state) {
104
                    $found = true;
105
                    break;
106
                }
107
                // see if there is something newer and more stable
108
                // bug #7221
109
                if (in_array($release['s'], $this->betterStates($state), true)) {
110
                    $found = true;
111
                    break;
112
                }
113
            } elseif (isset($version)) {
114
                if ($release['v'] == $version) {
115
                    $found = true;
116
                    break;
117
                }
118
            } else {
119
                if (in_array($release['s'], $states)) {
120
                    $found = true;
121
                    break;
122
                }
123
            }
124
        }
125
        return $this->_returnDownloadURL($base, $package, $release, $info, $found);
126
    }
127
 
128
    function getDepDownloadURL($base, $xsdversion, $dependency, $deppackage,
129
                               $prefstate = 'stable', $installed = false)
130
    {
131
        $channel = $dependency['channel'];
132
        $package = $dependency['name'];
133
        $states = $this->betterStates($prefstate, true);
134
        if (!$states) {
135
            return PEAR::raiseError('"' . $prefstate . '" is not a valid state');
136
        }
137
        $state = $version = null;
138
        if (isset($packageinfo['state'])) {
139
            $state = $packageinfo['state'];
140
        }
141
        if (isset($packageinfo['version'])) {
142
            $version = $packageinfo['version'];
143
        }
144
        $info = $this->_rest->retrieveData($base . 'r/' . strtolower($package) . '/allreleases.xml');
145
        if (PEAR::isError($info)) {
146
            return PEAR::raiseError('Package "' . $deppackage['channel'] . '/' . $deppackage['package']
147
                . '" dependency "' . $channel . '/' . $package . '" has no releases');
148
        }
149
        if (!is_array($info) || !isset($info['r'])) {
150
            return false;
151
        }
152
        $exclude = array();
153
        $min = $max = $recommended = false;
154
        if ($xsdversion == '1.0') {
155
            $pinfo['package'] = $dependency['name'];
156
            $pinfo['channel'] = 'pear.php.net'; // this is always true - don't change this
157
            switch ($dependency['rel']) {
158
                case 'ge' :
159
                    $min = $dependency['version'];
160
                break;
161
                case 'gt' :
162
                    $min = $dependency['version'];
163
                    $exclude = array($dependency['version']);
164
                break;
165
                case 'eq' :
166
                    $recommended = $dependency['version'];
167
                break;
168
                case 'lt' :
169
                    $max = $dependency['version'];
170
                    $exclude = array($dependency['version']);
171
                break;
172
                case 'le' :
173
                    $max = $dependency['version'];
174
                break;
175
                case 'ne' :
176
                    $exclude = array($dependency['version']);
177
                break;
178
            }
179
        } else {
180
            $pinfo['package'] = $dependency['name'];
181
            $min = isset($dependency['min']) ? $dependency['min'] : false;
182
            $max = isset($dependency['max']) ? $dependency['max'] : false;
183
            $recommended = isset($dependency['recommended']) ?
184
                $dependency['recommended'] : false;
185
            if (isset($dependency['exclude'])) {
186
                if (!isset($dependency['exclude'][0])) {
187
                    $exclude = array($dependency['exclude']);
188
                }
189
            }
190
        }
191
        $found = false;
192
        $release = false;
193
        if (!is_array($info['r']) || !isset($info['r'][0])) {
194
            $info['r'] = array($info['r']);
195
        }
196
        foreach ($info['r'] as $release) {
197
            if (!isset($this->_rest->_options['force']) && ($installed &&
198
                  version_compare($release['v'], $installed, '<'))) {
199
                continue;
200
            }
201
            if (in_array($release['v'], $exclude)) { // skip excluded versions
202
                continue;
203
            }
204
            // allow newer releases to say "I'm OK with the dependent package"
205
            if ($xsdversion == '2.0' && isset($release['co'])) {
206
                if (!is_array($release['co']) || !isset($release['co'][0])) {
207
                    $release['co'] = array($release['co']);
208
                }
209
                foreach ($release['co'] as $entry) {
210
                    if (isset($entry['x']) && !is_array($entry['x'])) {
211
                        $entry['x'] = array($entry['x']);
212
                    } elseif (!isset($entry['x'])) {
213
                        $entry['x'] = array();
214
                    }
215
                    if ($entry['c'] == $deppackage['channel'] &&
216
                          strtolower($entry['p']) == strtolower($deppackage['package']) &&
217
                          version_compare($deppackage['version'], $entry['min'], '>=') &&
218
                          version_compare($deppackage['version'], $entry['max'], '<=') &&
219
                          !in_array($release['v'], $entry['x'])) {
220
                        $recommended = $release['v'];
221
                        break;
222
                    }
223
                }
224
            }
225
            if ($recommended) {
226
                if ($release['v'] != $recommended) { // if we want a specific
227
                    // version, then skip all others
228
                    continue;
229
                } else {
230
                    if (!in_array($release['s'], $states)) {
231
                        // the stability is too low, but we must return the
232
                        // recommended version if possible
233
                        return $this->_returnDownloadURL($base, $package, $release, $info, true);
234
                    }
235
                }
236
            }
237
            if ($min && version_compare($release['v'], $min, 'lt')) { // skip too old versions
238
                continue;
239
            }
240
            if ($max && version_compare($release['v'], $max, 'gt')) { // skip too new versions
241
                continue;
242
            }
243
            if ($installed && version_compare($release['v'], $installed, '<')) {
244
                continue;
245
            }
246
            if (in_array($release['s'], $states)) { // if in the preferred state...
247
                $found = true; // ... then use it
248
                break;
249
            }
250
        }
251
        return $this->_returnDownloadURL($base, $package, $release, $info, $found);
252
    }
253
 
254
    /**
255
     * Take raw data and return the array needed for processing a download URL
256
     *
257
     * @param string $base REST base uri
258
     * @param string $package Package name
259
     * @param array $release an array of format array('v' => version, 's' => state)
260
     *                       describing the release to download
261
     * @param array $info list of all releases as defined by allreleases.xml
262
     * @param bool $found determines whether the release was found or this is the next
263
     *                    best alternative
264
     * @return array|PEAR_Error
265
     * @access private
266
     */
267
    function _returnDownloadURL($base, $package, $release, $info, $found)
268
    {
269
        if (!$found) {
270
            $release = $info['r'][0];
271
        }
272
        $pinfo = $this->_rest->retrieveCacheFirst($base . 'p/' . strtolower($package) . '/' .
273
            'info.xml');
274
        if (PEAR::isError($pinfo)) {
275
            return PEAR::raiseError('Package "' . $package .
276
                '" does not have REST info xml available');
277
        }
278
        $releaseinfo = $this->_rest->retrieveCacheFirst($base . 'r/' . strtolower($package) . '/' .
279
            $release['v'] . '.xml');
280
        if (PEAR::isError($releaseinfo)) {
281
            return PEAR::raiseError('Package "' . $package . '" Version "' . $release['v'] .
282
                '" does not have REST xml available');
283
        }
284
        $packagexml = $this->_rest->retrieveCacheFirst($base . 'r/' . strtolower($package) . '/' .
285
            'deps.' . $release['v'] . '.txt', false, true);
286
        if (PEAR::isError($packagexml)) {
287
            return PEAR::raiseError('Package "' . $package . '" Version "' . $release['v'] .
288
                '" does not have REST dependency information available');
289
        }
290
        $packagexml = unserialize($packagexml);
291
        if (!$packagexml) {
292
            $packagexml = array();
293
        }
294
        $allinfo = $this->_rest->retrieveData($base . 'r/' . strtolower($package) .
295
            '/allreleases.xml');
296
        if (!is_array($allinfo['r']) || !isset($allinfo['r'][0])) {
297
            $allinfo['r'] = array($allinfo['r']);
298
        }
299
        $compatible = false;
300
        foreach ($allinfo['r'] as $release) {
301
            if ($release['v'] != $releaseinfo['v']) {
302
                continue;
303
            }
304
            if (!isset($release['co'])) {
305
                break;
306
            }
307
            $compatible = array();
308
            if (!is_array($release['co']) || !isset($release['co'][0])) {
309
                $release['co'] = array($release['co']);
310
            }
311
            foreach ($release['co'] as $entry) {
312
                $comp = array();
313
                $comp['name'] = $entry['p'];
314
                $comp['channel'] = $entry['c'];
315
                $comp['min'] = $entry['min'];
316
                $comp['max'] = $entry['max'];
317
                if (isset($entry['x']) && !is_array($entry['x'])) {
318
                    $comp['exclude'] = $entry['x'];
319
                }
320
                $compatible[] = $comp;
321
            }
322
            if (count($compatible) == 1) {
323
                $compatible = $compatible[0];
324
            }
325
            break;
326
        }
327
        if (isset($pinfo['dc']) && isset($pinfo['dp'])) {
328
            $deprecated = array('channel' => (string) $pinfo['dc'],
329
                                'package' => trim($pinfo['dp']['_content']));
330
        } else {
331
            $deprecated = false;
332
        }
333
        if ($found) {
334
            return
335
                array('version' => $releaseinfo['v'],
336
                      'info' => $packagexml,
337
                      'package' => $releaseinfo['p']['_content'],
338
                      'stability' => $releaseinfo['st'],
339
                      'url' => $releaseinfo['g'],
340
                      'compatible' => $compatible,
341
                      'deprecated' => $deprecated,
342
                );
343
        } else {
344
            return
345
                array('version' => $releaseinfo['v'],
346
                      'package' => $releaseinfo['p']['_content'],
347
                      'stability' => $releaseinfo['st'],
348
                      'info' => $packagexml,
349
                      'compatible' => $compatible,
350
                      'deprecated' => $deprecated,
351
                );
352
        }
353
    }
354
 
355
    function listPackages($base)
356
    {
357
        $packagelist = $this->_rest->retrieveData($base . 'p/packages.xml');
358
        if (PEAR::isError($packagelist)) {
359
            return $packagelist;
360
        }
361
        if (!is_array($packagelist) || !isset($packagelist['p'])) {
362
            return array();
363
        }
364
        if (!is_array($packagelist['p'])) {
365
            $packagelist['p'] = array($packagelist['p']);
366
        }
367
        return $packagelist['p'];
368
    }
369
 
370
    function listAll($base, $dostable, $basic = true, $searchpackage = false, $searchsummary = false)
371
    {
372
        $packagelist = $this->_rest->retrieveData($base . 'p/packages.xml');
373
        if (PEAR::isError($packagelist)) {
374
            return $packagelist;
375
        }
376
        if ($this->_rest->config->get('verbose') > 0) {
377
            $ui = &PEAR_Frontend::singleton();
378
            $ui->log('Retrieving data...0%', false);
379
        }
380
        $ret = array();
381
        if (!is_array($packagelist) || !isset($packagelist['p'])) {
382
            return $ret;
383
        }
384
        if (!is_array($packagelist['p'])) {
385
            $packagelist['p'] = array($packagelist['p']);
386
        }
387
        PEAR::pushErrorHandling(PEAR_ERROR_RETURN);
388
        $next = .1;
389
        foreach ($packagelist['p'] as $progress => $package) {
390
            if ($this->_rest->config->get('verbose') > 0) {
391
                if ($progress / count($packagelist['p']) >= $next) {
392
                    if ($next == .5) {
393
                        $ui->log('50%', false);
394
                    } else {
395
                        $ui->log('.', false);
396
                    }
397
                    $next += .1;
398
                }
399
            }
400
            if ($basic) { // remote-list command
401
                if ($dostable) {
402
                    $latest = $this->_rest->retrieveData($base . 'r/' . strtolower($package) .
403
                        '/stable.txt');
404
                } else {
405
                    $latest = $this->_rest->retrieveData($base . 'r/' . strtolower($package) .
406
                        '/latest.txt');
407
                }
408
                if (PEAR::isError($latest)) {
409
                    $latest = false;
410
                }
411
                $info = array('stable' => $latest);
412
            } else { // list-all command
413
                $inf = $this->_rest->retrieveData($base . 'p/' . strtolower($package) . '/info.xml');
414
                if (PEAR::isError($inf)) {
415
                    PEAR::popErrorHandling();
416
                    return $inf;
417
                }
418
                if ($searchpackage) {
419
                    $found = (!empty($searchpackage) && stristr($package, $searchpackage) !== false);
420
                    if (!$found && !(isset($searchsummary) && !empty($searchsummary)
421
                        && (stristr($inf['s'], $searchsummary) !== false
422
                            || stristr($inf['d'], $searchsummary) !== false)))
423
                    {
424
                        continue;
425
                    };
426
                }
427
                $releases = $this->_rest->retrieveData($base . 'r/' . strtolower($package) .
428
                    '/allreleases.xml');
429
                if (PEAR::isError($releases)) {
430
                    continue;
431
                }
432
                if (!isset($releases['r'][0])) {
433
                    $releases['r'] = array($releases['r']);
434
                }
435
                unset($latest);
436
                unset($unstable);
437
                unset($stable);
438
                unset($state);
439
                foreach ($releases['r'] as $release) {
440
                    if (!isset($latest)) {
441
                        if ($dostable && $release['s'] == 'stable') {
442
                            $latest = $release['v'];
443
                            $state = 'stable';
444
                        }
445
                        if (!$dostable) {
446
                            $latest = $release['v'];
447
                            $state = $release['s'];
448
                        }
449
                    }
450
                    if (!isset($stable) && $release['s'] == 'stable') {
451
                        $stable = $release['v'];
452
                        if (!isset($unstable)) {
453
                            $unstable = $stable;
454
                        }
455
                    }
456
                    if (!isset($unstable) && $release['s'] != 'stable') {
457
                        $latest = $unstable = $release['v'];
458
                        $state = $release['s'];
459
                    }
460
                    if (isset($latest) && !isset($state)) {
461
                        $state = $release['s'];
462
                    }
463
                    if (isset($latest) && isset($stable) && isset($unstable)) {
464
                        break;
465
                    }
466
                }
467
                $deps = array();
468
                if (!isset($unstable)) {
469
                    $unstable = false;
470
                    $state = 'stable';
471
                    if (isset($stable)) {
472
                        $latest = $unstable = $stable;
473
                    }
474
                } else {
475
                    $latest = $unstable;
476
                }
477
                if (!isset($latest)) {
478
                    $latest = false;
479
                }
480
                if ($latest) {
481
                    $d = $this->_rest->retrieveCacheFirst($base . 'r/' . strtolower($package) . '/deps.' .
482
                        $latest . '.txt');
483
                    if (!PEAR::isError($d)) {
484
                        $d = unserialize($d);
485
                        if ($d) {
486
                            if (isset($d['required'])) {
487
                                if (!class_exists('PEAR_PackageFile_v2')) {
488
                                    require_once 'PEAR/PackageFile/v2.php';
489
                                }
490
                                if (!isset($pf)) {
491
                                    $pf = new PEAR_PackageFile_v2;
492
                                }
493
                                $pf->setDeps($d);
494
                                $tdeps = $pf->getDeps();
495
                            } else {
496
                                $tdeps = $d;
497
                            }
498
                            foreach ($tdeps as $dep) {
499
                                if ($dep['type'] !== 'pkg') {
500
                                    continue;
501
                                }
502
                                $deps[] = $dep;
503
                            }
504
                        }
505
                    }
506
                }
507
                if (!isset($stable)) {
508
                    $stable = '-n/a-';
509
                }
510
                if (!$searchpackage) {
511
                    $info = array('stable' => $latest, 'summary' => $inf['s'], 'description' =>
512
                        $inf['d'], 'deps' => $deps, 'category' => $inf['ca']['_content'],
513
                        'unstable' => $unstable, 'state' => $state);
514
                } else {
515
                    $info = array('stable' => $stable, 'summary' => $inf['s'], 'description' =>
516
                        $inf['d'], 'deps' => $deps, 'category' => $inf['ca']['_content'],
517
                        'unstable' => $unstable, 'state' => $state);
518
                }
519
            }
520
            $ret[$package] = $info;
521
        }
522
        PEAR::popErrorHandling();
523
        return $ret;
524
    }
525
 
526
    function listLatestUpgrades($base, $state, $installed, $channel, &$reg)
527
    {
528
        $packagelist = $this->_rest->retrieveData($base . 'p/packages.xml');
529
        if (PEAR::isError($packagelist)) {
530
            return $packagelist;
531
        }
532
        $ret = array();
533
        if (!is_array($packagelist) || !isset($packagelist['p'])) {
534
            return $ret;
535
        }
536
        if (!is_array($packagelist['p'])) {
537
            $packagelist['p'] = array($packagelist['p']);
538
        }
539
        if ($state) {
540
            $states = $this->betterStates($state, true);
541
        }
542
        foreach ($packagelist['p'] as $package) {
543
            if (!isset($installed[strtolower($package)])) {
544
                continue;
545
            }
546
            $inst_version = $reg->packageInfo($package, 'version', $channel);
547
            PEAR::pushErrorHandling(PEAR_ERROR_RETURN);
548
            $info = $this->_rest->retrieveData($base . 'r/' . strtolower($package) .
549
                '/allreleases.xml');
550
            PEAR::popErrorHandling();
551
            if (PEAR::isError($info)) {
552
                continue; // no remote releases
553
            }
554
            if (!isset($info['r'])) {
555
                continue;
556
            }
557
            $found = false;
558
            $release = false;
559
            if (!is_array($info['r']) || !isset($info['r'][0])) {
560
                $info['r'] = array($info['r']);
561
            }
562
            foreach ($info['r'] as $release) {
563
                if ($inst_version && version_compare($release['v'], $inst_version, '<=')) {
564
                    continue;
565
                }
566
                if ($state) {
567
                    if (in_array($release['s'], $states)) {
568
                        $found = true;
569
                        break;
570
                    }
571
                } else {
572
                    $found = true;
573
                    break;
574
                }
575
            }
576
            if (!$found) {
577
                continue;
578
            }
579
            $relinfo = $this->_rest->retrieveCacheFirst($base . 'r/' . strtolower($package) . '/' .
580
                $release['v'] . '.xml');
581
            if (PEAR::isError($relinfo)) {
582
                return $relinfo;
583
            }
584
            $ret[$package] = array(
585
                    'version' => $release['v'],
586
                    'state' => $release['s'],
587
                    'filesize' => $relinfo['f'],
588
                );
589
        }
590
        return $ret;
591
    }
592
 
593
    function packageInfo($base, $package)
594
    {
595
        PEAR::pushErrorHandling(PEAR_ERROR_RETURN);
596
        $pinfo = $this->_rest->retrieveData($base . 'p/' . strtolower($package) . '/info.xml');
597
        if (PEAR::isError($pinfo)) {
598
            PEAR::popErrorHandling();
599
            return PEAR::raiseError('Unknown package: "' . $package . '" (Debug: ' .
600
                $pinfo->getMessage() . ')');
601
        }
602
        $releases = array();
603
        $allreleases = $this->_rest->retrieveData($base . 'r/' . strtolower($package) .
604
            '/allreleases.xml');
605
        if (!PEAR::isError($allreleases)) {
606
            if (!class_exists('PEAR_PackageFile_v2')) {
607
                require_once 'PEAR/PackageFile/v2.php';
608
            }
609
            if (!is_array($allreleases['r']) || !isset($allreleases['r'][0])) {
610
                $allreleases['r'] = array($allreleases['r']);
611
            }
612
            $pf = new PEAR_PackageFile_v2;
613
            foreach ($allreleases['r'] as $release) {
614
                $ds = $this->_rest->retrieveCacheFirst($base . 'r/' . strtolower($package) . '/deps.' .
615
                    $release['v'] . '.txt');
616
                if (PEAR::isError($ds)) {
617
                    continue;
618
                }
619
                if (!isset($latest)) {
620
                    $latest = $release['v'];
621
                }
622
                $pf->setDeps(unserialize($ds));
623
                $ds = $pf->getDeps();
624
                $info = $this->_rest->retrieveCacheFirst($base . 'r/' . strtolower($package)
625
                    . '/' . $release['v'] . '.xml');
626
                if (PEAR::isError($info)) {
627
                    continue;
628
                }
629
                $releases[$release['v']] = array(
630
                    'doneby' => $info['m'],
631
                    'license' => $info['l'],
632
                    'summary' => $info['s'],
633
                    'description' => $info['d'],
634
                    'releasedate' => $info['da'],
635
                    'releasenotes' => $info['n'],
636
                    'state' => $release['s'],
637
                    'deps' => $ds ? $ds : array(),
638
                );
639
            }
640
        } else {
641
            $latest = '';
642
        }
643
        PEAR::popErrorHandling();
644
        if (isset($pinfo['dc']) && isset($pinfo['dp'])) {
645
            $deprecated = array('channel' => (string) $pinfo['dc'],
646
                                'package' => trim($pinfo['dp']['_content']));
647
        } else {
648
            $deprecated = false;
649
        }
650
        return array(
651
            'name' => $pinfo['n'],
652
            'channel' => $pinfo['c'],
653
            'category' => $pinfo['ca']['_content'],
654
            'stable' => $latest,
655
            'license' => $pinfo['l'],
656
            'summary' => $pinfo['s'],
657
            'description' => $pinfo['d'],
658
            'releases' => $releases,
659
            'deprecated' => $deprecated,
660
            );
661
    }
662
 
663
    /**
664
     * Return an array containing all of the states that are more stable than
665
     * or equal to the passed in state
666
     *
667
     * @param string Release state
668
     * @param boolean Determines whether to include $state in the list
669
     * @return false|array False if $state is not a valid release state
670
     */
671
    function betterStates($state, $include = false)
672
    {
673
        static $states = array('snapshot', 'devel', 'alpha', 'beta', 'stable');
674
        $i = array_search($state, $states);
675
        if ($i === false) {
676
            return false;
677
        }
678
        if ($include) {
679
            $i--;
680
        }
681
        return array_slice($states, $i + 1);
682
    }
683
}
684
?>