php Cookbook

It installs and configures PHP and the PEAR package management system. Also includes resources for managing PEAR (and PECL) packages, PECL channels, and PHP-FPM pools.

Maintainers

This cookbook is maintained by the Sous Chefs. The Sous Chefs are a community of Chef cookbook maintainers working together to maintain important cookbooks. If you’d like to know more please visit sous-chefs.org or come chat with us on the Chef Community Slack in #sous-chefs.

Requirements

Platforms

Debian, Ubuntu
CentOS, Red Hat, Oracle, Scientific, Amazon Linux
Fedora

Chef

Chef 14+

Attributes

node['php']['install_method'] = method to install php with, default package.
node['php']['directives'] = Hash of directives and values to append to php.ini, default {}.
node['php']['pear_setup'] = Boolean value to determine whether to set up pear repositories. Default: true
node['php']['pear_channels'] = List of external pear channels to add if node['php']['pear_setup'] is true. Default: ['pear.php.net', 'pecl.php.net']

The file also contains the following attribute types:

platform specific locations and settings.
source installation settings

Resources

This cookbook includes resources for managing:

Recipes

default

Include the default recipe in a run list, to get php. By default php is installed from packages but this can be changed by using the install_method attribute.

package

This recipe installs PHP from packages.

source

This recipe installs PHP from source.

Note: Debian 9 is not supported for building from source.

Usage

Simply include the php recipe where ever you would like php installed. To install from source override the node['php']['install_method'] attribute with in a role or wrapper cookbook:

Role example

name 'php'
description 'Install php from source'
override_attributes(
  'php' => {
    'install_method' => 'source',
  }
)
run_list(
  'recipe[php]'
)