:hedgehog: PostHog is the leading platform for building self-driving products. Our developer tools – AI observability, analytics, session replay, flags, experiments, error tracking, logs, and more – capture all the context agents need to diagnose problems, uncover opportunities, and ship fixes. Steer it all from Slack, web, desktop, or the MCP.
Python ab-testingai-analyticsanalyticscdpdata-warehouseexperimentsfeature-flagsjavascriptproduct-analyticspythonreactsession-replaysurveystypescriptweb-analytics
import { OnboardingComponentsContext, createInstallation } from 'scenes/onboarding/shared/OnboardingDocsContentWrapper'
import { getPHPSteps as getPHPStepsPA } from '../product-analytics/php'
import { StepDefinition } from '../steps'
export const getPHPSteps = (ctx: OnboardingComponentsContext): StepDefinition[] => {
const { CodeBlock, Markdown, dedent, Tab, snippets } = ctx
const BooleanFlag = snippets?.BooleanFlagSnippet
const MultivariateFlag = snippets?.MultivariateFlagSnippet
const OverrideProperties = snippets?.OverridePropertiesSnippet
// Get installation steps from product-analytics
const installationSteps = getPHPStepsPA(ctx)
// Add flag-specific steps
const flagSteps: StepDefinition[] = [
{
title: 'Evaluate boolean feature flags',
badge: 'required',
content: (
<>
<Markdown>
{dedent`
Check if a feature flag is enabled:
`}
</Markdown>
{BooleanFlag && <BooleanFlag language="php" />}
</>
),
},
{
title: 'Evaluate multivariate feature flags',
badge: 'optional',
content: (
<>
<Markdown>
{dedent`
For multivariate flags, check which variant the user has been assigned:
`}
</Markdown>
{MultivariateFlag && <MultivariateFlag language="php" />}
</>
),
},
{
title: 'Include feature flag information in events',
badge: 'required',
content: (
<>
<Markdown>
{dedent`
If you want to use your feature flag to breakdown or filter events in your insights, you'll need to include feature flag information in those events. This ensures that the feature flag value is attributed correctly to the event.
**Note:** This step is only required for events captured using our server-side SDKs or API.
`}
</Markdown>
<Tab.Group tabs={['Set send_feature_flags (recommended)', 'Include $feature property']}>
<Tab.List>
<Tab>Set send_feature_flags (recommended)</Tab>
<Tab>Include $feature property</Tab>
</Tab.List>
<Tab.Panels>
<Tab.Panel>
<Markdown>
{dedent`
Set \`send_feature_flags\` to \`true\` in your capture call:
`}
</Markdown>
<CodeBlock
blocks={[
{
language: 'php',
file: 'PHP',
code: dedent`
PostHog::capture(array(
'distinctId' => 'distinct_id_of_your_user',
'event' => 'event_name',
'send_feature_flags' => true
));
`,
},
]}
/>
</Tab.Panel>
<Tab.Panel>
<Markdown>
{dedent`
Include the \`$feature/feature_flag_name\` property in your event properties:
`}
</Markdown>
<CodeBlock
blocks={[
{
language: 'php',
file: 'PHP',
code: dedent`
PostHog::capture(array(
'distinctId' => 'distinct_id_of_your_user',
'event' => 'event_name',
'properties' => array(
'$feature/feature-flag-key' => 'variant-key' // replace feature-flag-key with your flag key. Replace 'variant-key' with the key of your variant
)
));
`,
},
]}
/>
</Tab.Panel>
</Tab.Panels>
</Tab.Group>
</>
),
},
{
title: 'Override server properties',
badge: 'optional',
content: <>{OverrideProperties && <OverrideProperties language="php" />}</>,
},
{
title: 'Running experiments',
badge: 'optional',
content: (
<Markdown>
{dedent`
Experiments run on top of our feature flags. Once you've implemented the flag in your code, you run an experiment by creating a new experiment in the PostHog dashboard.
`}
</Markdown>
),
},
]
return [...installationSteps, ...flagSteps]
}
export const PHPInstallation = createInstallation(getPHPSteps)