puppet-php

puppet-php is a Puppet module for managing PHP, in particular php-fpm. Apache with mod_php cannot be handled by this module.

This originally was a fork of jippi/puppet-php (nodes-php on Puppet Forge) but has since been rewritten in large parts.

Usage

The module aims to use sane defaults for the supported architectures. You must use hiera to configure most aspects of this module.

The recommended way is to include the php main class in your manifests:

include ::php

You can configure the module through hiera. Here are the defaults for some parameters as you would specify them in hiera:

php::ensure: latest
php::manage_repos: true
php::fpm: true
php::dev: true
php::composer: true
php::pear: true
php::phpunit: false
php::fpm::config:log_level: notice
php::composer::auto_update: true

There are more configuration options available. Please refer to the documention in the manifests for a complete overview.

Apache support

Apache with mod_php is not supported by this module. Please use puppetlabs/apache instead.

We prefer using php-fpm. You can find an example Apache vhost in manifests/apache_vhost.pp that shows you how to use mod_proxy_fcgi to connect to php-fpm.

Defining php.ini settings

PHP configuration parmaters in php.ini files can be defined as parameter settings on the php, php::fpm and php::cli classes or php::extension resources for each component independently.

These settings are written into their respective php.ini file. Global settings in php::settings are merged with the settings of all components. Please note that settings of extensions are always independent.

In the following example the timezone will be set in the PHP cli application and all php-fpm pools.

php::settings:
  Date/date.timezone: Europe/Berlin
php::cli::settings:
  PHP/memory_limit: 512M
php::fpm::settings:
  PHP/short_open_tag: 'On'

Installing extensions

Extensions can be installed and configured by defining the hash php::extensions in hiera. They are activated for all activated components.

php::extensions:
  json: {}
  mysql: {}
  memcached:
    provider: pecl
    header_packages:
      - libmemcached-dev
  apc:
    package_prefix: php-
    settings:
      apc.stat: 1
      apc.stat_ctime: 1

Bugs & New Features

If you happen to stumble upon a bug, please feel free to create a pull request with a fix (optionally with a test), and a description of the bug and how it was resolved.

Or if you're not into coding, simply create an issue adding steps to let us reproduce the bug and we will happily fix it.

If you have a good idea for a feature or how to improve this module in general, please create an issue to discuss it. We are very open to feedback. Pull requests are always welcome.

We hate orphaned and unmaintained Puppet modules as much as you do and therefore promise that we will continue to maintain this module and keep response times to issues short. If we happen to lose interest, we will write a big fat warning into this README to let you know.

License

The project is released under the permissive MIT license.

The source can be found at github.com/Mayflower/puppet-php.

This Puppet module is being actively maintained by some fellow puppeteers at Mayflower GmbH.

Changelog

2.0.4

• Style fixes all over the place
• Module dependencies are now bound to the current major version

2.0.3

• Some issues & bugs with extensions were fixed
• If you set the provider parameter of an extension to "none", no extension packages will be installed
• The EPEL yum repo has been added for RedHat systems

2.0.2

• Adds support for header_packages on all extensions
• Adds install_options to pear package provider

2.0.1

• This is a pure bug fix release
  • Fix for CVE 2014-0185 (https://bugs.php.net/bug.php?id=67060)

2.0.0

• Remove augeas and switch to puppetlabs/inifile for configs
  • Old: settings => [‘set PHP/short_open_tag On‘]
  • New: settings => {‘PHP/short_open_tag’ => ‘On‘}
• Settings parmeter cleanups
  • The parameter config of php::extension resources is now called settings
  • The parameters user and group of php::fpm have been moved to php::fpm::config
  • New parameter php::settings for global settings (i.e. CLI & FPM)
• New parameter php::cli to disable CLI if supported

1.1.2

• SLES: PHP 5.5 will now be installed
• Pecl extensions now autoload the .so based on $name instead of $title

1.1.1

• some nasty bugs with the pecl php::extension provider were fixed
• php::extension now has a new pecl_source parameter for specifying custom source channels for the pecl provider

1.1.0

• add phpunit to main class
• fix variable access for augeas

1.0.2

• use correct suse apache service name
• fix anchoring of augeas

1.0.1

• fixes #9 undefined pool_base_dir

1.0.0

Initial release