PHP/FI 2.0 版

はじめに
インストールの手順
PHP/FIで何ができるか?
CGIリダイレクション
セキュリティについて
セーフモード
コマンドラインからの PHP/FI 実行
HTTP 認証
Apache リクエスト変数
Apache モジュール
Apache モジュールの設定
FastCGI サポート
アクセス制御
アクセス情報の記録
相対URLと絶対URL、なぜイメージファイルが表示されないのか
PHP/FI における GET と POST データの処理法
- 複数選択 と PHP
- イメージボタンによる投稿 と PHP
PHP における GD (GIF画像作成用ライブラリ) サポート
PHP/FI と仮想ホスト
ファイルアップロード
クッキー(Cookie)のサポート
mSQL サポート
Postgres95/PostgreSQL サポート
mysql サポート
Solid サポート
Sybase サポート
Oracle サポート
Illustra サポート
Adabas サポート
正規表現
エスケープキャラクター
UNIX ファイル許可属性の8進数表記
PHP/FI スクリプト言語
- 構文
- 変数
- 連想配列
- 可変変数
- 言語構造
- ユーザー定義関数
- 変数の範囲
- 数学的表現
- While ループ
- Switch 構造
- 安全な変数 - GET メソッドにおけるハッキング防止
- 演算子のオーバーロードと変数の型の扱い
- 関数呼び出しのエラー抑制
- 内部関数
自作の内部関数を PHP/FI に加える方法
ソースコード改造について

はじめに

PHP は Perl で書かれた小さな CGI ラッパーであった。私は自分のレジュメを読んだ人からアイデアを得るための簡便なツールが必要だったので、ある日の午後、このプログラムを作った。この頃、私個人の使用以外は考えていなかった。私がレジュメを置いていたWebサーバーは極端に過負荷で、常にプロセスをフォークするという問題を抱えていた。私は、Perl ラッパーを C で書き直し、自分のレジュメがアクセスされる度に Perl プロセスがフォークされることによる著しい無駄を取り除こうとした。

しだいに私のラッパーを知った同じ Web サーバのユーザーから、これを使わせてくれないか、と尋ねられるようになった。それから、当然のように彼らはより多くの機能を望みはじめた。私は多くの機能を付加し、その後ドキュメントとメーリングリストとFAQ 付でベータ版配布をはじめた。このパッケージの最初の名前は「Personal Home Page Tools」で、後に「Personal Home Page Construction Kit」となった。

同じ頃、私はデータベースで遊ぶようになり、 SQL クエリーを容易に web ページ中に埋め込めるツールを書いた。これは、根本的に別のCGIラッパーで、 SQLクエリーを処理し、それらのクエリーに基づいて容易にフォームとテーブルを作ることができた。このツールは、FI (Form Interpreter) と名付けられた。

PHP/FI バージョン 2.0 は、これら２つのパッケージを組み合わせて１つのプログラムにすることにより、完全に書き直されたものである。今や、HTML ファイル埋め込み型の簡単なプログラム言語を持つまでに進化した。元の頭字語である PHP は過去のものとなった。この単語は、もはや適当ではない。 PHP/FI は、個人のホームページ(Personal Home Page) での使用に留まらず、多くの web サーバーで使われるようになった。なんといっても、HTML ファイルに直接簡単なスクリプトを置くこのが可能になったおかげで、数多くの小さな Perl CGI プログラムを書く必要がなくなったのである。これにより、 Perl プロセスを何回もフォークすることによる負荷がなくなるため、あなたの web ページを見る際の総合的な速度が向上する。また、一つの html ファイルの中にすべての web ページの構成要素を置くことにより管理が簡単になる。いくつかのデータベースのサポートの付加により、データベース機能を有する web ページの開発がとても簡単になった。埋め込み型の方が、CGI と HTML 分割して作ろうとするよりもはるかに処理が容易であることに多くの人が気づいたのである。

PHP 3.0版は、更に別途書き直されたものである。 PHP を今から始めようとする場合には、2.0版よりも 3,0版で始めることを推奨する。 PHP3 は PHP/FI 2.0 に短期間で更新されるであろうし、開発の労力は現在 PHP3 に集中しているからである。 PHP/FI 2.0 に残るすべてのバグも単純なもの以外は修正される予定はない。 PHP3 に関する詳細な情報は、 http://www.lerdorf.on.ca/php3 で得ることができる。

このドキュメントにおいて、PHP,FI あるいは PHP/FI といった表現を用いているが、これらが指しているのは同じものである。 PHP と FI の違いは、コンセプトの違いによるものだけである。両者は、同じ配布ソースからつくられる。アクセスログ機能あるいはアクセス制限機能のサポートを外して実行ファイルを作った場合には、FI バイナリと呼ぶ。また、これらのオプション付で作成した場合には、PHPと呼ぶ。

インストールの手順

はじめる前に

もし、あなたにUNIXの経験が全くない場合には、このインストール際に UNIXに関するちょっとした知識を周りの誰かに聞きたいと思うかもしれない。すべての手順は可能な限りシンプルに構成されているが、このソフトウエアは多くの要素により構成されているので、全てのシステムにおいてスムーズに進行すると考えるのは現実的ではない。あなたは、インストールするシステムの特徴を知る周りの誰かを必要とするかもしれない。

インストール前に知るべきこと

インストールするサーバーは、post と get を用いた CGI プログラム動かすことができるか?
これは、Apache モジュール版をインストールする場合には関係ない。 そうでない場合には、このパッケージを使用することはできない。多くのプロバイダでは、CGI プログラムは許可されないか、極端に制限されている。自分のシステムがそうである場合には、システム管理者と話して、このパッケージを見せ、自分のためにインストールしてくれるかどうかを調べること。

mSQL がシステムにインストールされている場合には、インストールされている場所を知っている必要がある。

Postgres95 または PostgreSQL がシステムにインストールされている場合には、インストールされている場所を知っている必要がある。

もし、ログの保存やアクセス設定ファイルをNFSマウントされたディレクトリに置こうとする際に、システムがNFSファイルロック機能を有しない場合には、src/Makefile 中の NFS_HACK 変数を定義し、少し修正した gdbm ライブラリを用いなければならないであろう。詳しくは、doc ディレクトリの中の nfs_hack.txt を参照のこと。

もし、あなたがPHPを使って自分のページのアクセス状況をモニタすることに関心がない場合には、このオプションを実行ファイルに組み込まないこと。また、アクセス制限機能も外した方が良いかもしれない。これらのオプションを組み込むことは、著しいシステム負荷の増大を招く。

もし、Apache モジュール版をインストールする場合には、 Apache のソースコードのディレクトリを知っている必要がある。

インストール手順

手順 1.

まず、インストールプログラムを走らせる。: ./install

いくつかの質問をされる。もし、どんなこと聞かれているかがわからない場合には、単にリターンキーを押すこと。デフォルトの選択支はほとんどのシステムで安全である。しかし、設定ファイルとログファイルを置くディレクトリについての質問に関して、このことはあてはまらない。 httpd (通常は nobody)が書き込み許可を有するディレクトリを選ぶこと。このディレクトリを以下のコマンドで簡単に作成することができる。

chown nobody directory.

手順 2.

src ディレクトリに移る。: cd src

php.h ファイルを見ることを推奨する。多くのコンパイル時オプションをここでセットすることができる。

手順 3.

以下を入力する。: make

このコマンドにより、実行ファイル php.cgi がデフォルトで作成される。もし、Apache モジュール版をインストールする場合には、 libphp.a が作成される。

手順 4. (Apache モジュール版でない場合)

実行ファイル php.cgi を自分のシステムの cgi-bin ディレクトリにコピーする。もし、このディレクトリに書き込む権利がなく、自分のディレクトリにインストールしたい場合には、そうすることができる。しかし、次のコマンドにより、実行ファイルの setuid ビットをオンにしなければならない。:

chmod u+s /path/php.cgi

もし、実行ファイルの setuid ビットをオンにしない場合には、この実行ファイルにより作成されたファイルは全てそのユーザーの ID により所有される。もし、このことが受け入れられるならば、 setuid ビットを安心してオフにすることができる。

手順 4. (Apache モジュール版をインストールする場合)
Apache ソースディレクトリに移動する。ここには、mod_php.c と mod_php.h がコピーされていなければならない。書き込み許可の問題でこれらのファイルが書き込まれなった場合には、 2つのファイルを手動でそこにコピーする必要がある。 Configuration ファイルを編集し、EXTRA_LIBS の行に 手順 3の最後に出力された行を加える。そして、次の行をファイルの最後に加える。 :

Module php_module mod_php.o

続いて、次のように入力する。 : ./Configure そして、Apache httpd サーバーを再構築する。 make この実行ファイルをインストールする。

次に、Apache の conf/srm.conf ファイルを編集し、次のような行を加える必要がある。 :

AddType application/x-httpd-php .phtml

これにより、.phtml という拡張子を持つ全てのファイルに対して、 PHP モジュール起動のトリガーとなる新しい MIME の型、 application/x-httpd-php が定義される。他の拡張子を同様にして定義することも可能である。

もし、全てのユーザーが PHP で解釈されるファイルを実行可能であることを望まない場合には、 access.conf において、 AddType の行を <Location /path>....</Location> 構文の中に置くことにより、PHPで解釈されるドキュメントをサーバー中の特定のディレクトリにのみ許可することができる。

以上で、httpd サーバーを再起動する準備ができた。 PHP モジュールの設定に関するより詳細な情報は、 Apache モジュールに関してを参照のこと。

実行テスト

インストール終了後、自分のブラウザに次のような URL を入力することにより、実行ファイルが動作するかどうかをテストすることができる。 :

http://your.site.domain/cgi-bin/php.cgi

これにより、バージョン番号や他の有益な情報等を含むページが表示される。

Apache モジュール版をテストするためには、.phtml という拡張子を持つ任意のファイルを作成し、次のようなタグを入力する。:

<?phpinfo()>

これが PHP に解釈されれば、同様の情報を見ることができる。

使用法

既にある HTML ファイルに対して PHP/FI を使用する場合には、上記のURLに自分のファイル名をパス付きで加えるだけでよい。すなわち、

http://your.site.domain/cgi-bin/php.cgi/path/file.html

Apache このドキュメント中の CGI リダイレクションの項を参照されたい。 PHP/FI をリダイレクトで実行することにより、 PHP/FI に解釈される次のようなURLを自動的に使用することができる。

http:/your.site.domain/file.phtml

以上のことは、Apace モジュール版のユーザーには適用されない。

PHP/FI で何ができるのか?

PHP/FI を介して自分のページを見た時に最初に気づくのは、フッターにそのページのアクセス数についての情報が加えられていることであろう。 (アクセス記録機能を有効にして実行ファイルを作成した場合) これは、PHP/FI があなたのために行なえることのほんの一部に過ぎない。 PHP/FI はフォーム解釈用 CGI 、つまり PHP/FI という名前の FI という部分、として別の非常に重要な役割を果たす。例えば、自分のWWWページにフォームを加えようとする際には、フォームに入力された情報を処理する手段が必要になる。単にその情報を他のページに受け渡そうとするだけであっても、そのような処理を行なうCGI プログラムを用意する必要がある。 PHP/FI は、フォームに入力されたデータの処理や、そのデータを用いてこのようなことをすることを著しく簡単化する。

