PHP 4.x のインストールメモ

a. PHP のバージョンについて

PHP は http://php.net/ で入手できます。

初めて PHP をインストールする場合は、PHP 4.4.1(2005.10.31 公開)や、PHP 5.1.1(2005.11.28 公開)以降の最新のバージョンを利用してください。また、セキュリティホールなどが見つかり、使用しているバージョンの PHP が影響を受ける可能性がある場合は、バージョンアップした時に問題が出ないかどうかを確認してから、最新版にバージョンアップしてください。

ただし、PHP 4.4.1 はマルチバイト文字列を扱う mbstring にいくつかバグがあり、mb_send_mail() を使用すると件名が文字化けする問題が報告されています。バグの影響を受ける場合は、PHP-QAT でテスト用に PHP 4.4.2RC1 が公開されていますので、こちらを使用することを検討した方が良いと思います。

b. インストール

PHP の configure オプションは非常に多いです。オプションについては、./configure --help で確認してから、必要なものを指定してください。

--with-pgsql オプションは PostgreSQL をインストールしていない場合、エラーになります。このオプションを使用する場合は、先に PostgreSQL のインストールを行ってください。ここでは、MySQL は使用しないため、--without-mysql を入れています。PHP 4.x で MySQL を使用する場合は --without-mysql を入れないでください。PHP 4.x で --without-mysql を入れない場合は、自動的に MySQL モジュールがインストールされます。PHP 5.x では、自動的には MySQL モジュールはインストールされませんので、必要なオプションを指定してください。

参考までに、Apache 2.x を使用する場合は、--with-apxs2=/usr/local/apache2/bin/apxs のように、--with-apxs2 を使用して、Apache の apxs がインストールされている場所を指定します。

インストールは、以下のように行います。ここでは、PHP 4.4.1 を使用していますが、PHP 4.3.x や PHP 5.x でも、オプションに気を付ければ同様にインストールできます。PHP 4.1.x や、PHP 4.0.x をインストールする必要がある場合は、PHP 4.1.2 とマルチバイト正規表現モジュールのインストール を参考にしてください。

$ tar jxvf php-4.4.1.tar.bz2
$ cd php-4.4.1
$ ./configure \
  --with-apxs=/usr/local/apache/bin/apxs \
  --enable-mbstring \
  --with-libmbfl \
  --enable-pcntl \
  --with-zlib \
  --with-openssl \
  --with-pgsql=/usr/local/pgsql \
  --without-mysql
$ make
$ sudo make install

インストール終了後、PHP の設定ファイル php.ini を /usr/local/lib/ にコピーします。サンプルとして、以前の PHP との互換性を重視した php.ini-dist と、パフォーマンスとセキュリティを重視した php.ini-recommended がインストールしたソースのディレクトリに含まれています。

特に、既にある PHP スクリプトを利用するという理由でもない限り、php.ini-recommended をコピーすることをお勧めします。特に、公開サーバでは、php.ini-recommended から必要な設定を変更して使用すると良いと思います。

$ sudo cp php.ini-recommended /usr/local/lib/php.ini

php.ini-recommended の設定については、英語でコメントがありますが、和訳してくださった方がおられます。少し古いので、最新のバージョンとは少し違いがありますが、こちらも参考になると思います。http://www.net-newbie.com/postgres/php.ini-recommended.txt

c. php.ini の編集

まず、セキュリティに関係する設定を行っておくことをお勧めします。

php.ini-recommended をインストールした場合は、以下の設定が全て Off に設定しておくことをお勧めします。allow_url_fopen については、PHP で外部のサーバに接続することを前提としたスクリプトを書く必要がなければ Off にしておく方が良いと思います。

[PHP]

; 特殊な変数(GET/POST/Cookie/サーバ変数/環境変数など)をグローバル変数に登録する
register_globals = Off

; GET/POST/Cookie を自動的にエスケープする
magic_quotes_gpc = Off

; ファイルを開く関数で http://... などの URI でも開くようにするかを設定
allow_url_fopen = Off

; PHP を使用していることを知らせる(HTTP レスポンスヘッダに X-Powered-By: PHP/(version) が表示される)
expose_php = Off

次に、display_errors と error_reporting を設定します。

display_errors は PHP スクリプトでエラーが発生した場合にブラウザに表示するかどうかを設定するフラグで、error_reporting はエラーの報告レベルを指定します。

display_errors については、PHP スクリプトを開発するサーバでは、On にしておいた方が便利ですが、外部公開しているサーバでエラーが表示されてしまうのはあまり好ましくありません。外部公開するサーバでは、Off にしておく方が安全です。

