PHPのアップグレード

1.  はじめに

これまで、何故、まだPortageでPHP5がstableにマークされていないのか？というたくさんの要望がありました。 これはPHP5パッケージ自体の問題ではありません。 PHP5がstableにまだマークされない主たる要因は、PHP5で動作しない、たくさんのアプリケーション、PHPの拡張機能やパッケージがPortageにあり、私たちにはどうすることも出来ないからです。 PHP5は、PHP4との100％完全な後方互換性がなく、すべてのPHP4で開発されたプログラムがPHP5の環境で実行するための移植作業が、できなかったり、されてなかったりしていました。 しかし、たくさんのユーザがこれからも長い間PHP4のサポートを必要としています。

この問題を解決するための解答は、同時に1つのLinux BoxにPHP4とPHP5の環境を同時に提供することです。 しかし、現在のPHPパッケージとeclassのレイアウトでは不可能でした。このため新しいレイアウト、新しいeclass、新しいebuildへ移行するために多大な努力を行う必要がありました。

このドキュメントでは、システムを停止することなくどのようにアップグレードするかを詳細に説明します。

2.  変更点

基本的なPHPパッケージの統合

すべてのPHPのebuildであるdev-php/php、dev-php/php-cgiと dev-php/mod_phpは、dev-lang/phpへ統合されました。

SAPIを使用したい場合は、以下のUSEフラグを使用してください。

• cgi - /usr/bin/php-cgiをビルド & インストールする場合に使用
• cli - /usr/bin/phpをビルド & インストールする場合に使用
• apache - Apache 1.3(新しいレイアウト)向けのmod_phpをビルド&インストールする場合に使用
• apache2 - Apache 2.0(新しいレイアウト)向けのmod_phpをビルド&インストールする場合に使用

上記のUSEフラグを様々にうまく組み合わせて使用できます。ただし、apacheとapache2を同時に使用することはできません。

これらのebuildで最も重要なことは、PHP4とPHP5を同時にインストールすることができることです。

(CLIとApache2モジュールに対応した最新バージョンのPHPをインストールする)
USE="cli apache2" emerge 'dev-lang/php'

(PHP4のみをインストールする)
USE="cli apache2" emerge '=dev-lang/php-4*'

(PHP4とPHP5の両方をインストールする)
USE="cli apache2" emerge '=dev-lang/php-4*' '=dev-lang/php-5*'

新しいPortageカテゴリ

新しいPHPのebuildは、dev-phpからdev-lang/phpへ移動しました。 PHP4とPHP5を独立したパッケージとしてインストールできるようにするために、dev-php4 とdev-php5という、2つの新しいPortageカテゴリが作成されました。 これらのカテゴリは、主にpecl-pdo、pecl-apc、php-java-bridge、xdebugといったPECLパッケージで使われます。

pecl-apcをインストールには、以下のようにします。

(PHP4向けのAPCをインストールする)
emerge dev-php4/pecl-apc

(PHP5向けのAPCをインストールする)
emerge dev-php5/pecl-apc

(PHP4とPHP5の両方へAPCをインストールする)
emerge dev-php4/pecl-apc dev-php5/pecl-apc

新規ディレクトリ

• これらの新しいebuildは、/usr/lib/php4と/usr/lib/php5へ インストールします(Apache用のモジュールは、Apacheに合わせた正しい場所へ挿入されます)。
• PEARパッケージとその他のPHPライブラリは、/usr/share/php(以前は、/usr/lib/phpでした)にインストールされます。
• PECLパッケージは、もはやphp.iniファイルに設定ディレクティブを追加することはしません。 その代わり、[PACKAGE].iniファイルが/etc/php/[SAPI]/extディレクトリに追加されます。

PHPバイナリへのシンボリックリンク

たとえば、1つ以上のPHPバージョンをインストールする場合を説明します。

USE="cgi cli apache2" emerge '=dev-lang/php-4*' '=dev-lang/php-5*'

