Skip to main content
drupalreleases

Use direct release data with your AI assistant.

Learn more

Config ignore pattern

Security covered Maintenance fixes only 22 sites

This module allows you to ignore specific configuration items from being synced between environments. It's useful for preventing accidental deletion of user-created content, like webforms, during configuration imports. You define ignore patterns using regular expressions in your settings.php file.

INTRODUCTION

The Config ignore pattern module allows certain configuration to be ignored from
sync import and export based on the configuration object name.

The primary use case for this module is preventing the removal of configuration
from active storage during configuration import, e.g. Webforms created on a
production site.

REQUIREMENTS

None.

INSTALLATION

Install as you would normally install a contributed Drupal module.
See: https://www.drupal.org/node/895232 for further information.

CONFIGURATION

Configuration is ignored using regular expressions matched to configuration
object names. Ignore patterns are set in settings.php.

In this example, all webforms created via the UI would not be exported during
drush config:export and any such UI-created webforms would not be deleted
during drush config:import.

/**
 * Ignored config name regex patterns.
 */
$settings['config_ignore_patterns'] = [
  '/^webform\.webform\.[a-z_]+$/',
];

Any other configuration that depends on configuration matching this pattern will
also be ignored.

Existing configuration in file/sync storage that matches ignore patterns will
still be imported and exported. This also allows configuration management of
selected configuration objects even when their names match ignore patterns.

For example, if all Webform entities are ignored using the above pattern, you
could still export and import config for a specific Webform if you add a
configuration file for it in your config_sync_directory.

The easiest way to do so is to perform a 'Single item' configuration export from
/admin/config/development/configuration/single/export.

You can enable debugging to see debug messages on
/admin/config/development/configuration and during drush config:export and
drush config:import.

/**
 * Config ignore pattern debugging.
 */
$settings['config_ignore_pattern_debug'] = TRUE;
Drupal 10–11

Ask your assistant about Config ignore pattern

Check compatibility with your Drupal and PHP version, maintenance and security coverage, from current release data. How it works

Depends on

Dependencies of the latest stable release

No dependencies recorded for this project.

Required by

Tracked projects that depend on this one

No tracked projects depend on this one yet.

Activity

Tracked releases
6
Tracked since
Dec 2023
Latest release
2 years ago
Releases (12 mo)
0
Maintenance
Dormant

Release Timeline

Releases

Version Type Core PHP Release date
1.0.2 Stable 10–11 Jul 12, 2024
1.0.1 Stable 10–11 Jul 12, 2024
1.0.0 Stable 10 Jan 24, 2024
1.0.0-beta2 Pre-release 10 Dec 19, 2023
1.0.0-beta1 Pre-release 10 Dec 19, 2023
1.x-dev Dev 10–11 Dec 19, 2023