error_reporting は、開発中であれば、必ず E_ALL に設定して、エラーが発生しないように開発を行ってください。公開サーバでは、エラーログの状況に応じて変更しても良いと思いますが、E_ALL にしておき、エラーが発生していないかを確認した方が安全です。

; エラー報告レベル
error_reporting  =  E_ALL

; エラーが発生した場合にブラウザに表示する [外部公開サーバ: Off, 開発サーバ: On]
display_errors = Off

外部公開サーバでは、以下の設定を行って、Apache ログへの出力を行うか、指定したファイルへのエラーログの記録を行うことで、エラーの発生状況を把握してください。

; エラーログを記録する
log_errors = On

; エラーログの保存場所(syslog/エラーログファイル Path/指定しない: 指定しない場合は Apache のエラーログファイル)
; error_log = syslog

後は、日本語などのマルチバイトを扱う場合、インストール後に php.ini を編集する必要があります。

まずは、以下のように、mbstring ディレクティブの設定を行っておけば良いと思います。mbstring.internal_encoding については、PHP スクリプトの文字コードを UTF-8 で書く場合は以下のように指定します。

[mbstring]
mbstring.language = Japanese
mbstring.internal_encoding = UTF-8

他にも多くの設定があります。セーフモード設定(open_basedir, disable_functions, ...)や、セッション関連の設定(session.use_only_cookies, session.use_trans_sid, ...)などがありますので、外部公開サーバの場合はできる限り安全な設定にしておく必要があると思います。

詳しくは PHP マニュアル: コア php.ini ディレクティブに関する説明を参照してください。

a. Cygwin に Apache のインストール

(2004.11.14 修正、追記)

The Apache HTTP Server Project から Apache 1.3.33 をダウンロードして、展開します。

$ tar apache_1.3.33.tar.gz
$ cd apache_1.3.33

Apache のインストールスクリプトを使用した場合、インストール時にいくつかの実行ファイルのコピーに失敗しますが、Makefile を書き換え、Cygwin の fileutils パッケージに含まれる install を使用すると、エラーが発生せず、正常にインストールに成功します。

以下の行を修正します。Apache 1.3.33 の Makefile では、45 行目にありました。

INSTALL         = $(TOP)/$(AUX)/install.sh -c

以下のように修正します。

INSTALL         = /usr/bin/install

次に、コンパイル、インストールを行います。

$ ./configure --with-port=80 --enable-module=so
$ make
$ make install

上述のように、Makefile を書き換えた場合は、エラーは発生しませんので、以下のようにコピーを行う必要はありません。

通常では、make install を実行した時にいろいろとエラーが表示され、いくつかの実行ファイルがインストールされません。インストールされていない httpd.exe などのファイルを Apache のインストールディレクトリにコピーします。

