Preparing PEAR Packages

One of the formats Seagull is currently available in is as a PEAR package. For more info on how to install PEAR packages see Using the PEAR package manager.

To create PEAR package for your Seagull modules follow these basics:

  • get more info on the PEAR package format http://pear.php.net/manual/en/developers.packagedef.php
  • check out the package builder script [gitlink:trunk/etc/generatePearPackageXml.php]
  • create your own release notes for $notes
  • modify the script’s listing of all the dependencies on PEAR libs you may have added/removed
  • it’s easiest to work with an exported version of Seagull, ie, no svn folders
  • specify the path to the directory where your module can be found, in $packagedir
  • modify the location and roles of any files you may have changed
  • call the generate script from a web browser with a ‘make’ parameter, ie, http://localhost/myProject/etc/generatePearPackageXml.php?make (or you can call from CLI)
  • this will create a package2.xml file in the root of your module folder
  • at the commandline, in the module’s root folder, with the PEAR binary in your path, type

    $ pear package package2.xml
    

That’s all there is too it. The resulting .tgz archive can be uploaded to any correctly configured PEAR channel server.