cookbook 'php', '= 1.3.4'
php
(100) Versions
1.3.4
-
-
10.2.4
-
10.2.3
-
10.2.2
-
10.2.1
-
10.2.0
-
10.1.1
-
10.0.3
-
10.0.2
-
10.0.1
-
10.0.0
-
9.2.18
-
9.2.17
-
9.2.16
-
9.2.15
-
9.2.14
-
9.2.13
-
9.2.12
-
9.2.11
-
9.2.10
-
9.2.9
-
9.2.8
-
9.2.7
-
9.2.6
-
9.2.5
-
9.2.4
-
9.2.3
-
9.2.2
-
9.2.1
-
9.2.0
-
9.1.4
-
9.1.3
-
9.1.2
-
9.1.1
-
9.1.0
-
9.0.0
-
8.1.2
-
8.1.1
-
8.1.0
-
8.0.1
-
8.0.0
-
7.2.0
-
7.1.0
-
7.0.0
-
6.1.1
-
6.1.0
-
6.0.0
-
5.1.0
-
5.0.0
-
4.6.0
-
4.5.0
-
4.4.0
-
4.3.0
-
4.2.0
-
4.1.0
-
4.0.0
-
3.1.1
-
3.1.0
-
3.0.0
-
2.2.1
-
2.2.0
-
2.1.1
-
2.1.0
-
2.0.0
-
1.10.1
-
1.10.0
-
1.9.0
-
1.8.0
-
1.7.2
-
1.7.1
-
1.7.0
-
1.6.1
-
1.6.0
-
1.5.0
-
1.4.6
-
1.4.4
-
1.4.2
-
1.4.0
-
1.3.14
-
1.3.12
-
1.3.10
-
1.3.4
-
1.3.2
-
1.3.0
-
1.2.6
-
1.2.4
-
1.2.2
-
1.2.0
-
1.1.8
-
1.1.6
-
1.1.4
-
1.1.2
-
1.1.0
-
1.0.2
-
1.0.0
-
0.99.2
-
0.99.1
-
0.99.0
-
0.9.1
-
0.9.0
-
0.7.0
Follow295
- 10.2.4
- 10.2.3
- 10.2.2
- 10.2.1
- 10.2.0
- 10.1.1
- 10.0.3
- 10.0.2
- 10.0.1
- 10.0.0
- 9.2.18
- 9.2.17
- 9.2.16
- 9.2.15
- 9.2.14
- 9.2.13
- 9.2.12
- 9.2.11
- 9.2.10
- 9.2.9
- 9.2.8
- 9.2.7
- 9.2.6
- 9.2.5
- 9.2.4
- 9.2.3
- 9.2.2
- 9.2.1
- 9.2.0
- 9.1.4
- 9.1.3
- 9.1.2
- 9.1.1
- 9.1.0
- 9.0.0
- 8.1.2
- 8.1.1
- 8.1.0
- 8.0.1
- 8.0.0
- 7.2.0
- 7.1.0
- 7.0.0
- 6.1.1
- 6.1.0
- 6.0.0
- 5.1.0
- 5.0.0
- 4.6.0
- 4.5.0
- 4.4.0
- 4.3.0
- 4.2.0
- 4.1.0
- 4.0.0
- 3.1.1
- 3.1.0
- 3.0.0
- 2.2.1
- 2.2.0
- 2.1.1
- 2.1.0
- 2.0.0
- 1.10.1
- 1.10.0
- 1.9.0
- 1.8.0
- 1.7.2
- 1.7.1
- 1.7.0
- 1.6.1
- 1.6.0
- 1.5.0
- 1.4.6
- 1.4.4
- 1.4.2
- 1.4.0
- 1.3.14
- 1.3.12
- 1.3.10
- 1.3.4
- 1.3.2
- 1.3.0
- 1.2.6
- 1.2.4
- 1.2.2
- 1.2.0
- 1.1.8
- 1.1.6
- 1.1.4
- 1.1.2
- 1.1.0
- 1.0.2
- 1.0.0
- 0.99.2
- 0.99.1
- 0.99.0
- 0.9.1
- 0.9.0
- 0.7.0
Installs and maintains php and php modules
cookbook 'php', '= 1.3.4', :supermarket
knife supermarket install php
knife supermarket download php
php Cookbook
Installs and configures PHP 5.3 and the PEAR package management system. Also includes LWRPs for managing PEAR (and PECL) packages along with PECL channels.
Requirements
Platforms
- Debian, Ubuntu
- CentOS, Red Hat, Fedora, Amazon Linux
- Microsoft Windows
Cookbooks
- build-essential
- xml
- mysql
These cookbooks are only used when building PHP from source.
Attributes
-
node['php']['install_method']
= method to install php with, defaultpackage
. -
node['php']['directives']
= Hash of directives and values to append tophp.ini
, default{}
.
The file also contains the following attribute types:
- platform specific locations and settings.
- source installation settings
Resource/Provider
This cookbook includes LWRPs for managing:
- PEAR channels
- PEAR/PECL packages
php_pear_channel
PEAR Channels are alternative sources for PEAR packages. This LWRP 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
Attribute Parameters
- channel_name: name attribute. The name of the channel to discover
- channel_xml: the channel.xml file of the channel you are adding
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 LWRP is clever enough to abstract away the small differences and can be used for managing either. This LWRP 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
- :purge: Purge a pear package (this usually entails removing configuration files as well as the package itself). With pear packages this behaves the same as
:remove
Attribute Parameters
- 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 "mongo" do 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
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_curl
module_fileinfo
module_fpdf
module_gd
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 LWRP. For example, the functionality of the module_memcache
recipe can be enabled in the following ways:
# using apt package "php5-memcache" do action :install end # using pear LWRP php_pear "memcache" do action :install end
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:
name "php" description "Install php from source" override_attributes( "php" => { "install_method" => "source" } ) run_list( "recipe[php]" )
Development
This section details "quick development" steps. For a detailed explanation, see [[Contributing.md]].
-
Clone this repository from GitHub:
$ git clone git@github.com:opscode-cookbooks/php.git
-
Create a git branch
$ git checkout -b my_bug_fix
-
Install dependencies:
$ bundle install
Make your changes/patches/fixes, committing appropiately
Write tests
-
Run the tests:
bundle exec foodcritic -f any .
bundle exec rspec
bundle exec rubocop
bundle exec kitchen test
In detail:
- Foodcritic will catch any Chef-specific style errors
- RSpec will run the unit tests
- Rubocop will check for Ruby-specific style errors
- Test Kitchen will run and converge the recipes
License & Authors
- Author:: Seth Chisamore (schisamo@opscode.com)
- Author:: Joshua Timberman (joshua@opscode.com)
- Author:: Julian C. Dunn (jdunn@getchef.com)
Copyright:: 2013, Chef Software, Inc. 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.
Note: This cookbook contains a modified copy of go-phar.pear
for use on the
Microsoft Windows platform only to correct an (upstream bug)[http://pear.php.net/bugs/bug.php?id=16644]. The original
go-pear.phar
is licensed under the (PHP License version 2.02)[http://www.php.net/license/2_02.txt]:
--------------------------------------------------------------------
The PHP License, version 2.02
Copyright (c) 1999 - 2002 The PHP Group. All rights reserved.
--------------------------------------------------------------------
Redistribution and use in source and binary forms, with or without
modification, is permitted provided that the following conditions
are met:
1. Redistributions of source code must retain the above copyright
notice, this list of conditions and the following disclaimer.
2. Redistributions in binary form must reproduce the above
copyright notice, this list of conditions and the following
disclaimer in the documentation and/or other materials provided
with the distribution.
3. The name "PHP" must not be used to endorse or promote products
derived from this software without prior permission from the
PHP Group. This does not apply to add-on libraries or tools
that work in conjunction with PHP. In such a case the PHP
name may be used to indicate that the product supports PHP.
4. The PHP Group may publish revised and/or new versions of the
license from time to time. Each version will be given a
distinguishing version number.
Once covered code has been published under a particular version
of the license, you may always continue to use it under the
terms of that version. You may also choose to use such covered
code under the terms of any subsequent version of the license
published by the PHP Group. No one other than the PHP Group has
the right to modify the terms applicable to covered code created
under this License.
5. Redistributions of any form whatsoever must retain the following
acknowledgment:
"This product includes PHP, freely available from
http://www.php.net/".
6. The software incorporates the Zend Engine, a product of Zend
Technologies, Ltd. ("Zend"). The Zend Engine is licensed to the
PHP Association (pursuant to a grant from Zend that can be
found at http://www.php.net/license/ZendGrant/) for
distribution to you under this license agreement, only as a
part of PHP. In the event that you separate the Zend Engine
(or any portion thereof) from the rest of the software, or
modify the Zend Engine, or any portion thereof, your use of the
separated or modified Zend Engine software shall not be governed
by this license, and instead shall be governed by the license
set forth at http://www.zend.com/license/ZendLicense/.
THIS SOFTWARE IS PROVIDED BY THE PHP DEVELOPMENT TEAM ``AS IS'' AND
ANY EXPRESSED OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO,
THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A
PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE PHP
DEVELOPMENT TEAM OR ITS CONTRIBUTORS BE LIABLE FOR ANY DIRECT,
INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES
(INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR
SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT,
STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE)
ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED
OF THE POSSIBILITY OF SUCH DAMAGE.
--------------------------------------------------------------------
This software consists of voluntary contributions made by many
individuals on behalf of the PHP Group.
The PHP Group can be contacted via Email at group@php.net.
For more information on the PHP Group and the PHP project,
please see .
Dependent cookbooks
build-essential >= 0.0.0 |
xml >= 0.0.0 |
mysql >= 0.0.0 |
yum-epel >= 0.0.0 |
windows >= 0.0.0 |
iis >= 0.0.0 |