Environment Configuration Doc Update

[ravenloveriel]

Re: Environment Configuration

Priority: Medium

Issue Description:

Issue: Conflicting Usage of $_ENV Global Variable in our Public Doc

The public documentation contains contradictory information regarding the use of the $_ENV global variable in PHP applications on the Pantheon platform:

In one section, it discourages customers from using $_ENV for security reasons: "For security reasons, using the $_ENV superglobal inside PHP applications is not supported." Source: Link

In another section, it encourages the use of $_ENV variables for custom configurations on Pantheon: "When incorporating custom configurations on Pantheon, use $_ENV instead of $_SERVER wherever possible." Source: Link

This discrepancy raises the question of whether the $_ENV global variable is supported on the platform or not.

Sample of a chat conversation where the customer is confused: https://app.intercom.com/a/inbox/xkegk7cr/inbox/conversation/51746601543668

Suggested Resolution

Update the docs indicating that the $_ENV global variable is supported in the platform where it is usually placed in the wp-config.php, and settings.php.