1
0
Fork 0
mirror of https://github.com/puma/puma.git synced 2022-11-09 13:48:40 -05:00
puma--puma/docs/compile_options.md
Oskar Pearson 88cec26d79
Improve quoting of bundle cflags (#2514)
Ensure that the full cflags option is quoted when
using bundle install

Without this, compilation would fail with this error:

Installing puma 5.1.1 with native extensions
Gem::Ext::BuildError: ERROR: Failed to build gem native extension.

    current directory: /usr/local/bundle/gems/puma-5.1.1/ext/puma_http11
/usr/local/bin/ruby -I /usr/local/lib/ruby/2.7.0 -r
./siteconf20201214-9-1yhulk9.rb extconf.rb --with-cflags\=-D
PUMA_QUERY_STRING_MAX_LENGTH\=64000
checking for BIO_read() in -lcrypto... *** extconf.rb failed ***
Could not create Makefile due to some reason, probably lack of necessary
libraries and/or headers.  Check the mkmf.log file for more details.  You may
need configuration options.
2020-12-14 14:23:30 -07:00

597 B

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 allow accept larger 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'"