簡単な例

次のようなフォームがあるとする。:

<FORM ACTION="/cgi-bin/php.cgi/~userid/display.html" METHOD=POST> <INPUT TYPE="text" name="name"> <INPUT TYPE="text" name="age"> <INPUT TYPE="submit"> </FORM>

続いて、次のような文を含む display.html というファイルを用意する。:

<?echo "Hi $name, you are $age years old!<p>">

簡単だ! PHP/FI は自動的にフォームのそれぞれについて一つの変数を作る。これらの変数を ACTION タグで URL により指定されたファイルにおいて用いることができる。

次のステップでは、変数の使い方を理解したとして、ホームページに論理的な流れを作り出すことを始める。例えば、ユーザーの入力により異なったメッセージを表示したい場合には、if/else 構文を使うだろう。上記の例においてユーザーが入力した年齢に基づいて displat.html を変えることにより、異なった表示を行なうことができる。 :

<?
    if($age>50);
        echo "Hi $name, you are ancient!<p>";
    elseif($age>30);
        echo "Hi $name, you are very old!<p>";
    else;
        echo "Hi $name.";
    endif;
>

PHP/FI は上に示した簡単な例よりもはるかに多くのことを行なえる強力なスクリプト言語を提供する。詳細な情報は PHP/FI スクリプト言語を参照のこと。

PHP/FI を自分のページにアクセスする許可を与える人を設定するためにも使うことができる。これは、PHP/FI に組み込まれた設定用画面により行なうことができる。これにより、例えば特定のドメインからのアクセスする人のみ自分のページを見ることを許可するということを決めることができる。また、特定のページをパスワードにより保護するというような規則を設けることもできる。詳細な情報はアクセス制御の項を参照のこと。

PHP/FI は、RFC-1867 の要件を満たす全ての WWW ブラウザからのファイルアップロードを受け取ることができる。この機能においては、テキストとバイナリの両方をアップロードすることができる。 PHP/FI のアクセス制御機能と論理関数により、ファイルをアップロードできる人と、いったんアップロードされたファイルによりすることができることを完全に制御することができる。詳細は、ファイルのアップロードの項を参照のこと。

PHP/FI は、mSQL と呼ばれるデータベースをサポートしている。これにより、情報をデータベースに渡したり、.HTML ファイルに記述された簡単な SQL クエリーを通じてこの情報にアクセスしたりすることが可能になる。データベースのバックエンドをWWWページに加えることは、従来簡単なことでなかった。詳細は、mSQL のサポートの項を参照のこと。

PHP/FI は、Postgres95/PostgreSQL データベースをサポートする。この機能は、.HTML ファイル中における埋め込み型の SQL クエリーをサポートする。詳細は、Postgres95/PostgreSQL のサポートを参照のこと。

PHP/FI は、mysql データベースエンジンもサポートする。 .HTML ファイルにおける埋め込み SQL クエリーがサポートされる。詳細な情報については、mysql サポートを参照のこと。

CGI リダイレクション

Apache 1.0.x について

PHP/FI を実行するうまいやり方は、Apache サーバーと共に CGI リダイレクションモジュールを用いることである。もし、Apache モジュール版の PHP/FI を用いる場合には、リダイレクトモジュールに関する事項を気にする必要はない。このリダイレクトモジュールは2種類のものが手に入る。一つは、Dave Andersen <angio@aros.net> により作られたものであり、 ftp://ftp.aros.net/pub/util/apache/mod_cgi_redirect.c から手に入る。もう一つは、Apache にバンドルされているものであり、mod_actions.c という名前である。これらのモジュールはほとんど同じものである。わずかな違いは、使用法に関してである。両方のモジュールは共にテストされおり、 PHP/FI と組み合わせて動作する。

これを書いている時点(96/4/20)において次のような問題がある。現在の Apache の公式リリース(1.0.5 版)には、 POST により渡されたデータを処理する際に、 CGI リダイレクションによる関連する要求を実行不可能であるという、厳しい制限がある。私は、この原因を突き止め、自分の版の Apache で修正した。これに関する公式のパッチが PHP ホームページの File Archives にある。

Apache 1.0.x に関する 2 番目の更に大きな問題は、倍精度実数型のデータをほとんどのアーキテクチャーにおいて正しく配置しないということである。あなたが、mod_php を用いた時に奇妙なバスエラーが起こることを発見したときには、 Apache 1.1 にアップグレードするか、Apache のソースファイル中の alloc.c を編集するかのどちらかを行なう必要がある。このファイル中に、次のようなコードがある。 :

  union align
  {
    /* Types which are likely to have the longest RELEVANT alignment
     * restrictions... we don't do much with doubles.
     */

    char *cp;
    void (*f)();
    long l;
    FILE *fp;
  };

この部分に倍精度の実数を一つ加えて Apache サーバーを再構築する必要がある。正しいコードを示す:

  union align
  {
    /* Types which are likely to have the longest RELEVANT alignment
     * restrictions... we don't do much with doubles.
     */

    char *cp;
    void (*f)();
    long l;
    FILE *fp;
    double d;
  };

これらの問題は、後のバージョンの Apache では全て修正されている。

Apache のドキュメントでモジュールの加え方を確認すること。通常、Configuration という名前のファイルにモジュール名を加える。 mod_actions モジュールを使いたい場合には、次のような1行を加える。:

Module action_module mod_actions.o

mod_cgi_redirect.c モジュールを使っている場合には次のような1行を加える。:

Module cgi_redirect_module mod_cgi_redirect.o

次に httpd をコンパイルし、インストールする。 CGI リダイレクションを設定するために、 mime.types というファイルに新しい MIME タイプを作るか、 srm.conf というファイルに AddType コマンドを使って新しいMIMEタイプを加えることができる。加えるべき MIME の型は次のようなものである。:

application/x-httpd-php phtml

もし、mod_actions.c モジュールを使っているならば、 srm.conf ファイルに次のような行を加える必要がある。:

Action application/x-httpd-php /cgi-bin/php.cgi

もし、mod_cgi_redirect.c 使っているならば、 srm.conf に次のような行を加える。:

CgiRedirect application/x-httpd-php /cgi-bin/php.cgi

mod_actions.c と mod_cgi_redirect.c を同時に用いてはならない。

CGI リダイレクションモジュールのどちらかをインストールし、正しく設定した場合には、単に拡張子 .phtml を有するファイルを作ることにより、PHP/FI により解釈されるファイルを決めることができる。さらに、index.phtmlを srm.conf 中の DirectoryIndex に関する設定の行に加え、 index.phtml という名前でインデックスファイルを作ることにより、 (index.phtml を置いた) あるディレクトリの最上位のページは自動的に php で解釈されるようになる。

Netscape HTTPD

Netscape サーバー CGI リダイレクションモジュールを用いることにより、自動的に PHP/FI により処理される拡張子を有するファイルに関する要求をリダイレクトできる。このモジュールは以下の場所で手に入る。 PHP/FI Home Page の File Archives。このパッケージに含まれる README の中で、これをPHP/FI と組み合わせて使う際の設定法が明解に説明されている。

NCSA HTTPD

NCSA は、現在モジュールをサポートしていない。そこで、CGI リダイレクションを使うためにはソースコードを修正する必要がある。 NCSA 1.5 に対するパッチが PHP/FI file archives より手に入る。

セキュリティについて

CGI 版の PHP/FI は、 .htaccess ファイルがディレクトリにある場合でも、 PHP/FI はこのファイルを読まない。 .htaccess による標準的なサーバーによるアクセス制御機能を用いて保護しているファイルがある場合には、PHP/FI を通してそのページをロードすることにより、このセキュリティ機構を回避される可能性がある。このことは、Apache モジュール版の PHP/FI にはあてはまらないことに注意されたい。

CGI 版に関する2番目の問題点は、システムのcgi-bin ディレクトリに php.cgi が置かれた場合に、php.cgi を実行するユーザーのID でアクセスできる限りシステムの中の全てのファイルを見ることが可能であるということである。

この問題に対する対策はいくつかある。最も簡単な解決策は、php.h 中にある パターン制限(PATTERN_RESTRICT) 機能を使うやり方である。この機能により、PHP/FI により解釈させることが可能なある拡張子(もしくは拡張子のパターン)を定義することができる。この拡張子を持たないあるファイルを誰かがPHP/FIを通じてロードしようとした時には、アクセス拒否 のメッセージが現れる。

別の対策は、PHP/FI のアクセス制限機構により .htaccess に記述したアクセス制限の設定を模擬することである。しかし、この情報を2つの場所に置くのは冗長であるし、 2つのシステムは全く同じ機能を有しているわけではない。

この問題は、ファイルの許可属性によっても解決することができる。 PHP/FI は、任意のユーザのID で動作するように設定できる。つまり、 PHP/FI により読み込まれてもよいファイルに適当なアクセス許可属性を与え、PHP/FI により読み込まれたくないファイルは、他ユーザーに所有させて適当に変更した許可属性を与えるべきである。

PHP に関するアクセス権が共有されているサイトに関連する追加のセキュリティオプションについては、セーフモード節を参照のこと。

セーフモード

PHP のセーフモードは、全てのユーザーが CGI プログラムを実行することを許可しようとする多くの ISP が直面する共通の問題を解決しようとするものである。共有される CGI アクセスをより安全にするための一般的な機構は、Apache に付属するユーティリティ su_exec のような CGI ラッパーを使用することである。この機構は、PHP がモジュールとして実行されている場合には動作しない。これは、この場合、setuid されて実行可能な別プロセスではないからである。

この機構は、ファイルのアクセス許可の手法に基づいている。あるファイルがそのファイルをアクセスしようとしているスクリプトと同じユーザーIDにより所有されるか、または、そのファイルがそのファイルにアクセスしようとするスクリプトと同じユーザーにより所有されるディレクトリにある場合にアクセスが許可される。ここで注意を要するのは、自分の OS が、自分所有のファイルを自分以外の所有に変更することをルートでないユーザーに許可しないことを確認する必要があることである。多くの古い SysV システムはこれを許可している。 Irix が、その典型的なものである。 Irix の OS レベルでこの動作を変更することは不可能である。

セーフモードは、セキュリティ上の危険性がある各関数に適用される。以下は、関連する各関数に適用される現在のチェックの一覧表である。次のリストで、PHP UID は、PHP により解釈される現在のファイルの所有者のユーザーID を指す。そして、HTTP UID は、httpd プロセスが実行されているユーザーID (通常は、nobody) を指す。

Include, ReadFile, Fopen, File, Link, Unlink, Symlink, Rename, RmDir, ChMod, ChOwn, ChGrp: インクルードされるファイルの所有者が PHP UID であるか、またはファイルが存在するディレクトリが PHP UID により所有されている必要がある。
Exec, System, PassThru ,Popen: 子プロセスとして実行される実行ファイルは、PHP がコンパイルされる際に php.h で #define PHP_SAFE_MODE_EXEC_DIR で定義されたディレクトリにある必要がある。
Mysql_Connect: この関数は、MySQL データベースと接続する際に使用するためにオプションとしてユーザー名をとる。セーフモードの時は、このユーザー名は、現在解釈中のファイルの所有者のユーザ名または httpd ユーザー(通常は、nobody)のどちらかである必要がある。
HTTP 認証: HTTP認証コードを含むスクリプトの所有者のユーザーID番号は、認証領域に事前送付される。これにより、誰かが同じサーバー上の別の認証付きページをだましてパスワードを横取りするスクリプトを書くことを防止する。

