devkuma – Apache

Apache | Apache のインストール

kc@example.com (kc kim) — Wed, 13 Nov 2019 23:46:40 +0900

Apache のダウンロードとインストール方法について説明する。インストール後に Apache を起動する方法と、Apache の技術文書を参照する方法もあわせて説明する。

Apache | Apache のインストール | Apache のダウンロードとインストール

kc@example.com (kc kim) — Wed, 13 Nov 2019 23:46:40 +0900

Apache のダウンロードとインストール方法について説明する。2019 年 11 月時点の最新バージョンは Apache 2.4.41 である。ここでは Windows 10 (64bit) 環境にインストールする。

Apache のダウンロード

Apache をダウンロードする。Apache の公式 Web サイトは次のとおりである。

http://httpd.apache.org/

最新バージョンである「Apache httpd 2.4.41 Released 2019-08-14」のブロックにある「Download」をクリックする。

今回は Windows 10 (64bit) 環境にインストールするため、「Files for Microsoft Windows」と書かれたリンクをクリックする。

http://httpd.apache.org/download.cgi#apache24

Files for Microsoft Windows をクリックしたときに韓国語が表示された場合は、ページ上部まで移動すると「この文書は最新版の翻訳ではありません。最近の変更内容は英語文書を参照してください。」という警告が表示されているはずである。その場合は「en」をクリックして英語版を表示する。

http://httpd.apache.org/docs/current/ko/platform/windows.html

Apache の公式サイトでは、ソースコードのみを提供しており、Windows 用バイナリは提供していないと案内している。その代わり、配布を行っているサイトがいくつか紹介されているため、ここでは「Apache Lounge」をクリックする。

http://httpd.apache.org/docs/current/en/platform/windows.html

Apache Lounge のサイトが表示される。 https://www.apachelounge.com/download/

32bit 版と 64bit 版があるが、ここでは 64bit 環境にインストールするため、「Apache 2.4.41 Win64」の下に表示される「httpd-2.4.41-win64-VC16.zip」をクリックする。

ダウンロードが完了したら、任意の場所に保存する。これで Apache のダウンロードは完了である。

Visual C++ 再頒布可能パッケージのインストール

Visual Studio でビルドされた Visual C++ アプリケーションを実行するには、必要なランタイムコンポーネントがインストールされている必要がある。Windows 用 Apache バイナリも Visual Studio でビルドされているため、ランタイムが必要である。

他のアプリケーションで使用するためにすでにインストールされていることも多いが、ランタイムコンポーネントがインストールされていない場合は、次のように「VCRUNTIME140.dll が見つからないため、コードの実行を続行できません。プログラムを再インストールすると、この問題が解決する可能性があります。」といったエラーが表示される。

https://visualstudio.microsoft.com/ko/downloads/

上記のページに移動し、Visual C++ ランタイムをインストールする。ここでは Visual Studio 2019 用が必要である。

これで準備は完了した。次に Apache のインストールについて説明する。

Apache のインストール

Apache のインストールは、ダウンロードした圧縮ファイル「httpd-2.4.41-win64-VC16.zip」を適当なフォルダーに展開するだけでよい。

ここでは「C:\dev\Apache24」に保存した。

Apache

kc@example.com (kc kim) — Wed, 13 Nov 2019 23:46:40 +0900

広く利用されている Web サーバーの一つである Apache の使い方について説明する。ここでは、ローカル環境に Apache をインストールする方法、Apache を使って Web サイトをインターネットに公開するまでの手順、アクセス制御、ログファイルの確認方法など、基本的な使い方と各種設定方法を実際に試しながら説明する。

Apache | Apache のインストール | 設定ファイル (http.conf) の初期設定

kc@example.com (kc kim) — Wed, 13 Nov 2019 23:46:40 +0900

Apache の設定は http.conf ファイルで行う。Apache をインストールした後は、インストールしたディレクトリや使用するポート番号に合わせて設定ファイルを変更する必要がある。ここでは、Apache のインストール直後に行う初期設定について説明する。

インストールディレクトリの修正

Apache の設定ファイルである http.conf ファイルは、インストールディレクトリの “/Apache24/conf/” にある。

macOS では /etc/apache2/httpd.conf にある。

修正する前に、念のため http.conf ファイルをコピーしてバックアップとして別に保存しておく。必要ないと思う場合は省略してもよい。

それでは http.conf ファイルを編集する。http.conf ファイルはテキストファイルなので、テキストエディタで開ける。たとえば Windows のメモ帳でも編集できる。

