簡易チュートリアル
ここで、PHP の基礎の基礎について簡単なチュートリアルで説明したいと思います。
PHP は Web ページを作成する機能だけを有しているわけではありませんが、
ここでは PHP で動的な Web ページを作成することのみを扱います。詳細は、
PHP でできること
と題するセクションを参照ください。
PHP を使用できる Web ページは、通常の HTML ページと全く同様に扱われ、
通常の HTML ページを作成するのと同様の方法で編集することができます。
PHP を使用する初めてのページ
このチュートリアルでは、PHP はインストール済みであることを想定しています。
インストール方法については、
ダウンロードページ
を参照ください。
以下の内容で hello.php
という名前のファイルを作成してください:
初めての PHP スクリプト: <filename>hello.php</filename>
]]>
ターミナルを使い、このファイルがあるディレクトリに移動し、
以下のコマンドで開発用のサーバーを起動します:
ブラウザを使用して、/hello.php
で終わる Web アクセス用 URL を指定し、
このファイルにアクセスしてください。
先程のコマンドを実行済みの場合、この URL は
http://localhost:8000/hello.php
のようになります。
全てが正しく設定されている場合、
このファイルは PHP によりパースされ、
"Hello World" がブラウザで表示されます。
PHP は通常のHTMLの Webページにも埋め込むことができます。
つまり、HTML ドキュメントを PHP の文を使って書けるということです。
そのことを示すデモが以下になります:
PHP Test
Hello World'; ?>
]]>
上記の出力は、以下のようになります:
PHP Test
Hello World
]]>
このプログラムは非常に簡単なので、実際には、このようなページを
作成するために PHP を使用する必要はありません。
Hello World を PHP の echo
命令により出力しているだけです。
このファイルは、実行ファイルまたは特殊なファイルとする必要がないことに注意してください。
このファイルが拡張子 ".php" を有し、このファイルが PHP
に渡される必要があると設定されているため、サーバーは PHP
により解釈されるファイルを見付けることができます。
このファイルは、多くの面白いことを可能にする特別なタグを利用できる、
通常の HTML ファイルと考えることができます。
この例の目的は、特殊な PHP タグ形式を示すことです。
この例では、<?php が PHP
タグの開始を示しています。この後、PHP 命令を置き、終了タグ ?>
を記述することにより、PHP モードを抜けています。
このように任意の場所で PHP モードを抜けて HTML
ファイルに移ることができます。詳細は、
基本的な構文のセクションを参照ください。
改行に関する注意
HTML においては改行にはほとんど意味がありません。ただ、
HTML の見栄えをよくするためにも適宜改行を入れておくとよいでしょう。
?> の直後の改行は、PHP によって取り除かれます。
複数の PHP ブロックを使用している場合や、
何かを出力するのかどうかがわからないファイルを include する際などに、
この挙動は非常に便利です。と同時に少々混乱するかもしれません。
強制的に改行させるには、?> の後に空白を置くか、
あるいは PHP ブロック内の最後の echo/print で明示的に改行を出力します。
テキストエディタに関する注意
PHP ファイルを作成、編集、監理する際に使用できる、
多くのテキストエディタや統合開発環境 (IDE) があります。
これらのツールのリストの一部は、PHP エディタのリスト
で整理されています。あるエディタを推薦したい場合、上記のページを訪れ、
ページの監理者にそのエディタをリストに加えてくれないかとたずねてみてください。
ワードプロセッサに関する注意
StarOffice Writer, Microsoft Word および Abiword
のようなワードプロセッサは、PHP ファイルの編集には向いていません。
これらのワープロ上でテストスクリプトを編集する場合は、
ファイルをプレーンテキストとして保存していることを確認してください。
さもないと、PHP はスクリプトを読み込んで実行できません。
さて、動作する簡単な PHP スクリプトを作成することができましたので、
最も有名な PHP スクリプトを作成してみましょう!
phpinfo 関数をコールすることにより、
定義済み変数、
ロードされている PHP モジュール、設定
等のシステムに関する多くの有用な情報を得ることができます。
この重要な情報を見てみてください。
PHP からシステムに関する情報を取得する
]]>
実用的な例
次に、より実用的なことをしてみましょう。
ページを見ているユーザーが使用しているブラウザの種類を確認してみます。
これを行なうには、ブラウザが
HTTP リクエストの一部として送信した user agent 文字列を調べます。
この情報は、変数
に保存されています。PHP では、変数名は常にドル記号で始まります。
ここで使用する変数は、$_SERVER['HTTP_USER_AGENT']
です。
$_SERVER は、
Web サーバー関連情報を全て保持する PHP の特別な予約変数です。詳細は、
スーパーグローバル
を参照ください。
この変数を表示するには、以下のようにします。
変数を出力する (配列要素)
]]>
このスクリプトの出力例は以下のようになります。
PHP で利用可能な変数の型
には多くの種類があります。上の例では、
配列
の要素を出力しています。配列は、非常に有用です。
$_SERVER は、PHP
で自動的に利用可能な変数のひとつに過ぎません。マニュアルの
定義済の変数
のセクションでリストを参照することができます。
あるいは、完全なリストを取得するには、さきほどのセクションで使用した
phpinfo 関数の出力を確認します。
PHP タグの中に複数の PHP 命令を置くことができ、echo
文以上のことを行なうコードブロックを作成することができます。
例えば、Firefox かを調べたい場合は、
以下のようにします。
<link linkend="language.control-structures">制御構造</link> および
<link linkend="language.functions">関数</link>の使用例
]]>
このスクリプトの出力例は以下のようになります。
ここで、新しい概念をいくつか導入します。
if 文を使用しています。
C 言語の基本構文を知っているとしたら、理解できると思います。
C 言語や上記の構文を使用する他の言語をあまり知らない場合には、
PHP の入門書を手にとって最初の数章を読むか、このマニュアルの
言語リファレンスの部分を読むべきです。
二番目の新しい概念は、str_contains 関数のコールです。
str_contains は PHP に組み込まれた関数で、
指定された文字列が、別の文字列に含まれているかを判定します。この場合、
$_SERVER['HTTP_USER_AGENT'] (いわゆる干し草の山
【haystack】) の中で
"Firefox" (いわゆる針【needle】) を探しています。
この文字列が見つかった場合、
この関数は &true; を返し、
見つからなかった場合には &false; を返します。
この関数が &true; を返すと、
if
文は &true; と評価し、その{波括弧}の中のコードが実行されます。
そうでない場合は、実行されません。
if,
else と
strtoupper や strlen
のような他の関数で、似たような例を作ってみてください。
関連するマニュアルの各ページにも例が載っています。
関数の使用法に自信がない場合には、マニュアルの
関数定義の読み方および
PHP関数のセクションの両方を
読んでみると良いでしょう。
この例を少し発展させて、PHP ブロックの中からでも PHP
モードから出たり入ったりすることができることを以下に示します。
HTML および PHP モードの両方を混在させる
str_contains() がtrueを返しました
あなたはFirefoxを使用しています
str_contains()がfalseを返しました
あなたはFirefoxを使用していません
]]>
この例の出力は以下のようになります。
str_contains() がtrueを返しました
あなたはFirefoxを使用しています
]]>
何かを出力する際に PHP の echo 文を使用する代わりに、PHP
モードを抜けて通常の HTML を送信しています。ここで注意すべき重要で強力な点は、
スクリプトの論理フローが損なわれないということです。
str_contains が &true; または &false;
のどちらを返すか、言い換えるとFirefox
が見つかったかどうかに基づき、HTML
ブロックだけが見る側に送信されることになります。
フォームの処理
PHP の最も強力な機能の一つは、HTML フォームを処理する手段です。
理解するべき重要な基本概念は、あるフォームの中の全てのフォーム要素が、
自動的に PHP スクリプトで利用可能になるということです。
詳細は、マニュアルのセクション
外部から来る変数 および PHP
でフォームを使用する例を参照ください。以下に HTML フォームの例を示します。
簡単な HTML フォーム
]]>
このフォームに関して特別なところはありません。これは通常の HTML
フォームで特殊なタグは全く使用していません。
ユーザーがこのフォームを記入し、投稿ボタンを押した時、
action.php ページがコールされます。
このファイルには、以下のようなコードを記述します。
フォームからのデータを出力する
さん。
あなたは、 歳です。
]]>
このスクリプトの出力例は次のようになります。
htmlspecialchars および
(int) の部分以外は、何を行っているかは明らかでしょう。
htmlspecialchars は、html での特殊な文字を適切にエンコードし、
HTML タグや JavaScript をページ内に仕込めないようにします。
また、age フィールドには数値が入ることがわかっているので、これを
int 型に 変換
します。これにより、おかしな文字が入力されることを防ぎます。
これらの処理を PHP に自動的に行わせるためには、
filter 拡張モジュールを使用します。
変数 $_POST['name'] と
$_POST['age'] は PHP により自動的に設定されます。
前の部分では、スーパーグローバル$_SERVER を使用しましたが、
ここでは、全ての POST データを保持するスーパーグローバル
$_POST を導入しています。
フォームのメソッドが POST であることに注意してください。
GET メソッドを使用している場合、
フォームの情報は代わりにスーパーグローバル $_GET
に代入されます。リクエストデータの発信源に留意しない場合には、
スーパーグローバル変数
$_REQUEST
を使用することもできます。この変数は、GET, POST, COOKIE, FILE
データの混ざったものが含まれます。
次にするべきことは?
ここで得た知識により、マニュアルのほとんどの部分、
そしてサンプルのアーカイブにある多くのスクリプトの例を理解できるようになったはずです。
この他 PHP でできる多くのことを示すスライドプレゼンテーションを見るには、
PHP カンファレンスマテリアルサイト
&url.php.talks;
を参照ください。