# salt.states.pecl

## Installation of PHP Extensions Using pecl

These states manage the installed pecl extensions. Note that php-pear must be installed for these states to be available, so pecl states should include a requisite to a pkg.installed state for the package which provides pecl (`php-pear` in most cases). Example:

    php-pear:
      pkg.installed

    mongo:
      pecl.installed:
        - require:
          - pkg: php-pear

`salt.states.pecl.` `installed`(name, version=None, defaults=False, force=False, preferred_state='stable')

  Make sure that a pecl extension is installed.

  name
    The pecl extension name to install
  version
    The pecl extension version to install. This option may be ignored to install the latest stable version.
  defaults
    Use default answers for extensions such as pecl_http which ask questions before installation. Without this option, the pecl.installed state will hang indefinitely when trying to install these extensions.
  force
    Whether to force the installed version or not
  preferred_state
    The pecl extension state to install

  Note

  The `defaults` option will be available in version 0.17.0.

`salt.states.pecl.` `removed`(name)

  Make sure that a pecl extension is not installed.

  name
    The pecl extension name to uninstall

Current Salt release: 0.17.1

### Table Of Contents

- salt.states.pecl
  - Installation of PHP Extensions Using pecl

#### Previous topic

salt.states.ntp

#### Next topic

salt.states.pip

### Quick search

Enter search terms or a module, class or function name.

### Upcoming SaltStack Events

My conferences on Lanyrd