#  Phusion Passenger - https://www.phusionpassenger.com/
#  Copyright (c) 2014-2025 Asynchronous B.V.
#
#  "Passenger", "Phusion Passenger" and "Union Station" are registered
#  trademarks of Asynchronous B.V.
#
#  Permission is hereby granted, free of charge, to any person obtaining a copy
#  of this software and associated documentation files (the "Software"), to deal
#  in the Software without restriction, including without limitation the rights
#  to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
#  copies of the Software, and to permit persons to whom the Software is
#  furnished to do so, subject to the following conditions:
#
#  The above copyright notice and this permission notice shall be included in
#  all copies or substantial portions of the Software.
#
#  THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
#  IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
#  FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
#  AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
#  LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
#  OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
#  THE SOFTWARE.

# This file defines all supported Apache per-directory configuration options. The
# build system automatically generates the corresponding Apache module boilerplate
# code from the definitions in this file.
#
# Main configuration options are not defined in this file, but are defined in
# src/apache2_module/Configuration.cpp instead.
#
# The following boilerplate code is generated:
#
#  * command_rec array members (ConfigGeneral/AutoGeneratedDefinitions.cpp.cxxcodebuilder)
#  * Global (server-wide) struct fields (ServerConfig/AutoGeneratedStruct.cpp.cxxcodebuilder)
#  * Per-directory struct (DirConfig/AutoGeneratedStruct.h.cxxcodebuilder)
#  * Per-directory struct fields initialization code (DirConfig/AutoGeneratedCreateFunction.cpp.cxxcodebuilder)
#  * Per-directory struct fields merging code (DirConfig/AutoGeneratedMergeFunction.cpp.cxxcodebuilder)
#  * Struct field setter functions (ConfigGeneral/AutoGeneratedSetterFuncs.cpp.cxxcodebuilder)
#  * Apache module <-> Core headers serialization code (ConfigGeneral/AutoGeneratedHeaderSerialization.cpp.cxxcodebuilder)
#
# Options:
#
#  * name - The configuration option name. Required.
#  * context - The context in which this configuration option is valid.
#              Allowed values:
#              :global -- Global configuration
#              :application -- Per-application configuration (default)
#              :location -- Per-location/per-request configuration
#  * htaccess_context - If `context` is set to :location, then this
#              defines whether -- and in which -- .htaccess contexts it is allowed.
#              This is an array of `OR_` macro names.
#              Default: ['OR_OPTIONS']
#  * type - This configuration option's value type. Allowed types:
#           :string, :integer, :flag, :string_array, :string_keyval, :string_set
#  * field - The name that should be used for the auto-generated field in
#            the configuration structure. Defaults to the configuration
#            name without the 'Passenger' prefix, and in camel case. Set this
#            to nil if you do not want a structure field to be auto-generated.
#  * min_value - If `type` is :integer, then this specifies the minimum
#                allowed value. When nil (the default), there is no minimum.
#  * default - A static default value. Set during configuration merging,
#              and reported in the tracking code that generates the
#              configuration manifest.
#  * default_expr - If `default` is set, but you don't want the value
#                   to appear in the autogenerated code (e.g. you want the
#                   autogenerated code to contain the corresponding constant name)
#                   when you can use this option to override what gets written in the
#                   autogenerated code.
#  * dynamic_default - If this option has a default, but it's dynamically inferred
#              (and not a static value) then set this option to a human-readable
#              description that explains how the default is dynamically inferred.
#              Reported in the tracking code that generates the configuration
#              manifest.
#  * desc - A description for this configuration option. Required.
#  * header - The name of the corresponding CGI header. By default CGI header
#             generation code is automatically generated, using the configuration
#             option's name in uppercase as the CGI header name.
#             Setting this to nil will disable auto-generation of CGI header
#             generation code. You are then responsible for writing CGI header
#             passing code yourself in Hooks.cpp.
#  * header_expression - The expression to be passed to `addHeader()`.
#  * function - If nil, a setter function will be automatically generated. If
#               non-nil, must be the name of the setter function.
#  * obsolete - Whether this is an obsolete option. Defaults to false.
#  * obsoletion_message - If the `obsolete` option is true, then
#               specify the obsoletion warning message here. This is optional:
#               there is a default obsoletion message.

PhusionPassenger.require_passenger_lib 'constants'
PhusionPassenger.require_passenger_lib 'apache2/config_utils'

