project:init fails to generate DB env vars for custom service names (e.g. "mariadb"), breaking Drupal Stacks guide #5382
Description
Priority
2 - Important - inaccurate info needs to be corrected to prevent customer issues
Where should the changes be made?
I am building a Drupal 11 site following the official Upsun Drupal documentation. The documentation relies entirely on the upsun project:init command to generate a .environment file that maps PLATFORM_RELATIONSHIPS to standard shell variables (DB_SCHEME, DB_HOST, etc.) for Drupal's use.
The project:init command gives .environment file:
export DATABASE_URL="${DB_SCHEME}://${DB_USERNAME}:${DB_PASSWORD}@${DB_HOST}:${DB_PORT}/${DB_PATH}"
but it completely fails to generate the definition/parsing logic for these variables.
As a result, DB_SCHEME and other variables remain empty, DATABASE_URL is malformed, and Drupal crashes with "Driver not specified".
Documentation Links:
- Current Docs (Broken Flow): https://docs.upsun.com/get-started/stacks/drupal.html
- Relies entirely on the shell script generation which is currently buggy for custom service names.
- Does not mention installing
platformsh/config-reader.
- Old/Alternative Docs (Working Flow): https://fixed.docs.upsun.com/guides/drupal/deploy/customize.html#install-the-config-reader
- Explicitly advises installing
platformsh/config-reader. - This library handles the JSON parsing correctly regardless of the service name.
- Explicitly advises installing
What exactly should be updated?
The new docs https://docs.upsun.com/get-started/stacks/drupal.html should be updated to clarify platformsh/config-reader usage or fix the init command to generate correct .environment logic
Optional: Additional context
No response