Webarchitects PHP Ansible role

This Ansible role is designed to install and configure PHP on Debian, by default it installs packages from deb.sury.org, but it can also be used to install and cpnfigure only PHP packages from Debian.

Role variables

See the defaults/main.yml file for the default variables, the vars/main.yml file for the preset variables and the meta/argument_specs.yml file for the variable specification.

This roles has one required boolean variable and two optional boolean variables and two optional lists:

php

The php variable is required to be defined, by default it is true, when it is false all tasks in this role will be skipped.

php_check_legacy_variables

The optional php_check_legacy_variables variable is true by default, this results in the role failing if any variables names from older versions of this role are defined, set it to false to skip these checks.

php_sury

The optional php_sury variable is true by default which results in the Debian PHP repo provided by Ondřej Surý being enabled for installing .deb packages. When php_sury is false the Ondřej Surý repo configuration is removed if present.

php_config

The optional php_config list is used to specify the state of the PHP configuration, it enables the editing, generating and removal of PHP .conf and .ini files.

Each item in the list requires a state, which can be absent or present and a version which must be a string from this list of PHP versions:

- "8.2"
- "8.1"
- "8.0"
- "7.4"
- "7.3"
- "7.2"
- "7.1"
- "7.0"
- "5.6"

Optional item variables are name and files, which is used to define the PHP version configuration state.

The files dictionary requires a path and state for each file, the state can be one of four options:

- absent
- edited
- present
- templated

The edited state can only be used for existing files, it enables the Ansible ini module to be used to edit configuration files withoiyt the need to template them.

The present state will result in existing files being edited and not existing files to be templated.

The templated state can be used to generate new configuration files.

File configuration is defined using a conf dictionary.

An example php_config item:

php_config:
  - name: PHP 8.2 configuration
    version: "8.2"
    state: present
    files:
      - name: PHP 8.2 FPM configuration
        path: /etc/php/8.2/fpm/php.ini
        state: edited
        conf:
          apc:
            "apc.enabled": "1"
          Date:
            "date.timezone": "Europe/London"

php_versions

The optional php_versions list is used to install and remove PHP packages, each item in the list requires a state, which can be absent or present and a version which must be a string from this list of PHP versions:

- "8.2"
- "8.1"
- "8.0"
- "7.4"
- "7.3"
- "7.2"
- "7.1"
- "7.0"
- "5.6"

Two optional lists, pkg_absent and pkg_present are used to list .deb packages that are to be installed or removed.

An example php_versions item:

php_versions:
  - name: PHP 8.2 packages
    version: "8.2"
    state: present
    pkg_absent:
      - libapache2-mod-php8.2
    pkg_present:
      - php8.2-apcu

Help

Reinstall a package and the configuration files when they have been deleted (see serverfault comment):

UCF_FORCE_CONFFMISS=1  apt-get -o Dpkg::Options::="–force-confmiss" install "php8.1-fpm"

Repository

The primary URL of this repo is https://git.coop/webarch/php however it is also mirrored to GitHub and available via Ansible Galaxy.

If you use this role please use a tagged release, see the release notes.

In June 2021 this role was renamed from phpfpm to php and the URL of the git repo was updated to match, at the same time the git repo that was at https://git.coop/webarch/php was archived to git.coop/webarch/php7.

Copyright

Copyright 2019-2023 Chris Croome, <chris@webarchitects.co.uk>.

This role is released under the same terms as Ansible itself, the GNU GPLv3.