Repository files navigation

Cookbook to install php and apache2

• Debian Buster (probably works for previous versions and ubuntu too)

• Chef 13.0+

Create a wrapper cookbook and add this cookbook to your Berksfile/Metadata.

In your recipie you can use the existing resources, e.g.

codenamephp_php_sury_repository'sury-php'codenamephp_php_package'install php 5.6'dopackage_name"php5.6-cli"endcodenamephp_php_package'install php 7.4'dopackage_name"php7.4-cli"additional_packages%w[php7.4-fpmphp7.4-curlphp7.4-gd]endcodenamephp_php_composer'install composer'codenamephp_php_xdebug'install xdebug'dophp_versions%w[5.67.4]services%w[clifpm]end

This resource can be used to install composer globally.

• :install: Install the composer binary (phar) by downloading it from composer homepage and putting it to a folder that is in the path.

• binary_path: The path where the binary will be placed, default:/usr/bin/composer
• source: An alias or a source url from where the binary will be downloaded. If the alias is not recognized the source is used as is so it should be a valid url. default:stable, supported aliases:
  • stable
  • preview
  • snapshot
  • 1
  • 2

# Minmal parameterscodenamephp_php_composer'install composer'# Custom source and pathcodenamephp_php_composer'install composer'dobinary_path'/my/custom/executable/path'source'snapshot'end

This config can be used to create and manage configurations.

• enable: Creates or updates the config and enables it by symlinking it for the given services
• create: Creates or updates the config without enabling it
• disable: Removes the symlink from the given services but does not delete the config
• delete: Disables and delete the config

• cookbook_file: The file from the cookbook that will be used as config
• php_versions: The php versions the config will be managed for as string array
• config_name: The name the config will get in the mods-available folder
• priority: The prefix the symlink will get to determine the sequence the config is loaded in, default:30 (after default configs which have 20)
• services: The services the config should be managed for, default:['cli', 'apache2', 'fpm']
• cookbook_file_cookbook: The cookbook the cookfile_file will be taken from, default:codenamephp_php

# Minimal configcodenamephp_php_config'configure xdebug'docookbook_file'xdebug.ini'php_versions%w[5.67.2]config_name'xdebug-custom.ini'end# Custom configcodenamephp_php_config'configure xdebug'docookbook_file'super-xdebug.ini'php_versions%w[5.67.2]config_name'super-xdebug-custom.ini'priority40services%w[cli]cookbook_file_cookbook'my_cookbook'end

This package is used to install php and additional extensions from package

• install: Installs php and additional extensions

• package_name: The name of the base package, default:php
• additional_packages: Additional packages to install, default:[]

# Minimalcodenamephp_php_package'install php'# Custom package and extensionscodenamephp_php_package'install php'dopackage_name'php7.2-cli'additional_packages%w[php7.2-jsonphp7.2-xml]end

This resource is used to install the repository fromOndřej Surý to apt.

• add: Adds the repository to apt sources

• uri: The uri of the repository, default:https://packages.sury.org/php/
• repo_name: The name the repository will get, default:sury_php
• components: The components that will be used, default:main
• key: The source of the key the repo is signed with, default:https://packages.sury.org/php/apt.gpg

# Minimalcodenamephp_php_sury_repository'add sury repository'

This resource can be used to install xdebug with a default configuraiton.

• install: Installs the xdebug extension and configuration for the given php versions
• remove: Removes the extensionand configuration

• php_versions: The php versions the config will be managed for as string array
• package_name: The name of the package that will be installed, default:php-xdebug
• config_name: The name of the custom config that will be created, default:xdebug-custom.ini
• config_cookbook_file: The cookbook file that will be used as config, default:xdebug.ini
• config_cookbook_file_cookbook: The cookbook the cookbook file will be taken from, default:codenamephp_php
• add_sury_repository: If the sury repository should be added, default:true
• services: The services the config should be managed for, default:['apache2', 'fpm']

# Minimal configcodenamephp_php_xdebug'install xdebug'dophp_versions%w[5.67.2]end

This resources installsPhive as global command line tool

• install: Downloads, verifies and installs the phar
• uninstall: Removes the phar

• binary_path: The final path where the binary will be put. Should be in the system path, default:'/usr/bin/phive'
• binary_temp_path: The path where the phar will be downloaded to prior to verification, default:'/tmp/phive.phar'
• source: The source from where the phar will be downloaded, default:'https://phar.io/releases/phive.phar'
• key_uri: The uri from where the key for verification will be downloaded, default:'https://phar.io/releases/phive.phar.asc'
• key_path: The path to where the key will be downloaded to prior to verifcation, default:'/tmp/phive.phar.asc'
• install_php_dependencies: Flag if the dependencies (php and some extensions) should be installed, default: trueKeep in mind that if you set these to false, you need to install the dependencies yourself or Phive might not work
• php_version: The desired php version that will be used when installing the dependencies. This is usesd as prefix, e.g. php7.4 -> php7.4-curl'The 'php' is normalized so you can either pass 'phpX.X' or just 'X.X'

# Minimal configcodenamephp_php_phive'install phive'

# With custom php versioncodenamephp_php_phive'install phive'dophp_version'8.0'end

# Without php dependenciescodenamephp_php_phive'install phive'doinstall_php_dependenciesfalseend

The default cookbook is a No-Op since you want to choose your PHP version and stick to it. Having the default cookbook to install some "random" version could leadto unexpected updates and would cause more breaking changes.