ebuildは、/usr/binにインストールされた最後のバージョンのPHPへシンボリックリンクを作成します。 上記の場合、PHP4より後にPHP5がインストールされたので、PHP5へシンボリックリンクが作成されます。 /usr/bin/phpや、/usr/bin/php-cgiではPHP4をリンクしたい場合、または、ある場合にはPHP4、別の場合にはPHP5にリンクしたい場合は、app-admin/php-toolkitで提供されるphp-select toolを使うことができます。php-selectにより、適切なバイナリにシンボリックリンクを簡単に作成できます。

3.  アップグレード手順

アップグレードするためのパッケージを見つける

初めに、アップグレードをするために必要な追加パッケージを特定する必要があります。 app-portage/gentoolkitパッケージに含まれるequeryツールを使用して特定することができます。

$ equery list 'dev-php/'
[ Searching for all packages in 'dev-php' among: ]
 * installed packages
[I--] [  ] dev-php/php-4.4.0 (0)
[I--] [  ] dev-php/mod_php-4.4.0 (1)
[I--] [  ] dev-php/smarty-2.6.10 (0)
[I--] [  ] dev-php/PEAR-PEAR-1.3.5-r1 (0)
[I--] [  ] dev-php/PEAR-Mail-1.1.6 (0)
[I--] [  ] dev-php/PEAR-MDB-1.3.0 (0)
[I--] [  ] dev-php/PECL-apc-3.0.6 (0)
[I--] [  ] dev-php/PECL-imagick-0.9.11 (0)
[I--] [  ] dev-php/xdebug-2.0.0_beta3 (0)

たとえば以下のようなPHPの拡張機能は、

• PECL-apc
• PECL-imagick
• xdebug

両方のPHPバージョンで独立して使用できるようにするために、 dev-php4とdev-php5の2つのPortageカテゴリに別けられています。 さらにこれらのパッケージの大部分は、名前が変更されています。

新しいディレクトリと名前変更された例を以下に紹介します。

以前の古いパッケージを削除する

GentooでPHPの導入方法に関してたくさんの変更が加えられました。 新しいパッケージをインストールする前に、古いPHPパッケージを完全に削除しなければなりません。

(PHPパッケージをunmergeする)
emerge --unmerge php mod_php

(PHPの拡張機能をunmergeする)
emerge --unmerge PECL-apc PECL-imagick xdebug

(PHPライブラリとアプリケーションをunmergeする)
emerge --unmerge PEAR-PEAR PEAR-Mail PEAR-MDB smarty

USEフラグを設定する

いくつかの新しいUSEフラグを追加しましたので、それらを再確認し/etc/portage/package.use(存在しない場合には作成してください)に適切な行を追加したいかもしれません。

PHPインストールでサポートしたい機能に即してUSEフラグを設定してください (最低でもcliUSEフラグを設定することを推奨します)。

dev-lang/php -* cli apache2 ctype expat fastbuild ftp gd hash iconv memlimit mysql nls pcre pic pdo reflection session simplexml sockets spl ssl tokenizer truetype unicode xml xsl zlib

並行してPHP4とPHP5をインストールしたい場合、それぞれのバージョンで異なるUSEフラグを設定することができます。

=dev-lang/php-4* -* cli cgi apache2 ctype expat fastbuild force-cgi-redirect ftp gd iconv ipv6 memlimit mysql nls pcre pic posix session sockets ssl tokenizer truetype unicode xml xsl zlib
=dev-lang/php-5* -* cli cgi apache2 ctype fastbuild force-cgi-redirect ftp gd hash iconv ipv6 memlimit mysql nls pcre pic posix pdo reflection session simplexml soap sockets spl sqlite ssl tokenizer truetype unicode xml xmlreader xmlwriter xsl zlib

PHPをemergeする

PHP4のみ、PHP5のみ、同時に両方をインストールするかを選べます。 PHP4のみをインストールする場合には、=dev-lang/php-4*でemergeします。 PHP5(最新)のみインストールする場合には、dev-lang/phpを使用できます。 同時に両方をインストールする場合には、=dev-lang/php-4*と=dev-lang/php-5*をemergeします。

USEフラグの設定を確認します。

(PHP4パッケージの確認)
emerge --pretend --verbose '=dev-lang/php-4*'

