README.md
No OneTemporary
Actions

Size

4 KB

Subscribers

None

README.md
View Options

	puppet-php
	==========

	Puppet module to manage PHP on debian using dotdeb apt repository

	Right now only supports dotdeb on debian squeeze, should be fairly easy to modify if needed though

	Puppet forge URL: http://forge.puppetlabs.com/nodes/php

	### Installation

	```
	puppet module install nodes/php
	```

	or simply clone the repository in your `module_path` (the folder must be named php)

	### Setup

	There is little to no class dependency between all classes

	To ensure that things happen in a predictable order please use the example below to ensure that extensions are installed before they are configured

	```
	# Install extensions; Configure extensions; Reload apache if changed
	Php::Extension <\| \|> -> Php::Config <\| \|> ~> Service["apache2"]
	```

	If you rely on `dotdeb` (default behavior) you also want to make sure that the `php::apt` class is loaded and `apt` has been updated (`apt-get update`) before packages are installed

	```
	# Install sources; Update sources; Install packages
	Apt::Source <\| \|> ~> Exec['apt_update'] -> Package <\| \|>
	```

	Using the Pecl package provider requires the `php5-dev` and `build-essential` package to be installed beforehand

	### Example configuration of the module.

	It will install CLI, mod_php for apache, dev packages, pear and APC

	```
	$php_version = '5.4.11-1~dotdeb.0'

	include php
	include php::apt

	class {
	'php::cli':
	ensure => $php_version;
	'php::apache':
	ensure => $php_version;
	'php::dev':
	ensure => $php_version;
	'php::pear':
	ensure => $php_version;
	'php::extension::apc':
	ensure => $php_version;
	}
	```

	### Package providers

	The module provides a `pear` and `pecl` provider

	#### Pear package example

	```
	package { 'pear.phpunit.de/PHPUnit':
	ensure => installed,
	provider => pear;
	}
	```

	#### Pecl package example

	```
	package { 'igbinary':
	ensure => installed,
	provider => pecl;
	}
	```

	### Installing packages

	It's quite simple to install packages not included in the package, simply use `php::extension`

	```
	php::extension { 'platform-independent-name':
	ensure => $ensure, # Same as Package { ensure }
	package => $package, # Package name as defined in the package provider
	provider => $provider; # Provider used to install (pecl, pearl, (default)undef)
	}

	# same as

	package { $package: # Package name as defined in the package provider
	ensure => $ensure, # Same as Package { ensure }
	provider => $provider; # Provider used to install (pecl, pearl, (default)undef)
	}
	```

	The advantage of using `php::extension` over `package` is the anchor of dependency mentioned in Setup

	Packages from a custom `pear` channel is also supported nicely

	```
	package { 'pear.phpunit.de/PHPUnit':
	ensure => '3.7.12', # Same as Package { ensure }
	provider => pear,
	require => Exec['php::pear::auto_discover'];
	}
	```

	If you want to auto-discover channels, make sure to `require` `Exec['php::pear::auto_discover']`

	### Configure packages

	Modifying php configuration is also baked right now

	Simply use `php::config` to modify your ini files

	```
	php::config { '$unique-name':
	inifile => '$full_path_to_ini_file'
	settings => {
	set => {
	'.anon/apc.enabled' => 1
	}
	}
	}

	# same as

	augeas { "php-${uniqie-name}-config":
	context => "/files${full_path_to_ini_file}",
	changes => {
	"set '.anon/apc.enabled' '1'"
	}
	}
	```

	`settings` is a key / value `augeas` hash

	Currently `settings` only support the type `set` in augeas

	The advantage of using `php::config` over `augeas` is the anchor of dependency mentioned in Setup

	### PHP SAPIs

	By default the module comes with support for mod_php (`php::apache`) and cli `php::cli`

	### PHP modules

	The following modules are implemented by default:

	* apc (php::extension::apc)
	* curl (php::extension::curl)
	* gd (php::extension::gd)
	* gearman (php::extension::gearman)
	* http (php::extension::http)
	* igbinary (php::extension::igbinary)
	* imagick (php::extension::imagick)
	* mcrypt (php::extension::mcrypt)
	* mysql (php::extension::mysql)
	* redis (php::extension::redis)
	* ssh2 (php::extension::ssh2)
	* uploadprogress (php::extension::uploadprogress)
	* xdebug (php::extension::xdebug)

	each of them are located in the `php::extension` namespace

	### Packages

	The following PHP related packages come build in too

	* Composer (php::composer)
	* phpunit (php::phpunit)

File Metadata

Mime Type: text/plain
Expires: Jun 4 2025, 7:44 PM (10 w, 4 d ago)
Storage Engine: blob
Storage Format: Raw Data
Storage Handle: 3271371

README.mdNo OneTemporaryActions

README.mdView Options

File Metadata

Event Timeline

README.md
No OneTemporary
Actions

README.md
View Options