acromedia / ansible-role-php

Install and configure PHP for use in Acro hosting environments

Ansible role: PHP

Install and configure PHP, typically for use with Drupal sites in Acro Media NGINX + FPM hosting environments.

Requirements

• Ubuntu LTS (20.04 or newer)

Role Variables

php_default_version

• The default CLI version of php to set on the server.
• Defaults to 8.3

php_memory_limit

• The default maximum memory limit
• Applies to all php versions installed
• Defaults to 256M.

php_max_input_vars

• The maximum number of input vars that can be accepted in a POST request
• Drupal typically needs this way higher than the default
• Applies to all php versions installed
• Defaults to 3001.

php_versions

• A list of versions to install.
• Defaults to [ {{php_default_version}} ].

For PHP 8.0 and before:

• See defaults/main.yml - Up to and including PHP 8.0, the add_modules and default modules list were version-specific variables.

For PHP 8.1 and later:

php_add_modules

• A list of extra apt packages not already included in the default list. See defaults/main.yml.
• The modules you specify must be the full name of the apt package to install. (See example playbook below)
• Defaults to an empty list. []

php_modules

• Not defined by default, so the role can define it and populated it, based on the combination of php_versions and php_default_module_name_suffixes (see defaults/main.yml)
• If you define this var in your playbook, your var will completely override the ENTIRE list of ALL modules, for ANY PHP >= 8.1 version that the role would normally install. E.g. If you have multiple versions of php installed, you'll need to specify all modules for every version yourself.

php_use_legacy_module_lists

• Defaults to true
• For compatibility with older playbooks that have been using the role, and have custom module specifications.
• Setting this to false will let the role the use 8.1-style package name generator for all (older) php versions, as well as 8.1 and beyond.
• If your role doesn't use any version specific lists (see defaults/main.yml), then it's safe to set this to false.

Dependencies

None

Example Playbook

- name: Install + Configure PHP
  hosts: servers
  gather_facts: yes
  become: yes
  vars:
    php_default_version: '8.1'
    php_versions:
      - '7.4'
      - '8.0'
      - '8.1'
    php_add_modules:
      - php7.4-foo
      - php8.0-foo
      - php8.1-foo
      - php8.1-bar
    # php_use_legacy_module_lists: ... See variable documentation.
  roles:
    - role: acromedia.php
      tags:
        - php

License

GPLv3

Author Information

Acro Media Inc. https://www.acromedia.com/

ansible-role-php's Issues

Support ubuntu 22.04

PPA tries to access ubuntu "sid" repository in molecule test

Which is obviously wrong. Sid is a debian version, not ubuntu. I can't tell if this is an ansible problem or a molecule problem.

The exact error presents as:

TASK [contrib/acromedia.php : Add ondrej repo to allow multiple PHP versions] ***
fatal: [instance]: FAILED! => {"changed": false, "msg": "Failed to update apt cache: E:The repository 'http://ppa.launchpad.net/ondrej/php/ubuntu sid Release' does not have a Release file."}

Add 8.2, remove 7.4

8.2 has been released, 7.4 is EOL.

See https://www.php.net/supported-versions.php

Role fails if FPM module is excluded

The list of packages can be overridden. If the FPM package is excluded, the role fails because it tries to act on files that aren't present.

Need support for PHP 8.1

While we're at it, can we provide support for future X.x versions of PHP?

Fix molecule tests since 22.04

New docker updates have broken all molecule tests that use systemd.

See recent changes to acro's nginx, virtual host roles, or to some of geerlingguy's roles for reference.

new relic reporting dies when new php version is added

This is a bit beyond the scope of this role, but it would be nice for the role to do some checking to see if new relic is installed, so the operator has a chance to address new relic.

Add support for PHP 8.0