まず、ファイル内で “ServerRoot” を検索する。すると、次のように書かれた箇所が見つかる。

#
# ServerRoot: The top of the directory tree under which the server's
# configuration, error, and log files are kept.
#
# Do not add a slash at the end of the directory path.  If you point
# ServerRoot at a non-local disk, be sure to specify a local disk on the
# Mutex directive, if file-based mutexes are used.  If you wish to share the
# same ServerRoot for multiple httpd daemons, you will need to change at
# least PidFile.
#
Define SRVROOT "c:/Apache24"

ServerRoot "${SRVROOT}"

ServerRoot には Apache サーバーのディレクトリを設定する。デフォルトで “c:/Apache24” になっている部分を、実際に Apache をインストールしたディレクトリに変更すればよい。具体的には、SRVROOT 変数にインストールしたディレクトリを設定し、ServerRoot ではその SRVROOT 変数を使用して設定している。ここでは次のように変更した。

Define SRVROOT "C:/apache/Apache24"

ServerRoot "${SRVROOT}"

上で設定した SRVROOT 変数は、次のように他の設定箇所でも使用され、同じディレクトリが設定される。

#
# DocumentRoot: The directory out of which you will serve your
# documents. By default, all requests are taken from this directory, but
# symbolic links and aliases may be used to point to other locations.
#
DocumentRoot "${SRVROOT}/htdocs"

<Directory "${SRVROOT}/htdocs">

 ...省略...

</Directory>

<IfModule alias_module>

 ...省略...

    #
    # ScriptAlias: This controls which directories contain server scripts. 
    # ScriptAliases are essentially the same as Aliases, except that
    # documents in the target directory are treated as applications and
    # run by the server when requested rather than as documents sent to the
    # client.  The same rules about trailing "/" apply to ScriptAlias
    # directives as to Alias.
    #
    ScriptAlias /cgi-bin/ "${SRVROOT}/cgi-bin/"

</IfModule>

#
# "${SRVROOT}/cgi-bin" should be changed to whatever your ScriptAliased
# CGI directory exists, if you have that configured.
#
<Directory "${SRVROOT}/cgi-bin">
    AllowOverride None
    Options None
    Require all granted
</Directory>

ポート番号の設定

次に、ポート番号の設定を確認する。ファイル内で “Listen” を検索する。

#
# Listen: Allows you to bind Apache to specific IP addresses and/or
# ports, instead of the default. See also the <VirtualHost>
# directive.
#
# Change this to Listen on specific IP addresses as shown below to 
# prevent Apache from glomming onto all bound IP addresses.
#
#Listen 12.34.56.78:80
Listen 80

Listen は、Apache がどのポート番号と IP アドレスを listen するかを設定する。一般的に Web サーバーとブラウザの通信には 80 番ポートを使用するため、デフォルト設定でも 80 番が設定されている。通常は変更する必要はないが、複数の Web サーバーが同じサーバーコンピュータ上で実行される場合は、ポート番号が重複しないようにここで設定を変更する。

ServerName の設定

最後に ServerName の設定である。設定ファイル内で “ServerName” を検索する。

#
# ServerName gives the name and port that the server uses to identify itself.
# This can often be determined automatically, but we recommend you specify
# it explicitly to prevent problems during startup.
#
# If your host doesn't have a registered DNS name, enter its IP address here.
#
#ServerName www.example.com:80

ServerName は、サーバー自身を表すホスト名とポート番号を設定する。初期設定ではコメントアウトされており、設定する場合は “www.example.com:80” のようにホスト名とポート番号を指定する。ポート番号を省略すると、サーバーへリクエストできるデフォルトポート番号である 80 が使用される。

ここでは Apache をローカル環境にインストールしているため、ServerName の前にある “#” を削除し、次のように変更した。

#
# ServerName gives the name and port that the server uses to identify itself.
# This can often be determined automatically, but we recommend you specify
# it explicitly to prevent problems during startup.
#
# If your host doesn't have a registered DNS name, enter its IP address here.
#
ServerName localhost:80

設定ファイルの修正が終わったら、設定ファイルを保存する。

Apache | Apache のインストール | Apache の起動 (コンソール起動とサービス登録)

kc@example.com (kc kim) — Wed, 13 Nov 2019 23:46:40 +0900

Apache を起動する方法について説明する。Windows 環境で使用する場合、起動方法は大きく二つある。コンソールアプリケーションを使って手動で起動する方法と、Apache を Windows サービスとして登録および設定し、自動的に起動する方法である。

Apache を簡単に起動する

