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.

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.

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

• Chef 15.3+

• 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

This cookbook includes resources for managing:

• php_pear
• php_pear_channel
• php_fpm_pool

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.

This recipe installs PHP from packages.

This recipe installs PHP from one of two available community package repositories, depending on platform family. This provides the ability to install PHP versions that are no provided by the official distro repositories.

Set node['php']['install_method'] = 'community_package' to use these repositories.

Please see test/cookbooks/test/recipes/community.rb for an example of how to use attributes to install the desired version of PHP & its supporting packages, and please refer to the documentation on these community repositories:

• CentOS - Remi’s RPM repository
• Ubuntu - Ondřej Surý PPA
• Debian - Sury repo

This recipe installs PHP from source.

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

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

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

This project exists thanks to all the people who contribute.

Thank you to all our backers!

Support this project by becoming a sponsor. Your logo will show up here with a link to your website.