a32f34b408
Knife-Zero doesn't include Berkshelf support, so vendoring everything in the repo is convenient again
143 lines
3.5 KiB
Markdown
143 lines
3.5 KiB
Markdown
[](https://travis-ci.org/yevgenko/cookbook-php-fpm)
|
|
|
|
# Description
|
|
|
|
Installs and configures PHP-FPM (FastCGI Process Manager), an alternative PHP FastCGI implementation with some additional features useful for sites of any size, especially busier sites. It's like the `unicorn` of the PHP world dawg.
|
|
|
|
# Requirements
|
|
|
|
## Platform
|
|
|
|
- Debian, Ubuntu
|
|
- CentOS, Red Hat, Fedora
|
|
- Amazon Linux
|
|
|
|
## Cookbooks
|
|
|
|
- none
|
|
|
|
## Chef
|
|
|
|
- 12.14 or later
|
|
|
|
# Description
|
|
|
|
Creates a PHP-FPM configuration file at the path specified. Meant to be deployed with a service init scheme/supervisor such as runit. Please see the `application::php-fpm` recipe for a complete working example. In depth information about PHP-FPM's configuration values can be [found in the PHP-FPM documentation](http://php.net/manual/en/install.fpm.configuration.php).
|
|
|
|
# Usage
|
|
|
|
Simply include the recipe where you want PHP-FPM installed. Default pool **www** will be created. To disable pool creation set default['php-fpm']['pools'] to false.
|
|
|
|
To customize settings and pools you can override default attributes.
|
|
|
|
## Usage in roles:
|
|
|
|
```ruby
|
|
name "php-fpm"
|
|
description "php fpm role"
|
|
run_list "recipe[php-fpm]"
|
|
override_attributes "php-fpm" => {
|
|
"pools" => {
|
|
"default" => {
|
|
:enable => true
|
|
},
|
|
"www" => {
|
|
:enable => "true",
|
|
:cookbook => "another-cookbook",
|
|
:process_manager => "dynamic",
|
|
:max_requests => 5000,
|
|
:php_options => { 'php_admin_flag[log_errors]' => 'on', 'php_admin_value[memory_limit]' => '32M' }
|
|
}
|
|
}
|
|
}
|
|
```
|
|
|
|
# Creating pools in recipes
|
|
|
|
## Create PHP-FPM pool named 'www' with default settings:
|
|
|
|
```ruby
|
|
php_fpm_pool "www"
|
|
```
|
|
|
|
## Create PHP-FPM pool named 'www' with custom settings:
|
|
|
|
```ruby
|
|
php_fpm_pool "www" do
|
|
cookbook "another-cookbook" # get template from another cookbook
|
|
process_manager "dynamic"
|
|
max_requests 5000
|
|
php_options 'php_admin_flag[log_errors]' => 'on', 'php_admin_value[memory_limit]' => '32M'
|
|
end
|
|
```
|
|
|
|
## Delete PHP-FPM pool named 'www':
|
|
|
|
```ruby
|
|
php_fpm_pool "www" do
|
|
enable false
|
|
end
|
|
```
|
|
|
|
# Development
|
|
|
|
## Requirements
|
|
|
|
- [Docker](https://www.docker.com/)
|
|
|
|
## Setup
|
|
|
|
To get all dependencies:
|
|
|
|
```
|
|
bundle install
|
|
```
|
|
|
|
## Test
|
|
|
|
To see available platforms:
|
|
|
|
```
|
|
bundle exec rake -T
|
|
```
|
|
|
|
To test particular platform:
|
|
|
|
```
|
|
bundle exec rake kitchen:default-ubuntu-1604
|
|
```
|
|
|
|
To test all platforms:
|
|
|
|
```
|
|
bundle exec rake kitchen:all
|
|
```
|
|
|
|
## Publishing (maintainers only!)
|
|
|
|
Bump version in metadata.rb, commit and push to master!
|
|
|
|
```
|
|
bundle exec rake publish
|
|
```
|
|
|
|
as a result new tag will be created and pushed to github as well as new version will be published on <https://supermarket.chef.io>
|
|
|
|
# Contributing
|
|
|
|
Please do not bump version when proposing a change, no other rules ;)
|
|
|
|
# License and Author
|
|
|
|
Author:: Seth Chisamore ([schisamo@chef.io](mailto:schisamo@chef.io))
|
|
|
|
Copyright:: 2011-2017, 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.
|