コマンドラインからの PHP/FI 実行

PHP/FI の CGI 版を構築する場合、次のようにタイプするだけでコマンドラインからこれを使用することができる。
php.cgi ファイル名
ただし、ファイル名は、処理しようとするファイルである。また、スクリプトの最初に次のような行を作成することにより、スタンドアロン PHP/FI スクリプトを作成することも可能である。

    #!/usr/local/bin/php.cgi -q

"-q" は、HTTP ヘッダの出力を抑制する。もし、望むならばこのオプションは抜くことが可能である。

HTTP 認証

PHP/FI における HTTP 認証のフックは Apache モジュールとして PHP/FI を実行している時にのみ使用可能である。 Apache モジュール PHP/FI スクリプトにおいては、 Header() コマンドにより "認証要求" メッセージをクライアントのブラウザに送ることができる。これにより、ユーザ名/パスワード入力用ダイアログがポップアップする。ユーザーがユーザー名とパスワードを入力すると、 PHP/FI スクリプトを含む URL が $PHP_AUTH_USER,$PHP_AUTH_PW and $PHP_AUTH_TYPE にそれぞれユーザー名、パスワード、認証方法をセットした状態で再び呼ばれる。基本的な認証のみがここではサポートされている。

クライアント認証をページで行なうスクリプトの例の一部を以下に示す。

    <?
        if(!$PHP_AUTH_USER) {
            Header("WWW-authenticate: basic realm=\"My Realm\"";)
            Header("HTTP/1.0 401 Unauthorized");
            echo "Text to send if user hits Cancel button\n"
            exit;
        } else {
            echo "Hello $PHP_AUTH_USER.<P>";
           Header("WWW-authenticate: basic realm=\"My Realm\"");
            echo "You entered $PHP_AUTH_PW as your password.<P>";
        }
    >

単に $PHP_AUTH_USER と $PHP_AUTH_PW を出力するかわりに、認証のためにユーザー名とパスワードをチェックしたいこともあるだろう。クエリーをデータベースに送るか、dbm ファイル中のユーザー情報を見ることにより、認証が可能であろう。

相手がバグのあるインターネット・エクスプローラであるときには注意を要する。このブラウザはヘッダーの順序にとてもうるさい。現状では、WWW-authenticate ヘッダーを HTTP/1.0 401 ヘッダーの前に送ることにより認証を行なうことができる。

従来の外部プログラムにより認証されるページについてパスワードを暴くようなスクリプトが書かれることを防ぐために、外部認証が特定のページについて可能であるならば PHP_AUTH 変数はセットされない。

しかし、この機能により未認証のURLを制御する誰かが同じサーバー上の認証済みURLからパスワードを盗むことを防ぐことはできない。 php.h 中に定義された PHP_AUTH_VARS を未定義とすることにより、上記の変数がセットされないことを保証し、 mod_php を使用する誰かがパスワードを盗むことを確実に不可能にすることができる。

Apache リクエスト変数

PHP を Apache モジュールとして実行している場合、使いたいヘッダ変数の前に $req_ を付加することにより、リモートブラウザから送られたリクエストヘッダ変数にアクセスすることが可能である。リクエスト名が、User-Agent のように文字 - を含む場合は、 - を _ (アンダースコア)に置き換え、$req_User_Agent のように参照する必要がある。 phpinfo() 関数は、リクエストヘッダを全て表示するために使用することができる。

例

    <
        echo "$req_connection<br>";
        echo "$req_host<br>";
    >

上の簡単なスクリプトは、次のように出力する。

    Keep-Alive
    www.host.com

Apache モジュールに関して

PHP/FI を Apache モジュールとして実行することは、このパッケージを最も効率的に運用する手段である。 PHP/FI をモジュールとして実行することは、 PHP/FI の機能が Apache サーバーの機能と組み合わされ一つのプログラムとなることを意味する。 PHP/FI をモジュールとして実行することには、数多くの利点がある。:

性能

性能面からは、従来のCGIプログラムよりもかなり速い。事実、PHP/FI をモジュールとして動作させる時、CGIは必要とされない。 HTML中のスクリプトコードは Apache web サーバープロセスにより直接実行される。

セキュリティ

モジュールとして実行される際には、 Apache の設定ファイルか個人の.htaccess ファイル中において定義される通常の httpd で用いられるアクセス制限ルールは、モジュールがファイルを処理することを許可された後で適用される。もしくは、通常のhttpd ベースの認証を制御するPHP/FIスクリプトを作ることもできる。 HTTP 認証を参照のこと。

設定の簡便性

パーサが httpd プロセスの内部でいつでもアクティブであるので、 httpd プロセスの設定に用いるのと同じ設定ファイルを用いてプロセス開始時に設定を行なうことができる。モジュールにおいては、.htaccess ファイル中に PHP 設定ディレクティブを置くことにより、ディレクトリ毎に設定を行なうこともできる。

カスタムサーバー型アプリケーションの基礎

Apache の内部から自分の関数にアクセスすることに関心がある C プログラマにとって、PHP/FI フレームワークは、Apache と PHP 自体への非常に簡単なインターフェースを提供します。 PHPに関数を加えて処理されるページから呼び出すのは、スクラッチから Apache モジュール全体を書くより非常に簡単である。このドキュメントの終りの方にある自分の関数をPHP/FI に加えるには節を参照のこと。

Apache モジュール設定ディレクティブ

次の宣言文は、srm.conf ファイルか、 access.conf 中の <Directory>...</Directory> タグの内部か、access.conf 中の <Location /path>...</Location> タグの内部か個々の .htaccess ファイル中に置くことができる。:

.htaccess ファイルにおいて命令が動作するために、Options override を AllowOverride Apache 命令によりセットする必要がある。ただし、 *.conf ファイルにおいてのみ使用可能な phpEngine 命令は例外である。

phpShowInfo on|off: PHP 情報フッターをオン／オフにする。デフォルトはオン。
phpLogging on|off: ログ機能をオン／オフにする。デフォルトはオン。
phpDebug on|off: 自動 ?info デバッグ画面を on または off にする。デフォルトはオフ。
phpUploadTmpDir directory: フォームによりアップロードされるファイルを置くディレクトリを指定する。
phpDbmLogDir directory: dbm に基づくログファイルが書き込まれるディレクトリを指定する。
phpSQLLogDB database: ログ記録用の SQL データベースの名前をセットする。デフォルトは、"phpfi"。
phpSQLLogHost hostname: ログ記録用の SQL データベースがあるホスト名をセットする。デフォルトは、"localhost"。
phpAccessDir directory: PHP アクセス制御用の内部ファイルが保存されるディレクトリを指定する。
phpMaxDataSpace KiloBytes: PHPモジュールにおける内部記憶領域の最大値。この値を小さな数にすることにより、mod_php がシステムに与える負荷を最小化することができるが、複雑なスクリプトを書くことも制限を受ける可能性がある。デフォルトは、8K。
phpIncludePath colon-separated path: include() を実行する際に php がファイルを探すコロンで分割されたディレクトリのリスト。デフォルトは、カレントディレクトリのみを探す。
phpAutoPrependFile ファイル名: PHPの Include()関数を用いて (よって、phpIncludePath がこのファイル名に適用される) 実際の PHP/FI ファイルである"主ファイル" が実行される前に実行されるファイルの名前をここで指定することができる。自動的に付加されるファイル(auto-prepended file)から HTML を書く場合には、 Header()関数を主ファイル中で使用することが困難になることに注意されたい。
phpAutoAppendFile ファイル名: PHP/FIファイル本体が実行された後に(PHPのInclude()関数により) 実行されるファイルの名前。 phpAutoPrependFileと同様。
phpAdaDefDB データベース: デフォルトで使用するの Adabas データベース。デフォルト値はなし。
phpAdaUser ユーザ名: デフォルトの Adabas データベースユーザ名。デフォルト値はなし。
phpAdaPW パスワード: デフォルトの Adabas データベースのパスワード。デフォルト値はなし。
phpEngine on|off: PHP の文法解釈エンジンを on または off にする。デフォルトはonである。この命令は、AllowOverride Options により .htaccess ファイルにおいて、命令リストにより命令を使用できるようにする一方で、同時に mod_php へのアクセスを制限するようなサイトにおいてのみ有益である。仮想ホスト毎に PHP のインストール管理を行う一般的な方法は、仮想ホスト毎に AddType 命令により PHP の mime 型を使用可能にし、 PHP を使用しない仮想ホストの組では、"e;phpEngine off" を用いることである。 PHP を使用しない顧客が、PHP mime 型を自分の .htaccess に置くことにより回避しようとしても、phpEngine off の設定によりPHP パーサに機能上の拘束が課される。
phpLastModified on|off: PHPページは動的に作成されるため、アクセスする度に各ページは処理され、ブラウザに送られる。しかし、単純な挿入のために PHP を使用する場合には、ソースが変わらない限り実行されるページは不変である。このような場合、ページの再作成や再ロードを回避したいと考えるであろう。 phpLastModified をオンにすると Apache は、Last-Modified タグをブラウザに送る。この場合、そのページは変更があった場合にのみ再ロードされる。ページ記録機能を使用している場合、多重アクセスは記録されないことに注意されたい。

これらの宣言文は全てオプションである。宣言がどこでもなされない場合には、コンパイル時のデフォルト値が用いられる。

FastCGI サポート

PHP/FI は FastCGI サポートを有効にしてコンパイルすることができる。その際には、PHP/FI をコンパイルする前に自分のプラットフォーム用の FCGI 開発キットをダウンロードし、コンパイルする必要がある。また、CGI リダイレクションを動作させる必要がある。それから、自分のプラットフォーム用 FastCGI のドキュメント中の指示に従うこと。 mod_fastcgi モジュールを Apache サーバーと共に使用する場合には、次のような順序で作業を行なう。:

Apache 設定ファイルを編集し、mod_fastcgi モジュールを付け加える。それから、Apache を再コンパイルする。
srm.conf ファイルを編集し、次のような行を加える。:
AddType application/x-httpd-fcgi .fcgi AppClass /usr/local/etc/httpd/fcgi-bin/php.fcgi -processes 4 AddType application/x-httpd-fphp .fhtml Action application/x-httpd-fphp /fcgi-bin/php.fcgi
php.cgi 実行ファイルを/usr/local/etc/httpd/fcgi-bin/php.fcgiにコピーする。

これにより、 .fhtml 拡張子を有する全てのファイルは、既に実行されている FastCGI php.fcgi プロセスへと渡される。 php.fcgi 実行ファイルは、まだ通常のCGI実行ファイルとしても動作するので、 php.cgi から php.fcgi へのシンボリックリンクを作成することも可能である。

Apache を使用しない場合には、上記手順に似ているが異なった手段となる。 NCSA や Netscape サーバにおいて使用可能な CGI リダイレクション機構用ファイルは、 PHP/FI ファイルアーカイブにある。

アクセス制御

PHP/FI 組み込みのアクセス制御のサポートは、恐らく将来のバージョンにおいて打ち切られるだろう。代わりに web サーバーに付属するセキュリティ機構の使用を真剣に考慮するべきである。

