puma/puma

# Compile Options

There are some `cflags` provided to change Puma's default configuration for its
C extension.

## Query String, `PUMA_QUERY_STRING_MAX_LENGTH`

By default, the max length of `QUERY_STRING` is `1024 * 10`. But you may want to
adjust it to accept longer queries in GET requests.

For manual install, pass the `PUMA_QUERY_STRING_MAX_LENGTH` option like this:

```
gem install puma -- --with-cflags="-D PUMA_QUERY_STRING_MAX_LENGTH=64000"
```

For Bundler, use its configuration system:

```
bundle config build.puma "--with-cflags='-D PUMA_QUERY_STRING_MAX_LENGTH=64000'"
```

## Request Path, `PUMA_REQUEST_PATH_MAX_LENGTH`

By default, the max length of `REQUEST_PATH` is `8192`. But you may want to
adjust it to accept longer paths in requests.

For manual install, pass the `PUMA_REQUEST_PATH_MAX_LENGTH` option like this:

```
gem install puma -- --with-cflags="-D PUMA_REQUEST_PATH_MAX_LENGTH=64000"
```

For Bundler, use its configuration system:

```
bundle config build.puma "--with-cflags='-D PUMA_REQUEST_PATH_MAX_LENGTH=64000'"
```

## Request URI, `PUMA_REQUEST_URI_MAX_LENGTH`

By default, the max length of `REQUEST_URI` is `1024 * 12`. But you may want to
adjust it to accept longer URIs in requests.

For manual install, pass the `PUMA_REQUEST_URI_MAX_LENGTH` option like this:

```
gem install puma -- --with-cflags="-D PUMA_REQUEST_URI_MAX_LENGTH=64000"
```

For Bundler, use its configuration system:

```
bundle config build.puma "--with-cflags='-D PUMA_REQUEST_URI_MAX_LENGTH=64000'"
```