Apache HTTP Server Version 1.3

1.2 から 1.3 へのアップグレード

アップグレードを行う人のための、以前からの Apache ユーザにとって重要な情報を記述しているドキュメントです。最近の主要なリリースの違いをリストしているだけであることに注意してください。例えば、Apache 1.1 かそれ以前のものを使っている人は、このドキュメントが的を得ていると判断する前に、Apache 1.2 にアップグレードしていることがわかるでしょう。古いユーザはコードチェンジを追跡するsrc/CHANGESファイルを見ることができます。

これらは簡潔な説明なので、詳しくはApache 1.3 の新機能ドキュメントかsrc/CHANGESファイルで多くの情報を捜すと良いでしょう。

コンパイル時の設定の変更

ソースコードは再構築されているので、カスタムモジュールや、修正に影響を与えます。しかし、Module directive も AddModule directive に変更されています。
Configuration 変数である EXTRA_LFLAGS は EXTRA_LDFLAGS という名前になっています。
-DMAXIMUM_DNS 定義は、必要な時に二重の DNS 逆引きルックアップを実行する mod_access の変更により、廃れています。
-DSERVER_SUBVERSION=\"string\" のコンパイル時のオプションは、ランタイム時に API がap_add_version_component()を呼び出すことにより、置き換えられています。設定の記述によるサーバ定義のコンパイル時の修正は、現在サポートされていません
mod_dir は mod_autoindex と mod_dir に分割されています。
mod_browser は mod_setenvif によって置き換えられています。
CGI を書くことのできる、信頼されていないユーザが httpd を同じ uid で実行できる IRIX システムは、suexec を使うか、EXTRA_CFLAGS に -DUSE_FCNTL_SERIALIZED_ACCEPT を追加することを考えるべきです。これは遅いので、詳しい情報についてはパフォーマンスの改善が役に立ちます。デフォルトの設定ではサービスアタックの可能性がある軽い拒絶がありますが、デフォルト設定は非常に速くなります。
mod_auth_msqlは配布から外されています。
新しい Apache Autoconf-style Interface (APACI) は、真の out-of-the-box 構築と完全な Apache パッケージのインストール手順を提供するために、トップレベルに追加されています。

ランタイム設定の変更

デフォルトの設定ファイルには、たくさんの変更があります。既に存在する設定ファイルと、新しい設定ファイルの比較を徹底的に行ってください。特に:
- Apache 1.3.0 では、1.2 とは違って、設定ファイルの Options と AllowOverride の設定が、様々なディレクトリに対して割り当てるようになっています。
- Apache 1.3.3 以降のリリースでは、3つの設定ファイルのテンプレートが httpd.conf-dist にまとめられて、記述されている directive の順序が変更されています。
1.3.2 からは time based の設定を変更しない場合は、 mod_expires はディスクのファイルにはないコンテンツに Expire ヘッダを付加します。以前はコンテンツがディスクのファイルにない場合、 Expire ヘッダを付加しませんでした。これは、それらが以前には付加されなかった所で Expire ヘッダが付加されるということです。
スタンドアローンの FancyIndexing directive は現在事実上、それを置き換えるというより、IndexOptions directive の設定と併用されています。
AuthName の記述はブランク文字(スペースのような)を含んでいれば、.htaccess か、サーバ設定ファイルで引用されなければなりません。例えば、もしこのように AuthName directive を使うと:
```
     AuthName This and That
    
```
このように変更する必要があります
```
     AuthName "This and That"
    
```
この変更は設定の記述に一貫性を持たせています。
Apache 1.3.1 から、<Limit> directive に書かれるものは、大文字でなければなりません。GET、POST、PUT のような記述は大文字と小文字の区別がされているものとして定義されます。つまり、GET リクエストは get リクエストとは異なるということです。Apache 1.3.1 以前では、<Limit> directive の解析は、これを同じものとして扱っていました。Apache に組み込まれた limit のプロセスは、現在大文字だけを理解していて、もし設定ファイルで "<Limit Get post>" のようにしているのなら、大文字に訂正する必要があります。
サーバ設定ファイルで認識されない記述は、サーバがログするエラーメッセージになって、起動に失敗します。.htaccess ファイルで、知られていない記述はサーバにそのエラーログに対するエラーをログさせて、クライアントに 'Internal Server Error' ページを返します。
デフォルトの Apache サーバルートディレクトリは、NCSA 互換の /usr/local/etc/httpd/ から /usr/local/apache/ に変わっています。この変更はデフォルトの設定(とそのドキュメント)だけです; それはもちろん Apache の起動時に、-d ServerRoot と -f httpd.conf スイッチを使って置き換えることが可能です。
HTTP/1.1 スタイルのバーチャルホストを使う人は、NameVirtualHost directive (ip:port のペア毎に一つの directive)で HTTP/1.1 スタイルのバーチャルホストをすることになっている ip:port のペアを必要とします。以前、これは"main server address"で暗黙アドレス指定されていました。現在では多くの問題を避けるためには、はっきりと記述されなければなりません。設定について詳しくはApache Virtual Host documentationを見てください。
バーチャルホストの優先権は逆転しています(主に HTTP/1.1 Host: ヘッダと ServerPath directive を使うバーチャルホストに対して)。ファイルで先に記述してあるバーチャルホストが後に続くものより優先します。
HostnameLookupsのデフォルトは Off です。
REMOTE_HOST CGI 変数は変更されています。 Apache 1.2 とそれ以前では、もし名前がわからなければ、CGI スクリプトを有効にする REMOTE_HOST 環境変数は、クライアントのフルの DNS 名か、クライアントの IP アドレスのどちらかを設定していました。これは、もし名前が知られていなければ、この変数が NULL であると定義しているような CGI の仕様によって指定されているのとは異なります。Apache 1.3 では、これを訂正しています。REMOTE_ADDR は常にクライアントの IP アドレスをふくんでいますが、REMOTE_HOST はサーバがクライアントの DNS 名を確定できるときだけ定義されます。
記述されていない mod_access 構文 "allow user-agents" は外されています。"allow from env" に置き換えられています。
パス名にワイルドカード( * や ?)を使うと、 / (スラッシュ)とは一致しません。これはつまり、UNIX のシェルがどのように動いているのかということと、密接に関係しているということです。例えばこれは <Directory> directive に影響を与えます。
もし TransferLog directive が与えられていないと、まったくログが行われません。 (以前は logs/access_log に対するデフォルトでした)
Apache は現在エラーログのレベルを設定することが可能で、デフォルトでは、初期のバージョンで常に生じていたメッセージのいくつかを削除しています。
ブートしたときに Apache は stdin、stdout、stderr から自身を分離します。stderr はコンフィグファイルが読み込まれるまで分離しないので、初期のエラーメッセージを見ることができます。その後、全てのエラーログが error_log に書き込まれます。これは rsh、ssh、crontabs で Apache を起動するのを便利にしています。
<Files> のセクション区画は以前、フルのパス名をとっていて、フルのパス名に対して一致していました。これはいくつかの矛盾があり、外されました。これをエミュレートするために、<Directory> セクション区画にネスティングされた <Files> セクション区画を使っています。
スラッシュに関する <Location> の一致は変更されています。詳しくは <Location> ドキュメントを見てください。

