simplify your external dependency management - dpc11

Simplify your external dependency management

v

Simplify your ext. dependency management

About me

Stephan Hochdörfer, bitExpert AG

Department Manager Research Labs

enjoying PHP since 1999

[email protected]

@shochdoerfer


Dependencies?


Dependencies?

internalDependencies

externalDependencies


Dependencies?external

Dependencies

ExtensionsSystemtoolsFrameworks

Libs


Our first project....


Our first project....

+


Maintenance nightmare!


Version control, anyone?


Subversion – svn:externals


Git - Submodules


Git - Subtree


Recap

No overview of dependency configuration


Recap

Externals must be of the same type as the repository!


Recap

Commiting to Externals is possible!


Insight

You cannot control dependencies with a VCS!


Insight

A VCS is not made for dependency management!


Requirements first!


Do not hide dependency metadata!


Transitive dependencies

v


Do not reinvent the wheel


Separation from VCS


Mind change: Build process needed!


Step 1: Building the build


Step 2: Package the software


Step 3: Deliver the software


Build automation


Build automation with Phing

<?xml version="1.0" encoding="UTF-8"?><project name="MyProject" default="build">

<target name="prepare"> <echo msg="Creating dir ./build" /> <mkdir dir="./build" /> </target>

<target name="build" depends="prepare"> <echo msg="Copying files..." /> <copy file="./info.php" tofile="./build/info.php" /> </target></project>


Build automation with pear


Build automation with pear pantr

pantr = project-based PEAR installer


Build automation with pantr

1. pantr pear:init lib



2. pantr pear:channel-discover pear.pagosoft.com



3. pantr pear:install pgs/parser


Packaging


*nix packages – 4 steps to enlightenment



1. Create directory yourproject-0.0.1



2. dh_make –createorig -s



3. Add a Makefile



BINDIR = $(DESTDIR)/usr/binclean:install:mkdir -p $(BINDIR)cp info.php $(BINDIR)

uninstall:rm -f $(BINDIR)/info.php



4. fakeroot debian/rules binary


*nix packages – Dependencies?



Add them to debian/control file



Source: yourprojectSection: unknownPriority: extraMaintainer: Stephan HochdoerferBuild-Depends: debhelper (>= 7.0.50~)Standards-Version: 3.8.4

Package: yourprojectArchitecture: anyDepends: php5-cgi php5-mysqlDescription: yourproject short description long description...


PEAR package – 3 steps to enlightenment



1. Create directory yourproject-0.0.1



2. Create package.xml


PEAR package – 3 steps to enlightenment<?xml version="1.0" encoding="UTF-8"?><package packagerversion="1.8.0" version="2.0"> <name>Yourapp</name> <channel>pear.yourapp.com</channel> <summary>Yourapp summary</summary> <description>Yourapp description.</description> <lead> <name>Stephan Hochdoerfer</name> <user>sh</user> <email>[email protected]</email> <active>yes</active> </lead> <date>2009-10-18</date> <time>16:00:00</time> <version> <release>0.9.0</release>


PEAR package – 3 steps to enlightenment <dependencies> <required> <php> <min>5.0.0</min> </php> <pearinstaller> <min>1.4.0</min> </pearinstaller> </required> </dependencies> <phprelease /></package>



3. pear package


How to deliver the packages?



*nix repository vs. PEAR server



pearhub, pearfarm, openPear



PEAR Proxy needed?


Missing the glue!


Java anyone?


Maven – a project management tool


Maven

Goal: Standardization


Maven Lifecycle

archetype


Maven Lifecycle

archetype

validate


Maven Lifecycle

archetype

validate

compile


Maven Lifecycle

archetype

validate

compile

test


Maven Lifecycle

archetype

validate

compile

test

package


Maven Lifecycle

archetype

validate

compile

test

packageintegration-test


Maven Lifecycle

archetype

validate

compile

test


verify


Maven Lifecycle

archetype

validate

compile

test


verify

install


Maven Lifecycle

archetype

validate

compile

test


verify

install

deploy


Maven - Project Object Model

<project xmlns="http://maven.apache.org/POM/4.0.0"xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"xsi:schemaLocation="http://maven.apache.org/POM/4.0.0http://maven.apache.org/maven-v4_0_0.xsd">

<groupId>com.acme</groupId><artifactId>myproject</artifactId><packaging>jar</packaging><version>0.0.1-SNAPSHOT</version><name>My project</name>

</project>


Maven - Dependencies

<dependencies><dependency>

<groupId>com.zend</groupId><artifactId>framework</artifactId><version>1.11.6-SNAPSHOT</version><type>jar</type><scope>compile</scope>

</dependency></dependencies>


Maven Beginners guide

Maven for PHP?



1. Download & install Maven



2. Edit settings.xml to add PHP for Maven repository



<pluginRepository><id>release-repo1.php-maven.org</id><name>PHP-Maven 2 Release Repository</name><url>http://repo1.php-maven.org/release</url><releases>

<enabled>true</enabled></releases>

</pluginRepository>



3. Create new Maven project



mvn archetype:generate \-DarchetypeGroupId=org.phpmaven \-DarchetypeArtifactId=php5-lib-archetype \-DarchetypeVersion=1.1 \-DgroupId=org.yourproject \-DartifactId=appname



2. Deploy your project



mvn deploy


Maven Bonus points

Can act as a proxy!


Maven Bonus points

Plugins, Plugins, Plugins,...


Maven Bonus points

Automatic release management


Maven Bonus points

Automatic deployment


Maven Bonus points

Build profiles


Maven Bonus points

IDE support, e.g. Eclipse, Netbeans,...

http://joind.in/3232


Image Credits

http://www.sxc.hu/photo/1092493





simplify your external dependency management - dpc11

Documents

dependency management

dependency metadata

externaldependency management

nix packages dependencies

pantr pear

pear pantrpantr

nix repository

stephan hochdoerfer