Development repository for the php cookbook
Apache License 2.0
387
111
611

php Cookbook

Cookbook Version Build Status OpenCollective OpenCollective License

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

  • Ubuntu 18.04 / 20.04 / 22.04
  • Debian 10 / 11
  • CentOS 7+ (incl. Alma & Rocky)

Chef

  • Chef 15.3+

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

php::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.

php::package

This recipe installs PHP from packages.

php::community_package

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:

php::source

This recipe installs PHP 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 within a role or wrapper cookbook:

Role example

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

Contributors

This project exists thanks to all the people who contribute.

Backers

Thank you to all our backers!

https://opencollective.com/sous-chefs#backers

Sponsors

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

https://opencollective.com/sous-chefs/sponsor/0/website https://opencollective.com/sous-chefs/sponsor/1/website https://opencollective.com/sous-chefs/sponsor/2/website https://opencollective.com/sous-chefs/sponsor/3/website https://opencollective.com/sous-chefs/sponsor/4/website https://opencollective.com/sous-chefs/sponsor/5/website https://opencollective.com/sous-chefs/sponsor/6/website https://opencollective.com/sous-chefs/sponsor/7/website https://opencollective.com/sous-chefs/sponsor/8/website https://opencollective.com/sous-chefs/sponsor/9/website

Contributors

tas50
jeffbyrnes
kitchen-porter
damacus
Rockstar04
Xorima
xorimabot
iennae
sethvargo
dkinzer
ramereth
schisamo
solarce
bheuvel
djoos
estahn
hrak
mdiniz
leth
Restless-ET
sufius
detjensrobert
andytson
cburyta
hannesvdvreken
PowerSchill
mclyde-oracle
mishak87
miketheman
nathenharvey
PrajaktaPurohit
rshade
durana
Sauraus
ynuyasha
blongden
chrisroberts
dldinternet
chris-rock
ThatGerber
conormcd
craigmc
danielsdeleo
abdelkrimdev
feulf
VanTanev
wyrdvans
JCotton1123
hydrant25
devsibwarra
mskurski
matjack1
mca-gif
matthieumota
opetrushka-zendesk
patcon
rjocoleman
ryanneufeld
shanethehat
StevenBarre
tarunjangra
axelrtgs
franklinkim
giorgio-v
Jenkins-nuglif
willejs
yoshiwaan