/ home / community / community.general / 8.5.0 / module / pear

community.general.pear (8.5.0) — module

Manage pear/pecl packages

Authors: Jonathan Lestrelin (@jle64) <jonathan.lestrelin@gmail.com>

Install collection

Install with ansible-galaxy collection install community.general:==8.5.0

Add to requirements.yml

  collections:
    - name: community.general
      version: 8.5.0

Description

Manage PHP packages with the pear package manager.

Usage examples

Scanned by Steampunk Spotter

- name: Install pear package
  community.general.pear:
    name: Net_URL2
    state: present

Scanned by Steampunk Spotter

- name: Install pecl package
  community.general.pear:
    name: pecl/json_post
    state: present

Scanned by Steampunk Spotter

- name: Install pecl package with expected prompt
  community.general.pear:
    name: pecl/apcu
    state: present
    prompts:
        - (.*)Enable internal debugging in APCu \[no\]

Scanned by Steampunk Spotter

- name: Install pecl package with expected prompt and an answer
  community.general.pear:
    name: pecl/apcu
    state: present
    prompts:
        - (.*)Enable internal debugging in APCu \[no\]: "yes"

Scanned by Steampunk Spotter

- name: Install multiple pear/pecl packages at once with prompts.
    Prompts will be processed on the same order as the packages order.
    If there is more prompts than packages, packages without prompts will be installed without any prompt expected.
    If there is more packages than prompts, additional prompts will be ignored.
  community.general.pear:
    name: pecl/gnupg, pecl/apcu
    state: present
    prompts:
      - I am a test prompt because gnupg doesnt asks anything
      - (.*)Enable internal debugging in APCu \[no\]: "yes"

Scanned by Steampunk Spotter

- name: Install multiple pear/pecl packages at once skipping the first prompt.
    Prompts will be processed on the same order as the packages order.
    If there is more prompts than packages, packages without prompts will be installed without any prompt expected.
    If there is more packages than prompts, additional prompts will be ignored.
  community.general.pear:
    name: pecl/gnupg, pecl/apcu
    state: present
    prompts:
      - null
      - (.*)Enable internal debugging in APCu \[no\]: "yes"

Scanned by Steampunk Spotter

- name: Upgrade package
  community.general.pear:
    name: Net_URL2
    state: latest

Scanned by Steampunk Spotter

- name: Remove packages
  community.general.pear:
    name: Net_URL2,pecl/json_post
    state: absent

Inputs

    
name:
    aliases:
    - pkg
    description:
    - Name of the package to install, upgrade, or remove.
    required: true
    type: str

state:
    choices:
    - present
    - installed
    - latest
    - absent
    - removed
    default: present
    description:
    - Desired state of the package.
    type: str

prompts:
    description:
    - List of regular expressions that can be used to detect prompts during pear package
      installation to answer the expected question.
    - Prompts will be processed in the same order as the packages list.
    - You can optionally specify an answer to any question in the list.
    - If no answer is provided, the list item will only contain the regular expression.
    - 'To specify an answer, the item will be a dict with the regular expression as key
      and the answer as value C(my_regular_expression: ''an_answer'').'
    - You can provide a list containing items with or without answer.
    - A prompt list can be shorter or longer than the packages list but will issue a warning.
    - If you want to specify that a package will not need prompts in the middle of a list,  V(null).
    elements: raw
    type: list
    version_added: 0.2.0
    version_added_collection: community.general

executable:
    description:
    - Path to the pear executable.
    type: path