このパッケージをコンパイルする時にアクセス制御機能を含めた場合には、 ?configという記述をURLに加えることによりアクセス制御ファイルを編集することができる。以下に例を示す。

http://your.machine.domain/cgi-bin/php.cgi/path/file.html?config

あなたの設定用パスワードの初期値はあなたのユーザーIDにセットされる。もし自分のユーザーIDがパスワードとして使用できないときは、おそらく PHP があなたのユーザーIDが存在するマシンの /etc/passwd ファイルを読むことができないと考えられる。このような場合には、初期パスワードは、"php"にセットされる。このパスワードは変更するのが賢明である。単一の PHP/FI バイナリを用いて複数のユーザーが自分自身の個人設定用ファイルを保持することができる。

アクセス制御に関して最初はかなり混乱するかもしれない。 ?config の画面は複数の節(画面)に分割されている。最初の節はパスワードを変更するためのものである。このパスワードはこれを知る者だけがアクセス制御の設定を変更可能であるようにするためのものである。システム全体にインストールを行なった場合には、各ユーザーはパスワードで保護された自分用の設定画面を持つことができる。

?config 画面の第2節は、複数の表から構成される。各表はあるルールセットを規定する。最初のルールセットはいつもデフォルトのルールセットとなる。このデフォルトのルールセットはもしあるページが固有のルールセットを規定していない場合に用いられる。デフォルトのルールセットの後に複数の特定のルールセットを記した表を続けることができる。

特定のファイル用のルールセットを加えるためには、ブラウザ上でそのファイルのURLを入力し、 ?config をURLの終わりに付け加える。もし、まだあるルールセットが存在しない場合には、表示された ?config 画面においてそのページにそのルールセットが付け加えられたことを確認できる。新しいルールセットが付け加えられた時には、デフォルトのルールセットと同様にセットされる。次の図は、2つの簡単なルールセットを示している。最初は、全てのドメインからのアクセスをログに記録することだけを指示するデフォルトのルールセットであり、 2番目は /~rasmus/test.html というファイルのみについて ".edu" ドメインから来たユーザーのアクセスを許可しないことを指示するものである。

[Image of ?config screen]

ルールセットを編集する際には、所望の設定がルールセットの中に現れるように(ドロップダウンボックス等の)フィールドを修正し、 "Submit Changes" ボタンを押す。もし、もっと多くのルールが必要ならば、 "Add Rule" を押し、付け加えられたルールを編集する。

ルールを削除するためには、そのルールの右にあるチェックボックスを選択し、"Submit Changes" を押す。画面が再描画され、そのルールは消える。

正規表現をパターンフィールドに入力することが必要となることもある。詳細はこのドキュメント中の正規表現の節を参照のこと。

アクセス情報の記録

アクセス情報の記録は、コンパイル時にインストール用スクリプトの質問に対して Yes を答えることにより使用可能となる別のオペレーション機能である。アクセス記録データを dbm ファイル、mSQL データベース、 mysql データベースのどれかに保存することが可能である。後ろの 2つはより強力であるが、セットアップがやや難しい。

dbm ファイルをログ記録の保存に使う際には、ログファイルを書き込むことのできるディレクトリを指定する必要がある。 PHP はこのディレクトリがない場合には作成を試みる。しかし、適当な許可属性を確実に設定するために、始めて PHP を動作させる前にこのディレクトリを自分で作成することもできる。 PHP cgi プログラムを実行するユーザーIDがこのディレクトリに対して書き込み可能であるように許可属性を設定する必要がある。

アクセス記録データを保存するために mSQL データベース、または mysql データベースを使う時は、自分のシステムにmSQLまたは mysql がインストールされ、実行されているかを最初に確認する必要がある。次にデータベースを作成する必要がある。デフォルトの名前は "phpfi" であるが、この名前は src/php.h において変更可能である。 mSQL でデータベースを作成するには、次のように入力する。:

    msqladmin create phpfi

mysql については、次のように入力する。:

    mysqladmin create phpfi

次に mSQL の場合は、msql.acl ファイルを編集し、データベースの許可属性が正しいことを確認する。次のような記述で充分である。:

    database=phpfi
    read=*
    write=nobody,<your user id>
    access=local

mysql の場合は、httpd ユーザー(通常は "nobody") がデータベースにアクセスできるかどうかを確認する必要がある。 mSQL とは異なり、mysql はアクセス制御データをあるデータベースの中に保持する。デフォルトの許可属性を仮定すると、次のようなコマンドを実行することができるに違いない。:

    echo "INSERT INTO user VALUES ('localhost','nobody','','Y','Y','Y','Y','Y','Y','Y','Y','Y');" | mysql mysql

忘れずに次のように新しい設定をロードする。:

    mysqladmin reload

ログデータを保存させたいユーザーID毎に、 2つのテーブルを作成する必要がある。 scripts ディレクトリにあるシェルスクリプト msqllog はこれを行なう。単に以下を入力する。:

    msqllog <user id>

mysql の場合は、以下を入力する。:

    mysqllog <user id>

これによりスクリプトは適当なテーブルを作成する。各システム上においてログが保存される場所を反映するためにスクリプトを編集する必要があるかもしれない。

あなたはこのスクリプトを覗いてみたいと思うかもしれない。ここでは、記録用テーブルのフィールドの大きさを定義している。例えば、ファイルパスが64文字を越えることがわかっているならば、 msqllog または、mysqllog ファイル中の logN と lastN の両方のテーブルにおけるファイル名の大きさを大きくする必要がある。

アクセス記録時にはページ毎の "ヒット " 数についての情報が保存される。このヒット数情報はこれらのログファイルを評価することにより集計することができる。ログファイルを集計するスクリプトの例がこのパッケージに含まれている。 examples ディレクトリ中の log.html ファイルがそれである。これは、 dbm によるログファイルの解析を行なう。 mSQL によるログファイルの解析を行なうのは、mlog.html である。そして、 mysql によるログファイルの解析を行なうのは、mylog.html である。これを実行するには、このファイルと、他のmlog.* ファイルを自分の web サーバーからアクセス可能なディレクトリにコピーし、次のように入力する。:

    http://your.machine.domain/cgi-bin/php.cgi/path/mlog.html

もしくは、Apache モジュール版を使用している場合には、このスクリプトに拡張子 ".phtml" を付け、次のようにコールする。:

    http://your.machine.domain/path/mlog.phtml

PHP をアクセス記録機能付きでコンパイルした場合、デフォルトでは、各ページはいくつかのアクセス情報を含むフッター付きで表示される。このフッターを表示させずにヒット数の記録を行ないたいと思う時、 Apache を実行している場合には、Apache の httpd.conf または .htaccess ファイルに"phpShowInfo off" を記述しこのフッタをオフにすることができる。 Apache を使用していない場合には、?config に関するこれらのログフッタをによりオフにできるであろう。 ?config を行なう際にそのページについてのルールを作るか、このページの中に次のようなタグを加えることによりログフッターを非表示とすることができる。

<?setshowinfo(0)>

相対URLと絶対URL もしくは、なぜイメージファイルが表示されないのか?

全てのCGIラッパーに共通な問題の一つは、HTTPDプログラムが現在のディレクトリをロードしているものが保存されているディレクトリに変えてしまうことである。 CGIプログラムの場合は、現在のディレクトリはCGIプログラムが置かれたディレクトリにセットされる。このことは相対URL指定を受けた場合を除き通常問題とならない。

相対URLは、現在のディレクトリが現在処理中のHTMLファイルが置かれているディレクトリと同じであることを前提としたURLである。つまり、例えば以下のようなURLがあったとする。:

    http://my.machine/~rasmus/file.html

実際のHTMLファイルは以下の場所にある。:

    ~rasmus/public_html/file.html

仮にファイル file.html中に次のようなタグがあったとする。:

    <IMG SRC="pic.gif">

正常に読み込まれた場合、この gif ファイルは ~rasmus/public_html/pic.gif にあると想定される。しかし、次のようなURLのファイルがCGIラッパー経由で読み込まれたとすると、

    http://my.machine/cgi-bin/php.cgi/~rasmus/file.html

HTTPD は現在のディレクトリを /cgi-bin に (あるいは、ScriptAlias で指定した場所に)セットする。:

続いてこのページが読み込まれる際に、pic.gif ファイルは /cgi-bin/pic.gif にあるものと想定されるが、これは通常望んだ結果ではない。

この問題の手っ取り早い解決手段は絶対URLを使うことである。上記の例においてimageタグが次のようなものであった場合には、何の問題も生じなかったであろう。:

    <IMG SRC="/~rasmus/pic.gif">

絶対URLを使用することはポータビリティを悪化させるため、いつも望ましいわけではない。この問題に関して次のような明白な疑問を生じるかもしれない。「なぜ、PHP は正しい場所にカレントディレクトリを変えないのか?」実際にはPHPはカレントディレクトリを表示中の HTML ファイルがある場所に変えている、というのが答えである。 PHP スクリプトタグ中で用いられるあらゆるファイルパスは相対表現とすることができる。問題は、PHP による制御の範囲外にある <img > や <a href > のようなタグは、 PHP により処理されないということである。これらが解釈される時、PHP はもはやアクティブではなく、カレント作業ディレクトリはHTTP デーモンにより指定されたディレクトリに戻されている。

解決手段 は妥協策である。PHP は PATH_DIRという変数を提供する。これは、現在処理中の HTML ファイルのディレクトリ部を常に保持している。この PATH_DIR 変数を <img > や <a href > タグに用いた場合、サーバーが解釈する際には絶対URLのように見えるにもかかわらず、相対URL を用いた場合と同様の効果が得られる。上記の例において必要な変更点は img タグを次のように変えることだけである。:

    <IMG SRC="<?echo $PATH_DIR>/pic.gif">

上記タグの使用により、このタグを含むファイルを移動することが可能になる。このタグは常に同じディレクトリにあるpic.gif ファイルを HTML ソースファイルとして参照する。

この問題に対する伝統的な別の解決策は、 <BASE HREF=...> タグをHTMLファイル中に用いることである。

PHP における GET と POST メソッドの処理

PHP は、HTML フォームから送られる GET と POST メソッドの両方を検出する。理解しておかなければならない重要な点は、両方が共に与えられた場合にはPOST メソッドによるデータが常に最初に処理される、ということである。ある PHP 変数が POST メソッドによるデータで定義されるか、 UNIX環境におけるHTTPデーモンによって定義される場合には、 GETメソッドによるデータはこれを上書きすることはできない。これは、誰かが自分のURLに?REMOTE_HOST=some.bogus.hostと加えることにより、こうした別のデータを記録するように PHP のログ機構を欺くことを防ぐためである。しかし、POST メソッドによるデータはこれらの変数を上書きすることが可能である。

フォームにより作成される GET データの全ての構成要素(URL における '?' に続くデータ) はword=something という形式であり、 something という値を有する変数 $word を定義する。データがこの形式でない時でも、組み込み配列 $argv によりアクセスすることができる。例えば、次のようなURL:

    /cgi-bin/php.cgi/file.html?abc+def+EMAIL_ADDR=rasmus@lerdorf.on.ca&var=value