まず、エクスプローラーから Apache を起動する方法である。実行ファイル httpd.exe の場所は “(Apache インストールディレクトリ)\Apache24\bin\httpd.exe” である。

起動するには、"(Apache インストールディレクトリ)\Apache24\bin" フォルダーにある “httpd.exe” を「管理者として実行」する。これで Apache が起動する。

Apache が起動すると、コンソールアプリケーションが開き、起動中は次のような状態になる。

それでは Apache が実行されているか確認してみよう。ブラウザを起動して “http://localhost/” と入力し、次のように表示されれば Apache は正常に起動している。

もし次のように接続できないというエラーが表示された場合は、Apache の起動に失敗している。

エラーが発生した場合は、コマンドプロンプトから httpd.exe を実行してみると、エラーの原因をわかりやすく表示してくれる。

次は ServerRoot が正しく設定されていない場合に発生する。

C:\apache\Apache24\bin>httpd.exe
httpd.exe: Syntax error on line 39 of C:/Apache24/conf/httpd.conf: ServerRoot must be a valid directory

次は ServerName が正しく設定されていない場合に発生する。

C:\apache\Apache24\bin>httpd.exe
AH00558: httpd.exe: Could not reliably determine the server's fully qualified domain name, using fe80::3179:bb2:de42:8a63. Set the 'ServerName' directive globally to suppress this message

起動した Apache を停止するには、コンソールアプリケーションを閉じればよい。コマンドプロンプトで実行した場合は “Ctrl + c” を押す。次のように表示されれば Apache は停止している。

C:\apache\Apache24\bin>httpd.exe

C:\apache\Apache24\bin>

Apache をサービスに登録する

次に、Apache をサービスとして起動する方法である。まずサービスとして登録する。Apache が実行中の場合は停止する。コマンドプロンプトを管理者として起動し、"(Apache インストールディレクトリ)\Apache24\bin" ディレクトリへ移動して、“httpd -k install” コマンドを実行する。

C:\>cd apache\Apache24\bin

C:\apache\Apache24\bin>httpd -k install
Installing the 'Apache2.4' service
The 'Apache2.4' service is successfully installed.
Testing httpd.conf....
Errors reported here must be corrected before the service can be started.

C:\apache\Apache24\bin>

上のように表示されれば、サービスへの登録は完了である。

登録されたかどうかは、Windows 10 の「サービス」画面で確認できる。デスクトップ左下のスタートメニューを右クリックし、表示されるメニューから「コンピューターの管理」をクリックする。

「コンピューターの管理」画面が表示されたら、左側のメニューで「サービスとアプリケーション」にある「サービス」をクリックする。画面右側に登録されているサービス一覧が表示され、その中に Apache2.4 が含まれていることを確認できる。

Apache の起動

続いて Apache を起動する。コマンドプロンプトで “httpd -k start” を実行する。

C:\apache\Apache24\bin>httpd -k start

C:\apache\Apache24\bin>

「サービス」画面を確認すると、Apache2.4 サービスの状態が「実行中」になっている。

確認のため、ブラウザで “http://localhost/” と入力し、次のように表示されれば Apache は正常に起動している。

Apache の停止

サービスとして実行中の Apache をコマンドプロンプトから停止するには、“httpd -k stop” または “httpd -k shutdown” を実行する。

C:\apache\Apache24\bin>httpd -k stop
The 'Apache2.4' service is stopping.
The 'Apache2.4' service has stopped.

C:\apache\Apache24\bin>

Apache の再起動

Apache が実行中の状態で再起動するには、“httpd -k restart” を実行する。

C:\apache\Apache24\bin>httpd -k restart

C:\apache\Apache24\bin>

Apache をサービスから削除する

サービスとして登録された Apache を削除するには、"httpd -k uninstall" を実行する。

C:\apache\Apache24\bin>httpd -k uninstall
Removing the 'Apache2.4' service
The 'Apache2.4' service has been removed successfully.

C:\apache\Apache24\bin>

サービスとして Apache をどのように起動するかを設定する

Apache をサービスとして登録した場合、Windows のサービス管理機能を使用して Apache を起動したり、PC 起動時に自動で開始するよう設定したりできる。「サービス」画面で Apache2.4 をダブルクリックする。

Apache2.4 サービスのプロパティが表示される。

「スタートアップの種類」は現在「自動」に設定されているため、Windows の起動時に Apache も自動的に起動する。自動ではなく手動で Apache を起動する場合は、「スタートアップの種類」を「手動」に変更する。

先ほどはコマンドプロンプトで Apache の起動と停止を行ったが、この画面の「開始」「停止」「一時停止」「再起動」ボタンをクリックして Apache を起動または停止することもできる。