APACHE2_CONFIGURATION_OPTIONS = [
  ###### Global configuration ######

  {
    :name      => 'PassengerRoot',
    :type      => :string,
    :context   => :global,
    :desc      => "The #{PROGRAM_NAME} root folder."
  },
  {
    :name      => 'PassengerCtl',
    :type      => :string_keyval,
    :context   => :global,
    :field     => nil,
    :function  => 'cmd_passenger_ctl',
    :desc      => "Set advanced #{PROGRAM_NAME} options."
  },
  {
    :name      => 'PassengerDumpConfigManifest',
    :type      => :string,
    :context   => :global,
    :desc      => "Dump the #{SHORT_PROGRAM_NAME} config manifest to the given file, for debugging purposes."
  },
  {
    :name      => 'PassengerDefaultRuby',
    :type      => :string,
    :context   => :global,
    :default   => DEFAULT_RUBY,
    :default_expr => 'DEFAULT_RUBY',
    :desc      => "#{PROGRAM_NAME}'s default Ruby interpreter to use."
  },
  {
    :name      => 'PassengerLogLevel',
    :type      => :integer,
    :context   => :global,
    :min_value => 0,
    :default   => DEFAULT_LOG_LEVEL,
    :default_expr => 'DEFAULT_LOG_LEVEL',
    :desc      => "The #{PROGRAM_NAME} log verbosity."
  },
  {
    :name      => 'PassengerLogFile',
    :type      => :string,
    :context   => :global,
    :dynamic_default => "Apache's global error log",
    :desc      => "The #{PROGRAM_NAME} log file."
  },
  {
    :name      => 'PassengerDisableLogPrefix',
    :type      => :flag,
    :context   => :global,
    :default   => false,
    :desc      => "Disable prefixing log statements with PID and channel."
  },
  {
    :name      => 'PassengerSocketBacklog',
    :type      => :integer,
    :context   => :global,
    :min_value => 0,
    :default   => DEFAULT_SOCKET_BACKLOG,
    :default_expr => 'DEFAULT_SOCKET_BACKLOG',
    :desc      => "The #{PROGRAM_NAME} socket backlog."
  },
  {
    :name      => 'PassengerFileDescriptorLogFile',
    :type      => :string,
    :context   => :global,
    :desc      => "The #{PROGRAM_NAME} file descriptor log file."
  },
  {
    :name      => 'PassengerMaxPoolSize',
    :type      => :integer,
    :context   => :global,
    :min_value => 1,
    :default   => DEFAULT_MAX_POOL_SIZE,
    :default_expr => 'DEFAULT_MAX_POOL_SIZE',
    :desc      => "The maximum number of simultaneously alive application processes."
  },
  {
    :name      => 'PassengerPoolIdleTime',
    :type      => :integer,
    :context   => :global,
    :min_value => 0,
    :default   => DEFAULT_POOL_IDLE_TIME,
    :default_expr => 'DEFAULT_POOL_IDLE_TIME',
    :desc      => 'The maximum number of seconds that an application may be idle before it gets terminated.'
  },
  {
    :name      => 'PassengerResponseBufferHighWatermark',
    :type      => :integer,
    :context   => :global,
    :min_value => 0,
    :default   => DEFAULT_RESPONSE_BUFFER_HIGH_WATERMARK,
    :default_expr => 'DEFAULT_RESPONSE_BUFFER_HIGH_WATERMARK',
    :desc      => "The maximum size of the #{PROGRAM_NAME} response buffer."
  },
  {
    :name      => 'PassengerUserSwitching',
    :type      => :flag,
    :context   => :global,
    :default   => true,
    :desc      => "Whether to enable user switching support in #{PROGRAM_NAME}."
  },
  {
    :name      => 'PassengerDefaultUser',
    :type      => :string,
    :context   => :global,
    :default   => PASSENGER_DEFAULT_USER,
    :default_expr => 'PASSENGER_DEFAULT_USER',
    :desc      => "The user that #{PROGRAM_NAME} applications must run as when user switching fails or is disabled."
  },
  {
    :name      => 'PassengerDefaultGroup',
    :type      => :string,
    :context   => :global,
    :dynamic_default => 'The primary group of PassengerDefaultUser',
    :desc      => "The group that #{PROGRAM_NAME} applications must run as when user switching fails or is disabled."
  },
  {
    :name      => 'PassengerDataBufferDir',
    :type      => :string,
    :context   => :global,
    :dynamic_default => '$TMPDIR, or if not given, /tmp',
    :desc      => "The directory that #{PROGRAM_NAME} data buffers should be stored into."
  },
  {
    :name      => 'PassengerInstanceRegistryDir',
    :type      => :string,
    :context   => :global,
    :dynamic_default => 'Either /var/run/passenger-instreg, $TMPDIR, or /tmp (see docs)',
    :desc      => "The directory to register the #{PROGRAM_NAME} instance to."
  },
  {
    :name      => 'PassengerSpawnDir',
    :type      => :string,
    :context   => :global,
    :dynamic_default => 'Either $TMPDIR or /tmp',
    :desc      => "The directory for #{PROGRAM_NAME} used during child spawning."
  },
  {
    :name      => 'PassengerDisableSecurityUpdateCheck',
    :type      => :flag,
    :context   => :global,
    :default   => false,
    :desc      => "Whether to disable the #{PROGRAM_NAME} security update check & notification."
  },
  {
    :name      => 'PassengerSecurityUpdateCheckProxy',
    :type      => :string,
    :context   => :global,
    :desc      => "Use specified HTTP/SOCKS proxy for the #{PROGRAM_NAME} security update check."
  },
  {
    :name      => 'PassengerDisableAnonymousTelemetry',
    :type      => :flag,
    :context   => :global,
    :default   => false,
    :desc      => "Whether to disable #{PROGRAM_NAME} anonymous telemetry."
  },
  {
    :name      => 'PassengerAnonymousTelemetryProxy',
    :type      => :string,
    :context   => :global,
    :desc      => "Use specified HTTP/SOCKS proxy for #{PROGRAM_NAME} anonymous telemetry collection."
  },
  {
    :name      => 'PassengerStatThrottleRate',
    :type      => :integer,
    :context   => :global,
    :default   => DEFAULT_STAT_THROTTLE_RATE,
    :default_expr => 'DEFAULT_STAT_THROTTLE_RATE',
    :desc      => 'Limit the number of stat calls to once per given seconds.'
  },
  {
    :name      => 'PassengerPreStart',
    :type      => :string_set,
    :context   => :global,
    :field     => 'prestartURLs',
    :desc      => 'Prestart the given web applications during startup.'
  },
  {
    :name      => 'PassengerTurbocaching',
    :type      => :flag,
    :context   => :global,
    :default   => true,
    :desc      => "Whether to enable turbocaching in #{PROGRAM_NAME}."
  },
  {
    :name      => 'PassengerDisableHtaccess',
    :type      => :flag,
    :context   => :global,
    :default   => false,
    :field     => 'disableHtaccess',
    :desc      => 'Disallow Phusion Passenger directives in .htaccess files.',
  },
  {
    :name      => 'PassengerOldRouting',
    :type      => :flag,
    :context   => :global,
    :default   => false,
    :desc      => "Whether to revert to old routing behaviour in #{PROGRAM_NAME}."
  },
  {
    :name      => 'PassengerShowVersionInHeader',
    :type      => :flag,
    :context   => :global,
    :default   => true,
    :desc      => "Whether to show the #{PROGRAM_NAME} version number in the X-Powered-By header."
  },
  {
    :name      => 'PassengerMaxInstancesPerApp',
    :type      => :integer,
    :context   => :global,
    :min_value => 0,
    :default   => 0,
    :desc      => 'The maximum number of simultaneously alive application instances a single application may occupy.'
  },


  ###### Per-application configuration ######

  {
    :name      => 'PassengerRuby',
    :context => :location,
    :htaccess_context => ['OR_OPTIONS'],
    :type      => :string,
    :default   => DEFAULT_RUBY,
    :default_expr => 'StaticString()',
    :desc      => 'The Ruby interpreter to use.',
    :header_expression => 'config->mRuby.empty() ? serverConfig.defaultRuby : config->mRuby'
  },
  {
    :name      => 'PassengerPython',
    :context => :location,
    :htaccess_context => ['OR_OPTIONS'],
    :type      => :string,
    :default   => DEFAULT_PYTHON,
    :default_expr => 'DEFAULT_PYTHON',
    :desc      => 'The Python interpreter to use.'
  },
  {
    :name      => 'PassengerNodejs',
    :context => :location,
    :htaccess_context => ['OR_OPTIONS'],
    :type      => :string,
    :default   => DEFAULT_NODEJS,
    :default_expr => 'DEFAULT_NODEJS',
    :desc      => 'The Node.js command to use.'
  },
  {
    :name      => 'PassengerMeteorAppSettings',
    :type      => :string,
    :desc      => 'Settings file for (non-bundled) Meteor apps.'
  },
  {
    :name      => 'PassengerBaseURI',
    :context => :location,
    :htaccess_context => ['OR_OPTIONS'],
    :type      => :string_set,
    :function  => 'cmd_passenger_base_uri',
    :field     => 'mBaseURIs',
    :desc      => 'Declare the given base URI as belonging to a web application.',
    :header    => nil
  },
  {
    :name      => 'PassengerAppEnv',
    :context => :location,
    :htaccess_context => ['OR_OPTIONS'],
    :type      => :string,
    :default   => 'production',
    :desc      => 'The environment under which applications are run.'
  },
  {
    :name      => 'PassengerAppType',
    :context => :location,
    :htaccess_context => ['OR_ALL'],
    :type      => :string,
    :dynamic_default => 'Autodetected',
    :desc      => 'Force specific application type.',
    :header    => nil
  },
  {
    :name      => 'PassengerAppStartCommand',
    :type      => :string,
    :desc      => 'Command string for starting the application.',
    :header    => nil
  },
  {
    :name      => 'PassengerStartupFile',
    :context => :location,
    :htaccess_context => ['OR_ALL'],
    :type      => :string,
    :dynamic_default => 'Autodetected',
    :desc      => 'Force specific startup file.'
  },
  {
    :name      => 'PassengerMinInstances',
    :type      => :integer,
    :min_value => 0,
    :default   => 1,
    :header    => 'PASSENGER_MIN_PROCESSES',
    :desc      => 'The minimum number of application instances to keep when cleaning idle instances.'
  },
  {
    :name      => 'PassengerUser',
    :type      => :string,
    :dynamic_default => 'See the user account sandboxing rules',
    :desc      => 'The user that Ruby applications must run as.'
  },
  {
    :name      => 'PassengerGroup',
    :type      => :string,
    :dynamic_default => 'See the user account sandboxing rules',
    :desc      => 'The group that Ruby applications must run as.'
  },
  {
    :name      => 'PassengerMaxRequests',
    :type      => :integer,
    :min_value => 0,
    :default   => 0,
    :desc      => 'The maximum number of requests that an application instance may process.'
  },
  {
    :name      => "PassengerStartTimeout",
    :type      => :integer,
    :min_value => 1,
    :default   => DEFAULT_START_TIMEOUT / 1000,
    :default_expr => 'DEFAULT_START_TIMEOUT / 1000',
    :desc      => 'A timeout for application startup.'
  },
  {
    :name      => "PassengerAppConnectTimeout",
    :type      => :integer,
    :min_value => 1,
    :default   => DEFAULT_CONNECT_TIMEOUT,
    :default_expr => 'DEFAULT_CONNECT_TIMEOUT',
    :desc      => 'A timeout for application to accept socket connections.'
  },
  {
    :name      => 'PassengerMaxRequestQueueSize',
    :type      => :integer,
    :min_value => 0,
    :default   => DEFAULT_MAX_REQUEST_QUEUE_SIZE,
    :default_expr => 'DEFAULT_MAX_REQUEST_QUEUE_SIZE',
    :desc      => 'The maximum number of queued requests.'
  },
  {
    :name      => 'PassengerMaxPreloaderIdleTime',
    :type      => :integer,
    :min_value => 0,
    :default   => DEFAULT_MAX_PRELOADER_IDLE_TIME,
    :default_expr => 'DEFAULT_MAX_PRELOADER_IDLE_TIME',
    :desc      => 'The maximum number of seconds that a preloader process may be idle before it is shutdown.'
  },
  {
    :name      => 'PassengerLoadShellEnvvars',
    :type      => :flag,
    :default   => true,
    :desc      => 'Whether to load environment variables from the shell before running the application.'
  },
  {
    :name      => 'PassengerPreloadBundler',
    :type      => :flag,
    :default   => false,
    :desc      => 'Whether to tell Ruby to load the bundler gem before running the application.'
  },
  {
    :name      => 'PassengerSpawnMethod',
    :type      => :string,
    :dynamic_default => "'smart' for Ruby apps, 'direct' for all other apps",
    :desc      => 'The spawn method to use.',
    :function  => 'cmd_passenger_spawn_method'
  },
  {
    :name      => 'PassengerDirectInstanceRequestAddress',
    :type      => :string,
    :default   => DEFAULT_BIND_ADDRESS,
    :desc      => 'The address that Passenger binds to in order to allow sending HTTP requests to individual application processes.'
  },
  {
    :name      => 'PassengerFriendlyErrorPages',
    :context => :location,
    :htaccess_context => ['OR_OPTIONS'],
    :type      => :flag,
    :dynamic_default => 'On if PassengerAppEnv is development, off otherwise',
    :desc      => 'Whether to display friendly error pages when something goes wrong.'
  },
  {
    :name      => 'PassengerCustomErrorPage',
    :type      => :string,
    :desc      => 'Path to html file to use for Passenger generated error pages.'
  },
  {
    :name      => 'PassengerRestartDir',
    :type      => :string,
    :default   => 'tmp',
    :desc      => "The directory in which #{PROGRAM_NAME} should look for restart.txt."
  },
  {
    :name      => 'PassengerAppGroupName',
    :type      => :string,
    :dynamic_default => 'PassengerAppRoot plus PassengerAppEnv',
    :desc      => 'Application process group name.'
  },
  {
    :name      => 'PassengerMonitorLogFile',
    :type      => :string_set,
    :header    => nil,
    :desc      => 'Log file path to monitor.'
  },
  {
    :name      => 'PassengerForceMaxConcurrentRequestsPerProcess',
    :type      => :integer,
    :default   => -1,
    :desc      => "Force #{SHORT_PROGRAM_NAME} to believe that an application process " \
                 "can handle the given number of concurrent requests per process"
  },
  {
    :name      => 'PassengerAppRoot',
    :context => :location,
    :htaccess_context => ['OR_OPTIONS'],
    :type      => :string,
    :dynamic_default => "Parent directory of the associated Apache virtual host's root directory",
    :desc      => "The application's root directory.",
    :header    => nil
  },
  {
    :name      => 'PassengerLveMinUid',
    :type      => :integer,
    :min_value => 0,
    :default   => DEFAULT_LVE_MIN_UID,
    :default_expr => 'DEFAULT_LVE_MIN_UID',
    :desc      => 'Minimum user ID starting from which entering LVE and CageFS is allowed.'
  },


  ###### Per-location/per-request configuration ######

  {
    :name      => 'PassengerErrorOverride',
    :type      => :flag,
    :context   => :location,
    :htaccess_context => ['OR_ALL'],
    :default   => false,
    :desc      => 'Allow Apache to handle error response.',
    :header    => nil
  },
  {
    :name      => 'PassengerHighPerformance',
    :type      => :flag,
    :context   => :location,
    :htaccess_context => ['OR_ALL'],
    :default   => false,
    :desc      => "Enable or disable Passenger's high performance mode.",
    :header    => nil
  },
  {
    :name      => 'PassengerEnabled',
    :type      => :flag,
    :context   => :location,
    :htaccess_context => ['OR_ALL'],
    :default   => true,
    :desc      => "Enable or disable #{PROGRAM_NAME}.",
    :header    => nil
  },
  {
    :name      => 'PassengerBufferUpload',
    :type      => :flag,
    :context   => :location,
    :htaccess_context => ['OR_ALL'],
    :default   => true,
    :desc      => 'Whether to buffer file uploads.',
    :header    => nil
  },
  {
    :name      => 'PassengerStickySessions',
    :type      => :flag,
    :context   => :location,
    :htaccess_context => ['OR_ALL'],
    :default   => false,
    :desc      => 'Whether to enable sticky sessions.'
  },
  {
    :name      => 'PassengerStickySessionsCookieName',
    :type      => :string,
    :context   => :location,
    :htaccess_context => ['OR_ALL'],
    :default   => DEFAULT_STICKY_SESSIONS_COOKIE_NAME,
    :default_expr => 'DEFAULT_STICKY_SESSIONS_COOKIE_NAME',
    :desc      => 'The cookie name to use for sticky sessions.'
  },
  {
    :name      => 'PassengerStickySessionsCookieAttributes',
    :type      => :string,
    :context   => :location,
    :htaccess_context => ['OR_ALL'],
    :default   => DEFAULT_STICKY_SESSIONS_COOKIE_ATTRIBUTES,
    :default_expr => 'DEFAULT_STICKY_SESSIONS_COOKIE_ATTRIBUTES',
    :desc      => 'The attributes to use for the sticky session cookie.'
  },
  {
    :name      => 'PassengerBufferResponse',
    :type      => :flag,
    :context   => :location,
    :htaccess_context => ['OR_ALL'],
    :default   => false,
    :desc      => 'Whether to enable extra response buffering inside Apache.',
    :header    => nil
  },
  {
    :name      => 'PassengerAllowEncodedSlashes',
    :type      => :flag,
    :context   => :location,
    :default   => false,
    :desc      => "Whether to support encoded slashes in the URL",
    :header    => nil
  },


  ##### Enterprise options (placeholders in OSS) #####

  {
    :name      => 'PassengerFlyWith',
    :type      => :string,
    :context   => :global,
    :function  => 'cmd_passenger_enterprise_only',
    :field     => nil,
    :desc      => "Use Flying #{SHORT_PROGRAM_NAME}"
  },
  {
    :name      => 'PassengerMemoryLimit',
    :type      => :integer,
    :htaccess_context => ['OR_LIMIT'],
    :min_value => 0,
    :function  => 'cmd_passenger_enterprise_only',
    :field     => nil,
    :desc      => 'The maximum amount of memory in MB that an application instance may use.'
  },
  {
    :name      => 'PassengerMaxInstances',
    :type      => :integer,
    :htaccess_context => ['OR_LIMIT'],
    :min_value => 0,
    :function  => 'cmd_passenger_enterprise_only',
    :field     => nil,
    :desc      => "The maximum number of instances for the current application that #{PROGRAM_NAME} may spawn."
  },
  {
    :name      => 'PassengerRollingRestarts',
    :type      => :flag,
    :function  => 'cmd_passenger_enterprise_only',
    :field     => nil,
    :desc      => "Whether to turn on rolling restarts."
  },
  {
    :name      => 'PassengerResistDeploymentErrors',
    :type      => :flag,
    :function  => 'cmd_passenger_enterprise_only',
    :field     => nil,
    :desc      => 'Whether to turn on deployment error resistance.'
  },
  {
    :name      => 'PassengerDebugger',
    :type      => :flag,
    :function  => 'cmd_passenger_enterprise_only',
    :field     => nil,
    :desc      => 'Whether to turn on debugger support'
  },
  {
    :name      => 'PassengerConcurrencyModel',
    :type      => :string,
    :htaccess_context => ['OR_ALL'],
    :function  => 'cmd_passenger_enterprise_only',
    :field     => nil,
    :desc      => 'The concurrency model that should be used for applications.'
  },
  {
    :name      => 'PassengerThreadCount',
    :type      => :integer,
    :htaccess_context => ['OR_ALL'],
    :min_value => 0,
    :function  => 'cmd_passenger_enterprise_only',
    :field     => nil,
    :desc      => "The number of threads that #{PROGRAM_NAME} should spawn per application."
  },
  {
    :name      => 'PassengerMaxRequestTime',
    :type      => :integer,
    :context   => :location,
    :htaccess_context => ['OR_ALL'],
    :min_value => 0,
    :function  => 'cmd_passenger_enterprise_only',
    :field     => nil,
    :desc      => 'The maximum time (in seconds) that the current application may spend on a request.'
  },
  {
    :name      => 'PassengerMaxRequestQueueTime',
    :type      => :integer,
    :context   => :location,
    :htaccess_context => ['OR_ALL'],
    :min_value => 0,
    :function  => 'cmd_passenger_enterprise_only',
    :field     => nil,
    :desc      => 'The maximum number of seconds that a request may remain in the queue before it is dropped.'
  },
  {
    :name      => 'PassengerAppLogFile',
    :type      => :string,
    :context   => :location,
    :htaccess_context => ['OR_ALL'],
    :dynamic_default => 'PassengerLogFile',
    :function  => 'cmd_passenger_app_log',
    :desc      => 'Application log file path.'
  },


  ##### Aliases and backwards compatibility options #####

  {
    :name      => 'RailsEnv',
    :alias_for => 'PassengerAppEnv'
  },
  {
    :name      => 'RackEnv',
    :alias_for => 'PassengerAppEnv'
  },
  {
    :name      => 'RailsRuby',
    :alias_for => 'PassengerRuby'
  },
  {
    :name      => 'PassengerDebugLogFile',
    :alias_for => 'PassengerLogFile'
  },
  {
    :name      => 'RailsMaxPoolSize',
    :alias_for => 'PassengerMaxPoolSize'
  },
  {
    :name      => 'RailsMaxInstancesPerApp',
    :alias_for => 'PassengerMaxInstancesPerApp'
  },
  {
    :name      => 'RailsPoolIdleTime',
    :alias_for => 'PassengerPoolIdleTime'
  },
  {
    :name      => 'RailsUserSwitching',
    :alias_for => 'PassengerUserSwitching'
  },
  {
    :name      => 'RailsDefaultUser',
    :alias_for => 'PassengerDefaultUser'
  },
  {
    :name      => 'RailsAppSpawnerIdleTime',
    :alias_for => 'PassengerMaxPreloaderIdleTime'
  },
  {
    :name      => 'RailsBaseURI',
    :alias_for => 'PassengerBaseURI'
  },
  {
    :name      => 'RackBaseURI',
    :alias_for => 'PassengerBaseURI'
  },
  {
    :name      => 'RailsSpawnMethod',
    :alias_for => "PassengerSpawnMethod"
  },


  ##### Deprecated/obsolete options #####

  {
    :name      => 'RailsSpawnServer',
    :type      => :string,
    :context   => :global,
    :obsolete  => true,
    :obsoletion_message => "The 'RailsSpawnServer' option is obsolete. " \
      "Please specify 'PassengerRoot' instead. The correct value was " \
      "given to you by 'passenger-install-apache2-module'.",
    :desc      => 'Obsolete option.'
  },
  {
    :name      => "RailsAllowModRewrite",
    :type      => :flag,
    :context   => :global,
    :obsolete  => true,
    :obsoletion_message => "The 'RailsAllowModRewrite' option is obsolete: " \
      "#{PROGRAM_NAME} now fully supports mod_rewrite. " \
      "Please remove this option from your configuration file.",
    :desc      => 'Obsolete option.'
  },
  {
    :name      => "RailsFrameworkSpawnerIdleTime",
    :type      => :integer,
    :context   => :global,
    :obsolete  => true,
    :obsoletion_message => "The 'RailsFrameworkSpawnerIdleTime' option is obsolete. " \
      "Please use 'PassengerMaxPreloaderIdleTime' instead.",
    :desc      => 'Obsolete option.'
  },
  {
    :name      => 'PassengerUseGlobalQueue',
    :type      => :flag,
    :obsolete  => true,
    :obsoletion_message => "The 'PassengerUseGlobalQueue' option is obsolete: " \
      'global queueing is now always turned on. ' \
      'Please remove this option from your configuration file.',
    :desc      => 'Obsolete option.'
  },
  {
    :name      => 'UnionStationGatewayAddress',
    :type      => :string,
    :context   => :global,
    :obsolete  => true,
    :desc      => 'Obsolete option.'
  },
  {
    :name      => 'UnionStationGatewayPort',
    :type      => :integer,
    :context   => :global,
    :obsolete  => true,
    :desc      => 'Obsolete option.'
  },
  {
    :name      => 'UnionStationGatewayCert',
    :type      => :string,
    :context   => :global,
    :obsolete  => true,
    :desc      => 'Obsolete option.'
  },
  {
    :name      => 'UnionStationProxyAddress',
    :type      => :string,
    :context   => :global,
    :obsolete  => true,
    :desc      => 'Obsolete option.'
  },
  {
    :name      => 'PassengerAnalyticsLogUser',
    :type      => :string,
    :context   => :global,
    :obsolete  => true,
    :desc      => 'Obsolete option.'
  },
  {
    :name      => 'PassengerAnalyticsLogGroup',
    :type      => :string,
    :context   => :global,
    :obsolete  => true,
    :desc      => 'Obsolete option.'
  },
  {
    :name      => 'UnionStationKey',
    :type      => :string,
    :obsolete  => true,
    :desc      => 'Obsolete option.'
  },
  {
    :name      => 'UnionStationFilter',
    :type      => :string,
    :context   => :location,
    :obsolete  => true,
    :desc      => 'Obsolete option.'
  },
  {
    :name      => 'UnionStationSupport',
    :type      => :flag,
    :obsolete  => true,
    :desc      => 'Obsolete option.'
  }
]

PhusionPassenger::Apache2::ConfigUtils.initialize!(APACHE2_CONFIGURATION_OPTIONS)