においてPHPシンボルテーブルにおける関連する構成要素は次のようになる。:

    $argc       = 4
    $argv[0]    = abc
    $argv[1]    = def
    $argv[2]    = EMAIL_ADDR=rasmus@lerdorf.on.ca&var=value
    $EMAIL_ADDR = rasmus@lerdorf.on.ca
    $var        = value

データ中の EMAIL_ADDR の部分が、解釈されていない状態で $argv[2] の中と、 rasmus@lerdorf.on.ca という値を有するように作成された変数 $EMAIL_ADDR の名前の双方に現れている。

変数 $EMAIL_ADDR は、 PHP のログ機能を使っている場合には便利な変数であるので、上記の例で用いた。ユーザーの e-mail アドレスが既知であるようなページにおけるリンクに次のように付け加えることにより、次のページにそれを受け渡すことができる。:

    ?EMAIL_ADDR=

PHP ログ機能は自動的にこの変数を見つけてユーザーの e-mail アドレスとして値を記録する。 PHP1 のユーザーにとっては、上記の記述は PHP1 において URL に ? を加えることにより行なわれてきたことと同じ機能を与えるものである。現仕様は若干複雑になっているようであるが、複雑なページの構築が可能なように完全に一般的になっている。

上記の例において、 GET メソッドによるデータにおいて "&" 文字で区切ることにより、複数の変数を定義する手法も見ることができる。この "&" で区切られた変数のリストにおける定義を有効とするためには、GETメソッドデータの最後の(そして、唯一の) 構成要素でなければならない。

SELECT MULTIPLE と PHP

HTML における SELECT MULTIPLE タグはリストから複数の項目を選択可能にする。これらの項目はフォームのアクションハンドラに渡される。問題は、全て同じウイジェット名でそれらが渡されることである。すなわち、

    <SELECT NAME="var" MULTIPLE>

選択されたオプションの各々は、アクションハンドラに次のような形式で送られる。:

var=option1
var=option2
var=option3

各々のオプションは、以前の $var 変数の内容を上書きするであろう。解決策は、PHP/FI の添字無配列機能を用いることである。次のような記述を行なう必要がある。:

    <SELECT NAME="var[]" MULTIPLE>

これは、PHP/FI に対して var を配列として取り扱うように宣言するものである。オプションの各々の値の割付けはこの配列 var[] へ要素を付加すること　により行なわれる。

最初の項目は、$var[0]、次は $var[1] 等となる。選択されたオプションの数を定義するために関数 count() を用いることができる。また、必要ならばオプション配列をソートするために関数sort() を用いることができる。

イメージによる投稿 と PHP

フォームを投稿する時、通常の投稿(submit)ボタンの代わりに次のようなタグによりイメージを用いることが可能である。:

    <input type=image src=image.gif name=sub>

ユーザーがイメージのどこかをクリックした時、 sub_xとsub_yという2つの変数が付加されて付随するフォームがサーバーに送られる。この変数はユーザーがイメージ中でクリックした座標を保持している。経験ある者は、ブラウザから送られる実際の変数名はアンダースコアの代わりにピリオドとなる (sub.x,sub.y)というかもしれない。しかし、PHP はこのピリオドを自動的にアンダースコアに変換する。

相対URLと絶対URL もしくは、なぜイメージファイルが表示されないのか?

全てのCGIラッパーに共通な問題の一つは、HTTPDプログラムがカレントディレクトリをロードしているものが保存されているディレクトリに変えてしまうことである。 CGIプログラムの場合は、カレントディレクトリはCGIプログラムが置かれたディレクトリにセットされる。このことは相対URL指定を受けた場合を除き通常問題とならない。

相対URLは、カレントディレクトリが現在処理中のHTMLファイルが置かれているディレクトリと同じであることを前提としたURLである。つまり、例えば以下のようなURLがあったとする。:

    http://my.machine/~rasmus/file.html

実際のHTMLファイルは以下の場所にある。:

    ~rasmus/public_html/file.html

仮にファイル file.html中に次のようなタグがあったとする。:

    <IMG SRC="pic.gif">

    http://my.machine/cgi-bin/php.cgi/~rasmus/file.html

HTTPD はカレントディレクトリを /cgi-bin に (あるいは、ScriptAlias で指定した場所に)セットする。:

続いてこのページが読み込まれる際に、pic.gif ファイルは /cgi-bin/pic.gif にあるものと想定されるが、これは通常望んだ結果ではない。

    <IMG SRC="/~rasmus/pic.gif">

絶対URLの使用は、ポータビリティを悪化させるため、いつも望ましいわけではない。この問題に関して次のような明白な疑問を生じるかもしれない。「なぜ、PHP は正しい場所にカレントディレクトリを変えないのか?」実際にはPHPはカレントディレクトリを表示中の HTML ファイルがある場所に変えている、というのが答えである。 PHP スクリプトタグ中で用いられるあらゆるファイルパスは相対表現とすることができる。問題は、PHP による制御の範囲外にある <img > や <a href > のようなタグは、 PHP により処理されないということである。これらが解釈される時、PHP はもはやアクティブではなく、カレント作業ディレクトリはHTTP デーモンにより指定されたディレクトリに戻されている。

    <IMG SRC="<?echo $PATH_DIR>/pic.gif">

この問題に対する伝統的な別の解決策は、 <BASE HREF=...> タグをHTMLファイル中に用いることである。

GD (GIF生成のためのグラフィックライブラリ)のPHPでのサポート

PHPは、 Thomas Boutell氏が作成したGDバージョン1.2をサポートする。ただし、 PHPのパッケージにはGDのコードは含まれない。従って、PHPで、GDを使いたければ、最初に、 http://www.boutell.com/gd/gd1.2.tar.Zを入手し、インストールした後、再度、PHPをインストールする。

PHPはGDの全ての機能をサポートしない。PHPで利用できるGDの関数は、（後の）アルファベット順の関数リストに示してある。ここで使える全てのGD関数は、 Image という単語で始まる。 GDについて、さらに詳細が知りたければ下記にアクセスの事。 http://www.boutell.com/gd/

PHP/FI と仮想ホスト

PHPは数種のHTTPサーバがサポートする仮想ホスト環境でも不都合なく動作する。ひとつの問題は、仮想ホスト環境上ではHTTPDサーバが設定する環境変数 SCRIPT_NAME と矛盾を引き起こすかもしれない事である。 SCRIPT_NAME には、通常 HTTP サーバにおけるトップレベルルートディレクトリ ROOT_DIR から相対的に CGIプログラムのあるパスが設定される。しかしながら、仮想ホストを利用する場合、いくつかの HTTP サーバはその仮想ホストの正しいトップレベルディレクトリからの相対パスとして正確な SCRIPT_NAME 変数を設定することが出来ない。もし、?configで出力されるメッセージに、Invalid URL というエラーがあれば、PHPのセットアップに問題があったことになる。その場合は、php.hというファイル中を編集し、#define VIRTUAL_PATH で定義されるパスを仮想ホストのトップレベルディレクトリから php.cgi への相対パスにセットする必要がある。

ファイルアップロード

PHP/FIは、ブラウザーからのファイルアップロードを自動的に検知する。この機能は、フォームベースのファイルアップロード機能で、 Xerox の E. Nebel と L. Masinter により提案された。詳細は、RFC 1867 による。

ファイルをアップロードする画面は、下記のような特別なフォームを記述する事で実現出来る。

<FORM ENCTYPE="multipart/form-data" ACTION="_URL_" METHOD=POST>
<INPUT TYPE="hidden" name="MAX_FILE_SIZE" value="1000">
Send this file: <INPUT NAME="userfile" TYPE="file">
<INPUT TYPE="submit" VALUE="Send File">
</FORM>

_URL_ は、PHPで書かれたHTMLファイルの場所を指す必要がある。 hidden フィールド MAX_FILE_SIZE は、file 入力フィールドの前になければならない。 MAX_FILE_SIZEの値は、許容されるファイル容量の最大値をバイト単位で示したものである。受信側のファイルにおいては、支障なくファイルのアップロードを行うために次の環境変数が定義されている。:

$userfile

サーバマシン上に格納されたアップロードファイルの一時的なファイル名。

$userfile_name

送り側のオリジナルのファイル名。

$userfile_size

アップロードされたファイルのバイト容量。

$userfile_type

ブラウザが生成するファイルの MIME TYPE。例えば、"image/gif"。

上記変数のうし、$userfile のファイル名の部分は、アップロードフォームの NAME フィールドに一致する。

アップロードされたファイルはサーバのデフォールトの一時的なディレクトリーに格納される。この場所は、PHP/FIが稼働する環境変数 TMPDIR の設定により変更出来る。PHP/FI スクリプトの中で PutEnv()関数を使用して設定変更してもうまくいかない。もしくは、php.h を編集し、 UPLOAD_TMPDIR 変数の定義を埋め込むことも可能である。

アップロードファイルを受け取る PHP/FI スクリプトは、アップロード時に行ったことを把握するために必要な論理的手段を用意すべきである。例えば、小さすぎたり、大きすぎたりした任意のファイルを破棄するために $file_size という変数を使用できる。また、$file_type という変数を使って、正しくない型のファイルを破棄することも可能である。どのような論理的手段を用いた場合でも、アップロードされたファイルは一時的なディレクトリから消すか他の場所へ移動すべきである。

CERN HTTPD は、クライアントから送られたファイルの content-type mime ヘッダーにおいて空白文字で始まる行を全て削除するということに注意されたい。この様な仕様である限り、CERN HTTPD においてファイルアップロード機能はサポートされないであろう。

クッキー(Cookie)のサポート

PHP/FI は Netscape's Spec に定義される HTTP クッキーを透過的にサポートする。クッキーは、リモートブラウザにデータを保持する仕組みである。これにより、再訪したユーザーの追跡や特定を行なう。 SetCookie() 関数を用いて、クッキーをセットすることができる。クッキーはHTTPヘッダーの一部であるので、 SetCookie() 関数は他の出力がブラウザに送られる前に呼ばれなければならない。この制約は Header() 関数と同様のものである。

クライアントからサーバーに送られるクッキーは、 GET や POST メソッドによるデータと全く同様に自動的にPHP/FI 変数へ変換される。

一つのクッキーに複数の変数を割り付けたい場合には、クッキーの名前に [] を加えるだけで良い。例えば、:

    SetCookie("MyCookie[]","Rasmus Lerdorf", time()+3600);

パスやドメイン名が異なっていない場合には、クッキーはブラウザにおける同じ名前の以前のクッキーを置き換える。ショッピングカートのアプリケーションにおいては、カウンタとカートに入れられたものを保持したいと思うだろう。すなわち、

    
    $Count++;
    SetCookie("Count",$Count, time()+3600);
    SetCookie("Cart[$Count]",$item, time()+3600);

mSQL サポート

mini-SQL を意味する mSQL は、David Hughes により作られた小型でかつ簡易な SQL データベースエンジンである。この mSQL は、 ftp://ftp.bond.edu.au/pub/Minerva/msql より入手可能である。

PHP/FI は多くの mSQL サポート用関数を有している。

msql()
msql_Close()
msql_Connect()
msql_CreateDB()
msql_dbName()
msql_DropDB()
msql_FieldFlags()
msql_FieldLen()
msql_FieldName()
msql_FieldType()
msql_FreeResult()
msql_ListDBs()
msql_Listfields()
msql_ListTables()
msql_NumFields()
msql_NumRows()
msql_RegCase()
msql_Result()
msql_TableName()

