Home » PEAR » PEAR_PackageUpdate

A simple way to update packages at run time.

This package is unmaintained.

Download latest release 1.1.0RC1 (archived versions might be outdated)

License: PHP License 3.01

Description

PEAR_PackageUpdate (PPU) is designed to allow developers to easily include auto updating features for other packages and PEAR installable applications. PPU will check to see if a new version of a package is available and then ask the user if they would like to update the package. PPU uses PEAR to communicate with the channel server and to execute the update.

PPU allows the end user to take some control over when they are notified about new releases. The PPU Preferences allow a user to tell PPU not to ask about certain types of releases (bug fixes, minor releases, etc.), not to ask about certain release states (devel, alpha, etc.), not to ask until the next release or not to ask again.

PPU is just an engine for package updating. It should not be used directly. Instead one of the driver packages such as PEAR_PackageUpdate_Gtk2 should be used depending on the application or other package.

Documentation

Manual

Maintainers

• Laurent Laville (farell) — lead, active
• Scott Mattocks (scottmattocks) — lead, inactive

Dependencies

Required

• PHP (>= 4.3.0)
• PEAR Installer (>= 1.5.4)

Releases

• 1.1.0RC1 (beta, 2009-05-07)
  Release notes

  License: PHP License 3.01

  [+] New features
  none

  [*] Improvements / changes
  - License changed from PHP 3.01 to new BSD

  [-] Bugfixes
  none

  [!] Quality Assurance
  - Make test suite more easy: used the PhptTestSuite extension of PHPUnit3 Framework

• 1.1.0a1 (alpha, 2009-02-28)
  Release notes

  License: PHP License 3.01

  WARNING: As pear channel did not provided anymore XMLRPC support,
  I have not tested the XmlRPC adapter on real server. Tests and feedback are welcome!

  [+] New features
  - introduce adapter interface to communicate with channel remote server (credits to avb)

  [*] Improvements / changes
  - with adapters you may now try many protocols (on same call) to check updates
  see test suite PEAR_PackageUpdate_TestSuite_Stub, testCheckUpdateWithSoapOrREST
  as example

  [-] Bugfixes
  - fix notice error (on unserialize data) when preference file is corrupted
  - fix notice error when asking update for a package not yet installed
  - add missing error level when pushing some error on stack
  - fix error content generated by abstract methods
  - fix notice error into getInstalledRelease() when call for package that is not installed

  [!] Quality Assurance
  - update unit test suites (for PHPUnit 3.2+) with code coverage closest to 100% (84.82)
  - fix E_STRICT error

• 1.0.4 (stable, 2008-11-23)
  Release notes

  License: PHP License 3.01

  * bugs
  - fix bug #15131: Parse errors in examples

• 1.0.3 (stable, 2008-11-19)
  Release notes

  License: PHP License 3.01

  * bugs
  - fix cleanup phase of unit tests that raised notice errors

• 1.0.2 (stable, 2008-06-15)
  Release notes

  License: PHP License 3.01

  * bugs
  - fix a display problem about current version installed (for web frontend)
  when trying to upgrade a package still in xml 1.0 to a new version
  in package xml 2.0. (Thanks to Jörg Wegner)

• 1.0.1 (stable, 2008-06-01)
  Release notes

  License: PHP License 3.01

  * bugs
  - a little typo error on constant name PEAR_PACKAGEUPDATE_TYPE_MINOR, that produce
  an error if you use setMinimumReleaseType() method.

• 1.0.0 (stable, 2008-05-01)
  Release notes

  License: PHP License 3.01

  FINAL and first STABLE version after 9 month since last BETA release.
  No bug found !

  * news
  - default configuration file (.ppurc|ppurc.ini) is loaded from and saved into PEAR
  configuration directory (PEAR 1.7.0+ cfg_dir directive) if available.

  * QA
  - require now at least PEAR installer 1.5.4 rather than 1.4.8
  (security vulnerability fixes)
  - Scott Mattocks is marked as inactive on his request, because he did not have
  time to give attention to this package it deserve. Thanks Scott for your past works
  on this package, and make this cool features a reality for the community.
  - Test Suite used now the .phpt test case rather than phpunit, just in case of a
  crash, and recovery of PEAR configuration (suggestion given by Christian Weiske
  already in same condition for PEAR_Info).

• 0.7.0 (beta, 2007-07-01)
  Release notes

  License: PHP License 3.01

  * bugs
  - fix bug #11384: Undefined variable
  This solved also the problem to PEAR non standard installation,
  by giving file to read PEAR user-defined options from
  and/or file to read PEAR system-wide defaults from

  * news
  - add (missing) snapshot package state

  * changes
  - examples/CliFrontend.php script was changed a bit to prevent notice error if package is not installed
  - add myself (Laurent Laville) as co-author, in header comment blocks.
  - add credit, in header comment blocks, to Ian Eure for his function (example)
  to repackage PEAR_Errors for use with ErrorStack

• 0.6.1 (beta, 2007-02-13)
  Release notes

  License: PHP License 3.01

  * bugs
  - fix bug #10080: PEAR_Config::singleton() should be able to be used in update()

  * changes
  - API stability was changed from beta to stable
  - examples/withoutFrontend.php script was changed a bit to clarify Doc bug #10079

• 0.6.0 (beta, 2007-01-11)
  Release notes

  License: PHP License 3.01

  * IMPORTANT
  This beta version will be the last one before final stable release 1.0.0

  * news
  - two new functions: getInstalledRelease() and getLatestRelease(), to easily
  retrieve informations (release date, notes, version, state, dependencies, ...)
  about installed and latest version available of a package.

  TIP: usefull if you want to alert web admin of an auto-update with all necessary informations.

  * changes
  - drop support of package xml version 1.0
  - example withoutFrontend.php updated (PEAR_PackageUpdate_Null class is now reusable)

• 0.5.2 (beta, 2006-09-18)
  Release notes

  License: PHP License 3.01

  Allow updates from channels other than pear.php.net.
  Allow updates using REST.

• 0.5.1 (beta, 2006-07-15)
  Release notes

  License: PHP License 3.01

  * fixed PHP dependency :
  required at least PHP 4.3.0 due to usage of functions: get_include_path, file_get_contents

  * add optional dependency to web/html frontend

• 0.5.0 (beta, 2006-05-07)
  Release notes

  License: PHP License 3.01

  * news
  - more flexible implementation of the factory pattern allowing people to use custom class
  see new example 'withoutFrontend.php': how to use ppu without frontend

  * bugs
  - fixes typos error on constants
  - fixes typos missing letter on function setMinimumReleaseType

  * improvements
  - indentation of error messages array

  * Quality Assurance
  - add @throws phpdoc tag on all necessary function comment block

• 0.4.3 (beta, 2006-04-25)
  Release notes

  License: PHP License 3.01

  * news
  - Laurent Laville was added as a leader to the package

  * improvements
  - fixes request #7456: improve error frame used with PEAR_ErrorStack
  - mandatory ressources that will be call in all cases are now outside the class

  * Quality Assurance
  - PEAR cs standard for header comment blocks (see http://pear.php.net/pepr/pepr-proposal-show.php?id=128)
  - Adds since phpdoc tag to keep track of function history

• 0.4.2 (beta, 2006-04-20)
  Release notes

  License: PHP License

  Fixes for bug #7442: avoid warning messages when driver is unloadable.

• 0.4.1 (beta, 2006-04-13)
  Release notes

  License: PHP License

  Remove demo code from presentUpdate().

• 0.4.0a1 (alpha, 2006-03-28)
  Release notes

  License: PHP License

  Initial PEAR release.

Bugs