---

argument_specs:

  main:
    version_added: "0.0.1"
    short_description: Install and configure PHP FPM.
    description:
      - Install and configure PHP FPM.
      - Installation is done either from distribution packages or from U(deb.sury.org).
      - "Execution of this role can be limited using the following tags:"
      - "C(role::php:install): Install all php packages required by Nextcloud."
      - "C(role::php:config): Configure the PHP FPM and CLI components as recommended by Nextcloud."
      - "C(role::php): Apply all of the above."
    author: s3lph
    options:
      php_version:
        description:
          - The installed PHP version.
          - Required to restart C(php-fpm) after adding C(www-data) to the C(keydb) group.
        type: str
        default: "8.2"
      php_use_sury_repo:
        description:
          - If true, install PHP packages from U(deb.sury.org).
          - If false, install PHP packages from the regular distribution packages.
        type: bool
        default: false
      php_ini:
        description:
          - Nested dict of PHP configuration options.
          - Outer dict defines the INI section, inner dict the options and their values.
          - All options are applied to the FPM and CLI components of PHP.
        type: dict
        default:
          PHP:
            memory_limit: "512M"
            upload_max_filesize: "2G"
          opcache:
            opcache.enable: "1"
            opcache.memory_consumption: "256"
            opcache.interned_strings_buffer: "32"
            opcache.max_accelerated_files: "10000"
            opcache.revalidate_freq: "60"
            opcache.save_comments: "1"