これらの関数に加えて、PHP/FI においては GET もしくは POST データ中の前方引用付( ' )を自動的にエスケープするようにコンパイルすることができる。 MAGIC_QUOTES 変数を php.h ファイル中で定義した場合には、これらの引用付は自動的にエスケープされるので、データを直接 msql クエリーに渡すことが容易になる。

Postgres95/PostgreSQL サポート

Postgres95/PostgreSQL は、SQL 言語の主要部分を実装した強力な public domain のデータベースであり、mSQL において使用できない多くのデータ型とコマンドをサポートしている。 Postgres についての詳細な情報とソフトウエア自体は次のURLで見つけることができる。: http://www.postgreSQL.org/

次の PHP 関数が Postgres95/PostgreSQL 用に使用可能である。:

pg_Connect()
pg_Close()
pg_Host()
pg_Port()
pg_Options()
pg_tty()
pg_DBname()
pg_Exec()
pg_Result()
pg_FreeResult()
pg_GetLastOid()
pg_NumRows()
pg_NumFields()
pg_FieldNum()
pg_FieldName()
pg_FieldType()
pg_FieldSize()
pg_FieldPrtLen()
pg_errorMessage()

注意: バイナリカーソルはサポートしていない。

これらの関数に加えて、PHP/FI においては GET もしくは POST データ中の前方引用付( ' ) または、引用符( " )を自動的にエスケープするようにコンパイルすることができる。 MAGIC_QUOTES 変数を php.h ファイル中で定義した場合には、これらの引用付は自動的にエスケープされるので、データを直接 Postgres クエリーに渡すことが容易になる。

以下に localhost 上の 'mydb' というPostgres データベースと接続しテーブル中の人の名前と年齢を引き出すサンプルスクリプトを示す。:

<?
   $conn = pg_Connect("localhost", "5432", "", "", "mydb");
   if (!$conn) {
      echo "An error occured.\n";
      exit;
   }

   $result = pg_Exec($conn, "select * from table1");
   if (!$result) {
      echo "An error occured.\n";
      exit;
   }

   $num = pg_NumRows($result);
   $i = 0;

   while ($i < $num) {
      echo "name: ";
      echo pg_Result($result, $i, "name");
      echo "  age: ";
      echo pg_Result($result, $i, "age");
      echo "<BR>";
      $i++;
   }

   pg_FreeResult($result);
   pg_Close($conn);
>

mysql サポート

mysql は、mSQL パッケージのクローンである。 http://www.tcx.se/からコピーを手にいれることができる。

PHP/FI においては、多くの mysql 関数がサポートされる。:

mysql()
mysql_Close()
mysql_Connect()
mysql_CreateDB()
mysql_dbName()
mysql_DropDB()
mysql_FieldFlags()
mysql_FieldLen()
mysql_FieldName()
mysql_FieldType()
mysql_FreeResult()
mysql_ListDBs()
mysql_Listfields()
mysql_ListTables()
mysql_NumFields()
mysql_NumRows()
mysql_Result()
mysql_TableName()

これらの関数に加えて、GET もしくは POST データに含まれる前方引用符を自動的にエスケープするようにコンパイルすることが可能である。 MAGIC_QUOTES 変数が、php.h ファイルにおいて定義される場合には、これらの前方引用符は自動的にエスケープされるので、 mysql クエリーに直接データを渡すことが容易になる。

Solid サポート

Solid サーバーは、多機能な SQL サーバーである。ANSI SQL2、ODBC、 SAG CLI、X/Open SQL 標準をサポートする。 Solid サーバーに関するより詳しい情報は、 www.solidtech.com で手にはいる。 PHP 用 Solid インターフェースは、 DigiFace Internet Services により開発されたものである。

次のPHP 関数が Solid サーバーについて使用可能である。:

Solid_Connect()
Solid_Close()
Solid_Exec()
Solid_Result()
Solid_FreeResult()
Solid_NumRows()
Solid_NumFields()
Solid_FieldNum()
Solid_FieldName()

これらの関数に加えて、GET もしくは POST データに含まれる前方引用符を自動的にエスケープするようにコンパイルすることが可能である。 MAGIC_QUOTES 変数が、php.h ファイルにおいて定義される場合には、これらの前方引用符は自動的にエスケープされるので、 Solid クエリーに直接データを渡すことが容易になる。

以下に、Postgres の節において用いたのと同じ例をSolid サーバー用にしたものを示す。

<?
   $conn = Solid_Connect("", "username", "password");
   if (!$conn) {
      echo "An error occured.\n";
      exit;
   }

   $result = Solid_Exec($conn, "select * from table1");
   if (!$result) {
      echo "An error occured.\n";
      exit;
   }

   while (Solid_FetchRow($result)) {
      echo "name: ";
      echo Solid_Result($result, "name");
      echo "  age: ";
      echo Solid_Result($result, "age");
      echo "<BR>";
   }

   Solid_FreeResult($result);
   Solid_Close($conn);
>

Sybase サポート

サポート関数は、Sybase DB のライブラリ API コールを使用する。したがって、sybase サポートを有効にして PHP/FI をコンパイルするためには、 sybase API ライブラリとヘッダーファイルがシステムにインストールされている必要がある。

次の PHP/FI 関数がSybase 用に使用可能である。

SybSQL_CheckConnect()
SybSQL_Connect()
SybSQL_DBuse()
SybSQL_Exit()
SybSQL_Fieldname()
SybSQL_GetField()
SybSQL_IsRow()
SybSQL_NextRow()
SybSQL_NumFields()
SybSQL_NumRows()
SybSQL_Query()
SybSQL_Result()
SybSQL_Result_All()
SybSQL_Seek()

完全な例については、以降の例 sybSQL_Result() 関数を参照のこと。

Oracle サポート

Oracle 用 PHP/FI インターフェースは、Oracle Call Interface (OCI) を使用する。 PHP/FI をOracle サポート付きでコンパイルするためには、システム上に OCI ライブラリが必要である。

次の PHP/FI 関数が Oracle 用に利用可能である。

Ora_Bind()
Ora_Close()
Ora_Commit()
Ora_CommitOff()
Ora_CommitOn()
Ora_Exec()
Ora_Fetch()
Ora_GetColumn()
Ora_Logoff()
Ora_Logon()
Ora_Open()
Ora_Parse()
Ora_Rollback()

PHP/FI Oracle アプリケーションの例を次に示す。

<?
PutEnv("ORACLE_HOME=path_to_your_oracle_home"
PutEnv("ORACLE_SID=database"
  
/* Establish a connection between PHP and Oracle. */
$conn = Ora_Logon("username" "password"
  
if ($conn < 0) {
    echo("Could not connect to Oracle.\n"
    exit;
}

/* Open a cursor in Oracle. */
$cursor = Ora_Open($conn);

if ($cursor < 0) {
    echo("Could not open a cursor.\n"
    Ora_Logoff($conn);
    exit;
}

/* Turn off autocommit. */
Ora_CommitOff($conn);

/* This is the SQL query. */
$query = "SELECT * FROM some_table"

if (Ora_Parse($cursor, $query) < 0) {
    echo("Parse failed!\n"
    Ora_Logoff($conn);
    exit;
}

/* Execute the SQL statement associated with $cursor and
   prepare storage for select-list items. */
$ncols = Ora_Exec($cursor);
 
echo "lt;P>\n"
echo "lt;TABLE BORDER=1 CELLSPACING=0>\n"

/*  Retrieve all rows from the database one after another. */
while (Ora_Fetch($cursor) == 1) {
    $i = 0;
    echo "lt;TR>\n"
    while ($i < $ncols) {
     /* Get data for a single column of currently fetched row. */
     $col = Ora_GetColumn($cursor, $i);
        echo("lt;TD>$col</TD>\n"
     $i++;
    }
    echo("lt;/TR>\n"
}

echo "</TABLE>\n";

/* Close the Oracle connection. */
Ora_Close($cursor);
 
/* Disconnect the logon data area. */
Ora_Logoff($conn);
>

Informix Illustra サポート

Illustra はInfomix により買収されたデータベース製品である。幾つかの機能は、本インターフェースで(まだ)サポートされていない。 Illustra の優れた主な特徴は、オブジェクト指向により拡張可能なオブジェクトリレーショナルデータベースであることである。例えば、データベース内に基本型としてイメージ型を作成することが可能である。より、詳しいｊ情報は、 illustra ホームページより得ることができる。

次の PHP 関数が Illustra 用に利用可能である。:

mi_Connect()
mi_Close()
mi_DBname()
mi_Exec()
mi_Result()
mi_NumRows()
mi_NumFields()
mi_FieldNum()
mi_FieldName()

注意: 型の演算は、まだサポートされていない。

以下にローカルホストの 'mydb' という名前の illustra データベースに接続し、テーブルから人の名前と年齢を得るスクリプトを示す。:

<?
   $conn = mi_Connect("mydb", "username", "password");
   if ($conn<0) {
      echo "An error occured on connection.\n";
      exit;
   }

   $result = mi_Exec($conn, "select * from table1");
   if ($result < 0) {
      echo "An error occured.\n";
      exit;
   }

   $num = mi_NumRows($result);
   $i = 0;

   while ($i < $num) {
      echo "name: ";
      echo mi_Result($result, $i, "name");
      echo "  age: ";
      echo mi_Result($result, $i, "age");
      echo "<BR>";
      $i++;
   }

   mi_Close($conn);
>

Adabas サポート

Adabas D は、多くのプラットフォームで利用可能な先進的 RDBMS である。パーソナル版という名前の特別なバージョンは、 Linux用と Win32用のものが無償で手に入る。この版は、同時5ユーザーと100MBのデータに制限されている。 Adabas D に関する更に詳しい情報は、 http://www.softwareag.comを参照されたい。

次の PHP 関数が、Adabas データベースにアクセスするために利用可能である。:

Ada_Connect()
Ada_Close()
Ada_Exec()
Ada_Result()
Ada_ResultAll()
Ada_FreeResult()
Ada_NumRows()
Ada_NumFields()
Ada_NumRows()
Ada_NumFields()
Ada_FieldNum()
Ada_FieldName()
Ada_FieldType()

以下に Postgres と Solid の節で示したのと同じスクリプトを Adabas D 用に修正したものを示す。

<?
   $conn = Ada_Connect("node:db", "username", "password");
   if (!$conn) {
      echo "An error occured.\n";
      exit;
   }

   $result = Ada_Exec($conn, "select * from table1");
   if (!$result) {
      echo "An error occured.\n";
      exit;
   }

   while (Ada_FetchRow($result)) {
      echo "name: ";
      echo Ada_Result($result, "name");
      echo "  age: ";
      echo Ada_Result($result, "age");
      echo "<BR>";
   }

   Ada_FreeResult($result);
   Ada_Close($conn);
>

正規表現

正規表現は PHP/FI において複雑な文字列操作に用いられる。次の関数を通じてスクリプトインターフェイスは正規表現をサポートしている:
EReg(), ERegi(), EReg_Replace(), ERegi_Replace(), Reg_Match(), Reg_Replace(), Reg_Search()
全ての関数に対する最初の引数(argument)は正規表現文字列である。 EReg 関数は POSIX 1003.2 で定義された Posix 拡張正規表現を使っている。一方、 Reg 関数は基本的な正規表現を実装している。正規表現についての詳細は、man の regex(7) を参照のこと。このページが無い場合には、Henry Spencer により書かれた regex(7) の man ページが PHP/FI ディストリビューションの src/regex ディレクトリにある。システム管理者にこの man ページをインストールするように頼むこと。

正規表現とその動作についての例を以下に挙げる。

ereg("abc",$string);
$string の中で "abc" を見つければ真( true ) を返す。

ereg("^abc",$string);
$string の最初に "abc" を見つければ真( true ) を返す。

ereg("abc$",$string);
$string の終わりに "abc" を見つければ真( true ) を返す。

eregi("(ozilla.[23]|MSIE.3)",$HTTP_USER_AGENT);
クライアントのブラウザがNetscape 2, 3 あるいは MSIE 3であれば真( true ) を返す。

ereg("([[:alnum:]]+) ([[:alnum:]]+) ([[:alnum:]]+)",$string,$regs);

空白で分離される3つの単語を $regs[1], $regs[2] と $regs[3] に代入する。

ereg_replace("^","<BR>",$string)
$string の始めに <BR> タグを入れる。

ereg_replace("$","<BR>",$string)
$string の終わりに <BR> タグを入れる。

ereg_replace(10,"",$string);
$string の中の全ての復改文字( LF )を取り除く。

ereg_replace(13,"<BR>",$string);
$string の中の全ての改行文字( CR )を <BR> tag で置き換える。

エスケープキャラクター

次のエスケープシークエンスは前方引用符で囲われた文字列引数が使われるほとんどのところでサポートされている。

	\a --> bell(ベル)
 	\b --> backspace(バックスペース)
 	\n --> linefeed(ラインフィード)
 	\r --> carriage return(改行)
 	\t --> tab(タブ)
 	\nnn --> octal char（8進数を表現する文字）
 	\xXX --> （16進数を表現する文字）

UNIX ファイル許可属性の8進表記

PHP/FI スクリプト言語のいくつかの関数は、UNIX 形式の許可属性パラメータを定義するために8進表記を要求する。この8進表記においては、0-7の値を表わすために3ビットが用いられる。 3つの各ビットは、特定の許可属性を表わす。 8進数は、従来より 0755 のように 0で始まる数で記述されてきた。 PHP においては、 8進数パラメータを要求する関数はパラメータが8進数であると単純に仮定するので、この先頭の 0 は必要ない。しかし、先頭に 0 を付けることは、10進数を処理していないことを自覚するための良い練習となる。

ビット表記

    xxx
    ^^^
    ||+----1 bit (実行許可)
    |+-----2 bit (書き込み許可)
    +------4 bit (読み出し許可r)

これらの3ビットは、所有者、グループ、全ての人に関して3回繰り返される。つまり、0755 は以下を意味する。

    owner: r,w,x
    group: r, ,x
    world: r, ,x

ディレクトリの実行ビットは、'アクセス'を意味し、'実行'を意味しないことに注意されたい。 0?755 のような4番目の8進数ニブル(半ワード)に拡張ビットも存在する。つまり、

    4: suid ビット   (userid をセット)
    2: sgid ビット   (グループ id をセット)
    1: sticky ビット (あるディレクトリにおいてその所有者のみが、ファイルを消去できる。)

PHP/FI スクリプト言語

PHP スクリプト言語は多くの場合 C 言語の構文に似ている。変数、配列、関数の呼び出し、異なる変数の型、そして cgi プログラムを書くために必要なほとんどのものがサポートされている。

各々の PHP/FI 関数は次項で説明されている。各関数の説明にはその名前でタグが付けてあるので、このドキュメントの URL に #関数名を付加することにより容易に見つけることが可能であろう。

構文

それぞれの PHP 命令は

で始り、

で終わる。あるいは、PHP 命令を一組の

によりグループ化し、

文字で分割しても良い。

変数はサポートされており、変数名の前に $ を付けることにより定義される。例えば、変数に 5 をセットし、それからこの変数を表示するには次のように書くのが正しい書き方である。

	<?$a = 5>
	<?echo $a>

以下のように書いても同じである。

	<?; $a = 5; echo $a >

また、これも同じ意味である。

	<?;
	$a = 5;
	echo $a;
	>

スペース、タブや改行のような余分な空白文字は無視される。このため、PHP スクリプトのブロックをフォーマットして読みやすくする為に空白文字を用いることができる。変数においては大文字小文字は区別されるが、関数の呼び出しにおいては区別されない。後述する関数の概要において、大文字小文字の区別は関数名を読みやすくする為だけに使われている。実際のスクリプトにおいては、大文字、小文字の好きな方を用いて良い。

コメントもサポートされている。コメントは C 言語のコメントと全く同様に書くことが出来る。

/*

で始り、

*/

でコメントを終わる。コメントは

ブロックの中のどこに置いても構わない。

変数

3種類の変数がサポートされている。すなわち、ロング整数型、倍精度浮動小数型、 文字列型である。これらは自動的に検出される。例えば、:

	<?$a = 5>

ここで $a はロング整数型の変数である。

	<?$a = 5.0>

この時、$a は倍精度実数型である

	<?$a = "5">

この時、$a は文字列型である。

変数の型はあまり重要ではない。あらゆる変数はその型にかかわらず内部ですべて3つの型に変換され、様々な関数は正しい型を使おうとする。 2,3の関数だけが変数の型に影響される。

3つの変数型はその名前に [値]を付けることですべて配列として扱うことも出来る。 C 言語とは異なり、それらは Perl で使うのと同様に実際には連想配列である。次のように書くのが正しい:

	<?
	  $a[0] = 5;
	  $a["hello"] = 6;
	  echo $a[0];
	  echo $a["hello"];
	>

以下の点に注意すること。ある変数名が配列と普通の変数と両方で使われる場合には、普通の変数は配列中では添字"0"の要素を登録することと同じ事を意味する。例えば、

    $a = 1;

は次のように書かれるのと同じである。

    $a[0] = 1;

PHP/FI は添字無し配列もサポートしている。添字無し配列においては、要素が追加された時に独自に添字が作成される。例えば、:

    $a[] = "Hello";
    $a[] = "There";

添字無し配列に代入された最初の要素は、常に添字 0 を割り当てられる。 2番目は添字 1 である。よって、先の要素は次のように出力される。

    echo $a[0];
     echo $a[1];

配列は、簡単な割り付けによりコピーすることができる。 $b が配列である場合、次のように入力することにより、全ての値を $a という名前の新しい配列にコピーすることができる。:

    $a = $b;

PHP は変数を使用する前にその変数を定義することを強制しないというのは、必ずしも望ましいことではない。上記の命令において、$b が未定義の場合、$a は空の文字列("") にセットされる。

追加されるのが配列であることを示すために [] 記法も用いられる。 $a と $b が共に配列である場合に、次のように入力することにより、 $b を $a に追加することができる。:

    $a[] = $b;

上の例では、連想配列と通常の番号をふられた配列の間に差が生じる。番号をふられた配列の場合は、$b からの全ての要素が $a からの元の要素に続くように番号がふりなおされる。一方、連想配列においては $b の要素は、$a の要素に取り込まれる。 $a に既に存在する全ての要素(同じ項目名を有する項目)は、 $b の要素で上書きされる。

配列の要素数を定義するために count() 関数を使うことが出来る。

言語の本質的な事実でもあるが、変数の型はある基本的な動作がどのように実行されるかで決められる。例えば、:

    $a = $b + $c;

は一連の異なった操作を行なう。$b が数字である場合には、数値 $c は $b に加算され、合計が $a に代入される。この場合、$c の型は動作に無関係である。操作は最初の変数の型で支配される。$b が文字列ならば、文字列として $c の値が $b に加えられ、最終的な文字列が $a に代入される。これらの処理においてはいくつか注意すべき点がある。これらの処理についてより深く理解するには、演算子の多重定義の項を参照のこと。

連想配列

先ほどのセクションで連想配列を紹介した。連想配列は添字が連続した数値である必要の無い配列である。配列の添字はいかなる数でも文字でも良い。 PHP/FI はこれらの連想配列を上手く処理するために一連の関数を用意している。その中には Next()、 Prev()、 Reset()、 End()、 Key()を含む。

可変変数

可変変数名を使う事が便利な時がある。それは、宣言し使われている変数名が動的に扱われるときである。通常の変数は次のように宣言される。

    $a = "hello";

可変変数は変数の値を持ち、さらに変数名としても扱われる。上の例では、hello は2つの $ を使って変数名としても使う事が出来る。例えば、

    $$a = "world";

この時2つの変数が定義され、 PHP/FI のシンボルツリーに保存されている。

    Variable Name        Variable Content
         a                   hello
         hello               world

さらにこの文は

    echo "$a $$a";

以下とまったく同じ出力をする。

    echo "$a $hello";

すなわち、両方とも次のように出力される。 : hello world

言語構造

言語構造に関する限り、 PHP 言語は非常に単純である。次のコマンドはファイルの中で制御フローを導くのに使われている。

if (condition)
else
elseif (condition)
endif
switch(expression)
case expression
default
break
endswitch
while
endwhile
include
exit

条件構文は C 言語と似ている。 == は等しいことをテストする。 != は等しくないことを表わす。また次のものもサポートしている。 >、 <、 >=、<=。条件の積 (AND) は &&、条件の和 (OR) は ||である。

例えば、

    <?
      if($a==5 &&  $b!=0 );
        $c = 100 + $a / $b;
      endif;
    >

上の例は以下のように標準的な C の構文で書くこともできる。
この場合、閉じるのに使われている大括弧の後のセミコロンは必要ない。

    <?
      if($a==5 && $b!=0) {
          $c = 100 + $a / $b;
      }
    >

2つの構文に違いはない。私は個人的に endif、 endswitch や endwhile を使うのが好きなので、閉じる時には常に自明な方法を用いる。しかし、これらの閉じるための構造を大括弧で置き換えることも出来る。

以下の点に注意すること。言語処理の流れは、コードの中のスクリプトブロックの形態に依存していない。 1つのブロックの中で if で始まり、他の表現で終わることも出来る。例えば、

	<?if($a==5 &&  $b!=0)>
		  <b>Normal html text</b>
	<?endif>

この例では閉じる大括弧の代わりに endif を使うことが非常に好ましい時がある事が容易に理解できる。上の例は次の例よりはるかに読みやすい。

	<?if($a==5 &&  $b!=0) {>
		  <b>Normal html text</b>
	<? } >

どちらの例も正しく、同じ事を行う。

ユーザ定義関数

次の文章のように PHP スクリプト中で関数を定義出来る。

    <?
      Function Test (
        echo "This is a test\n";
      );
    >

この関数は定義した後ではスクリプト中のどこででも呼び出すことが出来る。例えば、

    <?
      Test();
    >

この様なユーザが定義した関数は、PHP の内部関数と全く同じように働く。内部関数と同様に、関数に引数を渡し関数から値を返す事が可能である。以下は 3つの引数を取り、それらの引数の合計を返す関数の定義である。

    <?
      Function Sum $a,$b,$c (
        return($a+$b+$c);
      );

      echo Sum($a,$b,$c);
    >

return は関数から一つの値を返すのに使われる。この方法により返すことができる値は一つだけである。メインコードと関数の間でより多くの値を受け渡す必要がある場合には、グローバル変数を用いることができる。このことに関しては次項の「変数の範囲」でも説明する。

変数の範囲

変数の範囲はそれが定義されている文脈の中である。大部分の PHP/FI の変数は単一の範囲を持つだけである。しかし、ユーザ定義関数の中では、ローカルな関数範囲が使われる。関数の内部で使われる変数はデフォルトでローカルな関数範囲に制限されている。例えば、

    $a=1; /* global scope */
    Function Test (
      echo $a; /* reference to local scope variable */
    );
    Test();

このスクリプトは全く出力をしないであろう。これは、echo 文が $a 変数のローカル版を参照しており、この範囲内では値が割り付けられていないためである。 C 言語においては、ローカル変数の定義により上書きされない限りグローバル変数を関数内部において自動的に使用することができる。しかし、上記の動作はこれとやや異なっているということに必要である。この方法では、グローバル変数の値が誤って変更されるという問題を生じる可能性がある。 PHP/FI においては、関数で使用される全てのグローバル変数は関数の内部で global として宣言されなかればならない。例えば、

    $a=1;
    $b=2;
    Function Sum $first,$second (
      global $a,$b;

      $b = $a + $b;
    );
    Sum();
    echo $b;

上のスクリプトは "3"を出力する。 $a and $b を関数内でglobal 宣言することにより、各々の変数への全ての参照はグローバル変数を参照する。関数によって処理されるグローバル変数の数に制限は無い。しかし、変数は関数が呼ばれるよりも前のグローバルな範囲になければならない。関数の中で新しいグローバル変数を作ることは出来ない。

一方、「変数範囲」で重要な特徴は スタティック 変数である。スタティック変数はローカルな関数の範囲内でのみ存在するが、プログラムの実行がこの範囲を離れてもその値を失わない。次の例で考えてみよう。

    Function Test (
      $a=0;
      echo $a;
      $a++;
    );

この関数は全く役に立たない。何故ならば関数が呼ばれたときは常に $a に 0 を代入し、 "0" を出力するからである。変数を増加させる $a++ は関数が存在するとすぐに $a 変数がなくなるので意味がない。現在のカウントを失わないような役に立つ数を数える関数を作るには、変数 $a をスタティックに宣言する。

    Function Test (
      static $a=0;
      echo $a;
      $a++;
    );

Test() 関数が呼ばれるときは常に $a の値を出力してその数を増やす。

関数が再帰的に呼ばれる時にもスタティック変数は重要である。再帰的関数は自分自身を呼ぶような関数である。再帰的関数を書いている時には充分注意するべきである。何故ならばそれがいつまでも再帰するように出来るからである。再帰が適切に終わるようにしなければならない。次の簡単な関数は10まで再帰的にカウントする。

    Function Test (
      static $count=0;

      $count++;
      echo $count;
      if($count <  10) {
        Test();
      }
    );

数学的表現

PHPは式が求められる全ての場所で完全な数学的演算をサポートする。演算子の順番は考慮される。次のものは有効な演算子である:

	<? $a = 2 + 1 > 足し算
	<? $a = 2 - 1 > 引き算
	<? $a = 2 * 1 > かけ算
	<? $a = 2 / 1 > 割算
	<? $a = 2 % 1 > 剰余
 	<? $a = 2 ^ 1 > ビット毎の排他的OR

括弧での括りと演算子の順番はどちらもサポートされる。よって、次のものは有効である:

	<?$a = (2+1)*3+6/3>

C言語ライクなインクリメント演算子 += と -= がサポートされる。

すなわち

    <? $a += $b>

これは、次と同義である:

    <? $a = $a + $b>

C言語に似たビット演算子 &=、|=、^= がサポートされる。すなわち

    <? $a &= 4>

これは、次と同義である:

    <? $a = $a &  4>

While ループ

PHPスクリプト中で while(); endwhile; 構文によるループが使用できる。

	<?
	  $a=0;
	  while($a<100) {
		  $a++;
		  echo $list[$a];	
	  } 
	>

上記は配列の内容を表示する while ループの使用例である。注意 PHP言語は ++ と -- のような変数を加算減算するインクリメント演算子をサポートするが、 C言語のように厳密に扱われることはない。変数は即座にインクリメントされる。 C言語にみられるように、操作の前または後で変数をインクリメントする概念はない。

上記の言語構造の項で述べたように、 while(); endwhile; についても同様のことが可能である。

Switch 構造

PHPはC言語と良く似た switch 構造をサポートする。

	<?
	  $a=0;
	  switch($a) {
		case 1;
		  echo "a is 1";
		  break;
		case "hello";
		  echo "a is hello";
		  break;
		default;
		  echo "a is unknown";
		  break;
	  } 
	>

上記は switch 構造の例である。これは一連の if/elseif/else 構造に似ているが、より読みやすいものである。C言語とPHPとの switch 構造の違いは、各行を区切るためにコロン(:)ではなくセミコロン(;)が用いられていることである。

上記の言語構造の章で述べたように、 switch(); endswitch; を用いても同様のことが可能である。

これら全ての構造はもちろん、C言語と同様にネストして使用できる。 PHP配布パッケージの examplesディレクトリーにある様々なファイルが、この言語を学ぶための良いスタート地点を提供するであろう。

安全な変数 - GET メソッドのハッキング防止

前項では GET と POST のメソッドのデータと変数について述べた。これについて考えてみると、セキュリティーに関する問題を想像できるであろう。例えば、ウェブのページでデータベースからあるデータを入手し、このデータを "data"という変数に入れて POST メソッドのフォームから送ったとする。その次のページでこの変数にアクセスし、それを使って何かをすることができる。しかし、この2番目のページに直接アクセスし "?data=something"を URLに付け足すことにより GET メソッドの変数をセットした場合には、元の POST メソッドを効果的に回避することが可能である。

PHPは、変数名を安全な変数(secure variable)として指定する SecureVar()関数を提供する。これらの安全な変数は、PHP スクリプトの中で直接値をセットすることのみが可能である。もしくは、POST メソッドのフォームから値を得ることが可能である。この変数は GET メソッドによる変数定義の機構を使用してはセットできない。上記の記述をもとに、次の行を実行する。:

    <?SecureVar("data")>

これを二つめのページの始めに置くことにより、GET メソッドにおけるトリックは機能しなくなる。"data"という変数は、最初のページの POST メソッドのフォームから直接来ない限り、空の状態になる。

SecureVar()は、実際は正規表現を引数としてとるため、安全な方法で扱いたい変数の名前のパターンを指定することができる。例えば、

    <?SecureVar(".*data.*")>

は、"data"という語をその名前の中のどこかに含む全ての変数を指定する。

気をつけなければいけないのは、POSTメソッドは本質的に安全ではないという点である。システムのHTTPポートに単に telnet することで、疑似的にフォームのデータの転送をすることができるのである。実際にセキュリティが重要である場合には、このようなことが行なわれないように適当なセキュリティチェックを行なう必要がある。

演算子のオーバーロードと変数の型の扱い

オーバーロードされた演算子とは、例えば'+'のように、演算する式の型によって違ったことのできる演算子である。

問題は、PHPが三つの変数の型を理解することである。整数(Integer)、倍精度小数(Double)、文字列(String)がそれである。変数が最初に割り付けられた時にPHPは自動的に変数の型を判定する。

すなわち、

    $a = 1;     型は整数(integer)になる
    $b = 1.5;   型は倍精度小数(double)になる
    $c = "1";   型は文字列(string)になる

それでは、次のようにした場合どのようなことが起こるであろうか:

    $d = $a + $c;

構文解析は最初の算術式を見て、結果と、成すべき計算の種類の型を決めるために使用する。上記の例では $a が整数(integer)であるため、 $d は整数(integer)に、そして整数の足し算が結果として行なわれる:

    $d = 2      型は整数である

従って:

    $d = $c + $a

の結果は:

    $d = "11"   型は文字列である

上の事項は私にとって理にかなっており、一度理解すれば実用になるであろう。しかし、さらに複雑な式が使われた時、極端に混乱を招くものとなり得る。

解決方法は、単純な型キャストのメカニズムである。

実際、全ての変数は自動的に三つの全ての型に変換され、内部的なフラッグがその変数が現にどの型なのかを示しているのである。つまりいうなれば:

    $a = 1;

内部的に記号表(symbol table)には三つのバージョンで保存されている。

    Integer:  1    <--- ここをフラッグが指している
    Double :  1.0
    String :  "1"

SetType()関数は、この変数の型を示すフラッグを動かすことができる。

    SetType($a,"double");

これは、$a を倍精度小数(double)として、これから後強制的に扱うようにする。

GetType()関数は型を返す。この例でGetType()は、"double"を返す。

型のフラッグを動かさずにいろいろな三つの型を返す関数も存在する。

    IntVal($a)     returns  1
    DoubleVal($a)  returns  1.0
    StrVal($a)     returns  "1"

これは、PHP変数のオーバーロードされた演算子の本質を変えることはないが、それらをよりうまく扱うためのツールを提供する。PHPは一人前のPerlもどきではない。小さく速くなくてはならない。Perlはオーバーロードされた演算子の落とし穴を扱うのに、'+'の様な演算子は強制的に数字のみに働くようにする。もし文字列を加えたいならば、'.'演算子を使わなければならない。各々の型別に別れた演算子を持ち始めると、その言語をますます複雑なものとすることになる。すなわち、'=='を文字列に使うことができず、 'eq'を使うことになる。こういったことは、特にPHPの様にほとんどのスクリプトがどちらかといえば単純で、多くの場合あまり学習曲線の高くない基本的な論理的構文の言語を求めるプログラマーでない人々が書くような言語においては意味があることとは思えない。

関数呼び出し時のエラー抑制

特定のPHP関数からの致命的なエラーを無視することが望ましい場合もある。例えば、dbmopen() の呼び出しのエラーを無視して、ウェブの画面にエラーメッセージを出すことなしに、単に戻り値をチェックしたいとする。これは、"@"文字を関数の前に置くことで実現できる。すなわち

    $err_code = @dbmopen($filename,"w");

出力された実際のエラーメッセージは、PHPの内部変数である $phperrmsgを見ることでチェックできる。

より一般的なエラーメッセージ表示の抑制方法は、 SetErrorReporting()関数を使うことである。この関数を用いて、全てのスクリプトコードのブロックで、次のような呼び出しを含むブロックを前に置くことで、その後のエラーの表示を不能にすることができる:

    SetErrorReporting(0);

これは、全てのエラー表示を消す。再度表示可能にするには以下のようにする:

    SetErrorReporting(1);

内部関数

PHPには多くの組み込み関数がある。関数の呼び出しは C言語のものと同じ方法が用いられる。一つあるいは複数の引数を取るものもあり、変数に格納したり他の関数の引数にするための戻り値を返すものもある。例えば:

	<?$t=time()>

これは time()関数の戻り値を変数tに代入する。

関数のアルファベット順リスト

Abs(引数)

Abs は引数の絶対値を返す。

Ada_Close(接続ID)

Ada_Close は、指定された接続IDに関連する Adabas サーバーへの接続を閉じる。