---
title: newrelic_capture_params (PHP agent API)
source: https://docs.newrelic.com/docs/apm/agents/php-agent/php-agent-api/newrelic_capture_params
---

## Syntax

```php
newrelic_capture_params([bool $enable_flag])
```

Enable or disable the capture of URL parameters.

## Requirements

Compatible with all agent versions.

## Description

Enable or disable the capture of URL parameters (everything after the `?` in the URL). This overrides the `newrelic.capture_params` config file setting.

> #### ⚠️ IMPORTANT
>
> If you pass sensitive information directly in the URL, keep this disabled.

## Parameters

| Parameter                | Description                                                                                                                                    |
| ------------------------ | ---------------------------------------------------------------------------------------------------------------------------------------------- |
| `$enable_flag` _boolean_ | Optional. Defaults to `true`. If `true` or omitted, enables the capture of URL parameters. If `false`, disables the capture of URL parameters. |

## Examples

### Enable capture of URL parameters [#enable-params]

```php
function example() {
    if (extension_loaded('newrelic')) { // Ensure PHP agent is available
        newrelic_capture_params();
    }
    //...
}
```

### Disable capture of URL parameters [#disable-params]

```php
function example() {
    if (extension_loaded('newrelic')) { // Ensure PHP agent is available
        newrelic_capture_params(false);
    }
    //...
}
```