$ cp src/httpd.exe /usr/local/apache/bin/
$ cp src/support/*.exe /usr/local/apache/bin/

httpd.conf を編集して、User や Group、ServerName などの設定を行います。必要であれば、Apache の専用ユーザの追加や、グループの追加なども行ってください。User を現在のユーザ名に変更すれば、Apahce の起動は可能です。

$ vi /usr/local/apache/conf/httpd.conf

設定が終了したら、Apache を起動します。

$ PATH=/usr/local/apache/libexec:$PATH /usr/local/apache/bin/apachectl start

/usr/local/apache/libexec に PATH が通っていないとエラーになります。Apache を起動する時に、毎回 PATH を入力するのが面倒な場合は、/usr/local/apache/bin/apachectl を編集して、最初の部分に以下の行を追加してください。

PATH=/usr/local/apache/libexec:$PATH

または、Apache を起動するユーザの環境設定ファイル(~/.bashrc や ~/.bash_profile など)に、以下の行を追加しても良いと思います。

export PATH=$PATH:/usr/local/apache/libexec

Apache が起動したら、ブラウザで、http://localhost/ を開いて、Apache のサンプルページが表示されるかどうかを確認してください。確認したら、Apache を終了させておきます。

$ /usr/local/apache/bin/apachectl stop

b. Cygwin に PHP をインストール

(2004.02.08 追記)

libphp4.dll の作成に失敗する場合についてを追加しました。PHP のコンパイルを始める前に読んでください。

Apache の共有モジュールとして動作する mod_php4 を作成します。まず、PHP Hypertext Preprocessor から、ソースをダウンロードします。現在(2004.01.04)の最新版は PHP 4.3.4 です。PATH を設定し、ソースを展開して、configure を実行します。configure オプションについては、他に必要なものがあれば、付け足してください。

$ export PATH=/usr/local/apache/libexec:$PATH

$ tar jxvf php-4.3.9.tar.bz2
$ cd php-4.3.9

$ ./configure --with-apxs=/usr/local/apache/bin/apxs --without-mysql --enable-mbstring

configure オプションに問題がなければ、Makefile が作成されますので、少し編集します。

$ vi Makefile

ここで、Makefile にある、libphp4.so という記述を、libphp4.dll に置き換えてください。vi で :%s/libphp4\.so/libphp4.dll/g を実行すると簡単です。または、sed を使用して置き換える方法もあります。

$ sed -i 's/libphp4\.so/libphp4.dll/g' Makefile

make を実行します。

$ make

コンパイル中に warning などが出て、libphp4.dll の作成に失敗しますが、以下のように実行することで、libphp4.dll が作成できます。この方法については、Cygwin の mod_php4 のソースである、apache-php-4.2.0-2-src.tar.bz2 に含まれていた、CYGWIN-PATCHES/mkdll.sh を参考にしました。また、Cygwin ユーザーズガイドに、DLL のビルドと利用 という Cygwin 上で DLL を作成する際に非常に参考になるページがありましたので、詳しく知りたい場合はそちらを参照してください。

$ cd libs
$ gcc -shared -o libphp4.dll -Wl,--out-implib=libphp4.dll.a -Wl,--export-all-symbols \
    -Wl,--whole-archive libphp4.a /usr/local/apache/libexec/libhttpd.dll -Wl,--no-whole-archive -lcrypt

この部分でエラーが出て libphp4.dll の作成に失敗した場合、gcc のオプションに -lresolv を追加して再度コマンドを実行してみてください。詳しくは、libphp4.dll の作成に失敗する場合を参照してください。

以上が終了したら、libphp4.dll が作成されます。次に、インストール、設定ファイルのコピー、設定ファイルの編集などを行います。

$ cd ../
$ make install
$ cp php.ini-recommended /usr/local/lib/php.ini

$ vi /usr/local/lib/php.ini
$ vi /usr/local/apache/conf/httpd.conf

必要な設定を追加、編集してください。httpd.conf には、以下の行があることを確認してください。

LoadModule php4_module        libexec/libphp4.dll

PHP スクリプトを実行するためには、以下の設定も追加する必要があります。拡張子が phps の場合はソースを表示するように設定していますが、ソース表示が不要であれば、phps の設定は外しても良いと思います。

# ファイル名を省略した場合、読み込むファイルに index.php を追加します。

<IfModule mod_dir.c>
    DirectoryIndex index.html index.php
</IfModule>

# 拡張子が php の場合に php スクリプトを実行するように設定します。
# AddType application/x-tar .tgz の記述の下くらいに追加すると良いと思います。

AddType application/x-httpd-php .php
AddType application/x-httpd-php-source .phps

設定が終了したら、Apache を起動し、テストスクリプトを実行してみます。

$ /usr/local/apache/bin/apachectl start

以下の PHP スクリプトを Apache の Document Root(設定を変更していない場合は、/usr/local/apache/htdocs/) に、phpinfo.php として設置します。

<?php
    phpinfo();
?>

ブラウザで、http://localhost/phpinfo.php を開きます。PHP のバージョン、設定情報のページが表示されれば、インストールは成功です。

c. Cygwin で pear コマンドを使用する

PHP には、pear コマンドによって、クラスライブラリをインストールする方法が提供されていますが、Cygwin に PHP をインストールした状態では以下のようなエラーが表示され、使用できませんでした。

$ pear list
could not acquire unlock lock (/usr/local/lib/php/.lock)

Cygwin の場合は、他の OS と flock の挙動が少し違うようです。対処方法として、/usr/local/lib/php/PEAR/Registry.php の 290 行目付近で、

$this->lock_fp = @fopen($this->lockfile, $open_mode);

となっている部分を、

if (!is_resource($this->lock_fp)) {
    $this->lock_fp = @fopen($this->lockfile, $open_mode);
}

のように変更することで、Cygwin でも pear コマンドが使用できるようになりました。

$ pear list
INSTALLED PACKAGES:
===================
PACKAGE        VERSION  STATE
Archive_Tar    1.1      stable

...省略...

XML_Parser     1.0.1    stable
XML_RPC        1.0.4    stable

d. Cygwin で、set_time_limit() を有効にする Patch

PHP のコンパイルが終了した時に、テストする方法として、make test を実行することができるのですが、残念ながら、Cygwin では、set_time_limit() がうまく実行できないため、make test が途中で止まってしまいます。

テスト環境として、set_time_limit() が実行できないのは不便ですので、それを解消する Patch を作成してみました。Cygwin では、C 言語の setitimer() 関数では、ITIMER_REAL のみ実装されているという情報がありましたので、setitimer() で登録する引数を ITIMER_REAL に、signal() の引数を SIGALRM に変更してみました。とりあえず、PHP では、プロセス制御関数を有効にしてコンパイルした場合は影響がありそうですが、Cygwin でプロセス制御関数を使用しない限りはおそらく問題はないと思います。

set_time_limit() が使用できないことが不都合である場合は、下の Patch を適用してから、make を実行してください。

ファイルとしても置いておきます。cygwin_zend_execute_API.c.patch をダウンロードしてください。

--- zend_execute_API.c.orig	2003-08-05 02:14:16.000000000 +0900
+++ zend_execute_API.c	2003-12-31 23:37:46.767337600 +0900
@@ -851,10 +851,10 @@
 		t_r.it_value.tv_sec = seconds;
 		t_r.it_value.tv_usec = t_r.it_interval.tv_sec = t_r.it_interval.tv_usec = 0;
 
-		setitimer(ITIMER_PROF, &t_r, NULL);
-		signal(SIGPROF, zend_timeout);
+		setitimer(ITIMER_REAL, &t_r, NULL);
+		signal(SIGALRM, zend_timeout);
 		sigemptyset(&sigset);
-		sigaddset(&sigset, SIGPROF);
+		sigaddset(&sigset, SIGALRM);
 		sigprocmask(SIG_UNBLOCK, &sigset, NULL);
 	}
 #	endif
@@ -873,7 +873,7 @@
 
 		no_timeout.it_value.tv_sec = no_timeout.it_value.tv_usec = no_timeout.it_interval.tv_sec = no_timeout.it_interval.tv_usec = 0;
 
-		setitimer(ITIMER_PROF, &no_timeout, NULL);
+		setitimer(ITIMER_REAL, &no_timeout, NULL);
 	}
 #	endif
 #endif

make を実行する前に、Zend ディレクトリに入り、Patch を適用してください。Cygwin で patchutils をインストールしていない場合は、patch コマンドがありませんので、その場合は、Devel/patchutils パッケージをインストールしてください。

例えば、以下のようにして適用して、コンパイル、テストを行うことができます。

$ wget http://www.asahi-net.or.jp/%7Ewv7y-kmr/data/cygwin_zend_execute_API.c.patch
$ cd php-4.3.4/Zend
$ patch < ../../cygwin_zend_execute_API.c.patch
$ cd ../
$ ./configure --with-apxs=/usr/local/apache/bin/apxs --without-mysql --enable-mbstring
$ vi Makefile
$ make
$ make test

make test が終了して、結果が表示されれば成功です。あとは、libphp4.dll を作成して、インストールを行ってください。

e. Cygwin で libphp4.dll の作成に失敗する場合

2004.02.08 時点では、Cygwin の Libs/minires-devel がインストールされている場合、libphp4.dll の作成時に以下のようなエラーが出力されて、libphp4.dll の作成に失敗するようです。

$ gcc -shared -o libphp4.dll -Wl,--out-implib=libphp4.dll.a -Wl,--export-all-symbols \
    -Wl,--whole-archive libphp4.a /usr/local/apache/libexec/libhttpd.dll -Wl,--no-whole-archive -lcrypt

Creating library file: libphp4.dll.a
libphp4.a(dns.o)(.text+0x53a): In function `zif_checkdnsrr':
/usr/local/src/php-4.3.4/ext/standard/dns.c:256: undefined reference to `___res_search'
libphp4.a(dns.o)(.text+0x8e4): In function `zif_getmxrr':
/usr/local/src/php-4.3.4/ext/standard/dns.c:317: undefined reference to `___res_search'
libphp4.a(dns.o)(.text+0x928):/usr/local/src/php-4.3.4/ext/standard/dns.c:328: undefined reference to `___dn_skipname'
libphp4.a(dns.o)(.text+0x96b):/usr/local/src/php-4.3.4/ext/standard/dns.c:334: undefined reference to `___dn_skipname'
libphp4.a(dns.o)(.text+0x9e1):/usr/local/src/php-4.3.4/ext/standard/dns.c:346: undefined reference to `___dn_expand'

Cygwin をインストールするときに、全てのパッケージをインストールしたり、Libs/minires-develをインストールしている場合は、PHP のコンパイル時にはアンインストールしておくと libphp4.dll の作成に成功するようです。または、下の追記に書きましたが、コンパイルオプションに -lresolv を追加する方法があるようです。

(2004.07.30 追記)

Cygwin使っている人いますか？ その12 [313-315](2ch) によると上のエラーが発生した場合、以下のように -lresolv を追加してコンパイルを行うと libphp4.dll の作成に成功するようです。

$ gcc -shared -o libphp4.dll -Wl,--out-implib=libphp4.dll.a -Wl,--export-all-symbols \
    -Wl,--whole-archive libphp4.a /usr/local/apache/libexec/libhttpd.dll -Wl,--no-whole-archive -lcrypt -lresolv