In order to assist folks upgrading we are now going to maintain
a document describing information critical to existing Apache
users. Note that it only lists differences between recent major
releases, so for example, folks using Apache 1.1 or earlier will
have to figure out what changed up to Apache 1.2 before this
document can be considered relevant. Old users could look at the
src/CHANGES
file which tracks code changes.
These are intended to be brief notes, and you should be able to
find more information in either the New Features document, or in the
src/CHANGES
file.
Module
directive has been changed to the
AddModule
directive.Configuration
variable
EXTRA_LFLAGS
has been renamed
EXTRA_LDFLAGS
.-DMAXIMUM_DNS
definition has been obsoleted by
changes to mod_access
enforcing double-reverse DNS
lookups when necessary.-DSERVER_SUBVERSION=\"string\"
compile-time
option has been replaced with the run-time API call
ap_add_version_component()
. Compile-time modification
of the server identity by the configuration scripts is no longer
supported.mod_dir
has been split into two pieces
mod_autoindex
, and mod_dir
.mod_browser
has been replaced by
mod_setenvif
.suexec
, or adding
-DUSE_FCNTL_SERIALIZED_ACCEPT
to
EXTRA_CFLAGS
. This is slower, more information is
available on the performance tuning page.
There is a mild denial of service attack possible with the default
config, but the default config is an order of magnitude
faster.mod_auth_msql
has been removed from the
distribution.mod_expires
will add Expires headers to content
that does not come from a file on disk, unless you are using a
modification time based setting. Previously, it would never add an
Expires header unless content came from a file on disk. This could
result in Expires headers being added in places where they were not
previously added.AuthName This and Thatyou will need to change it to
AuthName "This and That"This change was made for consistency in the config language.
Unrecognized method names in the server configuration files will result in the server logging an error message and failing to start. In .htaccess files, unknown methods will cause the server to log an error to its error log and return an 'Internal Server Error' page to the client.
NameVirtualHost
directive (one directive per
pair). Previously this support was given implicitly on the "main
server address". Now it has to be explicitly listed so as to avoid
many problems that users had. Please see the Apache
Virtual Host documentation for further details on
configuration.HostnameLookups
defaults to Off.mod_access
syntax "allow user-agents" was removed.
The replacement is the more general "allow from env".<Directory>
directives, for example.TransferLog
directive is given then nothing
will be logged. (Previously it would default to
logs/access_log
.)ServerType inetd
has been deprecated. It still
exists, but bugs are unlikely to be fixed.httpd_monitor
has been deprecated. The replacement
is to use mod_status
and make a request to a URL such
as http://myhost/server-status?refresh=10
."nph-" CGIs, which formerly provided a direct socket to the client without any server post-processing, were not fully compatible with HTTP/1.1 or SSL support. As such they would have had to implement the transport details, such as encryption or chunking, in order to work properly in certain situations. Now, the only difference between nph and non-nph scripts is "non-parsed headers".
dbmmanage
has been overhauled.The following changes between the 1.2 and 1.3 API may require slight changes in third party modules not maintained by Apache.
ap_
' was globally applied
to the following classes of symbols: Apache provided general
functions (e.g., ap_cpystrn
), public API
functions (e.g., palloc
, bgets
)
and private functions which can't be made static (because of
cross-object usage) but should be (e.g.,
new_connection
). For backward source compatibility
with Apache 1.2 a new header file named compat.h
was
created which provides defines for the old symbol names. You'll
either have to #include compat.h
or update the API
symbols you use.const char *ap_get_server_version()
.ap_construct_url
prototype change. The second
parameter was previously a server_rec
, it has been
changed to a request_rec
.table
datatype has been made an opaque type.
Code which assumes a table
is the same as an
array_header
will not compile. This is actually a
change to enforce the API the way it was intended, all versions of
Apache have had a table_elts()
function which is
intended for code which needs to access the elements of a table.
The changes required for this are pretty easy, and work with all
versions of Apache.
Suppose t
is a table. Whenever code refers to
t->elts
, replace it with something like this:
Whenever code refers toarray_header *arr = table_elts(t); table_entry *elts = (table_entry *)arr->elts;
t->nelts
use
arr->nelts
. Many examples can be found in the
standard modules, search for table_elts
.