(PHP5パッケージの確認)
emerge --pretend --verbose '=dev-lang/php-5*'

(PHP4向けの拡張機能の確認)
emerge --pretend --verbose dev-php4/pecl-apc dev-php4/pecl-imagick dev-php4/xdebug

(PHP5向けの拡張機能の確認)
emerge --pretend --verbose dev-php5/pecl-apc dev-php5/pecl-imagick

(PHPライブラリとアプリケーションの確認)
emerge --pretend --verbose PEAR-PEAR PEAR-Mail PEAR-MDB smarty

すべてよければ、PHPをemergeします。

(PHP4パッケージをemergeする)
emerge '=dev-lang/php-4*'

(PHP5パッケージをemergeする)
emerge '=dev-lang/php-5*'

(PHP4向けの拡張機能をemergeする)
emerge dev-php4/pecl-apc dev-php4/pecl-imagick dev-php4/xdebug

(PHP5向けの拡張機能をemergeする)
emerge dev-php5/pecl-apc dev-php5/pecl-imagick

(PHPライブラリとアプリケーションをemergeする)
emerge PEAR-PEAR PEAR-Mail PEAR-MDB smarty

PHP4とPHP5を同時に使用する場合:cliとcgiバイナリでどちらを使用するか選択する

emergeの後、/usr/lib/php4/binと/または/usr/lib/php5/binに cliと/またはcgiのバイナリがインストールされます。 PHP4とPHP5を両方インストールする場合、Portageはユーザがどちらを標準として使用するか判断できないので、/usr/binには、最後にインストールしたPHPのバージョンからシンボリックリンクが作成されます。 このため最後にPHP5をインストールした場合、/usr/bin/phpへのシンボリックリンクは、/usr/lib/php5/bin/phpから作成されていることに気づくでしょう。 (phpizeとphp-configを使用してPHPの拡張機能をビルドする責任がある)php-develと同様に、あるcliと/またはcgiバイナリは、(/usr/binに)シンボリックリンクが作成されなければなりません。 app-admin/php-toolkitで提供されるphp-selectを使用することで、 簡単に変更できます。

=dev-lang/php-5*と同様に=dev-lang/php-4*をemergeしていると仮定します。 現在、選択されているPHPのバージョンを表示するために、以下で説明するphp-selectコマンドを入力してください。

(cli向け)
php-select php

(cgi向け)
php-select php-cgi

(phpizeとphp-config向け)
php-select php-devel

上記、実行結果の一例を示します。

# php-select php
/usr/bin/php is set to /usr/lib/php5/bin/php

この出力結果は、PHP cliバイナリの標準パスの/usr/bin/phpが、 PHP5のバイナリである/usr/lib/php5/bin/phpにシンボリックリンクされていることを意味します。 従って、/usr/bin/phpを使用するPHPスクリプトは、PHP5で実行されます。

標準のPHPを変更するためにphp-selectを使用する

前章で調査した標準のバージョンの設定で満足でない場合、 希望するバージョンを選択するために、再びphp-selectを使用することができます。

(cliを設定する場合)
php-select php php4

(cgiを設定する場合)
php-select php-cgi php5

(phpizeとphp-configを設定する場合)
php-select php-devel php5

リンクを確認する。

 # stat /usr/bin/php /usr/bin/php-cgi /usr/bin/phpize /usr/bin/php-config | grep File
 File: `/usr/bin/php' -> `/usr/lib/php4/bin/php'
 File: `/usr/bin/php-cgi' -> `/usr/lib/php5/bin/php-cgi'
 File: `/usr/bin/phpize' -> `/usr/lib/php5/bin/phpize'
 File: `/usr/bin/php-config' -> `/usr/lib/php5/bin/php-config'

4.  設定ファイルを移行する

Gentoo PHPパッケージは、 PHPバージョンごと、SAPIごとに1つのサブディレクトリを/etc/phpに作成して、 設定ファイルを保持します。

$ ls -1 /etc/php
apache2-php4
apache2-php5
cli-php4
cli-php5

