Add PHP feature flag docs#37089
Open
leoromanovsky wants to merge 3 commits into
Open
Conversation
Contributor
Preview links (active after the
|
Contributor
|
Created DOCS-14584 for editorial review. @leoromanovsky Please also note that there are some merge conflicts! |
Contributor
Author
Yep thanks I saw they are minor; will resolve later. |
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
2 participants
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Motivation
PHP customers adopting Datadog Feature Flags need the same server-side setup guidance that exists for the other supported SDKs. Without a PHP-specific page, PHP 7 users do not have a clear path to the Datadog PHP feature flag client, and PHP 8 users do not have a documented OpenFeature adapter path.
Changes and Decisions
Changes
This PR adds a PHP server-side Feature Flags documentation page covering prerequisites, installation, initialization, evaluation context, typed flag evaluation, flag details, unit testing, and troubleshooting. It also adds PHP to the server SDK card grid and the English sidebar menu so the page appears alongside .NET, Go, Java, Node.js, Python, and Ruby.
Decisions
The page separates the PHP 7-compatible
DDTrace\FeatureFlags\ClientAPI from the PHP 8DDTrace\OpenFeature\DataDogProviderpath. That keeps PHP 7 customers on a supported Datadog API while still documenting the OpenFeature workflow for PHP 8 applications. The structure mirrors the existing server SDK pages so customers can move between languages without relearning the documentation layout.Validation
Ran staged whitespace validation with
git diff --cached --check, checked the new Markdown file for trailing whitespace, and checked the changed files for conflict markers. I did not run a Hugo build because this worktree does not havenode_modulesor a local Hugo binary installed.