その他の変更

ServerType inetd は不評です。まだ存続していますが、バグがほとんど修正されていません。
httpd_monitorは不評です。代わりにmod_statusを使って、http://myhost/server-status?refresh=10 のような URL に対するリクエストを作ります。
Apache は現在、CGI スクリプトに対して効率的なバッファの接続がありません。これは、CGI がアウトプットを一時休止するか停止すると、すぐにデータが送られることを意味します; 以前、Apache は CGI が終わるか、完全なバッファをアウトプットするまでユーザに空のページを見せて、送信する前に訂正されたバッファサイズまでアウトプットをバッファしていました。バッファされていないアウトプットを得るために "nph-" CGI を使う必要は最早ありません。ほとんどの CGI は、デフォルトでバッファを行うことによって(例えば、perl)、パフォーマンスに悪影響を与えない言語で書かれています。
以前はサーバのポストプロセスなしでクライアントに直接ソケットを提供していた "nph-" CGI は、HTTP/1.1 や SSL とは完全には互換していません。そういうものとして、ある状況下で適切に動作させる目的で、暗号化やチャンキングのような転送を実装しています。現在、nph と non-nph のスクリプトの違いは"non-parsed headers"だけです。
dbmmanage は徹底的にオーバーホールされています。

サードパーティのモジュール

以下の 1.2 と 1.3 の API の違いは、Apache に実装されていないサードパーティのモジュールに僅かな変更を必要とすることです。

サーバにコンパイルされたサードパーティのコードで、シンボルクラッシュを避けるための一般的なプレフィクスである`ap_'は、以下のシンボルクラスの全てに割り当てられます: Apache の一般的な機能(例、ap_cpystrn)、公開されている API 機能(例、palloc、bgets)、スタティックではないが(cross-object の使用のせいで)、スタティックでなければならないプライベートな機能(例、new_connection)。compat.h と名付けられたの新しいヘッダファイルは Apache 1.2 のソースと互換性があり、古いシンボル名のための定義があります。#include compat.h するか、使っている API シンボルを最新にすると良いでしょう。
そこでなにかのアイテムが影響を与えているかどうかは、ソースコードの再構築を見て確認してください。
SERVER_VERSION 定義の使用。サードパーティのモジュールがこのシンボルを使ってサーバのバージョンの記述をリフェレンスすると、新しい API ルーチン const char *ap_get_server_version() を呼ぶことによってそれを得るために訂正されなければなりません。
ap_construct_url のプロトタイプは変更しています。二番目のパラメータは server_rec より先になり、request_rec に変更されています。
table のデータタイプはあいまいなタイプです。table を想定しているコードは array_header がコンパイルしていないのと同じです。これは実際、API を実行する方法を変更していて、Apache の全てのバージョンは、テーブルのエレメントにアクセスする必要があるコードになっている table_elts() 機能を持っています。このために行われた変更は非常に簡単なもので、Apache の全てのバージョンで動きます。
t はテーブルであるとします。コードが t->elts をリフェレンスすると、このようにそれをなにかで置き換えます:
```
    array_header *arr = table_elts(t);
    table_entry *elts = (table_entry *)arr->elts;
```
コードは t->nelts をリフェレンスする時は arr->nelts を使います。 table_elts を捜すと、標準のモジュールに多くの例があります。

このページの情報に関わる、ご質問、お問い合わせは、 japache@infoscience.co.jpまで。

JAPACHE ホームページ