すべてのサブディレクトリには、以前のパッケージのように、それ向けのphp.iniが含まれています。

php.iniの変更

php.iniの古い設定と新しい設定の差分を調べるために、 etc-update、またはdispatch-confを使用すべきです。 確実にチェックする必要がある2つのディレクティブは、 include_pathとextension_dirです。 しかし、ここで注意してください。extension_dirは、PHPバージョン間(5.0と5.1でも!)で 異なります。

/etc/php/apache2-php5/php.iniと/etc/php/cli-php5/php.iniのPHP5.1の例を示します。

include_path = ".:/usr/lib/php"
extension_dir = "/usr/lib/php/extensions/no-debug-non-zts-20050617/"

include_path = ".:/usr/share/php"
extension_dir = "/usr/lib/php5/lib/php/extensions/no-debug-non-zts-20050617/"

変更されたPHPの拡張機能の設定

新しいPHPパッケージは、外部(共有)PHP拡張機能用の設定ディレクティブを、もはやphp.iniに保存しません。 これらのディレクティブは、/etc/php/*/extディレクトリに拡張機能固有の設定ファイルで保持されます。 共有拡張機能を有効/無効にするために、/etc/php/*/ext-activeからシンボリックリンクを作成する仕組みが使われます。 拡張機能を有効にする場合は、/etc/php/*/ext-activeから /etc/php/*/ext/の中の、対応する[EXTENSION].iniへシンボリックリンクを作成します。 拡張機能を無効にする場合は、シンボリックリンクを削除します。

以前、dev-php/PECL-apcをインストールしていた場合は、APCの設定は、 php.iniに保存されます。 新しいdev-php5/pecl-apcパッケージを再emergeした場合は、 APCの標準設定は、/etc/php/*5/ext/apc.iniに書き込まれます。

APC設定ディレクティブを/etc/php/*5/php.iniから/etc/php/*5/ext/apc.iniへ移動させる必要があるので、 /etc/php/*5/ext-active/apc.iniから/etc/php/*5/ext/apc.iniへシンボリックリンクを作成します。

5.  PHP4と/またはPHP5が動作するようにApacheを設定する

PHP4またはPHP5モジュール(mod_php)を読み込むように、Apacheを設定するには、 /etc/conf.d/apache2の中のAPACHE2_OPTS変数に、 -D PHP4と-D PHP5をそれぞれ追加します。

(PHP4向けの設定)
APACHE2_OPTS="-D PHP4"

(PHP5向けの設定)
APACHE2_OPTS="-D PHP5"

同時に2つのPHPバージョンをApache上で動作させる方法はたくさんあります。 一番簡単な方法は、cgiバイナリとしてPHP4とPHP5を使用することと、 PHP4はcgiでPHP5はモジュール(または、その反対)で使用することです。 1つのApacheインスタンスで、PHP4モジュールとPHP5モジュールを使うことはできません。

実現可能な手法のいくつかを、PHP4 and PHP5 Configuration Guideの中で説明しています。

6.  サポート/手がかり

新しいGentooのPHPパッケージで問題に直面している場合は、この章で何か手がかりを得ることができるでしょう。

• GentooでのPHPについては、 Common Questionsを参照してください。
• Development-Page of the PHP Overlay(訳注:PHPオーバーレイの開発ページ)
• irc.freenode.net上の#gentoo-phpチャンネル。ここには、オーバーレイを作り出す常連が頻繁に訪れます。お待ちしています!
• Gentoo Forumsは、ヘルプを求めるのに最適な場所です。とてもたくさんのGentooユーザが24時間フォーラムを読んでいます。 それゆえ、すぐにヘルプが得られるとても素敵な場所となっています。

新しいパッケージの実装の詳細については、Stuarts Posting on gentoo-dev と 'Radical Changes for PHP5 Support'で始まるStuartsのブログのエントリーを見てください。

Development-Pageでは、 たくさんのドキュメントと、後に公式のPortageツリーへ移行すると思われる一番新しいebuildを見つけることでしょう。

このドキュメントの内容は Creative Commons - Attribution / Share Alikeライセンスです。