Low commit activity in last 3 years
No release in over a year
Executes PHP-FPM service tasks like zap or restart from Capistrano
2005
2006
2007
2008
2009
2010
2011
2012
2013
2014
2015
2016
2017
2018
2019
2020
2021
2022
2023
2024
 Dependencies

Development

~> 10.1

Runtime

 Project Readme

Capistrano PHP-FPM

Official Capistrano extension for PHP-FPM tasks. This replaces 1.0.0 of https://rubygems.org/gems/capistrano-fpm. It differs greatly in configuration.

Environments Supported

systemd sysv & upstart
capistrano/php_fpm/systemd capistrano/php_fpm/sysv_upstart

Installation

Add this line to your application's Gemfile:

gem 'capistrano', '~> 3.2'
gem 'capistrano-php-fpm'

Usage

Require one of the above 'Environments Supported' in your Capfile:

require 'capistrano/php_fpm/sysv_upstart'

capistrano/php_fpm comes with 5 tasks:

  • php_fpm:reload
  • php_fpm:restart
  • php_fpm:stop
  • php_fpm:start
  • php_fpm:zap

You can execute the task on command line:

cap production php_fpm:reload

And configure it on your deploy.rb file:

namespace :deploy do
  after :finishing, 'php_fpm:reload'
  after :rollback, 'php_fpm:reload'
end

Configuration

Configurable options shown here are also the defaults:

set :php_fpm_with_sudo, true
set :php_fpm_roles, :web
set :php_fpm_service_name, 'php-fpm' # Change this if you have non-standard naming for the php-fpm service
set :php_fpm_service_suffix, '.service' # Only used for systemd environment, change this if your service name is not sufixed by this
set :systemctl_location, '/bin/systemctl' # May already exist if you use other plugins. Be sure to check your config/deploy/{env} file

More Capistrano automation?

Check out capistrano-plugins github org.

Contributing and bug reports

Contributions and improvements are very welcome.

If something is not working for you, or you find a bug please report it.

Thanks

License

MIT