capify-php 1.0.0

data/LICENSE.txt

@@ -0,0 +1,20 @@
+Copyright (c) 2011 Tass Skoudros
+
+Permission is hereby granted, free of charge, to any person obtaining
+a copy of this software and associated documentation files (the
+"Software"), to deal in the Software without restriction, including
+without limitation the rights to use, copy, modify, merge, publish,
+distribute, sublicense, and/or sell copies of the Software, and to
+permit persons to whom the Software is furnished to do so, subject to
+the following conditions:
+
+The above copyright notice and this permission notice shall be
+included in all copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND,
+EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF
+MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND
+NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE
+LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION
+OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION
+WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.

data/README.markdown

@@ -0,0 +1,133 @@
+# capify-php
+
+* capify-php - is a Capistrano extension for PHP without the *rails* tasks.
+
+## Benefits
+
+capify-php is simple to install, it cleanly extends Capistrano, keeping your deploy.rb tidy.
+
+
+## Features
+
+* Same rollback you get from Capistrano
+* Easy to configure
+* Supports exporting PHP libraries from any Git source
+* Setup multiple environments with tasks inside your deploy.rb. (example below)
+
+## Installation
+
+If you don't have capistrano and/or capify-php  installed:
+
+	# gem install capistrano
+	# gem install capify-php -s http://gemcutter.org
+
+For every application you'll want to deploy:
+
+	# cd /path/to/app && capify .
+
+This will create the following files in your project (don't forget to commit them!):
+
+	capfile
+	config/deploy.rb
+
+Prepend your config/deploy.rb with the following lines:
+
+	require 'rubygems'
+	require 'capify-php'
+
+And make sure you start capify-php on the last line of that same file:
+
+	capify-php
+
+You should then be able to proceed as you usually would. To familiarise yourself with the now modified list of tasks, you can get a full list with:
+
+	$ cap -T
+
+## Configuration
+
+Before continuing, some changes to config/deploy.rb are necessary. First, your project's name:
+
+	set :application, "your_app_name"
+
+Next, setting up the Git repository (make sure it's accessible by both your local machine and server your are deploying to):
+
+	set :repository, "git@domain.com:path/to/repo"
+
+Now, to deploy from Git, and by following [GitHub's suggestion](http://github.com/guides/deploying-with-capistrano) (they must know what they are talking about), add a user (defaults to *deploy* by capistrano.php's recipe) to your server(s) just for deployments. In this example, I will be using SSH keys instead of getting a Git password prompt. Local user's SSH key must be added to *deploy*'s ~/.ssh/authorized_keys for this to work as described. 
+
+	ssh_options[:forward_agent] = true
+
+We need to tell it where to deploy, using what methods:
+
+
+You can change the default values for the following variables also:
+
+	set :php_lib_branch, "v2.0.1"
+	set :php_lib_repo, "https://github.com/symfony/symfony.git"
+	set :php_lib_dir, "symfony"
+
+## Deployment
+
+The first time you are deploying, you need to run:
+ 
+	# cap deploy:setup
+
+That should create on your server the following directory structure:
+
+	[deploy_to]
+	[deploy_to]/releases
+	[deploy_to]/shared
+	[deploy_to]/shared/cakephp
+	[deploy_to]/shared/system
+	[deploy_to]/shared/tmp
+
+Finally, deploy:
+
+	# cap deploy
+
+Which will change the directory structure to become:
+
+	[deploy_to]
+	[deploy_to]/current -> [deploy_to]/releases/20091013001122
+	[deploy_to]/releases
+	[deploy_to]/releases/20091013001122
+	[deploy_to]/releases/20091013001122/system -> [deploy_to]/shared/system
+	[deploy_to]/releases/20091013001122/tmp -> [deploy_to]/shared/tmp
+	[deploy_to]/shared
+	[deploy_to]/shared/cakephp
+	[deploy_to]/shared/system
+	[deploy_to]/shared/tmp
+
+## Multiple environments 1 deploy.rb
+
+	desc "Run tasks in production enviroment."
+	task :production do
+  		# Production nodes 
+  		role :web, "webserver-one-hostname-or-ip"
+  		role :app, "webserver-one-hostname-or-ip"
+  		role :web, "webserver-two-hostname-or-ip"
+  		role :app, "webserver-two-hostname-or-ip"
+  		set :branch, "master"
+	end 
+
+	desc "Run tasks in staging enviroment."
+	task :staging do
+  		# Staging nodes 
+  		role :web, "staging-hostname"
+  		role :app, "staging-hostname"
+  		role :db,  "staging-hostname", :primary=>true
+  		set :branch, "develop"
+	end
+
+
+## Patches & Features
+
+* Fork
+* Mod, fix
+* Test - this is important, so it's not unintentionally broken
+* Commit - do not mess with license, todo, version, etc. (if you do change any, make them into commits of their own that I can ignore when I pull)
+* Pull request - bonus point for topic branches
+
+## Bugs & Feedback
+
+http://github.com/askoudros/capify-php/issues

data/README.rdoc

@@ -0,0 +1,103 @@
+# capistrano.php
+
+Deploy a PHP based web application with Capistrano, Capistrano PHP is Capistrano without the *rails* finalisers. It is built to load your source and a extra php library using these extra variables in your deploy.rb.
+
+	set :php_lib_branch, ""
+	set :php_lib_repo, ""
+	set :php_lib_dir, ""
+
+## Installation
+
+If you don't have Capistrano and/or Capistrano.PHP  installed:
+
+	# gem install capistrano
+	# gem install capistrano.php -s http://gemcutter.org
+
+For every application you'll want to deploy:
+
+	# cd /path/to/app && capify .
+
+This will create the following files in your project (don't forget to commit them!):
+
+	capfile
+	config/deploy.rb
+
+Prepend your config/deploy.rb with the following lines:
+
+	require 'rubygems'
+	require 'capistrano.php'
+
+And make sure you start capcake on the last line of that same file:
+
+	capistrano.php
+
+You should then be able to proceed as you usually would. To familiarize yourself with the now modified list of tasks, you can get a full list with:
+
+	$ cap -T
+
+## Configuration
+
+Before continuing, some changes to config/deploy.rb are necessary. First, your project's name:
+
+	set :application, "your_app_name"
+
+Next, setting up the Git repository (make sure it's accessible by both your local machine and server your are deploying to):
+
+	set :repository, "git@domain.com:path/to/repo"
+
+Now, to deploy from Git, and by following [GitHub's suggestion](http://github.com/guides/deploying-with-capistrano) (they must know what they are talking about), add a user (defaults to *deploy* by capistrano.php's recipe) to your server(s) just for deployments. In this example, I will be using SSH keys instead of getting a Git password prompt. Local user's SSH key must be added to *deploy*'s ~/.ssh/authorized_keys for this to work as described. 
+
+	ssh_options[:forward_agent] = true
+
+We need to tell it where to deploy, using what methods:
+
+
+You can change the default values for the following variables also:
+
+	set :php_lib_branch, "v2.0.1"
+	set :php_lib_repo, "https://github.com/symfony/symfony.git"
+	set :php_lib_dir, "symfony"
+
+## Deployment
+
+The first time you are deploying, you need to run:
+
+	# cap deploy:setup
+
+That should create on your server the following directory structure:
+
+	[deploy_to]
+	[deploy_to]/releases
+	[deploy_to]/shared
+	[deploy_to]/shared/cakephp
+	[deploy_to]/shared/system
+	[deploy_to]/shared/tmp
+
+Finally, deploy:
+
+	# cap deploy
+
+Which will change the directory structure to become:
+
+	[deploy_to]
+	[deploy_to]/current -> [deploy_to]/releases/20091013001122
+	[deploy_to]/releases
+	[deploy_to]/releases/20091013001122
+	[deploy_to]/releases/20091013001122/system -> [deploy_to]/shared/system
+	[deploy_to]/releases/20091013001122/tmp -> [deploy_to]/shared/tmp
+	[deploy_to]/shared
+	[deploy_to]/shared/cakephp
+	[deploy_to]/shared/system
+	[deploy_to]/shared/tmp
+
+## Patches & Features
+
+* Fork
+* Mod, fix
+* Test - this is important, so it's not unintentionally broken
+* Commit - do not mess with license, todo, version, etc. (if you do change any, make them into commits of their own that I can ignore when I pull)
+* Pull request - bonus point for topic branches
+
+## Bugs & Feedback
+
+http://github.com/askoudros/capistrano.php/issues

data/lib/capify-php.rb

@@ -0,0 +1,495 @@
+# capify-php Rakefile
+#
+# Author::    Tass Skoudros (mailto:tass@skystack.com)
+# Copyright:: Copyright (c) 2010, Skystack, Limited (http://www.skystack.com)
+# License::
+
+Capistrano::Configuration.instance(:must_exist).load do
+
+  require 'capistrano/recipes/deploy/scm'
+  require 'capistrano/recipes/deploy/strategy'
+
+  # =========================================================================
+  # These variables may be set in the client capfile if their default values
+  # are not sufficient.
+  # =========================================================================
+
+  set :application,   ""
+  set :branch,        "master"
+  set :deploy_to,     ""
+  set :keep_releases, 5
+  set :repository,    ""
+  set :use_sudo,      false
+  set :user,          "deploy"
+
+  # =========================================================================
+  # These variables should NOT be changed unless you are very confident in
+  # what you are doing. Make sure you understand all the implications of your
+  # changes if you do decide to muck with these!
+  # =========================================================================
+
+  set :scm,                   :git
+  set :git_enable_submodules, 1
+  set :revision,              source.head
+  set :deploy_via,            :checkout
+  set :shared_children,       %w(config lib tmp)
+
+  set :git_flag_quiet,        ""
+
+  _cset(:php_lib_branch)      { "" }
+  _cset(:php_lib_repo)        { "" }
+  _cset(:php_lib_dir)         { "" }
+  
+  _cset :tmp_children,        %w(cache logs sessions tests)
+  _cset :cache_children,      %w(models persistent views)
+  _cset :logs_files,          %w(debug error)
+
+  def capify_php()
+    set :deploy_to, "/var/www/#{application}" if (deploy_to.empty?)
+    set(:current_path)        { File.join(deploy_to, current_dir) }
+
+    set(:shared_path)         { File.join(deploy_to, shared_dir) }
+    _cset(:php_lib_path)         { shared_path }
+    _cset(:tmp_path)          { File.join(shared_path, "tmp") }
+    _cset(:cache_path)        { File.join(tmp_path, "cache") }
+    _cset(:logs_path)         { File.join(tmp_path, "logs") }
+
+    after("deploy:setup", "php:database:config") if (!remote_file_exists?(database_path))
+    after("deploy:symlink", "php:database:symlink") if (remote_file_exists?(database_path))
+  end
+
+  def defaults(val, default)
+    val = default if (val.empty?)
+    val
+  end
+
+  def remote_file_exists?(full_path)
+    'true' ==  capture("if [ -e #{full_path} ]; then echo 'true'; fi").strip
+  end
+
+  # =========================================================================
+  # These are the tasks that are available to help with deploying web apps,
+  # and specifically, Rails applications. You can have cap give you a summary
+  # of them with `cap -T'.
+  # =========================================================================
+
+  namespace :deploy do
+    desc <<-DESC
+      Deploys your project. This calls `update'. Note that \
+      this will generally only work for applications that have already been deployed \
+      once. For a "cold" deploy, you'll want to take a look at the `deploy:cold' \
+      task, which handles the cold start specifically.
+    DESC
+    task :default do
+      update
+    end
+    desc <<-DESC
+      Prepares one or more servers for deployment. Before you can use any \
+      of the Capistrano deployment tasks with your project, you will need to \
+      make sure all of your servers have been prepared with `cap deploy:setup'. When \
+      you add a new server to your cluster, you can easily run the setup task \
+      on just that server by specifying the HOSTS environment variable:
+
+        $ cap HOSTS=new.server.com deploy:setup
+
+      It is safe to run this task on servers that have already been set up; it \
+      will not destroy any deployed revisions or data.
+    DESC
+    task :setup, :except => { :no_release => true } do
+      dirs = [deploy_to, releases_path, shared_path]
+      dirs += shared_children.map { |d| File.join(shared_path, d) }
+      tmp_dirs = tmp_children.map { |d| File.join(tmp_path, d) }
+      tmp_dirs += cache_children.map { |d| File.join(cache_path, d) }
+      run "#{try_sudo} mkdir -p #{(dirs + tmp_dirs).join(' ')} && #{try_sudo} chmod -R 777 #{tmp_path}" if (!user.empty?)
+      set :git_flag_quiet, "-q "
+      php.setup if (!php_lib_branch.empty?)
+    end
+
+    desc <<-DESC
+      Copies your project and updates the symlink. It does this in a \
+      transaction, so that if either `update_code' or `symlink' fail, all \
+      changes made to the remote servers will be rolled back, leaving your \
+      system in the same state it was in before `update' was invoked. Usually, \
+      you will want to call `deploy' instead of `update', but `update' can be \
+      handy if you want to deploy, but not immediately restart your application.
+    DESC
+    task :update do
+      transaction do
+        update_code
+        symlink
+      end
+    end
+
+    desc <<-DESC
+      Copies your project to the remote servers. This is the first stage \
+      of any deployment; moving your updated code and assets to the deployment \
+      servers. You will rarely call this task directly, however; instead, you \
+      should call the `deploy' task (to do a complete deploy) or the `update' \
+      task (if you want to perform the `restart' task separately).
+
+      You will need to make sure you set the :scm variable to the source \
+      control software you are using (it defaults to :subversion), and the \
+      :deploy_via variable to the strategy you want to use to deploy (it \
+      defaults to :checkout).
+    DESC
+    task :update_code, :except => { :no_release => true } do
+      on_rollback { run "rm -rf #{release_path}; true" }
+      strategy.deploy!
+      finalize_update
+    end
+
+    desc <<-DESC
+      [internal] Touches up the released code. This is called by update_code \
+      after the basic deploy finishes. It assumes a Rails project was deployed, \
+      so if you are deploying something else, you may want to override this \
+      task with your own environment's requirements.
+
+      This task will make the release group-writable (if the :group_writable \
+      variable is set to true, which is the default). It will then set up \
+      symlinks to the shared directory for the log, system, and tmp/pids \
+      directories, and will lastly touch all assets in public/images, \
+      public/stylesheets, and public/javascripts so that the times are \
+      consistent (so that asset timestamping works).  This touch process \
+      is only carried out if the :normalize_asset_timestamps variable is \
+      set to true, which is the default.
+    DESC
+    task :finalize_update, :except => { :no_release => true } do
+      run "chmod -R g+w #{latest_release}" if fetch(:group_writable, true)
+    end
+
+    desc <<-DESC
+      Updates the symlinks to the most recently deployed version. Capistrano works \
+      by putting each new release of your application in its own directory. When \
+      you deploy a new version, this task's job is to update the `current', \
+      `current/tmp', `current/webroot/system' symlinks to point at the new version. \
+      
+      You will rarely need to call this task directly; instead, use the `deploy' \
+      task (which performs a complete deploy, including `restart') or the 'update' \
+      task (which does everything except `restart').
+    DESC
+    task :symlink, :except => { :no_release => true } do
+      on_rollback do
+        if previous_release
+          run "rm -f #{current_path}; ln -s #{previous_release} #{current_path}; true"
+        else
+          logger.important "no previous release to rollback to, rollback of symlink skipped"
+        end
+      end
+      run "rm -f #{current_path} && ln -s #{latest_release} #{current_path}"
+    end
+
+    desc <<-DESC
+      Copy files to the currently deployed version. This is useful for updating \
+      files piecemeal, such as when you need to quickly deploy only a single \
+      file. Some files, such as updated templates, images, or stylesheets, \
+      might not require a full deploy, and especially in emergency situations \
+      it can be handy to just push the updates to production, quickly.
+
+      To use this task, specify the files and directories you want to copy as a \
+      comma-delimited list in the FILES environment variable. All directories \
+      will be processed recursively, with all files being pushed to the \
+      deployment servers.
+
+        $ cap deploy:upload FILES=templates,controller.rb
+
+      Dir globs are also supported:
+
+        $ cap deploy:upload FILES='config/apache/*.conf'
+    DESC
+    task :upload, :except => { :no_release => true } do
+      files = (ENV["FILES"] || "").split(",").map { |f| Dir[f.strip] }.flatten
+      abort "Please specify at least one file or directory to update (via the FILES environment variable)" if files.empty?
+
+      files.each { |file| top.upload(file, File.join(current_path, file)) }
+    end
+
+    namespace :rollback do
+      desc <<-DESC
+        [internal] Points the current symlink at the previous revision.
+        This is called by the rollback sequence, and should rarely (if
+        ever) need to be called directly.
+      DESC
+      task :revision, :except => { :no_release => true } do
+        if previous_release
+          run "rm #{current_path}; ln -s #{previous_release} #{current_path};"
+        else
+          abort "could not rollback the code because there is no prior release"
+        end
+      end
+
+      desc <<-DESC
+        [internal] Removes the most recently deployed release.
+        This is called by the rollback sequence, and should rarely
+        (if ever) need to be called directly.
+      DESC
+      task :cleanup, :except => { :no_release => true } do
+        run "if [ `readlink #{current_path}` != #{current_release} ]; then rm -rf #{current_release}; fi"
+      end
+
+      desc <<-DESC
+        Rolls back to the previously deployed version. The `current' symlink will \
+        be updated to point at the previously deployed version, and then the \
+        current release will be removed from the servers.
+      DESC
+      task :code, :except => { :no_release => true } do
+        revision
+        cleanup
+      end
+
+      desc <<-DESC
+        Rolls back to a previous version and restarts. This is handy if you ever \
+        discover that you've deployed a lemon; `cap rollback' and you're right \
+        back where you were, on the previously deployed version.
+      DESC
+      task :default do
+        revision
+        cleanup
+      end
+    end
+
+    desc <<-DESC
+      Clean up old releases. By default, the last 5 releases are kept on each \
+      server (though you can change this with the keep_releases variable). All \
+      other deployed revisions are removed from the servers. By default, this \
+      will use sudo to clean up the old releases, but if sudo is not available \
+      for your environment, set the :use_sudo variable to false instead.
+    DESC
+    task :cleanup, :except => { :no_release => true } do
+      count = fetch(:keep_releases, 5).to_i
+      if count >= releases.length
+        logger.important "no old releases to clean up"
+      else
+        logger.info "keeping #{count} of #{releases.length} deployed releases"
+
+        directories = (releases - releases.last(count)).map { |release|
+          File.join(releases_path, release) }.join(" ")
+
+        try_sudo "rm -rf #{directories}"
+      end
+    end
+
+    desc <<-DESC
+      Test deployment dependencies. Checks things like directory permissions, \
+      necessary utilities, and so forth, reporting on the things that appear to \
+      be incorrect or missing. This is good for making sure a deploy has a \
+      chance of working before you actually run `cap deploy'.
+
+      You can define your own dependencies, as well, using the `depend' method:
+
+        depend :remote, :gem, "tzinfo", ">=0.3.3"
+        depend :local, :command, "svn"
+        depend :remote, :directory, "/u/depot/files"
+    DESC
+    task :check, :except => { :no_release => true } do
+      dependencies = strategy.check!
+
+      other = fetch(:dependencies, {})
+      other.each do |location, types|
+        types.each do |type, calls|
+          if type == :gem
+            dependencies.send(location).command(fetch(:gem_command, "gem")).or("`gem' command could not be found. Try setting :gem_command")
+          end
+
+          calls.each do |args|
+            dependencies.send(location).send(type, *args)
+          end
+        end
+      end
+
+      if dependencies.pass?
+        puts "You appear to have all necessary dependencies installed"
+      else
+        puts "The following dependencies failed. Please check them and try again:"
+        dependencies.reject { |d| d.pass? }.each do |d|
+          puts "--> #{d.message}"
+        end
+        abort
+      end
+    end
+
+    desc <<-DESC
+      Deploys and starts a `cold' application. This is useful if you have never \
+      deployed your application before. It currently runs `deploy:setup` followed \
+      by `deploy:update`. \
+      (This is still an experimental feature, and is subject to change without \
+      notice!)
+    DESC
+    task :cold do
+      setup
+      update
+    end
+
+    namespace :pending do
+      desc <<-DESC
+        Displays the `diff' since your last deploy. This is useful if you want \
+        to examine what changes are about to be deployed. Note that this might \
+        not be supported on all SCM's.
+      DESC
+      task :diff, :except => { :no_release => true } do
+        system(source.local.diff(current_revision))
+      end
+
+      desc <<-DESC
+        Displays the commits since your last deploy. This is good for a summary \
+        of the changes that have occurred since the last deploy. Note that this \
+        might not be supported on all SCM's.
+      DESC
+      task :default, :except => { :no_release => true } do
+        from = source.next_revision(current_revision)
+        system(source.local.log(from))
+      end
+    end
+
+    namespace :web do
+      desc <<-DESC
+        Present a maintenance page to visitors. Disables your application's web \
+        interface by writing a "maintenance.html" file to each web server. The \
+        servers must be configured to detect the presence of this file, and if \
+        it is present, always display it instead of performing the request.
+
+        By default, the maintenance page will just say the site is down for \
+        "maintenance", and will be back "shortly", but you can customize the \
+        page by specifying the REASON and UNTIL environment variables:
+
+          $ cap deploy:web:disable \\
+                REASON="hardware upgrade" \\
+                UNTIL="12pm Central Time"
+
+        Further customization will require that you write your own task.
+      DESC
+      task :disable, :roles => :web, :except => { :no_release => true } do
+        require 'erb'
+        on_rollback { run "rm #{shared_path}/system/maintenance.html" }
+
+        warn <<-EOHTACCESS
+
+          # Please add something like this to your site's htaccess to redirect users to the maintenance page.
+          # More Info: http://www.shiftcommathree.com/articles/make-your-rails-maintenance-page-respond-with-a-503
+
+          ErrorDocument 503 /system/maintenance.html
+          RewriteEngine On
+          RewriteCond %{REQUEST_URI} !\.(css|gif|jpg|png)$
+          RewriteCond %{DOCUMENT_ROOT}/system/maintenance.html -f
+          RewriteCond %{SCRIPT_FILENAME} !maintenance.html
+          RewriteRule ^.*$  -  [redirect=503,last]
+        EOHTACCESS
+
+        reason = ENV['REASON']
+        deadline = ENV['UNTIL']
+
+        template = File.read(File.join(File.dirname(__FILE__), "templates", "maintenance.rhtml"))
+        result = ERB.new(template).result(binding)
+
+        put(result, "#{shared_path}/system/maintenance.html", :mode => 0644, :via => :scp)
+      end
+
+      desc <<-DESC
+        Makes the application web-accessible again. Removes the \
+        "maintenance.html" page generated by deploy:web:disable, which (if your \
+        web servers are configured correctly) will make your application \
+        web-accessible again.
+      DESC
+      task :enable, :roles => :web, :except => { :no_release => true } do
+        run "rm #{shared_path}/system/maintenance.html"
+      end
+    end
+
+    desc <<-DESC
+      Quick server(s) reset. For now, it deletes all files/folders in :deploy_to \
+      (This is still an experimental feature, and is subject to change without \
+      notice!) \
+
+      Used only when first testing setup deploy recipes and want to quickly \
+      reset servers.
+    DESC
+    task :destroy do
+      set(:confirm) do
+        Capistrano::CLI.ui.ask "This will delete your project on all servers. Are you sure you wish to continue? [Y/n]"
+      end
+      run "#{try_sudo} rm -rf #{deploy_to}/*" if (confirm == "Y")
+    end
+
+  end
+
+  namespace :php do
+
+    desc <<-DESC
+      Prepares server for deployment of a PHP application. \
+
+      By default, it will create a shallow clone of the PHP source repository \
+      inside #{shared_path}/php and run deploy:php:update.
+
+      For more info about shallow clones: \
+      http://www.kernel.org/pub/software/scm/git/docs/git-clone.html \
+
+      Further customization will require that you write your own task.
+    DESC
+    desc "Prepares server for deployment of a PHP application"
+    task :setup do
+      run "cd #{php_lib_path} && git clone --depth 1 #{php_lib_repo} #{php_lib_dir}"
+      set :git_flag_quiet, "-q "
+      update
+    end
+    desc <<-DESC
+      Force PHP installation to checkout a new branch/tag. \
+
+      By default, it will checkout the :php_lib_branch you set in \
+      deploy.rb, but you can change that on runtime by specifying \
+      the BRANCH environment variable:
+
+        $ cap deploy:php:update \\
+              BRANCH="1.3.0-alpha"
+
+      Further customization will require that you write your own task.
+    DESC
+    task :update do
+      set :php_branch, ENV['BRANCH'] if ENV.has_key?('BRANCH')
+      stream "cd #{php_lib_path}/#{php_lib_dir} && git checkout #{git_flag_quiet} #{php_lib_branch}"
+    end
+
+    namespace :cache do
+      desc <<-DESC
+        Clears anything in the cache.
+
+        Recursively finds all files in :cache_path and runs `rm -f` on each. If a file \
+        is renamed/removed after it was found but before it removes it, no error \
+        will prompt (-ignore_readdir_race). If symlinks are found, they will not be followed
+
+        You will rarely need to call this task directly; instead, use the `deploy' \
+        task (which performs a complete deploy, including `php:cache:clear')
+      DESC
+      task :clear, :roles => :web, :except => { :no_release => true } do
+        run "#{try_sudo} find -P #{cache_path} -ignore_readdir_race -type f -name '*' -exec rm -f {} \\;"
+      end
+    end
+
+    namespace :logs do
+      desc <<-DESC
+        Clears PHP's logs
+
+        Recursively finds all files in :logs_path and runs `rm -f` on each. If a file \
+        is renamed/removed after it was found but before it removes it, no error \
+        will prompt (-ignore_readdir_race). If symlinks are found, they will not be followed
+
+      DESC
+      task :clear, :roles => :web, :except => { :no_release => true } do
+        run "#{try_sudo} find -P #{logs_path} -ignore_readdir_race -type f -name '*' -exec rm -f {} \\;"
+      end
+      desc <<-DESC
+        Streams the result of `tail -f` on all :logs_files \
+
+        By default, the files are `debug` and `error`. You can add your own \
+        in config/deploy.rb
+
+          set :logs_files %w(debug error my_log_file)
+
+      DESC
+      task :tail, :roles => :web, :except => { :no_release => true } do
+        files = logs_files.map { |d| File.join(logs_path, d) }
+        stream "#{try_sudo} tail -f #{files.join(' ')}"
+      end
+    end
+
+  end
+
+end # Capistrano::Configuration.instance(:must_exist).load do

data/lib/templates/maintenance.rhtml

@@ -0,0 +1,52 @@
+<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
+       "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
+
+<html xmlns="http://www.w3.org/1999/xhtml" xml:lang="en" lang="en">
+
+<head>
+  <meta http-equiv="content-type" content="text/html;charset=UTF-8" />
+  <title>System down for maintenance</title>
+
+  <style type="text/css">
+    div.outer {
+      position: absolute;
+      left: 50%;
+      top: 50%;
+      width: 500px;
+      height: 300px;
+      margin-left: -260px; 
+      margin-top: -150px;
+    }
+
+    .DialogBody {
+      margin: 0;
+      padding: 10px;
+      text-align: left;
+      border: 1px solid #ccc;
+      border-right: 1px solid #999;
+      border-bottom: 1px solid #999;
+      background-color: #fff;
+    }
+
+    body { background-color: #fff; }
+  </style>
+</head>
+
+<body>
+
+  <div class="outer">
+     <div class="DialogBody" style="text-align: center;">
+       <div style="text-align: center; width: 200px; margin: 0 auto;">
+         <p style="color: red; font-size: 16px; line-height: 20px;">
+           The system is down for <%= reason ? reason : "maintenance" %>
+           as of <%= Time.now.strftime("%H:%M %Z") %>.
+         </p>
+         <p style="color: #666;">
+           It'll be back <%= deadline ? deadline : "shortly" %>.
+         </p>
+       </div>
+     </div>
+  </div>
+
+</body>
+</html>

metadata

@@ -0,0 +1,146 @@
+--- !ruby/object:Gem::Specification 
+name: capify-php
+version: !ruby/object:Gem::Version 
+  hash: 23
+  prerelease: 
+  segments: 
+  - 1
+  - 0
+  - 0
+  version: 1.0.0
+platform: ruby
+authors: 
+- Tass Skoudros
+autorequire: 
+bindir: bin
+cert_chain: []
+
+date: 2011-09-14 00:00:00 Z
+dependencies: 
+- !ruby/object:Gem::Dependency 
+  version_requirements: &id001 !ruby/object:Gem::Requirement 
+    none: false
+    requirements: 
+    - - ">="
+      - !ruby/object:Gem::Version 
+        hash: 9
+        segments: 
+        - 2
+        - 5
+        version: "2.5"
+  name: capistrano
+  prerelease: false
+  type: :runtime
+  requirement: *id001
+- !ruby/object:Gem::Dependency 
+  version_requirements: &id002 !ruby/object:Gem::Requirement 
+    none: false
+    requirements: 
+    - - ~>
+      - !ruby/object:Gem::Version 
+        hash: 23
+        segments: 
+        - 1
+        - 0
+        - 0
+        version: 1.0.0
+  name: bundler
+  prerelease: false
+  type: :development
+  requirement: *id002
+- !ruby/object:Gem::Dependency 
+  version_requirements: &id003 !ruby/object:Gem::Requirement 
+    none: false
+    requirements: 
+    - - ~>
+      - !ruby/object:Gem::Version 
+        hash: 7
+        segments: 
+        - 1
+        - 6
+        - 4
+        version: 1.6.4
+  name: jeweler
+  prerelease: false
+  type: :development
+  requirement: *id003
+- !ruby/object:Gem::Dependency 
+  version_requirements: &id004 !ruby/object:Gem::Requirement 
+    none: false
+    requirements: 
+    - - ">="
+      - !ruby/object:Gem::Version 
+        hash: 3
+        segments: 
+        - 0
+        version: "0"
+  name: rcov
+  prerelease: false
+  type: :development
+  requirement: *id004
+- !ruby/object:Gem::Dependency 
+  version_requirements: &id005 !ruby/object:Gem::Requirement 
+    none: false
+    requirements: 
+    - - ">="
+      - !ruby/object:Gem::Version 
+        hash: 9
+        segments: 
+        - 2
+        - 5
+        version: "2.5"
+  name: capistrano
+  prerelease: false
+  type: :runtime
+  requirement: *id005
+description: Deploy PHP applications using Capistrano.
+email: tass@skystack.com
+executables: []
+
+extensions: []
+
+extra_rdoc_files: 
+- LICENSE.txt
+- README.markdown
+- README.rdoc
+files: 
+- lib/capify-php.rb
+- lib/templates/maintenance.rhtml
+- LICENSE.txt
+- README.markdown
+- README.rdoc
+homepage: https://github.com/skystack/capify-php
+licenses: []
+
+post_install_message: 
+rdoc_options: []
+
+require_paths: 
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement 
+  none: false
+  requirements: 
+  - - ">="
+    - !ruby/object:Gem::Version 
+      hash: 3
+      segments: 
+      - 0
+      version: "0"
+required_rubygems_version: !ruby/object:Gem::Requirement 
+  none: false
+  requirements: 
+  - - ">="
+    - !ruby/object:Gem::Version 
+      hash: 3
+      segments: 
+      - 0
+      version: "0"
+requirements: []
+
+rubyforge_project: 
+rubygems_version: 1.8.10
+signing_key: 
+specification_version: 3
+summary: All the power of Capistrano for PHP.
+test_files: []
+