Come together with the global Drupal community in Rotterdam, 28 Sept – 1 Oct 2026. Sessions, contribution, connection, and Early Bird savings until 8 June.Config Split does require to _not_ start the split directory path with a Slash, else it does not work.
This is unfortunate in two ways:
1. In Drupal 8, almost everywhere it is required to enter a leading slash for system paths. After we learned this pattern with quite some pain, it should be consistent everywhere
2. What is worse, there is no validation. One can enter a path with or without leading slash, and only finds out when the directory cannot be used, that a slash is no good.
The request is: change the pattern so that a leading slash is required. If this poses problems, at least validation for the correct way to write the path is imperative.
Comments
Comment #2
eigentor commentedComment #3
eigentor commentedComment #4
bircherWell, a slash is perfectly fine if you specify a absolute directory. A slash is not necessary if you specify a folder relative to the drupal root. We do already have a warning when saving the split and the folder doesn't exist.
But we can always improve the documentation if it confused you.
The split path should have the same format as the sync directory path you specify in settings.php.