Add a new release

A new release, depends in part of package type, but as common properties, you should at least read/set :

date (optional, current date will be used)

getDate(), setDate()
time (optional, current time will be used; Only available for package.xml 2.0)

getTime(), setTime()
version

getVersion(), setReleaseVersion(), setAPIVersion()
stability

getState(), getStability(), setReleaseStability(), setAPIStability()
license

getLicense(), setLicense()
notes

getNotes(), setNotes()

To produce a package.xml version 1.0

<?php
require_once 'PEAR/PackageFileManager.php';
PEAR::setErrorHandling(PEAR_ERROR_DIE);
$p1 = new PEAR_PackageFileManager();
$name = 'MDB2';
$summary = 'database abstraction layer';
$description = 'PEAR MDB2 is a merge of the PEAR DB and ...';
$release_state = 'stable';
$release_version = '2.3.0';
$release_notes = 'open TODO list ...';
$license = 'BSD License';
$p1->setOptions(array(
'package' => $name,
'summary' => $summary,
'description' => $description,
'state' => $release_state,
'version' => $release_version,
'notes' => $release_notes,
'license' => $license,
'ignore' => array('Iterator.php'),
'packagedirectory' => 'C:/php/pear/MDB2',
'baseinstalldir' => '/'
));
//...
$p1->addMaintainer('lsmith', 'lead', 'Lukas Kahwe Smith', 'smith@pooteeweet.org');
if (isset($_GET['make']) || (isset($_SERVER['argv']) && @$_SERVER['argv'][1] == 'make')) {
$p1->writePackageFile();
} else {
$p1->debugPackageFile();
}
?>

To produce a package.xml version 2.0

<?php
require_once 'PEAR/PackageFileManager2.php';
PEAR::setErrorHandling(PEAR_ERROR_DIE);
$p2 = new PEAR_PackageFileManager2();
$name = 'MDB2';
$summary = 'database abstraction layer';
$description = 'PEAR MDB2 is a merge of the PEAR DB and ...';
$channel = 'pear.php.net';
$extends = 'MDB';
$release_state = 'stable';
$release_version = '2.3.0';
$api_state = 'stable';
$api_version = '2.3.0';
$release_notes = 'open TODO list ...';
$p2->setOptions(array(
'packagedirectory' => 'C:/php/pear/MDB2',
'baseinstalldir' => '/'
));
//...
$p2->setPackageType('php');
$p2->generateContents();
$p2->setPackage($name);
$p2->setChannel($channel);
$p2->setExtends($extends);
$p2->setSummary($summary);
$p2->setDescription($description);
$p2->setReleaseVersion($release_version);
$p2->setReleaseStability($release_state);
$p2->setAPIVersion($api_version);
$p2->setAPIStability($api_state);
$p2->setNotes($release_notes);
$p2->setLicense('BSD License', 'http://www.opensource.org/licenses/bsd-license.php' );
$p2->setPhpDep('4.2.0');
$p2->setPearinstallerDep('1.4.3');
$p2->addMaintainer('lead', 'lsmith', 'Lukas Kahwe Smith', 'smith@pooteeweet.org');
if (isset($_GET['make']) || (isset($_SERVER['argv']) && @$_SERVER['argv'][1] == 'make')) {
$p2->writePackageFile();
} else {
$p2->debugPackageFile();
}
?>

Even, if its not yet perfect, we have built our first package.xml.

	Important
	A point in favor of PEAR_PackageFileManager2. It may generates package with PHP4 even if PHP5 tokens are detected in source code, while PEAR_PackageFileManager cannot.

Prev	Up	Next
Chapter 7. Creating a new package	Home	Resume

PEAR_PackageFileManager : The Definitive Guide