このように、サービスの管理画面からも Apache の起動と停止を制御できる。

Apache | Apache のインストール | Apache ドキュメントの参照

kc@example.com (kc kim) — Wed, 13 Nov 2019 23:46:40 +0900

Apache の設定を行うときに参考になるのは、公式サイトで公開されている Apache ドキュメントである。ここでは、韓国語および英語で Apache ドキュメントを参照する方法について説明する。

韓国語で書かれた Apache ドキュメントを参照する

ドキュメントを参照するには、次の URL にアクセスする。

http://httpd.apache.org/

左側のメニューで「Documentation」に含まれる「Version 2.4」リンクをクリックする。

クリックしてページが開くと、Apache 2.4 システムに関する韓国語のドキュメントを見ることができる。

一部に英語の箇所もあるが、韓国語で書かれた詳細なドキュメントが用意されている。公式ドキュメントとして非常にわかりやすく説明されているため、わからないことがあれば随時参照するとよい。

英語版のドキュメントを参照する

韓国語版のドキュメントには「この文書は最新版の翻訳ではありません。最近の変更内容は英語文書を参照してください。」と表示されているように、内容が少し古い場合もあるようだ。英語版を参照したい場合は、ドキュメントページ右上に表示される「en」をクリックする。

クリックすると英語版のドキュメントが表示される。

英語ドキュメントをある程度読めて、最新の内容を確認したい場合は、こちらを参照するとよい。

Apache | Apache のインストール | 80 以外のポート番号を使って Web にアクセスする

kc@example.com (kc kim) — Wed, 13 Nov 2019 23:46:40 +0900

Apache だけでなく、他の Web サーバーでも一般的にポート番号 80 を使用する。もし同じサーバーで 80 番を使用するアプリケーションがすでに起動している場合は、別のポート番号を使用するよう設定する必要がある。ここでは、ポート番号 80 以外を使用して Web サーバーへブラウザからアクセスする方法について説明する。

Apache で使用するポート番号を変更する

「設定ファイル (http.conf) の初期設定 > ポート番号の設定」で説明したように、Apache で使用するポート番号は http.conf ファイルで指定する。デフォルトでは Listen ディレクティブを使用し、次のように 80 番が指定されている。

#
# Listen: Allows you to bind Apache to specific IP addresses and/or
# ports, instead of the default. See also the <VirtualHost>
# directive.
#
# Change this to Listen on specific IP addresses as shown below to 
# prevent Apache from glomming onto all bound IP addresses.
#
#Listen 12.34.56.78:80
Listen 80

同じサーバーで別の Web サーバーが起動しており、80 番ポートがすでに使用されている場合は、別のポート番号、たとえば 8080 を指定する。どの番号でも自由に指定できるわけではなく、同じサーバーで実行されている他のアプリケーション、たとえばメールサーバーや DNS サーバーなどが使用していない番号を指定する必要がある。ここでは例として 8080 を使用する。

#
# Listen: Allows you to bind Apache to specific IP addresses and/or
# ports, instead of the default. See also the <VirtualHost>
# directive.
#
# Change this to Listen on specific IP addresses as shown below to 
# prevent Apache from glomming onto all bound IP addresses.
#
#Listen 12.34.56.78:80
Listen 8080

設定を適用するには、http.conf ファイルを保存した後、Apache を再起動する。

ブラウザでポート番号を指定して Apache にアクセスする

ブラウザから Apache のような Web サーバーへアクセスする場合は、次の形式でアクセスする。

http://(Web サーバーのホスト名):(Web サーバーで使用するポート番号)/...

たとえば、8080 番に指定された Web サイトへアクセスするには、“http://www.devkuam.com:8080/" のようにアクセスする。

ポート番号として 80 番を使用する場合は例外として、ポート番号を省略すると 80 番が指定されたものとみなされる。 そのため、本来であれば “http://www.devkuam.com:80” のようにアクセスするところを、“http://www.devkuam.com” のようにポート番号を省略してアクセスできる。

ポート番号が 80 番の場合は省略できるため、次の二つは同じである。

http://www.example.com/
http://www.example.com:80/

今回の Apache はポート番号 8080 を使用しているため、この Web サーバーへアクセスするには http://localhost/ ではなく、http://localhost:8080 のようにポート番号を指定してアクセスする必要がある。それではブラウザを開いて接続してみよう。

正常に接続できた。80 以外のポート番号を使用する場合は、Web サーバーへアクセスするときにポート番号を指定する必要があることを忘れないようにする。