Website releases made easy with the PEAR installer Helgi Þormar Þorbjörnsson [email_address] FrOSCon 2008 24 / 08 / 2008

Who am I ? An Icelandic guy with a weird name iBuildings UK PEAR Group member PEAR Developer – Among other the installer pear.php.net maintainer PEAR <insert-job-title> ;-)

An Icelandic guy with a weird name

iBuildings UK

PEAR Group member

PEAR Developer – Among other the installer

pear.php.net maintainer

PEAR <insert-job-title> ;-)

How to pronounce my last name Þormar Þorbjörnsson being my last name ASCII version being Thormar Thorbjoernsson Þ = Th and pronounced like That or a Thorn Now you are more enlightened about this Icelandic thing called Thorn

Þormar Þorbjörnsson being my last name

ASCII version being Thormar Thorbjoernsson

Þ = Th and pronounced like That or a Thorn

Now you are more enlightened about this Icelandic thing called Thorn

Alternative, not a replacement Deploying websites with the PEAR installer is an alternative, not a replacement for other approaches

Deploying websites with the PEAR installer is an alternative, not a replacement for other approaches

Other alternatives FTP upload SCP / rsync Capistrano SVN / CVS / <insert fancy VC here> deployment etc etc etc

FTP upload

SCP / rsync

Capistrano

SVN / CVS / <insert fancy VC here> deployment

etc etc etc

PEAR installer features to the rescue Easy upgrading Custom tasks Post install tasks

Easy upgrading

Custom tasks

Post install tasks

PEAR installer features to the rescue Custom file roles Able to depend on PEAR installable packages Easier to split the site up into smaller parts and handle them like their own releases

Custom file roles

Able to depend on PEAR installable packages

Easier to split the site up into smaller parts and handle them like their own releases

Last but not least Tasks, custom roles and so on are all done with something we are familiar with ......

Tasks, custom roles and so on are all done with something we are familiar with ......

What's required The PEAR installer Knowledge how to package up your code with PEAR installer A bit of know how and RTFM skills And not be afraid of reading the source ;-)

The PEAR installer

Knowledge how to package up your code with PEAR installer

A bit of know how and RTFM skills

And not be afraid of reading the source ;-)

Dismantling your site Split your site into logical pieces Don't split it into as many packages as you can! Micro management is bad, mmmkay

Split your site into logical pieces

Don't split it into as many packages as you can!

Micro management is bad, mmmkay

Dismantling your site Each piece gets its own package.xml The website it self has a package.xml and all the other pieces will depend on it

Each piece gets its own package.xml

The website it self has a package.xml and all the other pieces will depend on it

Dismantling your site Web Services Backend Frontend Forum Website

The packages we get Website Website_WebServices Website_Frontend Website_Backend Website_Forum

Website

Website_WebServices

Website_Frontend

Website_Backend

Website_Forum

Custom file roles This feature allows you to write your own file role PEAR supports php, data, test, www, src by default People have been using them for various whacky things In relation to templates Custom handling of data files And more things, the sky is the limit

This feature allows you to write your own file role

PEAR supports php, data, test, www, src by default

People have been using them for various whacky things

In relation to templates

Custom handling of data files

And more things, the sky is the limit

Post install tasks Handy feature for all the family Write a simple PHP task that you can run after installation Clean up after the installation, tmp dirs etc DB setup tool Prime caches And just whatever you can dream up

Handy feature for all the family

Write a simple PHP task that you can run after installation

Clean up after the installation, tmp dirs etc

DB setup tool

Prime caches

And just whatever you can dream up

Need to know about post install We do not run post install script auto! Quick output what it looks like to have a post install script around pear/pearweb has post-install scripts: /usr/share/PEAR/pearweb.php pearweb: Use &quot;pear run-scripts pear/pearweb&quot; to finish setup. DO NOT RUN SCRIPTS FROM UNTRUSTED SOURCES

Post install tasks <file name=&quot;postinstall.php&quot; role=&quot;php&quot;> <tasks:postinstallscript> <tasks:paramgroup> <tasks:id> askdb </tasks:id> <tasks:param> <tasks:name> yesno </tasks:name> <tasks:prompt> Install database? </tasks:prompt> <tasks:type> yesno </tasks:type> <tasks:default> y </tasks:default> </tasks:param> </tasks:paramgroup> </tasks:postinstallscript> </file>

Post install tasks pear run-scripts pear/pearweb Including external post-installation script &quot;/usr/share/PEAR/pearweb.php&quot; - any errors are in this script Inclusion succeeded running post-install script &quot;pearweb_postinstall->init()&quot; init succeeded Update pearweb database? [y] :

Post install tasks Add more tasks:param to tasks:paramgroups to so the user gets more questions per task id Has the ability to skip a param group based on user input tasks:type has 3 different types string password yesno

Add more tasks:param to tasks:paramgroups to so the user gets more questions per task id

Has the ability to skip a param group based on user input

tasks:type has 3 different types

string

password

yesno

Update pearweb database? [y] : 1. Database driver : mysqli 2. Database User name : pear 3. Database password : pear 4. Database host : localhost 5. Database name : pear 1-5, 'all', 'abort', or Enter to continue:

Real world example http://cvs.php.net/pearweb/package.xml cvs.php.net/pearweb/package-pepr.xml http://cvs.php.net/pearweb/pearweb.php In package.xml look for pearweb.php and you see how we do it for pear.php.net Good place to study how things are built up

http://cvs.php.net/pearweb/package.xml

cvs.php.net/pearweb/package-pepr.xml

http://cvs.php.net/pearweb/pearweb.php

Puzzling the pieces together Now we run these pseudo packages and we want to install only part of our website structure pear install –alldeps Website_WebServices Website_Frontend Website_Backend This will install your only those 3 parts of your website along site all the deps which one of those is the Website.

Now we run these pseudo packages and we want to install only part of our website structure

pear install –alldeps Website_WebServices Website_Frontend Website_Backend

This will install your only those 3 parts of your website along site all the deps which one of those is the Website.

Puzzling the pieces together Web Services Backend Frontend Website

Questions ? [email_address]

Resources http://c7y.phparch.com (Look for my articles) http://pear.php.net/manual/en/ http://www.packtpub.com/PEAR-Installer/book

http://c7y.phparch.com (Look for my articles)

http://pear.php.net/manual/en/

http://www.packtpub.com/PEAR-Installer/book