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.

Requirements

Platforms

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

Chef

Chef 12.7+

Cookbooks

build-essential
mysql

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'] = Name of the pear executable to use, default pear.

The file also contains the following attribute types:

platform specific locations and settings.
source installation settings

Resources

This cookbook includes resources for managing:

PEAR channels
PEAR/PECL packages

`php_pear_channel`

PEAR Channels are alternative sources for PEAR packages. This resource provides and easy way to manage these channels.

Actions

:discover: Initialize a channel from its server.
:add: Add a channel to the channel list, usually only used to add private channels. Public channels are usually added using the :discover action
:update: Update an existing channel
:remove: Remove a channel from the List

Properties

channel_name: name attribute. The name of the channel to discover
channel_xml: the channel.xml file of the channel you are adding
pear: pear binary, default: pear

Examples

# discover the horde channel
php_pear_channel "pear.horde.org" do
  action :discover
end

# download xml then add the symfony channel
remote_file "#{Chef::Config[:file_cache_path]}/symfony-channel.xml" do
  source 'http://pear.symfony-project.com/channel.xml'
  mode '0644'
end
php_pear_channel 'symfony' do
  channel_xml "#{Chef::Config[:file_cache_path]}/symfony-channel.xml"
  action :add
end

# update the main pear channel
php_pear_channel 'pear.php.net' do
  action :update
end

# update the main pecl channel
php_pear_channel 'pecl.php.net' do
  action :update
end

`php_pear`

PEAR is a framework and distribution system for reusable PHP components. PECL is a repository for PHP Extensions. PECL contains C extensions for compiling into PHP. As C programs, PECL extensions run more efficiently than PEAR packages. PEARs and PECLs use the same packaging and distribution system. As such this resource is clever enough to abstract away the small differences and can be used for managing either. This resource also creates the proper module .ini file for each PECL extension at the correct location for each supported platform.

Actions

:install: Install a pear package - if version is provided, install that specific version
:upgrade: Upgrade a pear package - if version is provided, upgrade to that specific version
:remove: Remove a pear package
:reinstall: Force install of the package even if the same version is already installed. Note: This will converge on every Chef run and is probably not what you want.
:purge: An alias for remove as the two behave the same in pear

Properties

package_name: name attribute. The name of the pear package to install
version: the version of the pear package to install/upgrade. If no version is given latest is assumed.
preferred_state: PEAR by default installs stable packages only, this allows you to install pear packages in a devel, alpha or beta state
directives: extra extension directives (settings) for a pecl. on most platforms these usually get rendered into the extension's .ini file
zend_extensions: extension filenames which should be loaded with zend_extension.
options: Add additional options to the underlying pear package command

Examples

# upgrade a pear
php_pear 'XML_RPC' do
  action :upgrade
end

# install a specific version
php_pear 'XML_RPC' do
  version '1.5.4'
  action :install
end

# install the mongodb pecl
php_pear 'Install mongo but use a different resource name' do
  package_name 'mongo'
  action :install
end

# install the xdebug pecl
php_pear 'xdebug' do
  # Specify that xdebug.so must be loaded as a zend extension
  zend_extensions ['xdebug.so']
  action :install
end

# install apc pecl with directives
php_pear 'apc' do
  action :install
  directives(shm_size: 128, enable_cli: 1)
end

# install the beta version of Horde_Url
# from the horde channel
hc = php_pear_channel 'pear.horde.org' do
  action :discover
end

php_pear 'Horde_Url' do
  preferred_state 'beta'
  channel hc.channel_name
  action :install
end

# install the YAML pear from the symfony project
sc = php_pear_channel 'pear.symfony-project.com' do
  action :discover
end

php_pear 'YAML' do
  channel sc.channel_name
  action :install
end

`php_fpm_pool`

Installs the php-fpm package appropriate for your distro (if using packages) and configures a FPM pool for you. Currently only supported in Debian-family operating systems and CentOS 7 (or at least tested with such, YMMV if you are using source).

Please consider FPM functionally pre-release, and test it thoroughly in your environment before using it in production

More info: http://php.net/manual/en/install.fpm.php

Actions

:install: Installs the FPM pool (default).
:uninstall: Removes the FPM pool.

Attribute Parameters

pool_name: name attribute. The name of the FPM pool.
listen: The listen address. Default: /var/run/php5-fpm.sock
user: The user to run the FPM under. Default should be the webserver user for your distro.
group: The group to run the FPM under. Default should be the webserver group for your distro.
process_manager: Process manager to use - see http://php.net/manual/en/install.fpm.configuration.php. Default: dynamic
max_children: Max children to scale to. Default: 5
start_servers: Number of servers to start the pool with. Default: 2
min_spare_servers: Minimum number of servers to have as spares. Default: 1
max_spare_servers: Maximum number of servers to have as spares. Default: 3
chdir: The startup working directory of the pool. Default: /
additional_config: Additional parameters in JSON. Default: {}

Examples

# Install a FPM pool named "default"
php_fpm_pool 'default' do
  action :install
end

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.

Deprecated Recipes

The following recipes are deprecated and will be removed from a future version of this cookbook.

module_apc
module_apcu
module_curl
module_fileinfo
module_fpdf
module_gd
module_imap
module_ldap
module_memcache
module_mysql
module_pgsql
module_sqlite3

The installation of the php modules in these recipes can now be accomplished by installing from a native package or via the new php_pear resource. For example, the functionality of the module_memcache recipe can be enabled in the following ways:

# using apt
package 'php5-memcache'

# using pear resource
php_pear 'memcache'

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]'
)

Maintainers

This cookbook is maintained by Chef's Community Cookbook Engineering team. Our goal is to improve cookbook quality and to aid the community in contributing to cookbooks. To learn more about our team, process, and design goals see our team documentation. To learn more about contributing to cookbooks like this see our contributing documentation, or if you have general questions about this cookbook come chat with us in #cookbok-engineering on the Chef Community Slack

License

Licensed under the Apache License, Version 2.0 (the "License");
you may not use this file except in compliance with the License.
You may obtain a copy of the License at

    http://www.apache.org/licenses/LICENSE-2.0

Unless required by applicable law or agreed to in writing, software
distributed under the License is distributed on an "AS IS" BASIS,
WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
See the License for the specific language governing permissions and
limitations under the License.

threeturn/php

php Cookbook

Requirements

Platforms

Chef

Cookbooks

Attributes

Resources

php_pear_channel

Actions

Properties

Examples

php_pear

Actions

Properties

Examples

php_fpm_pool

Actions

Attribute Parameters

Examples

Recipes

default

package

source

Deprecated Recipes

Usage

Role example:

Maintainers

License

`php_pear_channel`

`php_pear`

`php_fpm_pool`