これらは、PHPが標準で備えている関数であり、構文と並んでPHPでのプログラミングの基本となる要素であるが、「ユーザー定義関数」として自身で関数を定義することも出来る。

関数については「初心者による初心者のためのPHP講座　第２回　PHPの基本構造」で触れているので、もう一度おさらいして欲しい。

ユーザー定義関数は、比較的小規模な処理を１つにまとめたもので、PHPのプログラムは、複数の「ユーザー定義関数」を組み合わせて実行させることで成立しているとも言える。

他の言語では、PHPの関数のような、ひとまとまりの処理を「サブルーチン」と呼ぶ場合もある。

ユーザー定義関数は、下記のようにfunction文を用いて定義する。

function 関数名() {
	処理1;
	処理2;
	処理3;
	.
	.
	.
}

関数は、１つまたは複数の引数を取ることもあるが、その場合は

function 関数名(引数1, 引数2, 引数3...) {
	処理1;
	処理2;
	処理3;
	.
	.
	.
}

となる。

関数名には、英数字、アンダースコアを使用することが出来るが、最初の一文字は、アルファベットかアンダースコアでなければならない。

戻り値を参照渡しする場合に、「&」で始まる関数を定義することがあるが、厳密には「&」は変数名の一部ではなく、「&関数名」となっている。

ユーザー定義関数を実行する場合は、標準の関数を実行する場合と同様に

関数名();

または

関数名(引数1, 引数2, 引数3...);

とすれば良い。

また、ユーザー定義関数の戻り値を別の関数の引数として用いることも出来る。

<?php
echo my_string();
round(my_value(), 2);
// my_string()とmy_value()はユーザー定義関数
?>

このあたりは、PHPの標準関数と同じである。

下記の例では、get_date_yesterday()という関数を定義しているが、これは昨日が何曜日だったかを求め、それを戻り値として返す関数である。

<?php
echo get_date_yesterday();

function get_date_yesterday() {
	$yesterday = time() + (60 * 60 * 9) - (60 * 60 * 24 * 1);
	// $yesterday = time() + (60秒 * 60分 * 9時間) - (60秒 * 60分 * 24時間 * 1日);
	$date_yesterday = date('l', $yesterday);
	return $date_yesterday;
}
?>

time()関数は、現在の時刻が、1970年1月1日0時0分から何秒経過したか求める関数であるが、 GMT基準であるため、日本時間に修正した上で、1日分の秒数を引いている。

こうして補正した秒数をdate()関数で整形し、曜日を求めている。

最後にreturn()を使って、戻り値として変数$date_yesterdayの値を返している。

return()は、処理を中断し、その引数を戻り値として返すが、echo()などと同様に厳密には関数ではないため、通常は、()は使わずに

return 引数(戻り値となる値、変数);

のように記述する。

戻り値として値を返さず、echo()関数で表示することが前提なら

<?php
get_date_yesterday();

function get_date_yesterday() {
	$yesterday = time() + (60 * 60 * 9) - (60 * 60 * 24 * 1);
	// $yesterday = time() + (60秒 * 60分 * 9時間) - (60秒 * 60分 * 24時間 * 1日);
	$date_yesterday = date('l', $yesterday);
	echo $date_yesterday;
}
?>

としても良い。これは戻り値を返さない関数になる。

関数は引数を取ることで、更に柔軟になる。

以下の例では、ＧＭＴとの時差に部分と、何日前の部分を引数として指定出来るようになっている。

<?php
echo get_date_before(9, 2);

function get_date_before($diff, $ago) {
	$before = time() + (60 * 60 * $diff) - (60 * 60 * 24 * $ago);
	// $before = time() + (60秒 * 60分 * 9時間) - (60秒 * 60分 * 24時間 * 1日);
	$date_before = date('l', $before);
	return $date_before;
}
?>

上記のサンプルでは、日本時間での一昨日前の曜日が表示されるが、

echo get_date_before(-8, 1);

とすれば、（夏時間の時期を除く）アメリカ太平洋標準時での昨日の曜日となる。

また、下記のように関数の定義内で別の関数を定義し、それを実行することも出来る。

<?php
echo check_holiday(9, 1);

function check_holiday($diff, $ago){

	function get_date_before($diff, $ago) {
		$before = time() + (60 * 60 * $diff) - (60 * 60 * 24 * $ago);
		// $before = time() + (60秒 * 60分 * 9時間) - (60秒 * 60分 * 24時間 * 1日);
		$date_before = date('l', $before);
		return $date_before;
	}

	$date = get_date_before($diff, $ago);

	if ($date == 'Saturday' || $date == 'Sunday') {
		return "休日";
	} else {
		return "平日";
	}

}
?>

この関数は、曜日が土曜日か日曜日なら「休日」と返す。

このように別の関数の定義をネストする場合は、関数を呼び出す前に、関数を定義しておくことがポイントになる。

また、上記のサンプルは、下記のように記述することも出来る。

<?php
echo check_holiday(9, 1);

function check_holiday($diff, $ago){
	$date = get_date_before($diff, $ago);

	if ($date == 'Saturday' || $date == 'Sunday') {
		return "休日";
	} else {
		return "平日";
	}

}

function get_date_before($diff, $ago) {
	$before = time() + (60 * 60 * $diff) - (60 * 60 * 24 * $ago);
	// $before = time() + (60秒 * 60分 * 9時間) - (60秒 * 60分 * 24時間 * 1日);
	$date_before = date('l', $before);
	return $date_before;
}
?>

このように記述することでget_date_before()関数を別の処理でも再利用しやすくなる利点もある。

更に下記のように記述すれば、check_holiday()関数は、単に与えられた曜日が平日か休日かを判断する関数となり、汎用性が高くなる。

<?php
echo check_holiday(get_date_before(9, 1))."<br />";
echo check_holiday(get_date_before(-8, 2))."<br />";
echo get_date_before(-8, 2);

function check_holiday($date){

	if ($date == 'Saturday' || $date == 'Sunday') {
		return "休日";
	} else {
		return "平日";
	}

}

function get_date_before($diff, $ago) {
	$before = time() + (60 * 60 * $diff) - (60 * 60 * 24 * $ago);
	// $before = time() + (60秒 * 60分 * 9時間) - (60秒 * 60分 * 24時間 * 1日);
	$date_before = date('l', $before);
	return $date_before;
}
?>

関数を定義する際は、出来る限り再利用しやすい形にした方が、プログラミングの効率も良い。

また、似たような処理を複数回記述する必要がある場合は、その部分をユーザー定義関数として独立させた方が良い。

以上のような処理は、ユーザー定義関数を使わなくとも簡単に記述できる。

<?php
$diff = 9;
$ago = 1;

$before = time() + (60 * 60 * $diff) - (60 * 60 * 24 * $ago);
// $before = time() + (60秒 * 60分 * 9時間) - (60秒 * 60分 * 24時間 * 1日);
$date_before = date('l', $before);

if ($date_before == 'Saturday' || $date_before == 'Sunday') {
	echo "休日";
} else {
	echo "平日";
}
?>

しかし、処理の再利用を前提とした場合、ユーザー定義関数が重要であることの理解は難しくないだろう。

関数を自身で定義し、複雑な処理を記述出来るようになると、必ず「変数のスコープ」を意識する必要が生じる。

「変数のスコープ」については、別の機会にお話ししたいと考えている。

Ver.0.1　2012/03/05

最新の「Plugin Directory Stats」をダウンロード

「Plugin Directory Stats」は、「Plugin Directory」からダウンロード数などの統計情報を取得し、ショートコードを使ってそれらを投稿、固定ページ、ウェイジェットの中で表示させることができる。

統計情報の取得にAPIと独自の仕組みを利用しているが、どちらもプラグインディレクトリのページをリクエストし、統計情報を取得する仕組みになっている。

つまりは、訪問者には見えない部分で、自サイトのページ以外にプラグインディレクトリのページを閲覧することになるため、サイトのパフォーマンスに少なからず影響を与える。

度が過ぎればWordPress.COMに対しても影響は皆無ではない。

そのため、原則として、プラグインの作者が、自身のプラグインの統計情報を自分のサイトで表示させる用途に向くプラグインである。

ただし、大量のプラグインの統計情報を表示させるような用途には向かない。

プラグインの利用者のサイト、WordPress.COMへの負荷を軽減するため、取得した情報は一定時間（デフォルトで3時間）キャッシュし、頻繁にページのリクエストを発生させない仕様になっている。

そのため表示される統計情報はリアルタイムの情報ではない。

キャッシュする時間を短くすることも出来るが、そもそも、リアルタイム性が重要な情報ではないので、可能な限り長めに設定して欲しい。

なお、統計情報は、プラグイン毎、作者者毎に独立してキャッシュされる仕組みであり、全情報が同時に更新されるとは限らない。

キャッシュの有効時間を過ぎた場合以外にもキャッシュが更新のタイミングがあり、UTCの午前0時（日本時間 午前9時）を過ぎ、日付が変わった後に、このプラグインのショートコードが記述されたページに訪問があった場合にもキャッシュが更新される。

以下は、このプラグインを使って統計情報の表示させた場合の例である。

・特定のプラグインの統計情報

Version: 0.1.4
Last Updated: 2012-05-15
Relase: 2012-03-05
Requires: 2.8
Tested up to: 3.3.2
Downloads: 567
Average Rating: 5/5 (2 ratings)

・作者毎のプラグインリスト

• Plugin Directory Stats
  Downloads: 567
• CodeMirror for CodeEditor
  Downloads: 1,755
• POST2PDF Converter
  Downloads: 8,416
• EZ zenback
  Downloads: 1,823
• WP SyntaxHighlighter
  Downloads: 23,288
• TinyMCE Backslash Button
  Downloads: 294
• SyntaxHighlighter TinyMCE Button
  Downloads: 10,576
• WP Wapuu Widget
  Downloads: 339

コメントは「DISQUS」を使用しているので、「DISQUS」側でコメントスパム対策を行なっているが、トラックバック（ピンバック）に関しては対策を行なっていなかった事が原因だが、やはり事前に対策を講じておくべきだったと反省している。

コメントスパムやトラックバックスパム対策と言えば「Akismet」が定番であるが、対象がトラックバックに絞られるため、もっとシンプルなトラックバックスパムに特化したプラグインの方が好ましい。

また、私のケースでは、記事へのリンクが含まれないサイトからのトラックバックを禁止する機能があれば十分だろうと思われたので、そのようなプラグインを探して見ると「Simple Trackback Validation」というプラグインが見つかった。

ところが、残念なことに「Simple Trackback Validation」は、長らくアップデートされていないので、出来れば使用は避けたい。

更に調べると、派生として「Simple Trackback Validation with Topsy Blocker」というプラグインが存在することが分かったので、こちらを使うことにした。

「Simple Trackback Validation with Topsy Blocker」は、「Simple Trackback Validation」の基本機能に加えて、「topsy.com blocker」という外部サービスを利用できるようになっている。

実際のところ、基本機能に違いがあるかは分からないが、単にリリースが新しいという理由で「Simple Trackback Validation with Topsy Blocker」を選んだ。

「Simple Trackback Validation with Topsy Blocker」では、トラックバックスパムの受信を拒否する以外に、承認待ちとして保存したり、スパムとしてマークして保存することも出来る。

スパム判定に「topsy.com blocker」という外部サービスを利用している点が、このプラグインの特徴であるが、これに加えて、次のような条件でもスパム判定を行う。

まず、IPアドレスをチェックする機能があり、トラックバックの送信元IPアドレスと、トラックバック元のサイトのIPアドレスを比較し、一致しなければスパムと判定される。

つまり、ツールなどを使って、実際のサイト以外からトラックバックが送信されたケースがこれに該当する。

また、トラックバック元のサイトに投稿へのリンクが含まれなければ、スパムと判定する。

これらの判定条件は、設定画面でON/OFFでき、かつ細かな設定が出来るようになっている。

「Simple Trackback Validation with Topsy Blocker」は、シンプルなプラグインではあるが、トラックバックスパムに対抗するための機能は十分に備えており、実際、これでトラックバックスパムを完全に拒否することが出来た。

「Plugin Directory」に登録されたものであれば、ダッシュボードで更新通知を受信できるためアップデートが楽というメリットがあるが、実はもう１つの理由がある。

それは、「Plugin Directory」に登録されたものなら比較的安全だろうという考えに基づいている。

WordPress用のテーマやプラグインは、悪意を持って作ることも簡単である。

実際、そのようなテーマやプラグインは少なくない。

そのため、導入前のチェックが重要になる。

チェックを行うツールとして「Theme-Check」と「Plugin-Check」をインストールする手もあるが、これもメッセージの内容が理解できてこそ意味のあるツールなので、敷居は低いとは言えない。

個人的には「Plugin Directory」のプラグインが比較的安全だろうとは思っているが、登録されているプラグイン全てが安全かと言われればそうではなく、そもそも「Plugin Directory」への登録自体が簡単で、ソースコードを提出しなくとも許可される。

実際、登録申請フォーム「Add Your Plugin」を見ると、「Plugin URL」の項目が「required(必須)」になっていない。

過去に「Plugin Directory」でセキュリティ上の問題が発生したことがあり、そのタイミング登録申請したプラグインに対してソースコードの提出を求められたので、最近は面倒を避けるために、最初からソースコードも提出しているおり、現在、すべての申請に対してソースコードの提出が求められていないかは分からない。

しかし、現在もノーチェックで登録が許可されている可能性も高い。

そもそも、登録申請から許可されるまでの時間を考えると、ソースコードを提出した場合でも、殆どノーチェックではないかと思われる。

つまり、すべての登録プラグインが、ガイドライン「Detailed Plugin Guidelines」を守っているとは限らず、「Free Themes Directory」に比べると甘いと言える。

とは言え、「Plugin Directory」はユーザー自体が多いので、万が一、悪意のあるプラグインが登録された場合でも、ある程度の期間公開されれば、ユーザーによって問題が報告され「Plugin Directory」から削除される。

公開からある程度時間の経過しているプラグインは、より安全であるとは言えるだろう。

ただし、公開間もないプラグインが全て危険という意味ではないので誤解のないように。

また「Plugin Directory」から削除される理由としては、プラグインの作者の都合であるケースもあるため、削除されたからと言って危険なプラグインだったとは限らない。

私は、以前から「Plugin Directory」に一度登録された後に削除されたプラグインを簡単に調べる方法が欲しいと思っていた。

削除されたプラグインは問題があった可能性もあるので、それを知りたいと言う理由もあるが、それに加えて運用上の理由が大きい。

私の場合は、ダッシュボードでの更新通知に完全に頼っているので、更新通知によってプラグインをアップデートしている。

更新通知がない場合は、それが単にアップデートが無いだけなのか、「Plugin Directory」から削除されたためなのか知る手段がないので、単にアップデートがないと考えるしかなくなる。

その結果、作者の意思で「Plugin Directory」から登録を削除し、「Plugin Directory」以外の場所で公開されている場合でも、アップデートがないと思って、古いバージョンを使い続けることになるかもしれないからだ。

この問題に対処する１つの方法として、先日「No Longer in Directory」というプラグインを見つけた。

このプラグインは、「Plugin Directory」から削除されたプラグインのリストを保持している。

リストは、バージョン1.0でも8,000行以上もある。

ダッシュボードの「プラグイン」->「No Longer in Directory」にアクセスすると、インストールされたプラグインの中にリストにマッチするものないか調べ、マッチするものがあれば、更にそのプラグインのページが「Plugin Directory」に存在するかHTTP requestによって調べ、ページがなければ、今、現在も「Plugin Directory」から削除されたままであると判断し、警告を表示する仕様になっている。

この方法であれば、リストが間違っていたり、不幸な偶然でリスト致してしまわない限り「Plugin Directory」以外からダウンロードしたプラグインが誤検知されることはない。

大前提としてリストが正確で、今後も更新され続けることが重要であるが、この問題の解決の１つの手段にはなりそうだ。

あまりダウンロードされないと、作者も更新しなくなる可能性があるので、再度、「No Longer in Directory」を宣伝しておく。

Ver.0.4　2012/02/16

最新の「POST2PDF Converter」をダウンロード

バージョン0.4では、作成されたPDFをキャッシュする機能を追加した。

過去のバージョンでは、ダウンロードリンクがクリックされる度に、PDFへの変換処理を行う仕様であったが、新しく追加されたキャッシュを有効にすることで、一度変換が行われた投稿に関しては変換を行わず、キャッシュからダウンロードされるようになり、サーバーの負荷が軽減されるようになった。

キャッシュの保持期間の設定は出来ず、無制限であるが、記事の内容が変更された場合は、更新後の最初ダウンロードのタイミングで個別にキャッシュは更新され、変更内容がPDFに反映される。

また、設定のリセットを含め、PDFの内容に影響を与える設定変更を行った場合や、キャッシュを無効にした場合には、すべてのキャッシュファイルがクリアされるようになっている。

記事とキャッシュの内容の不一致が起こらないように配慮しており、手動でキャッシュをクリアすることも出来るが、これは殆ど使う必要はないだろう。

記事とキャッシュの不一致が起こると考えられるケースは、直接、データベース上の記事データを変更した場合で、これをダッシュボード上から実行できるプラグインもあるが、通常の仕様の範囲では、まず、記事とキャッシュの不一致は発生しないと考えて良いだろう。

なお、ダッシュボードからプラグインの自動更新を行った場合も、キャッシュはクリアされてしまうため、これを避けたいならば、アップデートの際、手動で上書きインストールを行えば良い。

キャッシュは、「プラグインディレクトリ/post2pdf-converter/pdfs」に格納されている。

ループ処理は、PHPでは、出番が多い構文であり、必ずマスターしておくこと。

while構文

while構文はシンプルなループを記述するための構文で、if文と似ている。

while (式) {
	処理
}

if文の場合は、式が真の場合に処理を実行するが、while文の場合は、式が真である限り、同じ処理を繰り返し実行する。

下記のサンプルは、$countが6未満であれば処理を繰り返す。

$countの初期値は1であり、処理が実行される度に1加算される。

<?php
$count = 1;
while ($count < 6) {
        echo $count;
	$count++;
}
?>

従って、上記のサンプルを実行すると「12345」と表示される。

for構文

for構文は、while構文と比較すると複雑な構文で、繰り返しの条件を定義するために3つの式を必要とする。

for (式1; 式3; 式3) {
	処理
}

式1は、whileを開始した時に1度だけ実行され、式2は、処理に実行を完了する度に実行される。そして、式3が真であれば処理が繰り返される。

複雑ではあるが、以下のように読み替えると理解しやすい。

for (初期値; 条件式; 増減) {
	処理
}

式1で変数の初期値を定義し、式3で変数の増減を定義しておけば、式2の条件式で変数を評価することで意図した回数ループを繰り返すことが出来る。

<?php
for ($count = 1; $count < 6; $count++) {
        echo $count;
}
?>

上記のサンプルでは、$countの初期値が1で、処理の度に1増える。

そして、$countが6未満なら処理が繰り返されるため、実行すると「12345」と表示される。

次のサンプルでは、複数の変数の初期値と増減を記述している。

<?php
for ($count = 1, $value = 5; $count < 6; $count++, $value--) {
        echo "\$count:".$count." \$value:".$value."<br />";
}
?>

複数の変数の初期値と増減を記述する場合は、それらをカンマで区切ること。

for構文は、次のように記述しても良い。

for (式1; 式2; 式3):
	処理
endfor;

do～while構文

while構文やfor構文が、まず条件式を評価した上で、条件式が真であれば処理を繰り返すのに対して、do～while構文は、まず処理を実行してから、条件式の評価が行われる。

つまり、条件を満たしているか否かに関係なく、少なくとも1回の処理が実行され、2回目以降は、条件式が真である場合のみ繰り返される。

do {
	処理スクリプト
} while(式);

条件評価と処理の順序が逆であるが、基本的にはwhile構文と似ている。

次にサンプルは、$valの初期値が既に条件を満たしていない。

<?php
$val = -1;
do {
	echo $val;
} while ($val > 0);
?>

しかし、do～while構文では、条件の評価より先に処理が実行されるため、「-1」と表示される。

foreach構文

foreach構文は、配列を処理するために使われる配列専用のループ構文である。

だからと言って、配列にfor構文などを使用してはいけないという訳ではない。

foreach構文が優れている点は、ごく簡単な記述で、配列から要素を１つずつ取り出して処理出来る点である。

構文は下記のようになる。

foreach(配列 as $value) {
	処理
}

または

foreach(配列 as $key => $value) {
	処理
}

foreach構文では、配列から要素を取り出し、取り出した要素の値が自動的に変数$valueに代入される。

そして、この処理を、配列の先頭から最後まで繰り返す。

また、演算子「=>」を用いることで、配列から取り出された要素のキーと対応する値を、$key、$valueに代入させることも出来る。

なお、受け皿となる変数名は、$key、$value以外でも構わない。

おそらく、具体的な処理を見た方が理解しやすいだろう。

以下では、全ての要素からキーと値を取り出して表示させてる。

<!doctype html>
<?php echo '<?xml version="1.0" encoding="utf-8"?>'; ?>
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<html xmlns="http://www.w3.org/1999/xhtml" lang="ja" xml:lang="ja">
<head>
<meta http-equiv="Content-Type" content="text/html; charset=utf-8" />
<title>foreach文で連想配列を処理</title>
</head>
<body>
<?php
$members = array('suzuki' => 13, 'yamada'=> 25, 'tanaka' => 46);

foreach($members as $name => $age) {
	echo "名前：".$name."<br />";
	echo "年齢：".$age."<br /><br />";
}
?>
</body>
</html>

上記のスクリプトの実行結果を表示

下記のサンプルでは、要素の値の書き換えを行なっている。

<?php
$members = array('suzuki' => 13, 'yamada'=> 25, 'tanaka' => 46);

foreach($members as $name => $age) {
	$members[$name] = $age * 2;
}

print_r($members);
?>

処理としては、単に年齢を2倍しているだけであり、下記のサンプルのように変数の「参照渡し」を利用し、直接、要素を書き換えて同様の処理を行うことも出来る。

<?php
$members = array('suzuki' => 13, 'yamada'=> 25, 'tanaka' => 46);

foreach($members as $name => &$age) {
	$age = $age * 2;
}

print_r($members);
?>

「$gae」ではなく「&$age」としている点がこの処理のポイントである。

ループのネスト

ループ内にループを記述して多重ループを構成することも出来る。

<?php
$a = 1;

while ($a < 3) {
	$b = 1;

	while ($b < 3) {
		echo "\$a:".$a." \$b:".$b."<br />";
		$b++;
	}

	$a++;
}
?>

上のサンプルでは、外側のwhile文が1回実行される毎に内側のwhile文が3回実行される。

外側のwhile文は3回実行されるので、内側のwhile文内の処理echo()は、計９回実行されることになる。

break

「break」は、switch構文の際にも用いたが、ループ構文に対しても使用可能で、while、for、do～while、foreach構文の処理を中断し、ループを抜けることが出来る。

次の例では、「suzuki」というキーを持つ要素の値を表示している。

<?php
$members = array('suzuki' => 13, 'yamada'=> 25, 'tanaka' => 46);

foreach($members as $name => $age) {
	if ($name == "suzuki") {
		echo $age;
	}
}
?>

上記の例では、「suzuki」に一致するキーが見つかった時点で、以後の繰り返しは無駄になってしまう。

従って、以下のようにbreakを使ってループから抜けるのが適切な処理と言える。

<?php
$members = array('suzuki' => 13, 'yamada'=> 25, 'tanaka' => 46);

foreach($members as $name => $age) {
	if ($name == "suzuki") {
		echo $age;
		break;
	}
}
?>

無駄な処理は、処理の遅延や負荷を生む原因になるため、breakを使用することを心掛ける必要がある。

ネストされたループ処理をbreakで抜ける場合は注意が必要である。

break文では、ループ構造を抜ける回数を指定できるので、例えば２重のループを完全に抜ける場合は、

break 2;

と言った記述を行う必要がある。

なお、サンプルのようにループ構造を抜ける回数を指定しなかった場合は、「1」と見なされる。

continue

ループの中で「continue」が記述されていると、それ以降の処理をスキップして、この回の繰り返しを終了し、条件式の評価を行い、真ならば次の繰り返しを実行する。

以下のサンプルでは、「continue」を使って、キーが「yamada」の場合のみ、echo()による出力を行わないようにしている。

<?php
$members = array('suzuki' => 13, 'yamada'=> 25, 'tanaka' => 46);

foreach($members as $name => $age) {
	if ($name == "yamada") {
		continue;
	}

	echo "名前：".$name."<br />";
	echo "年齢：".$age."<br /><br />";
}
?>

ループとループ内の変数

以下のサンプルの実行結果が予想出来るだろうか？

<?php
$count = 1;
while($count < 6) {
	echo $count;
	$count++;
}

echo $count;
?>

これは、どうだろうか？

<?php
for ($count = 1; $count < 6; $count++) {
        $val = $count *2;
}

echo $count;
?>

答えは、どちらも「6」である。

条件式やループ内で定義した変数は、ループ終了後も解除されず、生きているので、同じ変数を再度利用する場合は、注意が必要である。

特に複数のwhile文やdo～while文で、条件式に使う変数を使い回す場合は、都度、再定義してリセットすること。

続いて、foreach構文の場合を検証してみよう。

<?php
$members = array('suzuki' => 13, 'yamada'=> 25, 'tanaka' => 46);

foreach($members as $name => $age) {
	if ($name == "suzuki") {
		$members[$name] = $age * 2;
	}
}

echo "\$name:".$name."<br />";
echo "\$age:".$age."<br /><br />";
?>

上記のサンプルの実行結果は、

$name:tanaka
$age:46

となる。

つまり、キーや値の受け皿となる変数は解除されず、最後に取得した値が格納されたままになっている。

しかし、同様のforeach構文で同じ変数をキーや値の受け皿として使う場合は、再度、配列の先頭から取得し直すため、現状、どのような値が格納されているかは問題にならない。

とは言え、ループが終了した時点で、これらは基本的に不要な変数となるので、unset()関数で変数の割り当てを解除し、メモリから解放すると良い。

<?php
$members = array('suzuki' => 13, 'yamada'=> 25, 'tanaka' => 46);

foreach($members as $name => $age) {
	if ($name == "suzuki") {
		$members[$name] = $age * 2;
	}
}

unset($name);
unset($age);
?>

そもそも、同様の機能を持つプラグインは既に複数存在しており、「POST2PDF Converter」は、特に目新しいプラグインではないのであるが・・・。

投稿や固定ページをPDFへ変換するプラグインのうち、人気のものは外部のオンラインサービスを利用してPDFファイルの変換している。

例えば、「Print Friendly and PDF Button」は、「printfriendly」と言うサービスを利用してPDFに変換している。

また、「PDF24 Article To PDF」は、「PDF24」というサービスを利用しており、「PDF & Print Button Joliprint」は、「joliprint」を利用している。

これらのサービスは、PDF変換以外の機能も提供しているケースが多く、概ね高機能である。

対して「POST2PDF Converter」は、「TCPDF」というオープンソースのPHPライブラリを利用しており、外部サービスに依存せず、サーバー上で変換を行う。

もっとも、「TCPDF」を利用したプラグインは、以前から他にも存在しており、この点でも「POST2PDF Converter」が特に目新しいものでは無いのであるが・・・。

どちらかと言えば、「TCPDF」を利用したプラグインは、WordPressのプラグインの中ではマイナーな部類になるが、それは「TCPDF」が機能的に劣ると言うことではなく、UTF-8のWordPressコンテンツとも基本的に相性が良い。

「TCPDF」は、イタリア人のNicola Asuni氏（Tecnick.com S.r.l）によって開発されたPHPライブラリであり、「FPDF」の派生である。

このライブラリを使用するには、PHP 5が必要であるが、PHP 4用のパッケージも用意されている。

PHPのライブラリであるが故に、WordPressとの相性も良く、簡単な記述でDBからHTML形式のコンテンツ取得し、それを「TCPDF」に渡してPDF形式に変換することが出来る。

また、グラフやQRコードなどのバーコードの描画も可能であり、工夫次第で、かなり凝ったPDFを生成できるようになっている。

APIは単純とは言えないが、僅かなコードの追加でHTMLをPDFに変換するための処理を記述できる。
WordPressのようにコンテンツをHTML形式で取得し易いシステムであれば、導入に苦はないはずである。

PDFへの変換処理に関しては「TCPDF Examples」でサンプルが用意されているので、これを真似て書くと手っ取り早いだろう。

少し版は古いが「MONZEN.ORG」で日本語ドキュメントが用意されているので、これも参考になる。

• TCPDFについて
• TCPDF マニュアル 日本語版

ディレクトリパス、フォント、フォントサイズと言った設定パラメーターは「/config/tcpdf_config.php」で定数として設定する形になっており、必要に応じてこれを編集する。

「/config/lang」ディレクトリには、各言語用の設定ファイルが格納されている。

バージョン5.9.145からは日本語用の設定ファイル「jpn.php」が同行されているので、これを使えば良いが、設定ファイルの記述自体は単純であり、足りない言語の設定ファイルも簡単に自作することが出来る。

$l['a_meta_charset'] で文字コード、$l['a_meta_dir']で記述方向（左から右ならltr、右から左ならrtl）、$l['a_meta_language']で言語コード定義する。

そして、$l['w_page']では、「page」の訳を定義する。

下記は、UTF-8、日本語の場合の記述例である。

// Japanese

global $l;
$l = Array();

// PAGE META DESCRIPTORS --------------------------------------

$l['a_meta_charset'] = 'UTF-8';
$l['a_meta_dir'] = 'ltr';
$l['a_meta_language'] = 'ja';

// TRANSLATIONS --------------------------------------
$l['w_page'] = 'ページ';

//============================================================+
// END OF FILE
//============================================================+

この設定ファイルは、最初にrequire_once()で読みこめば良い。

更にもう１つ、言語によって変更すべき要素があり、それがフォントである。

フォントは、setHeaderFont、setFooterFont、SetFont、SetDefaultMonospacedFontメソッドで指定する。

なお、SetDefaultMonospacedFontでは、プロポーショナルフォントを指定することは出来ず、等幅フォントを指定する必要がある。

標準の日本語フォントは、

• cid0jp（ArialUnicodeMS）
• kozgopromedium（Kozuka Gothic Pro）
• kozminproregular（Kozuka Mincho Pro）

の３つであるが、残念ながら文字化け等が発生するケースがある。

場合によっては、オープンソースのTrueType日本語フォントなどをTCPDF用に変換して、それを使った方が良いかもしれない。

バージョン5.9.123からは、TrueTypeフォントをTCPDF用に変換するためのメソッド、addTTFfont()が追加されたので、フォントの変換の際にはこれを利用する。

また、5.9.122以前に同梱されていたツールを使っても良い。

なお、このサイトでもオープンソースのIPAフォントと梅フォントをTCPDF用に変換したものを公開している。

TCPDFは、HTMLタグを解釈し、タグに従ってレイアウトを行った上でPDFに変換するが、全てのタグや属性を正しく解釈できる訳ではない。

また、通常ウェブサイトは、別途CSSを読み込んでレイアウトを行なっているが、このCSSがPDFに反映される訳でもない。（あくまでHTMLのみ解釈する。）

そのため、生成したPDFは、実際のウェブサイトとレイアウトが異なってしまう場合が多い。

必要であれば、HTMLにstyle属性を付加するなどして、微調整する必要がある。

PDFに変換される事を意識してHTMLを書くのも良いし、HTMLをそのままTCPDFに渡すのではなく、その前の段階で、HTMLをTCPDFに最適化させる処理を入れても良い。

拘れば、ここが最も面倒な作業になるだろう。

Ver.2.70 for EZ zenback modified 2.0　2012/01/28

最新の「Disqus Comment System for EZ zenback」をダウンロード

このバージョンは、リリース予定の「EZ zenback」（バージョン1.5.2を予定）に対応したバージョンであり、「EZ zenback」のユーザーは、事前にこのバージョンにアップデートして欲しい。

勿論、現行の「EZ zenback バージョン1.5」および過去のリリースも対応している。

「Disqus Comment System for EZ zenback Ver. 2.70 modified 2.0」は、「EZ zenback」との併用が前提となっているので、これ単体では使用しないこと。

Ver.0.3　2012/01/26

最新の「POST2PDF Converter」をダウンロード

「POST2PDF Converter」は、一度、変換されたPDFを保存せず、ダウンロードリンクがクリックされる度に、新たにPDFへの変換を行う方式を採用しており、この方法は、記事を変更した場合にも、リアルタイムでPDFにも反映されるというメリットがあるが、サーバーに負荷を掛けると言うデメリットもある。

このあたりは次のバージョンでの改善を考えているが、バージョン0.3では、この問題を解決する１つの手段として設定画面上で管理者が手動で記事をPDFに変換し、ダウンロード出来るようにした。

設定画面で作成したPDFファイルに、記事に任意の場所でリンクを貼れば、サーバーに負荷を掛ける事なく、記事をPDF形式でダウンロード出来るようになる。

また、「POST2PDF Converter」がPDF作成のために利用してる「TCPDF」は、PC用のTrueTypeフォントを直接フォントとして使用することが出来ず、予め変換を行う必要があるが、バージョン0.3では、この変換作業を設定画面上で行うこと出来るようになった。

変換できるフォントは、TrueTypeフォント、OpenTypeフォント、Type1フォントなどである。

なお、変換テストは、TrueTypeフォントでしか行なっていない。

TCPDF用フォントへの変換は、プログラムの改変する行為であり、またPDFで使用すると言うことは、広く一般に配布されるドキュメントでフォントを埋め込む事を意味する。

そのため、変換が許されるフォントは、ライセンス上、改変が許され、PDFの埋め込みフォントとして利用でき、作成したPDFの配布が許されているフォントに限られる。

現実的は、オープンソースのフォントや自作のフォントに限られるだろう。

変換後のフォントを再配布する場合も、ラインセンス上、問題がないか確認すること。

WordPressの翻訳系プラグインでも広く使われていたAPIであるので、WordPressへの影響は大きく、これを機に開発を終了してしまったプラグインや、公開されてはいるものの動作しないプラグインが出てきている状況である。

実際、私が使っていたWordPressプラグイン「Gtranslate」も「Google Translate API v1」を使っていたため、機能しなくなった。

また、WordPressプラグインではないが、このブログの下に表示される多機能ツールバー「Wibiya」の翻訳サービス「iTranslation」も同様の理由で機能しなくなってしまった。

そのため、代わりのプラグイン、サービスを探す必要が生じた。

APIが公開されている翻訳サービスは数多くあるようであるが、日本語に対応し、対応言語（翻訳可能な言語）が多く、使いやすく、サービスが継続されそうなものとなると殆ど皆無で、「Bing Translator」の「Microsoft Translator API」が良さそうである。

ただし、「Google Translate API v1」と比べると対応言語が37と少ないなど、機能面で見劣りすることは否めないが・・・。

そこで「Microsoft Translator API」をサポートするWordPressプラグインを探してみたが、多くのプラグインが「Google Translate API」を採用しており、予想外に見つからない。

それだけ「Google Translate API」が優れているということだろうが、私が探した範囲では、「Transposh Translation Filter」が、唯一「Microsoft Translator API」を採用し、まともに使えるプラグインだった。

厳密に言えば、「Transposh Translation Filter」は、「Google Translate API」と「Microsoft Translator API」の両方をサポートしており、「Microsoft Translator API」を使うなら、37の言語、日本語を除いて実質36の言語への翻訳が可能である。

設定画面上で、言語の有効化／無効化を行うが、言語と対応するAPIも分かりやすい。

ただし、言語名の表記が、その言語でされているため、何の言語なのか分からないという難点がある。

言語の選択を行うウィジェットを追加できる他、ブラウザの言語に応じて、予め翻訳済みの記事を自動表示するように設定することも出来る。

実際に「WordPressのショートコードAPI」を英語に翻訳してみると・・・

本文だけでなく、タイトル、メニューのラベル、カレンダーと言ったかなり細かなところまで翻訳されていることが分かる。

このプラグインの最大の特徴は、「Google Translate API」と「Microsoft Translator API」を利用した自動翻訳機能を備えながらも、サイトの訪問者などに翻訳して貰う機能を備えている点である。

サイトの訪問者は、自動翻訳による訳文に気に入らない部分があれば、そこを簡単に修正することが出来る。

これを利用すれば、人の手による翻訳で翻訳の精度を上げることが出来るが、もっとも、これは訪問者の協力が得られればの話である。

設定にもよるが、自動翻訳、または人の手による翻訳によって作られた訳文はデータベースに保存されるようで、翻訳の度に必ずしもAPIにアクセスするわけではないようである。

設定項目は多く、細かな設定が出来るプラグインであるが、基本的には、最初の「Supported languages」の設定さえ行えば、問題なく使えるはずだ。

ただし、「wp-config.php」で、$_SERVER['HTTP_ACCEPT_LANGUAGE']を使って定数「WPLANG」の設定を振り分けてローケルを切り替えている場合は、「Enable override for default locale」を無効にしないと、管理画面の表示が思わぬ結果になる。

ちなみに、今のところ、WordPressの翻訳系プラグインは選択肢不足の状況にあるので、もし、人気のプラグインを作りたいなら、翻訳系のプラグインは狙い目かもしれない。

これは、昨年末より「Plugin Directory」がバナーの表示をサポートしたからであり、これに関する記事が「WordPress Development Updates」にMattの手で書かれている。

バナーを表示させるだけでも随分と見栄えが良くなり、プラグインの機能を端的に伝える事も出来る。

プラグインを開発し、「Plugin Directory」で公開しているなら、ぜひバナーを設置したい。

以下、バナーを表示させる方法をまとめる。

1. まず、横772ピクセル、縦250ピクセルの画像を用意する。画像はjpegかpng形式でなければならない。ファイル名は、「banner-772x250.jpg」、または「banner-772x250.png」とすること。
2. 続いて、「assets」というディレクトリを、SVNのルートの作成し、その中に作成した画像を入れてアップロードする。（ローカルで作成して、単にコミットすれば良い。）「assets」の作成場所は「trunk」の中ではない事に注意。

以上で、暫くするとバナーが表示されるはずである。

これらの情報は、「Developer FAQ」にも書かれており、ここを読むと更に面白いことが出来ることに気づく。

?banner_url=画像のURL

というパラメーターをプラグインページのURLに付加することで、指定した画像をバナーに使用して、プラグインページを表示させることが出来る。

以下のURLは、同じプラグインページへのURLであるが、パラメーターによるバナー画像の指定で、バナーが変化することが分かる。

http://wordpress.org/extend/plugins/wp-syntaxhighlighter/

http://wordpress.org/extend/plugins/wp-syntaxhighlighter/?banner_url=http://plugins.svn.wordpress.org/wp-wapuu-widget/assets/banner-772×250.png

※URL中の「×」が全角で表示されているが、正しくは半角。

Ver.0.5　2012/01/12

最新の「CodeMirror for CodeEditor」をダウンロード

バージョン0.5では内包する「CodeMirror」ライブラリをアップデートしている。

新機能としては、タブをマーカーで表示して、タブによるインデントを見えるようにする機能が追加された。

また、検索、置換機能が新しくなり、キー操作によって必要な時だけ表示するタイプに変わった。

そのためツールバーは、以前のバージョンに比べてすっきりしている。

例えば、検索機能は、CtrlとFキーの同時押しで起動する。（または、CmdとFキー）

その他の操作は下記の通り。

• 下候補：CtrlとGキーを同時に押す。（または、CmdとGキー）
• 上候補：Shift、CtrlとGキーを同時に押す。（または、Shift、CmdとGキー）
• 置換：Shift、CtrlとFキーを同時に押す。（または、Cmd、OptionとFキー）
• 全置換：Shift、CtrlとRキーを同時に押す。（または、Shift、Cmd、OptionとFキー）

ただし、フルスクリーンモードでは、検索、置換機能が使えなくなった。

配列は、格納する値同士の紐付けが容易であるため、重宝する場面が多く、出番も多いので必ずマスターしておく必要がある。

私の場合、それほど多用するわけではないが、設定パラメーターを格納する際には、よく配列を用いている。

配列の定義

例えば、年齢を変数に格納するとしよう。

複数の年齢を格納する場合は、今まで学んだ知識の範囲でこれを記述するとなると、

<?php
$age1 = 13;
$age2 = 25;
$age3 = 46;
?>

のように複数の変数を定義する必要がある。

値の数が少ない場合は、上記のような定義も悪くはないが、値の数が1,000個、10,000個となると、定義すべき変数の数が膨大になり、非常に効率が悪い。

しかし、配列を用いれば、複数の値を１つの変数に格納することが出来る。

実際に配列を使って定義すると以下のようになる。

<?php
$age[0] = 13;
$age[1] = 25;
$age[2] = 46;
?>

上記の例では、１つの変数と言うことも出来る配列$ageに全ての構成要素が格納されている。

配列と言っても通常の変数と書式に違いはないが、配列に格納される各要素（値）を定義する場合は、角括弧構文を用いて[キー]を指定する必要がある。

<?php
$変数名[キー1] = 値1;
$変数名[キー2] = 値2;
$変数名[キー3] = 値3;
?>

「キー」と「値」は、必ずペアになっており、「キー」に紐付けられた「値」を配列の要素と呼ぶ。

「要素」は「値」が住んでいる部屋で、そのルームナンバーが「キー」と理解すると良いだろう。

配列から値を取り出したい場合も、ルームナンバーである「キー」を使って取り出すことが出来る。

値としては、通常の変数同様に、整数値、浮動小数点、文字列、論理値、NULLが格納できる他、配列を格納することも出来る。

配列を格納する配列を、多次元配列と呼ぶが、これについては後ほど説明する。

以下の例では、配列$ageを定義し、$ageからキー「1」の値を取り出してecho()で表示させている。

<?php
$age[0] = 13;
$age[1] = 25;
$age[2] = 46;

echo $age[1];
?>

以上のように、特定の値を取り出す場合にも角括弧構文を用いて、キーで指定する。

キーに0から始まる整数値を使う場合は、下記のように角括弧構文の中のキーを省略して定義することも出来る。

<?php
$age[] = 13;
$age[] = 25;
$age[] = 46;

echo $age[1];
?>

上記の例では、キーは省略されているもの、各要素には先頭から順に0、1、２・・・と言った整数値がキーとして与えられており、「25」と表示される。

また、配列は角括弧構文以外でも定義でき、配列の定義のために用意されているarray()関数を使って配列を定義することも出来る。

<?php
$age = array(13, 25, 46);
?>

キーは、省略されているが、この場合も、各要素には0から始まる整数値のキーが自動的に割り当てられる。

明示的にキーを書くならば、下記のようになる。

<?php
$age = array(0 => 13, 1 => 25, 2 => 46);
?>

array()関数を用いる場合は、演算子「=>」を使って、キーと値の関係を記述し、要素を定義できる。

また、explode()関数を使えば、特定の文字で区切られた文字列を配列に格納することが出来る。

<?php
$str_age = "13,25,46";
$age = explode(",", $str_age);

echo $age[1];
?>

上記の例では、「,」を区切り文字として「,」で元の文字列を分解し、先頭から順に要素として格納している。結果、「25」と表示される。

その他、str_split()関数、preg_split()関数など、戻り値として配列を返す関数は、数多く有り、これらも配列の定義に利用することが出来る。

空の配列

array()関数を使って配列を定義し、下記のように引数を省略すれば、要素を持たない空の配列を定義することが出来る。

<?php
$var = array();

if ($var === NULL) {
	echo "NULLです。";
} else if (is_array($var)) {
	echo "配列です。";
}
?>

ただし、型としては配列であるため、型の違いまで考慮すれば、NULLとは本質的に異なる。

なお、is_array()関数は、変数が配列の場合はtrue、そうでない場合は、falseを返す。

予め空の配列を定義する行為に意味がないわけではなく、配列が要素を持たない場合にも、空の変数ではなく、空の配列として識別が可能であるため、例えば、条件分岐によって要素を与え、条件によっては、全く要素が追加されず、空になるケースが考えられる場合でも、型としては配列であり、それを判定することが出来る。

特に角括弧構文を用いて要素を定義し、配列を組み立てる場合は、１つ目の要素が定義されるまでは、仮に参照したとしても未定義の変数でしかないので、予め、空の配列として定義しておくと良い。

<?php
$age = array();
$age[0] = 13;
$age[1] = 25;
$age[2] = 46;

echo $age[1];
?>

些細な事ではあるが、空の変数と区別する場合は重要である。

配列全体を表示する

配列全体を表示させる処理を実際のプログラムの中で使うことは、少ないかもしれないが、デバッグ用に出力して配列の中身を確認する必要性が生じるケースは少なくないので、これも覚えておく必要がある。

しかし、下記の例は上手くいかない。

<?php
$age = array(13, 25, 46);

echo $age;
?>

それは単純にecho()関数が、キーを指定せずに配列全体を表示させることは出来ず、結果は「Array」と表示してしまうからである。

代わりにprint_r()関数、var_dump()関数、var_export()関数を使うと良い。

<?php
$age = array(13, 25, 46);

print_r($age);
?>

連想配列

「連想配列」と言っても特殊な配列ではなく、整数値ではなく、文字列をキーに持つ要素を格納する配列のことである。

<?php
$age['suzuki'] = 13;
$age['yamada'] = 25;
$age['tanaka'] = 46;
?>

や

<?php
$age = array('suzuki' => 13, 'yamada'=> 25, 'tanaka' => 46);
?>

が「連想配列」になる。

「キー」には、アルファベット、数字、アンダースコアを使うことが出来るが、最初の１文字はアルファベットかアンダースコアである必要がある。

このようにキーに文字列を使い意味を持たせることで、配列の意図がより分かりやすいものになる。

連想配列の場合も、角括弧構文を用いて、キーを指定して配列から値を取り出すことができる。

<?php
$age = array('suzuki' => 13, 'yamada'=> 25, 'tanaka' => 46);

echo $age['yamada'];
?>

多次元配列

多次元配列とは、値として配列を格納する多重構造の配列である。

値として配列を格納することで、より複雑なツリー構造を構築でき、構造自体は複雑になるかもしれないが、配列の持つ意味は、明示的なものであり、PHPのコードで考えるよりも構造を図示をした方理解しやすいかもしれない。

これまで例では、名前と年齢を紐付けた連想配列を作成したが、ここでは、加えて性別も格納するとする。

以下で、その構造を図示してみた。

• suzuki
• age：13
• sex：male
• yamada
• age：25
• sex：female
• tanaka
• age：46
• sex：male

黒四角が各要素の「キー」であり、黒丸が値になるが、値は複数あるので、それぞれの黒丸のペアも独立した配列になる。

つまり、連想配列の中で、名前に紐付けられた形で年齢と性別の連想配列を格納する。

ちなみに、これは二次元配列である。

以下、３つの方法で連想配列を定義してみた。

<?php
// array()関数を使わずに定義
$prof['suzuki']['age'] = 13;
$prof['suzuki']['sex'] = 'male';
$prof['yamada']['age'] = 25;
$prof['yamada']['sex'] = 'female';
$prof['tanaka']['age'] = 46;
$prof['tanaka']['sex'] = 'male';

echo $prof['yamada']['sex'];
?>

<?php
// 内包する配列のみarray()関数を使って定義
$prof['suzuki'] = array('age' => 13, 'sex' => 'male');
$prof['yamada'] = array('age' => 25, 'sex' => 'female');
$prof['tanaka'] = array('age' => 46, 'sex' => 'male');

echo $prof['yamada']['sex'];
?>

<?php
// 全てにarray()関数を使って定義
$prof = array(
	'suzuki' => array('age' => 13, 'sex' => 'male'),
	'yamada'=> array('age' => 25, 'sex' => 'female'),
	'tanaka' => array('age' => 46, 'sex' => 'male'),
);

echo $prof['yamada']['sex'];
?>

おそらく3番目の方法が一番分かりやすいだろう。

末端の値を取り出す場合も、一次元の配列同様に角括弧構文を用いて「キー」で指定する。

ただし、複数のキーを記述する必要がある。

以下のように書いても良いし、以下の例のほうが、その意味が分かりやすいかもしれない。

<?php
$val = $prof['yamada'];
echo $val['sex'];
?>

キーの自動付与

キーを省略した場合は、自動的に0から始まる整数値がキーとして与えられることは前にも書いたが、ここでは少し複雑な例を扱う。

下記の例では、最後の要素に与えられるキーはどのようになるだろうか？

<?php
$color[3] = 'black';
$color[11] = 'white';
$color[] = 'blue';
?>

答えは、「12」である。

上の例では、キーの最大値が11であるため、その続きとして12となる。

これは、次のようにarray()関数を用いた場合も同様である。

<?php
$color = array(3 => 'black', 11 => 'white', 'blue');
?>

配列の操作

ここでは、様々な配列の操作について学ぶ。PHPでは、配列を扱う関数が充実しており、配列に対して様々な処理を簡単に行うことが出来る。

ここでは、一部ではあるが、それらを紹介する。

次の例では、キーとして「2」が与えられている要素が2度定義されている。

<?php
$color[0] = 'black';
$color[1] = 'white';
$color[2] = 'blue';

$color[2] = 'red';

echo $color[2];
?>

上記の例では、最終的に「red」と表示される。

つまり、要素を定義し直すことで、配列の要素を上書き出来るのである。

また、要素を削除するにはunset()関数を使えば良い。

<?php
$color[0] = 'black';
$color[1] = 'white';
$color[2] = 'blue';

unset($color[2]);

print_r($color);
?>

list()関数を使えば、配列を分解し、指定した変数に代入し直すことが出来る。

<?php
$color = array('black', 'white', 'blue');
list($val1, $val2, $val3) = $color;

echo $val2;
?>

extract()関数は、キーを変数名とした変数に値を格納し、配列を個別の変数に分解してくれる。

<?php
$age = array('suzuki' => 13, 'yamada'=> 25, 'tanaka' => 46);
extract($age);

echo $yamada;
?>

配列に格納される要素の数を知りたいなら、count()関数を使うと良い。

<?php
$color = array('black', 'white', 'blue');

echo count($color);
?>

implode()は、指定した文字列で要素の値を結合した文字列を返す。以下の例では「,」で結合されて「black,white,blue」となる。

<?php
$color = array('black', 'white', 'blue');
$color_list = implode(",", $color);

echo $color_list;
?>

配列を値でソートする場合は、昇順ならsort()関数、降順ならrsort()関数を使えば良い。ただし、キーと値との関係は維持されない。

<?php
$color = array('black', 'white', 'blue');
sort($color);

print_r($color);
?>

また、連想配列を値でソートする場合は、昇順ならasort()関数、降順ならarsort()関数を使う。キーと値の関係は維持される。

<?php
$name = array('suzuki' => 'taro', 'yamada'=> 'ichiro', 'tanaka' => 'ai');

asort($name);

print_r($name);
?>

連想配列をキーでソートするならksort()関数、krsort()関数を使う。この場合も、キーと値の関係は維持される。

<?php
$name = array('suzuki' => 'taro', 'yamada'=> 'ichiro', 'tanaka' => 'ai');

ksort($name);

print_r($name);
?>

複数の配列をマージ（結合）するなら、array_merge()関数を使えば良い。

<?php
$name1 = array('suzuki', 'yamada', 'tanaka');
$name2 = array('yamamoto', 'takahashi', 'honda');

$new_array = array_merge($name1, $name2);

print_r($new_array);
?>

以上は一例であり、配列を処理できる関数は数多く存在する。

Ver.1.5　2012/01/05

最新の「EZ zenback」をダウンロードする

バージョン1.5では、zenbackを表示させる手段として、ショートコードをサポートした。

書式：[zenback]

上記のショートコードは、投稿や固定ページの本文で使うことが出来る。

ショートコードを使えば、投稿や固定ページの任意の場所で、zenbackを表示させる事ができ、特定の投稿や固定ページのみでzenbackを表示させたい場合も、ショートコードを使うことで対応できる。

今回は、このショートコードAPIの説明を行う。

ショートコードの登録には、add_shortcode()関数を使用する。

add_shortcode('ショートコードタグ', 'ハンドラー');

ショートコードは、

[ショートコードタグ]

と言った[]で文字列を囲んだ書式であるが、[]を除いたものを「ショートコードタグ」として記述し、「ハンドラー」には、ショートコードと置き換える文字列を戻り値として返す関数の名称を記述する。

例えば、「こんにちは」と表示されるショートコード [hi]を登録する場合は、

add_shortcode('hi', 'my_shortcode_handler');

function my_shortcode_handler() {
	return 'こんにちは';
}

と記述すれば良い。

非常に簡単にショートコードを登録できるようになっているが、内部的には、 do_shortcode()というフィルター関数が、add_shortcode()関数で登録された全てのショートコードハンドラーを使って文字列に変換する処理を行なっており、デフォルトでは、do_shortcode()関数は、the_contentフィルターフックにプライオリティ11で適用されている。

このフィルターによって、投稿や固定ページが表示される際に、ショートコードが決められた文字列に変換され、表示に反映される。

デフォルトでは、ショートコードが使えるのは投稿と固定ページの中だけであるが、他の場所でも使用したいなら、このdo_shortcode()関数を使えば良い。

例えば、コメントでショートコードを使いたいなら、

add_filter('comment_text', 'do_shortcode', 11);

とすれば良い。（プライオリティは11ある必要はない。）

以上がショートコードの登録の基本であるが、ショートコードAPIは、単純なショートコードだけなく、属性値を持つショートコードや囲み型のショートコードもサポートしている。

[ショートコードタグ attr1="値1" attr2="値2" ・・・]任意の文字列[/ショートコードタグ]

次の例は、属性値を持つ、囲み型のショートコードであり、[div id="id1" class="class1"]任意の文字列[/div]と言う書式のショートコードを<div id=”id1″ class=”class1″>任意の文字列<div>に変換してくれる。

add_shortcode('div', 'my_shortcode_handler');

function my_shortcode_handler($atts, $content = null) {
	extract(shortcode_atts(array(
		'id' => 'block',
		'class' => 'block',
		), $atts));

	return '<div id="'.esc_attr($id).'" class="'.esc_attr($class).'">'.do_shortcode($content).'</div>';
}

ハンドラーは、引数としてショートコードで囲まれた部分の文字列を受け取ることが出来る。

加えて、属性名をキー、属性値を値とする配列の形で、ショートコードの記述された全ての属性と属性値を引数として受け取ることが出来る。

しかし、ユーザーが入力する属性、属性値に関しては、何が含まれているか分からない。

そこで、無効な属性が含まれている場合は、これを取り除き、欠けている場合は、デフォルト値を与えて補う必要があるが、これを簡単に行うことができるのが、shortcode_atts()関数である。

上の例では、id、classのデフォルト属性値は「block」となっており、ショートコードで、idまたはclassが省略された場合は、この「block」が値として自動的に割り当てられる。

そして最終的には、extract()を使って属性名を名前とする変数に格納している。

これらの値を用いて、置き換えの文字列を定義し、これを戻り値として返しているが、受け取った属性値は、セキュリティ上も信頼できないので、そのまま出力することは避けたい。

そこで、戻り値として返す前にesc_attr()関数でエスケープしている。

また、$contentに対してdo_shortcode()を適用して、ショートコードに囲まれたショートコード、つまりネストされたショートコードも、ショートコードとして正しく処理されるようにしている。

前にも書いたがdo_shortcode()が、ショートコードを処理するフィルターそのものであるので、do_shortcode()を文字列に適用すれば、文字列内のショートコードが正しく処理される。上記の場合は、$contentに対して、これを行なっている。

Ver.0.2　2012/01/02

最新の「POST2PDF Converter」をダウンロード

バージョン0.2では、ショートコードをサポートし、ショートコードを使って、投稿や固定ページの任意の場所にPDFのダウンロードリンクを追加できるようにしている。

書式：[pdf]PDF形式でダウンロード[/pdf]

ショートコードを使えば、特定のページのみPDF形式でのダウンロードを許可すると言ったことが出来る。

また、様々な属性をサポートしており、ページごとに言語やフォントやロゴを変えたり、投稿IDを指定して、別のページをPDFとしてダウンロードさせることも可能だ。

書式：[pdf id="1643" lang="jpn" file="id" font="cid0jp" monospaced="cid0jp" fontsize="11" subsetting="1" ratio="1.35" header="1" logo="1" logo_file="my_logo.png" logo_width="45" wrap_title="1" footer="1" filters="1" shortcode="1" ffamily="0"]Click here to get a PDF[/pdf]

また、このバージョンからは、本文末に署名を表示できるようになった。
任意のテキストを署名として登録できるので、署名以外に、ラインセンス、メッセージなどの表示にも利用できる。

加えて、引用やソースコードが本文に含まれる場合、それを整形して表示する機能も追加され、PDFに変換された際に見やすくなっている。

WP SyntaxHighlighter、SyntaxHighlighter Evolved、Syntax Highlighter for WordPress、Syntax Highlighter CompressなどのSyntaxHighlighterベースのプラグイン用に書かれたソースコード、WP-Syntax、CodeColorer、WP-CodeBox、WP-SynHighlightなどのGeSHiベースのプラグイン用に書かれたソースコードがその対象となる。

設定画面の項目も増え、ヘッダー、フッターの表示/非表示、フィルターの有効化/無効化、長いタイトルの折り返しと言った機能を設定できるようになっている。

また、同梱しているTCPDFをバージョン5.9.142にアップデートしている。

Ver.0.1　2011/12/27

最新の「POST2PDF Converter」をダウンロード

「POST2PDF Converter」は、PHPライブラリ「TCPDF」を用いて、HTML形式のWordPressのコンテンツをPDFに変換し、ダウンロード出来るようにする。

このページの先頭にも、ダウンロードリンクがあるので、実際の動きを見たいなら試してみると良いだろう。

主な特徴は下記の通り。

• ダウンロードリンクの追加が簡単、かつ柔軟。
• PDFのダンロードに制限をかけることが可能。
• 様々な言語に対応し、言語に応じて最適化される（つもり）。
• PDFのフォントサイズの変更やフォントの指定が可能。
• ショートコードを処理するか削除するか選べる。
• Font subsettingサポートし、PDFのファイルサイズを抑えられる。

なお、「Font subsetting」は、フォントのうち、実際使われている文字だけをPDFに組み込むことで、フォントの組み込みによるPDFのファイルサイズの増大を抑えることが出来る機能であるが、PHPの処理としては負荷がかかる複雑な処理になる。

そのため、場合によっては、「Font subsetting」を無効化し、フォント全体を組み込んだ方が良いかもしれない。

「POST2PDF Converter」で使用している「TCPDF」は、現状、日本語で書かれたHTMLを上手くPDF化出来ず、一部の文字が表示されないなどの問題が発生する。

これは、搭載している日本語フォントが主な原因であるが、この問題を解決するために、別途、TCPDF用日本語フォント「RCJフォント for TCPDF」と「梅フォント for TCPDF」を公開している。

ファイルサイズの関係で、「RCJフォント for TCPDF」と「梅フォント for TCPDF」は「POST2PDF Converter」に同梱していないので、別途インストールして欲しい。

「Font subsetting」を無効化し、フォント全体を組み込むならファイルサイズが比較的小さい「梅フォント for TCPDF」が向いている。

バージョン003.03 2011/12/22

最新の「RCJフォント for TCPDF」をダウンロード

「TCPDF」は、テキストやHTMLをPDFファイルに変換するためのPHPライブラリであるが、標準のフォントでは、正しく日本語を表示できないなど、日本語環境（おそらくマルチバイト過環境全般）での利用に関して問題も多い。

そこで、オープンソースの日本語フォントである「IPAフォント」ベースに、TCPDF用に変換した「RCJフォント for TCPDF」を作成した。

パッケージには、「IPAゴシック」、「IPA Pゴシック」、「IPA明朝」、「IPA P明朝」と同等のフォントが収められている。

このフォントは、「/tcpdf/fonts/」ディレクトリにインストールして使うことができるが、PDFを受け取った相手が、同じフォント持っていなくとも編集出来るようにするには「FontSubsetting」を

setFontSubsetting(false)

に設定して使用する必要があるため、PDFファイルにフォント全体が組み込まれ、生成するPDFファイルのサイズが大きくなるという問題もある。

「RCJフォント」は、超マイナーなフォントであり、パッケージにソースとして収録はしているが、PDFを受け取った相手のPCに「RCJフォント」がインストールされている確率は皆無であり、そのためPDFにフォントを組み込む必要が生じる。

また、フォント自体のファイルサイズが小さくないため、PHPに割り当てられたメモリの上限が小さい場合は、PDFを正常に生成出来ないかもしれない。

その場合は「php.ini」を編集するなどして、割り当てるメモリの上限を増やす必要がある。

memory_limit = 64M

Ver.1.7　2011/12/15

最新の「WP SyntaxHighlighter」をダウンロード

バージョン1.7は、1.6.7に続くリリースとなるが、中身は、バージョンの数字以上に変化している。

まず、bbPress 2.0以上をサポートし、フォーラムのトピック、リプライに含まれるコードを強調表示できるようになった。

bbPressの投稿フォームには、コメント欄と同様にテキスト形式のリンクボタンを挿入できるようになっており、簡単にソースコードを強調表示させることが出来る。

また、過去のバージョンでは、ソースコードのマークアップに<pre>タグのみを用いていたが、バージョン1.7では、ショートコードもサポートした。

書式はWordPress.comで使われているショートコードと互換性がある。

[sourcecode language="php" gutter="true" firstline="1" highlight="" htmlscript="false"]PHP コード[/sourcecode]
[sourcecode lang="xhtml" gutter="true" firstline="1" highlight="" htmlscript="false"]XHTML コード[/sourcecode]

language（lang）以外の属性は、省略しても良い。language（lang）を省略するとプレーンテキストとして強調表示される。

設定にもよるが、ショートコードは、投稿の作成/編集画面、固定ページの作成/編集画面、コメントの投稿欄、管理画面上のコメントの編集/返信画面、「WP SyntaxHighlighter Widget」で使うことができる他、bbPressのトピック/リプライの投稿フォーム、トピック/リプライの編集フォーム、管理画面のトピック/リプライの作成/編集画面でも使用できる。

実は、より簡略な下記の書式のショートコードもサポートしているのだが、事実上、これらの書式は使えない。

[source language="php" gutter="true" firstline="1" highlight="" htmlscript="false"]PHP コード[/source]
[code lang="xhtml" gutter="true" firstline="1" highlight="" htmlscript="false"]XHTML コード[/code]

なぜならば、この書式を適切に処理できるフィルターを実装していないからだ。そのため、これらの書式を使おうと思うと面倒になる。仮に自身でコードをエスケープしたとしても低い権限しか与えられていないユーザーが投稿した場合は、ソースコードが壊れる場合がある。

そもそも「WP SyntaxHighlighter Widget」の場合は、手入力でのマークアップは想定していないので、多少長くともWordPress.comとの互換性を優先した形になっている。

ショートコードを有効にした状態で、本文中にこれらのショートコードを書くと、表示の際にタグに展開されてしまうので注意が必要だ。

それを避けたい場合は、下記のようにショートコードを「[]」で囲んでエスケープすること。

[[sourcecode language="php" gutter="true" firstline="1" highlight="" htmlscript="false"]PHP コード[/sourcecode]]
[[sourcecode lang="xhtml" gutter="true" firstline="1" highlight="" htmlscript="false"]XHTML コード[/sourcecode]]

例外として、<pre>タグで囲まれたショートコード（sourcecode、source、codeのみ）、つまり、ショートコードを含むソースコードを<pre>タグでマークアップした場合は、ショートコードをエスケープしなくとも、正常に処理されるようにしている。

ショートコードの導入に合わせて、コメント欄、WP SyntaxHighlighter Widget、bbPressの投稿フォームに追加されるテキスト形式のリンクボタンも強化され、<pre>タグだけでなく、ショートコードの挿入もサポートし、設定画面で切り替えることが出来るようになった。

過去のバージョンでは、投稿および固定ページにソースコードを記述することが許されたのは、「unfiltered_htm」権限を持つユーザー、つまりデフォルトのユーザーロールでは、管理者、編集者のみであったが、必要に応じて投稿者や寄稿者など、記事の投稿が許されているユーザー対して、ソースコードの記述を許可出来るようになった。

以上が目に見える機能面での主な新機能であるが、目に見えない部分でも変化している。

構成ファイルのうち、メインファイルが肥大して来たので、役割毎にファイルを分割し、処理を効率化している。

パフォーマンスを重視するなら、設定画面で不要な機能を無効化することをオススメする。

ただし、（過去のバージョンでも既に複雑であったが）設定画面は、我ながら、ここまで必要かと思うほど複雑になっているので、隅まで良く見た方が良い。

デフォルトでも、全てのユーザーが必要としていると思われない機能は、殆ど無効化されているが、設定の煩雑さを考慮して、敢えてデフォルトで有効になっている機能もある。

なお、デフォルトで有効になっている機能は、プラグインインストール時のWordPressのバージョンによっても異なる。

今後のリリースでも、設定画面に関しては、より複雑化する方向に向かうのではないかと思うわれるが、「設定しなくとも使え、設定することで、より幸せになれる」方向で開発を行うつもりであるため、頭が痛くなるようなら設定画面は見ない方が幸せかもしれない。

とは言え、以下の項目だけは、しっかり設定した方が良いだろう。

• 使用するライブラリ・・・２つのバージョンから選べるが、外観や機能も随分と異なったものになる。
• テーマ・・・外観を変えたいなら。
• ツールバー・・・強調表示されたソースコードの右上に表示される「?」やツールバーを消せる。
• デフォルトの言語・・・必要な言語だけに絞りこめば、ボタンをクリックした時に表示される言語も減るので操作しやすくなる。

コメントやウィジェットの処理を除き、過去のバージョンでは、WordPressのデフォルトフィルターに依存し、独自のフィルターの適用は避けてきたが、必要性に迫られて投稿や固定表示の投稿/編集時、および表示時に適用されるフィルターも追加している。

リリースから間もないが、既に人気プラグインとなっており、「Ultimate TinyMCE」も「TinyMCE Advanced」と並んで定番となりそうである。

「TinyMCE Advanced」が4行にわたって自由にアイコンを配置し、順序の変更や区切りの表示も柔軟に出来るのに対して、「Ultimate TinyMCE」は、デフォルトで表示される2行に加えて3行目、4行目に表示するボタンをチェックボックで選択する仕組みを採用している。

順番の変更は出来ない。単に表示/非表示が選べるだけである。

柔軟性を欠くものの、その分気軽さがあり、下記のように簡単にビジュアルエディターにボタンを追加できる。

また、ボタンを追加してくれる以外に、標準のボタンの機能拡張も行なってくれる。

下記は、拡張された「リンクの挿入/編集」ボタンである。

既存のボタンの拡張に関しては、個人的には不要なので、設定画面で選択出来るようになると有難い。

過去のバージョンでは、WordPressのインストールパスによっては、設定画面でアイコンが表示されないバグがあったが、バーッジョン1.5.6以降では、これも解消している。

また、バージョン1.5.7以降は、設定画面の日本語表示にも対応した。

ちなみに「TinyMCE Advanced」と「Ultimate TinyMCE」の共存はできない、エラーになるわけではないが、同時に有効化すると、ボタンの配置は「TinyMCE Advanced」の設定が優先され、一部のボタンは「Ultimate TinyMCE」のものと置き換わる。

しかし、条件分岐やループ処理などの制御構文を記述することで、初めて複雑なプログラミングが可能になる。

今回は「条件分岐」について説明する。

「条件分岐」とは、特定の条件を満たすか否か判定し、その結果に応じて処理を割り当てる制御構文である。

条件分岐には「if文」、「switch文」が使われる。

if文

「if文」とは、「もし～ならば、処理を実行する」といった意味を持つ構文である。

条件式の評価を行い、その条件が真（ture）であれば、処理を実行する。

<?php
if (条件式) {
	処理;
}
?>

下の例では、変数$colorが、「red」であれば、echo()関数が実行され、「Red」と表示される。

<?php
if ($color == "red") {
	echo "Red";
}
?>

if文では、「()」内に評価する条件式を記述し、対応する処理は「{}」内に記述する。

条件式の評価の部分で使われている「==」は、比較演算子と呼ばれる構文で、この場合は、左辺と右辺の値が等しいことを意味している。

「$colorがredと等しい」か否かの評価、つまり「$colorがred」であるか否かの評価を行なっている。

上記のif文は、条件式の評価が偽（false）である場合は、何も行わない、単一の条件の評価であるが、「else if文」を使えば、最初の「もし(if)　ならば」が偽であれば、「あるいは　ならば」といった別の評価を行うことが出来る。

下記の例では「$colorがred」である場合は、「echo “Red”;」実行して、if文を終了するが、「$colorがred」でない場合は、続いて「$colorがblue」か否かの評価が行われる。

<?php
if ($color == "red") {
	echo "Red";
} else if ($color == "blue") {
	echo "Blue";
}
?>

「else if」文は、下記のように複数回記述することも出来る。

<?php
if ($color == "red") {
	echo "Red";
} else if ($color == "blue") {
	echo "Blue";
} else if ($color == "black") {
	echo "Black";
}
?>

「else if」は、空白を空けずに「elseif」と書いても良い。

個人的には、「else if」と書く癖があるが、同様の構文を持つJavaスクリプトで「elseif」と書くべきところを、「else if」と書いて失敗することがある。

そう言った意味では「elseif」で覚えたほうが良いかもしれない。

更に、「else文」を使えば、いずれの条件式評価も偽となった場合の処理を記述することが出来る。

<?php
if ($color == "red") {
	echo "Red";
} else if ($color == "blue") {
	echo "Blue";
} else if ($color == "black") {
	echo "Black";
} else {
	echo "ERR: Unknown Color";
}
?>

意図して「else」を使わない場合もあるが、例外的な処理として「else」を記述した方が良いケースも少なくない。

例えば、次のケースでは、すべての条件式評価が偽の場合は、変数$stringは、未定義となるが、「else文」で例外的な場合の代入値を定義することも出来る。（予め、$stringのデフォルト値をif文の前で定義して、それを例外的な場合の値としても良い）

<?php
if ($color == "red") {
	$string = "Red";
} else if ($color == "blue") {
	$string = "Blue";
} else if ($color == "black") {
	$string = "Black";
}
?>

「else if文」や「else文」を組み合わせる場合は、if文の条件式は先頭から順に評価されることを意識しなければならない。

いずれかの条件式が真となった時点でif文は終了されるため、条件式の順序がまずいと、予想外の結果になる可能性がある。

下記は、今まで学んだ内容のみで組み立てたサンプルである。

現在の時間の「分」が偶数であれば、「もう、～です。」、奇数であれば「まだ、～です。」と表示する。

<!doctype html>
<?php echo '<?xml version="1.0" encoding="utf-8"?>'; ?>
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<html xmlns="http://www.w3.org/1999/xhtml" lang="ja" xml:lang="ja">
<head>
<meta http-equiv="Content-Type" content="text/html; charset=utf-8" />
<title>if文</title>
</head>
<body>
<?php
$min = date("i");
$min_remainder = $min % 2;
if ($min_remainder == 0) {
	echo "もう、".date("H:i:s")."です。";
} else {
	echo "まだ、".date("H:i:s")."です。";
}
?>
</body>
</html>

上記のスクリプトの実行結果を表示

比較演算子

比較演算子とは、左辺と右辺の値を比較するための構文である。

そして比較の結果が真であれば「true」、偽であれば「false」を返す。

「if文」の説明でも、条件式の記述に比較演算子「==」を使用しているので、大まかには理解できていることと思うが、条件式を記述するために比較演算子は欠かせない。

「==」は左辺と右辺が等しいか比較する演算子であるが、次の結果は予想できるだろうか？

<?php
$a = 1;
if ($a == "1") {
	echo "Yes";
} else {
	echo "No";
}
?>

変数$aは、整数「1」として定義されているが、if文では、文字列「1」と等しいか評価を行なっている。

型が異なるわけであるが、PHPでの型の扱いについては、何度が述べてきたので、おそらく予想出来ていたと思うが、このケースは、「Yes」と表示される。

つまり、「==」では型の違いは無視される。

厳密に言えば、整数と文字列の比較の場合は、文字列は、自動的に整数型に変換された上で比較される。

しかし、PHPでは、型の評価を行う比較演算子が用意されているので、型を含めた比較を行うことも出来る。

以下に、PHPで用いられる比較演算子をリストする。

• ==　・・・左辺と右辺の値が等しい。
• ===　・・・左辺と右辺の値と型が等しい。
• !=　・・・　左辺と右辺の値が等しくない。
• <>　・・・　左辺と右辺の値が等しくない。
• !==　・・・　左辺と右辺の値が等しくない、または型が等しくない。
• >　・・・　左辺が右辺より大きい。
• >=　・・・　左辺が右辺より大きい、または等しい。
• <　・・・　左辺が右辺より小さい・
• <=　・・・　左辺が右辺より小さい、または等しい。

以下のサンプルでは、様々な比較演算子をif文で使用してる。

<?php
if ($age >= 20) {
	echo "お酒、タバコが許されます。";
} else if ($age == 18) {
	echo "ようやく普通免許が取れますね。";
} else if ($age == 14) {
	echo "中二病の可能性があります。";
} else if ($age <= 12) {
	echo "運賃は、半額です。";
}
?>

論理演算子

「論理演算子」を使えば「AかつB」、「AまたはB」、「AかつB、またはAかつC」と言った条件を記述することが出来る。

つまり、複数の条件式を繋いで評価することが出来る。

PHPで用いられる論理演算子は下記のとおりである。

• 左辺　&&　右辺　・・・　左辺、右辺共に真。
• 左辺　and　右辺　・・・　左辺、右辺共に真。
• 左辺　||　右辺　・・・　少なくとも、左辺または右辺のどちらかが真。
• 左辺　or　右辺　・・・　少なくとも、左辺または右辺のどちらかが真。
• 左辺　xor　右辺　・・・左辺または右辺の一方が真。両方が真の場合は、偽を返す。
• !値（式）　・・・　値（式）が偽である。値（式）が偽の時に真を返す。

次の例では、「&&」を使って、年齢（変数$age）、性別（変数$sex）の両方が特定の条件を満たすか判定している。

<?php
if ($age >= 18 && $sex == "male") {
	echo "結婚できます。";
} else if ($age >= 16 && $sex == "female") {
	echo "結婚できます。";
} else {
	echo "結婚できません。";
}
?>

また、論理演算子は、算術演算子と同様に「()」を使うことで、評価の優先順位を変えることが出来る。

以下の例では、まず「()」内が真であることが条件となる。

<?php
if ($sex == "male" && ($age == 25 || $age == 42 || $age == 61)) {
	echo "厄年です。";
} else if ($sex == "female" && ($age == 19 || $age == 33 || $age == 37)) {
	echo "厄年です。";
} else {
	echo "厄年ではありません。";
}
?>

性別と年齢の両方が真であることが、条件式が真となる条件であるが、年齢に関しては、「()」内のいずれかを満たせば真となる。

if文のネストと「{}」の省略

if文は、次のように別のif文にネスト（入れ子）することも出来る。

<?php
if ($sex == "male") {
	if ($age == 25 || $age == 42 || $age == 61) {
		echo "厄年です。";
	} else {
		echo "厄年ではありません。";
	}
} else if ($sex == "female") {
	if ($age == 19 || $age == 33 || $age == 37) {
		echo "厄年です。";
	} else {
		echo "厄年ではありません。";
	}
}
?>

if文内の処理が1行で書ける場合は、次のように「{}」を省略することが出来る。

<?php
if ($age >= 20)
	echo "成人です。";
?>

if文での真偽の解釈と演算子を省略した条件式

if文は、条件式の比較演算子を省略し、次のように書くことも出来る。

<?php
if ($value) {
	echo "tureです。";
}
?>

これは次の式の省略形であるが、比較演算子が、型を無視する「==」である以上、話は単純ではない。

<?php
if ($value == true) {
	echo "tureです。";
}
?>

つまり、条件式が真となるのは、$valueにtrueが代入されている時だけとは限らない。

変数$valueが、整数の「0」、浮動小数点の「0.0」、空の文字列、文字列「”0″」、NULL以外の値を持つ時は、常に真となる。

他にも、変数が配列の場合やオブジェクトの場合も考慮する必要があるが、ここでは省略する。

上記の２つの例のような条件式であっても、変数の型が論理値であると確信できる場合は、変数に格納された値がtrueであることの判定に十分に使えるが、そうでない場合は、変数に何か値が格納されているたけで、条件式が真となる可能性があることを覚えておく必要がある。

場合よっては比較演算子に「===」を使うべきである。

また、比較演算子を省略し、条件式に変数のみを記述する方法は、変数が空である可能性を除き、0などの条件式が偽となる値が変数に格納されることがないと確信できるなら、変数に値が格納されているか否かの判定に使うことも出来る。

同様に、次のような省略も成立する。

if (!$value) {
	echo "tureです。";
}
?>

ここでは、論理演算子「!」を使用しており、「$valueが、trueでない」という意味になる。

if文では、必ずしも型を判定する比較演算子を使用する必要はなく、むしろ必要のない判定は省いた方が処理上もスマートであるが、変数に格納される可能性のある値を十分に把握しておかなければ、予想外の結果になる可能性がある。

switch文

switch文は、if文でも代用できるが、変数の値に応じて、処理を割り当てたい時などに適した構文である。

下記のように、case文やbreak文と組み合わせて使用する。

<?php
switch (式または変数){
	case 値1:
		式または変数が、値1と等しい場合の処理;
 		break;
	case 値2:
 		式または変数が、値2と等しい場合の処理;
		break;
	case 値3:
  		式または変数が、値3と等しい場合の処理;
		break;
	default:
		式または変数が、いずれの値とも等しくない場合の処理;
}
?>

「break」は、ループ（繰り返し）処理を抜けるための制御構造であり、条件に一致し、それに応じた処理が終了した時点で。switch文を終了するために記述している。

switch文は、if文と異なり、一度、いずれかの条件に一致しまうと、「break」が記述されている行まで、（case文の条件を無視して、本来、他の条件のための）処理の実行を継続してしまうため、「break」の記述が必要になる。

必要がなければ、「defaut」は省略しても良い。

次の例では、曜日が格納されている変数$dateの値に応じてメッセージを変えている。

<?php
switch ($date){
	case '月曜日':
		echo '休み明けは、ダルいですね。';
 		break;
	case '金曜日':
 		echo '明日からお休みです。';
		break;
	case '日曜日':
  		echo '明日から仕事です。';
		break;
	default:
		echo '今日も頑張りましょう。';
}
?>

以下の例では、複数の条件に、同じ処理を割り当てている。

<?php
switch ($country){
	case 'イギリス':
		echo 'ヨーロッパ';
 		break;
	case '日本':
  		echo 'アジア';
		break;
	case 'ドイツ':
 		echo 'ヨーロッパ';
		break;
	case '中国':
  		echo 'アジア';
		break;
}
?>

次は、「break」の記述を忘れた例である。

<?php
switch ($country){
	case 'イギリス':
		echo 'ヨーロッパ';
	case '日本':
  		echo 'アジア';
		break;
	case 'ドイツ':
 		echo 'ヨーロッパ';
		break;
	case '中国':
  		echo 'アジア';
		break;
}
?>

この場合、変数$countryの値が「イギリス」の場合、まず「ヨーロッパ」と表示し、「アジア」と表示した後に、「break」と出会って、switch文を終了する。

これを逆手に取れば、次のような処理を記述することも出来る。

<?php
switch ($country){
	case 'イギリス':
	case 'ドイツ':
 		echo 'ヨーロッパ';
		break;
	case '日本':
  		echo 'アジア';
		break;
	case '中国':
  		echo 'アジア';
		break;
}
?>

上での例では、変数$countryの値が、「イギリス」または「ドイツ」である場合に、「ヨーロッパ」と表示される。

三項演算子

「三項演算子」は、条件分岐を行う構文のように見えるが、演算子であり、条件に応じて式を返す。

条件に応じて処理を実行するif文、switch文とは本質的に異なる。

今まで学んだ演算子は、数学で言うところの２つの項を使用する「二項演算子」であるが、「三項演算子」は、唯一、３つの項を使用する演算子である。

個人的には、「三項演算子」は使わず、if文で記述することが多いが、知っておかないと、他の人が書いたプログラムを読めなくなってしまう。

「三項演算子」は、以下のようにシンプルに記述できる。

条件式 ? 式1 : 式2

条件式が真の場合は、「式1」を返し、偽の場合は「式2」を返す。

次の例では、返された式を変数$strに代入するように記述している。

変数$ageが20以上の場合は、「成人です。」を返し、変数$strに代入され、20未満の場合は、「未成年です。」が返されて変数$strに代入される。

<?php
$str = ($age >= 20) ? "成人です。" : "未成年です。";
echo $str;
?>

条件式を囲む「()」は省略しても良い。

<?php
$str = $age >= 20 ? "成人です。" : "未成年です。";
echo $str;
?>

以下のように記述した場合も、処理としては全く同じ結果となる。

<?php
echo $age >= 20 ? "成人です。" : "未成年です。";
?>

WordPressは、記事の作成、編集のために「ビジュアルエディター」と「HTMLエディター」の２つのエディターを備えており、操作を簡略化するために、それぞれ独自のボタンを配している。

「ビジュアルエディター」で表示されるボタンは、ビジュアルエディターのベースとなってるライブラリ、「TinyMCE」が標準で搭載してるボタンか、「TinyMCE」のプラグインとして導入されているものである。

また、「HTMLエディター」に表示されるボタンは「クイックタグ（Quicktag）」と呼ばれ、「ビジュアルエディター」のボタンとは異なるものである。

（現時点では、未だリリースされていないが）「WordPress 3.3」では、この「クイックタグ」の処理が変更されており、従来方法ではクイックタグを「HTMLエディター」に追加出来なくなってしまっている。

そのため、独自のクイックタグを追加するようなプラグインは、WordPress 3.3に合わせて修正しない限り、WordPress 3.3では、クイックタグが表示されないと言った問題が発生することが予想される。

この記事では、WordPress 3.3のHTMLエディターに独自のクイックタグを追加する方法を説明する。

下記は、<pre>タグ（および終了タグ</pre>）を入力するためのクイックタグを追加する場合の例である。

プラグインやfunctions.phpで記述すれば良い。

<?php

function add_my_quicktag() {
?>
	<script type="text/javascript">
	//QTags.addButton('ID', 'ボタンのラベル', '開始タグ', '終了タグ');
	QTags.addButton('ed_pretag', 'pre', '<pre>', '</pre>');
	</script>
<?php
}

add_action('admin_print_footer_scripts',  'add_my_quicktag');

?>

「ID」は任意のもの、「ボタンのラベル」には、ボタン上に表示したい文字を設定する。

「開始タグ」には、ボタンをクリックした時に、選択範囲の前に挿入されるタグを入力する。

「終了タグ」は、不要であれば省略することも出来る。

その他に、タイトル（title属性）、アクセスキー、プライオリティと言ったパラメーターを指定することも出来る。

詳しくは、

/wp-includes/js/quicktags.dev.js

のコメントを参照のこと。

上記の例は、単にタグを挿入するだけの処理であるが、より高度な処理を行うために、指定したJavaスクリプトの関数を実行させることもでき、この場合も、シンプルに記述することが出来る。

<?php

function add_my_quicktag() {
?>
	<script type="text/javascript">
	//QTags.addButton('ID', 'ボタンのラベル', 関数名);
	QTags.addButton('ed_saywordpress', 'Say WordPress', say_wordpress);
	function say_wordpress() {
		alert('WordPress');
	}
	</script>
<?php
}

add_action('admin_print_footer_scripts',  'add_my_quicktag');

?>

「関数名」は、クォーテーションで囲んではいけない。

また、「WordPress 3.3」では、「quicktags_settings」と言うフィルターフックが新しく追加されており、このフックを使えば、デフォルトで表示させるクイックタグを制御することが出来る。

標準では、デフォルトで表示されるクイックタグは、strong(b)、em(i)、link、block(b-quote)、del、ins、img、ul、ol、li、code、more、spell(lookup)、close（close tags）、fullscreenであるが、下記のように記述することで、これを変更することが出来る。

function default_quicktags($qtInit) {
	$qtInit['buttons'] = 'strong,em,link';
	return $qtInit;
}

add_filter('quicktags_settings', 'default_quicktags', 10, 1);

上記の例では、strong(b)、em(i)、linkがデフォルトで表示されるクイックタグとなる。

なお、デフォルトのクリックタグの指定は、最初に説明した方法で追加したクイックタグには影響を与えないので、デフォルトのボタンとして指定しなくとも表示される。

詳しくは、

/wp-includes/class-wp-editor.php

のeditor_settings()関数を参照のこと。

この演算子を使えば、足し算、引き算などの四則演算を行ったり、値の代入を行うことが出来る。

また、PHPのプログラムでは、ある条件を満たすか否かの判定、つまりは真偽（true、false）の判定を行うことが多いが、このような判定では「比較演算子」、「論理演算子」が欠かせない。

既に「初心者による初心者のためのPHP講座　第３回　文字列」で「文字列演算子」について触れ、「初心者による初心者のためのPHP講座　第４回　定数と変数」で「代入演算子」と「算術演算子」についても触れており、実際に使用しているが、それら以外にも演算子には様々な種類がある。

とは言え、復習的な部分も少なくない。

演算子は、必ず知っておく必要があるが、演算子だけ取り上げて学習するよりも、プログラムの中で実際に使った方が感覚的にも分かりやすいかもしれない。

具体的な使い方は、実際にプログラミングしながら覚えれば良い。

しかし、演算を行うための演算子という記述があることは、少なくとも覚えておこう。

算術演算子

単純な計算を行うための記述にであり、「5+3」、「2×3」の「+」や「×」に相当するもので、プログラミングの知識が無くとも、馴染みがあり、理解しやすいはずである。

PHPでは、以下の５つの四則演算子が用意されている。

+	足し算
-	引き算
*	掛け算
/	割り算
%	割り算の余りを求める

下記は、算術演算子を使ったサンプルである。

<!doctype html>
<?php echo '<?xml version="1.0" encoding="utf-8"?>'; ?>
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<html xmlns="http://www.w3.org/1999/xhtml" lang="ja" xml:lang="ja">
<head>
<meta http-equiv="Content-Type" content="text/html; charset=utf-8" />
<title>四則演算子</title>
</head>
<body>
<?php
$cal1 = 8 + 3;	// 8と3の足し算。$cal1には整数11が代入される。
$cal2 = 8 - 3;	// 8から3を引く。$cal2には整数5が代入される。
$cal3 = 8 * 3;	// 8に3を掛ける。$cal3には整数24が代入される。
$cal4 = 8 / 3;	// 8を3で割る。$cal4には浮動小数点2.66666666667が代入される。
$cal5 = 8 % 3;	// 8割る3の余り。$cal3には整数2が代入される。
echo "8 ＋ 3 ＝ ".$cal1."<br />";
echo "8 － 3 ＝ ".$cal2."<br />";
echo "8 × 3 ＝ ".$cal3."<br />";
echo "8 ÷ 3 ＝ ".$cal4."<br />";
echo "8 ÷ 3の余りは ".$cal5."<br />";
echo $cal3." － ".$cal1." ＝ ".($cal3 - $cal1); // 変数同士の演算
?>
</body>

上記のスクリプトの実行結果を表示

算術演算子では単純な計算しか出来ないが、高度な演算については関数が用意されているので、それらを使えば良い。

例えば、指数演算を行うpow()関数、サインを求めるsin()関数などがある。

演算子「+」は、算術演算子としてだけでなく、配列演算子として配列の結合に使われる場合もある。

文字列演算子

文字列を連結する際に使用する演算子「.」を指す。

「.」で接続された文字列（変数）は、左の文字列の後ろに右の文字列を加える形で１つに連結される。

"東京"."都"		// 東京都となる

代入演算子

代入演算子は右辺の値を左辺の代入する「=」が基本となるが、 算術演算子や文字列演算子と組み合わせて、より複雑な値の代入を行うことが出来る。

=		// 左辺に右辺を代入
+=		// 左辺に右辺を加えた数を左辺に代入
-=		// 左辺から右辺を引いた数を左辺に代入
*=		// 左辺に右辺を掛けた数を左辺に代入
/=		// 左辺を右辺で割った数を左辺に代入
%=		// 左辺を右辺で割った余りを左辺に代入
.=		// 左辺に右辺を連結した値を左辺に代入

加算子、減算子

加算子、減算子とは、値を１つ増やしたり、１つ減らしたりする演算子の事である。

$a++	// $a += 1と同じ
$a--	// $a -= 1と同じ

以下の例では、変数$aの値を加算子、減算子で増減させている。

<?php
$a = 0;
$a++;		// 1加算されて$aの値は1になる
echo $a."<br />";
$a--;		// 1減算されて$aの値は0になる
echo $a;
?>

下記のように変数の前に「++」、「–」を配置しても良い。

<?php
$a = 0;
++$a;		// 1加算されて$aの値は1になる
echo $a."<br />";
--$a;		// 1減算されて$aの値は0になる
echo $a;
?>

厳密に言えば「$a++」と「++$a」、「$a–」と「$a++」では内部処理が異なる。

「++」または「–」を変数の後に記述した場合は、まず、元の変数の値を返してから加算、減算が行われる。

それに対して、変数の前に記述した場合は、最初に加算、減算が行われ、その結果を変数の値として返す。

次のサンプルでは、その違いがはっきりと結果に現れている。

<!doctype html>
<?php echo '<?xml version="1.0" encoding="utf-8"?>'; ?>
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<html xmlns="http://www.w3.org/1999/xhtml" lang="ja" xml:lang="ja">
<head>
<meta http-equiv="Content-Type" content="text/html; charset=utf-8" />
<title>加算子、減算子</title>
</head>
<body>
<?php
$a = 0;
$b = 0;
echo '++$aは '.++$a."です。<br />";
echo '$aは '.$a." です。<br />";
echo '$b++は '.$b++." です。<br />";
echo '$bは '.$b." です。";
?>
</body>
</html>

上記のスクリプトの実行結果を表示

その他の演算子

「比較演算子」、「論理演算子」もよく使用する演算子であるが、これらは別の機会に説明する。

演算子の優先順位

演算子には、演算の優先順位がある。

例えば「*」、「/」、「%」は、「+」、「-」より優先して演算される。

つまり、掛け算、割り算は、足し算、引き算よりも優先されると言うことだが、これは数学上の数式と同じである。

意図して優先順位を変える場合は、数学同様に「()」を使えば良い。

<?php
echo 1 + 3 * 5;		// 16になる
echo "<br />";
echo (1 + 3) * 5;	// 20になる
?>

演算と型

変数等の値を考える場合、その型を意識する必要がる。

基本的に同じ型同士でなければ演算できないが、都度、型を変換する必要がないように自動的に型の変換が行われるようになっている。

<!doctype html>
<?php echo '<?xml version="1.0" encoding="utf-8"?>'; ?>
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<html xmlns="http://www.w3.org/1999/xhtml" lang="ja" xml:lang="ja">
<head>
<meta http-equiv="Content-Type" content="text/html; charset=utf-8" />
<title>演算と型</title>
</head>
<body>
<?php
echo "2" + "3.3";
echo "<br />";
echo "2a" + "3";
echo "<br />";
echo "a2" + "3";
echo "<br />";
echo "2.3b" + "3b";
echo "<br />";
echo "a" + "3";
?>
</body>
</html>

上記のスクリプトの実行結果を表示

「整数」と「浮動小数点」の演算では、「整数」が「浮動小数点」に変換された後に演算が行われ、演算結果の型は、「浮動小数点」となる。

変わったところでは、文字列と数値、文字列同士の演算も成立する。

文字列が数字で始まる場合、始まりの数字の部分が値として使われ演算される。

文字列が数字で始まらない場合は、整数の0として扱われる。

このプラグインは、どちらかと言えば後発で、機能も非常にシンプルであるが、既にかなりの人気を獲得している。

「Facebook, Twitter & Google+ Social Widgets」で追加できるボタンは、「Facebook いいね！」、「ツイート」、「Google+」の3つに限られており、この３つのボタンのうち、選択したものを単に横並びに記事に表示するだけである。

しかし、この３つのボタンは、世界中で人気のサービスであり、ある意味、的を得た選択と言える。

「Facebook, Twitter & Google+ Social Widgets」は、単に有効化するだけでも使えるが、表示に関して細かな設定でき、このあたりも人気の秘密だろう。

まず、ボタンの順序を自由に入れ替えることが出来る。

また、ボタンを表示するページを次から複数選択することが出来る。

• 投稿
• 固定ページ
• ホーム
• カテゴリーページ
• タグページ
• タクソノミーページ
• 日付別ページ
• 作成者ページ
• 検索結果
• 添付ファイルページ

加えて、ページ内でのボタンの表示位置が指定でき、「投稿の上」、「投稿の下」、または「両方」に表示させることが出来る。

なお、このプラグインの作者は、以前、「WP SyntaxHighlighter」用にとDOSバッチファイル用のBrushファイルを作成してくれた方である。

参考：SyntaxHighlighter用のBrushファイル「DOS バッチファイル」

Ver.0.2　2011/11/03

最新の「TinyMCE Backslash Button」をダウンロードする

バージョン0.2では、HTMLエディター上でもフォントの指定付きでバックスラッシュを入力出来るQuicKtagを追加した。

これによって、ビジュアルエディター、HTMLエディターの両方でバックスラッシュの入力が可能になった。

Ver.1.6　2011/11/02

最新の「WP SyntaxHighlighter」をダウンロード

「WP SyntaxHighlighter」は、基本的に標準のビジュアルエディターの使用を想定したものであり、HTMLエディターを主に利用しているユーザーにとっては使い易いとは言えなかった。

バージョン1.6では、ソースコードをエースケープし、<pre>でマークアップして強調表示の対象とできるQuicktag（ボタン）「SH pre」をHTMLエディターに追加した。

これにより、HTMLエディターでのソースコード記述が大幅に楽になっている。

「SH pre」ボタンの基本的な操作は、TinyMCEの「pre」ボタンを同じである。

ただし、タグの編集が出来るHTMLエディターのボタンであることもあり、「pre」ボタンと異なり、設定値の変更機能は備えていない。

また、一度「SH pre」ボタンで処理したソースコードは、特殊な文字がエスケープされて表示されるため、見かけ上、元々のソースコードとは、異なった表示となってしまう。

定数、変数とは、「初心者による初心者のためのPHP講座　第３回　文字列」で学んだ文字列などの値を格納しておく箱のようなもので、命令文の中などで箱から値を取り出して使うことが出来る。

定数

定数とは変わることない不変の値、不変の値を格納する箱を指し、define()関数を使って以下のように定義する。

define("定数名", 値);

定数名には、アルファベット、数字、アンダースコアを使うことが出来るが、最初の１文字はアルファベットかアンダースコアである必要がある。

また、特別な引数を設定しない限り、アルファベットの大文字と小文字は区別され、別のものとして扱われる。

定義した定数に格納された値は、定数名で取り出すことが出来る。

難しいことを考えるよりも、実際にサンプルを見たほうが理解が早いだろう。

以下のサンプルでは、echo()関数と組み合わせて定数を使用している。

<!doctype html>
<?php echo '<?xml version="1.0" encoding="utf-8"?>'; ?>
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<html xmlns="http://www.w3.org/1999/xhtml" lang="ja" xml:lang="ja">
<head>
<meta http-equiv="Content-Type" content="text/html; charset=utf-8" />
<title>定数</title>
</head>
<body>
<?php
define("VALUE1", 100);
define("VALUE2", "100");
define("VALUE3", "こんにちは");
echo VALUE1."<br />";
echo VALUE2."<br />";
echo VALUE3."<br />";
echo VALUE1."円"."<br />";
echo VALUE3."。 この商品は".VALUE1."円です。";
?>
</body>
</html>

上記のスクリプトの実行結果を表示

定数に文字列を格納する場合は、前回学んだ通り「”」や「’」で囲む必要がある。

数値を格納する場合は、「”」や「’」で囲む必要はないが、文字列として数字を扱う場合は、「”」や「’」で囲む必要がある。

例えば「”1″」と「1」は、それぞれ文字列と数値であり、プログラミング上では、本来は別物であり、区別されるべきものだが、PHPでも区別はあるものの、その区別が曖昧である。

この事は、変数の説明の際に再度述べる。

定数は、何度でも呼び出して使用することができ、一度、定数を定義してしまえば、後は定数として呼び出すだけで良いので、都度、値を記述するより遥かに楽であるし、ミスも起こりにくくなる。

実際、上記のサンプルでも定数「VALUE1」、「VALUE3」は、2度以上使われている。

文字列の連結同様に「.」を使って、定数や文字列と連結することも出来る。

定数は、不変の値を考えるよりも、一度定義したら変更が効かない値と考えたほうが分かりやすいかもしれない。

つまり、箱の中身を取り出すことは出来ても、入れ替えることは出来ない。

定義した後で値を変更する必要がなく、繰り返し使う可能性がある値は、定数として定義すると良いだろう。

変数

変数とは、変化する可能性がある値を格納する箱のようなものである。

定数が、一度定義したら値の変更が出来ないのに対して、変数は、何度でも値を変更することが許されている。

つまり、箱の中身を自由に入れ替えることが出来る。

変数の定義は、定数と異なり関数を使う必要がなく、非常にシンプルである。

$変数名;
$変数名 = 値;

「$」が変数であることを表し、空の変数を定義するなら単に「$変数名」と宣言すれば良いし、何かしらの値を代入した変数を定義するなら「代入演算子」である「=」を使って値を代入した形で変数を定義すれば良い。

値の代入の有無は別として、この要領で変数を宣言をした時点で変数は初期化され、値が格納される。（値を代入していない場合は、空の値が格納される。）

このあたりは、数学の代入と要領は同じである。

変数名には、アルファベット、数字、アンダースコアを使うことが出来るが、最初の１文字はアルファベットかアンダースコアである必要がある。

また、アルファベットの大文字と小文字は区別され、別のものとして扱われる。

「$$value」のように変数名に変数を使う使うことも出来るが、ここでは説明を省く。

では実際にサンプルを見てみよう。

<!doctype html>
<?php echo '<?xml version="1.0" encoding="utf-8"?>'; ?>
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<html xmlns="http://www.w3.org/1999/xhtml" lang="ja" xml:lang="ja">
<head>
<meta http-equiv="Content-Type" content="text/html; charset=utf-8" />
<title>定数</title>
</head>
<body>
<?php
$value;
$price = 2000;
$birthday = "19970903";
$comment = "こんにちは。";
define("VALUE1", "おはよう。");
echo "値は「".$value."」です。<br />";
echo $price."<br />";
echo $birthday."<br />";
echo $comment."<br />";
echo $comment." この商品は".$price."円です。<br />";
echo VALUE1." この商品は".$price."円です。<br />";
$value = "ありがとう";
echo "値は「".$value."」です。";
?>
</body>
</html>

上記のスクリプトの実行結果を表示

定数同様に、文字列と数値の区別があり、文字列を変数に代入する場合は、「”」や「’」を使う必要がある。

「.」を使って文字列や定数と連結することも出来る。

変数「$value」をecho()関数でブラウザに表示した結果が、16行目と23行目では異なっているが、16行目の時点では、$valueは空であり、22行目で初めて文字列を格納しているためである。

このように変数に格納された値は、再度、値を代入する形で容易に変更できる。

値の代入の応用

変数に変数を代入したり、関数の戻り値を代入することも可能である。

<?php
$today = date("Y/m/d");
$message = "今日は".$today."です。";
?>

このサンプルでは、 date()関数の戻り値、つまりは現在の日付を変数「$today」に代入している。

更に変数「$today」は、変数「$message」に代入されている。

代入演算子「=」以外にも、「+=」、「 -=」、「*=」、「/=」、「%=」、「.=」と言った代入演算子を使用することができる。

<!doctype html>
<?php echo '<?xml version="1.0" encoding="utf-8"?>'; ?>
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<html xmlns="http://www.w3.org/1999/xhtml" lang="ja" xml:lang="ja">
<head>
<meta http-equiv="Content-Type" content="text/html; charset=utf-8" />
<title>様々な代入演算子</title>
</head>
<body>
<?php
$num1 = 8;
$num1 += 5;
$num2 = 1000;
$num2 -= 500;
$num3 = 3;
$num3 *= 4;
$num4 = 21;
$num4 /= 7;
$num5 = 17;
$num5 %= 5;
$str1 = "鈴木";
$str1 .= "さん";
echo $num1."<br />";
echo $num2."<br />";
echo $num3."<br />";
echo $num4."<br />";
echo $num5."<br />";
echo $str1;
?>
</body>
</html>

上記のスクリプトの実行結果を表示

上記のサンプルで使われている演算子のうち「.」は、文字列、定数、変数の連結で学んでいるが、その他は、下記のとおりである。

• +　・・・足し算
• -　・・・引き算
• *　・・・掛け算
• /　・・・割り算
• %　・・・割り算の余りを求める

上記のサンプルは、下記と同じ意味であり、下記のような記述の方が理解しやすいだろう。

<!doctype html>
<?php echo '<?xml version="1.0" encoding="utf-8"?>'; ?>
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<html xmlns="http://www.w3.org/1999/xhtml" lang="ja" xml:lang="ja">
<head>
<meta http-equiv="Content-Type" content="text/html; charset=utf-8" />
<title>様々な代入演算子</title>
</head>
<body>
<?php
$num1 = 8;
$num1 = $num1 + 5;
$num2 = 1000;
$num2 = $num2 - 500;
$num3 = 3;
$num3 = $num3 * 4;
$num4 = 21;
$num4 = $num4 / 7;
$num5 = 17;
$num5 = $num5 % 5;
$str1 = "鈴木";
$str1 = $str1."さん";
echo $num1."<br />";
echo $num2."<br />";
echo $num3."<br />";
echo $num4."<br />";
echo $num5."<br />";
echo $str1;
?>
</body>
</html>

定義済み変数

PHPでは、予め定義された変数がある。

つまり、自分で値を代入する必要がなく、何もしなくとも予め値が格納されており、自由に値を取り出して使うことが出来る変数である。

「$_SERVER」、「$_GET」、「$_POST」、「$_COOKIE」などがそうであるが、これらについては、実際に使う機会に詳しく説明する。

これらは「スコープ」を無視して使えることから、「スーパーグローバル変数」と呼ばれている。

※「スコープ」については別の機会に説明する。

参照渡し

次のサンプルでは$aと$bは実質的に同じ意味を持つ。

つまりどちらの値は「100」である。

<?php
$a = 100;
$b = $a;
?>

では、次のプログラムの実行結果はどうなるだろうか？

<?php
$a = 100;
$b = $a;
$a = 200;
echo $b;
?>

「100」と表示されるという予想と「200」と表示される予想の２つの予想が成り立つのではないかと思うが、答えは「100」である。

$aとSbは、値こそ同じかもしれないが、全く別の変数であり、$bが定義された時点で「100」が代入されており、$bを定義し直さない限り、$bの値を変えることは出来ない。

では、次のサンプルの結果はどうなるだろうか？

<?php
$a = 100;
$b = &$a;
$a = 200;
echo $b;
?>

答えは「200」である。

3行目の$bに$aを代入する式で「$a」の前に「&」を付けて「&$a」としているが、こうすることによって、後に$aの値が変わった際に、$bにも反映されるようになる。

これを「参照渡し」と呼ぶ。

変数の型

ここまでの説明から、変数の値には、文字列と数値があることに気づいたと思うが、実際、様々な種類の値を変数に格納することが出来る。

変数に代入される値の種類を「変数の型」と呼び、プログラミング上では、型の違いを意識する必要がある。

しかし、PHPも例外ではないが、PHPにおいては「変数の型」の区別が曖昧である。

以下、主な「変数の型」をまとめる。

文字列

文字列は、「初心者による初心者のためのPHP講座　第３回　文字列」で説明した通りである。

$my_string = "おはよう";

整数

数値の一種で、小数点を持たないもの。

PHPでは、-2,147,483,648 から 2,147,483,647 までの整数値を扱うことが出来る。

$my_integer = 1000;

浮動小数点

小数点を持つ数値。14桁まで扱うことが出来る。

$my_float = 3.1415;

論理値

格納できる値は、trueまたはfalseのみで、それぞれ「正しい」、「誤り」を表すと考えると理解しやすいかもしれない。

プログラミング上では「真偽」という。

この型は、ある事柄に関して、それが正しいか、誤りかを判定する際に使われる。

例えば、特定の条件の満たすなら「true」を格納し、そうでない場合は「false」を格納しておいて、後の処理でその値を判別に利用する。

$my_boolean = true;
$my_boolean = false;

文字列の「”true”」や「”false”」とは本質的に意味が異なり、「”」を必要としないことからも分かるように文字列として値が格納されているわけではなく、この型の変数をecho()関数で表示すると、値が「true」の場合は、「1」が表示され、値が「false」の場合は、何も表示されない。

真偽の判定ではあるが、echo()関数で「true」、「false」と表示させたいなど、文字列とし再利用する必要がある場合は、以下のように最初から文字列として定義したほうが良い場合もある。

$my_boolean = "true";
$my_boolean = "false";

しかし、似て非なるものであり、上記の例の型は「文字列」であり、もはや「論理値」ではない。

配列、連想配列

区切り文字で区切られたリスト状の値、階層構造を持つリストのような複雑なデータを変数に格納に、容易に処理が出来る点もPHPの特徴である。

「配列」、「連想配列」については、別の機会に詳しく述べる。

$my_array = array(
	"鈴木さん" => array('男', '20'),
	"田中さん" => array('女', '68'),
	"山田さん" => array('男', '45'),
);

オブジェクト

「class」を使った「オブジェクト指向プログラミング」を行う際に使用するが、本講座でのサンプルプログラムは、「オブジェクト指向」ではないので、ここでは説明を省く。

NULL

NULL型とは、値として何も格納されていない空の状態である。

「NULL」が代入されている場合の他、何も代入されていない場合もNULL型となる。

<?php
$my_null = NULL;
$my_null;
?>

その他の型

「リソース」、「ストリーム」と言った特殊な型も存在するが、これらは特定の処理の際に使うものである。

型の区別の実際

PHPは、型の区別が非常に曖昧なプログラミング言語であり、そのため型の区別をあまり意識する必要がないので、PHPが「易しい言語」である理由の１つになっているかもしれない。

但し、これがプログラマーに優しいか否かは別問題ではあると思うが・・・。

次の例は、演算子「+」を使って、数学上の足し算を行なっている。

<?php
$a = 100;
$b = "50";
echo $a + $b;
?>

$aは整数、$bは文字列であり、型を厳密に区別するなら、整数と文字列の足し算など成立しないが、実際には「150」と表示される。

次のサンプルでは、$cに代入する際に足し算を行い、gettype()関数で、$cの型を取得し、echo()関数で表示している。

<?php
$a = 100;
$b = "50";
$c = $a + $b;
echo gettype($c);
?>

結果は「integer」、つまり整数となる。

整数と文字列の足し算の結果が、自動的に整数型になっている。

PHPでは、変数が柔軟に処理される反面、「100」と「”100″」の区別が難しくなっている側面もある。

未定義の変数

次のサンプルは、一文字ずつ、よく見て欲しい。単純なタイプミスがある。

<?php
$my_string = "おはよう";
echo $ny_string;
?>

このサンプルのecho()関数は、未定義の変数「$ny_string」を引数として使おうとしている事になるが、これは「エラー」にはならない。

設定ファイル「php.ini」の設定によっては、「Notice: Undefined variable」と言う「注意」が表示される場合もあるが、これはエラーではないため、処理は継続される。

PHPでは、未定義の変数を使おうとした場合、自動的にNULL型の変数として定義されるようである。

よって、このサンプルは、NULL型の$ny_stringを表示することになるので、結果として何も表示れない。

この場合、処理結果が意図した結果と異なるので、エラーとして表示されなくとも誤りがあることは明確であるが、処理の仕方によっては正常に動作しているように見えることもあるので厄介である。

ともかく、自動定義されるからと言って、変数を未定義のまま使用する事は避けた方が良い。

私も同様のミスをした経験があり、ユーザーから「注意」が表示されることを指摘されて、ようやく、未定義の変数の扱いについて気づいた。

NULL型の変数として自動的に定義される点も、私の処理には都合が良く、処理結果から、この誤りに気づくことが出来なかった。

バージョン0.4 2011/10/30

最新の「CodeMirror for CodeEditor」をダウンロード

バージョン0.4では、新しい機能の追加はないが、内包する「CodeMirror」ライブラリをアップデートしている。

このバージョンで採用した「CodeMirror」ライブラリは、正式リリースのものではなく、開発中のものであり、バージョン2.16の修正版（2.16-22）に当たる。

開発中のバージョンを採用した事には理由がある。

以前のバージョンでは、IEで参照するとタブがスペースに変換され、インデントが正しく反映されない問題が発生しており、以前から気になっていた。

この問題は、バージョン2.16で解消しており、このプラグインでもバージョン2.16を新たに採用するつもりであったが、テストした結果、新たに別の問題が発生していることが分かり、これら全ての問題を解消するために開発中のバージョンを採用した。

なお「CodeMirror」の開発チームは、仕事に熱心で、レスポンスが良く、バグとして報告すれば、直ぐに対応して貰える。

マイナーな用途のライブラリではあるが、こう言った点からも、今後、この手のライブラリの主流の１つになることが予想される。

バグを報告したり、パッチを提供したりするユーザーも増えて来ているようなので、開発自体も更に盛り上がって行きそうだ。

十分な情報を得るためには、をかもとさんの書かれた記事、「WordPress 開発に便利なプラグイン Debug Bar」にもあるように「wp-config.php」に記述を追加する必要があるが、「SAVEQUERIES」、「WP_DEBUG」は、下手に常時有効にする訳にはいかないため、どちらかと言えば、評価環境で使った方が良いプラグインと言える。

また、「Debug Bar」は、フロントエンドや管理画面の上部に表示される「管理バー」から実行するタイプであるため、使用する場合は、管理バーを表示させておく必要がある。

よって、管理バーが苦手な方には向かないかもしれない。

しかし、「Debug Bar」の機能はこれだけではなく「Debug-Bar-Extender」、「Debug Bar Query Tracer」、「Debug Bar Console」と言ったプラグインで機能を強化できる。

「Debug-Bar-Extender」については、jim912さんが書かれた「Debug BarとDebug-Bar-ExtenderでWordPressのパフォーマンスチェック」という記事が参考になる。

「Debug Bar Query Tracer」は、使っていないため、機能についてはよく分からない。

私が重宝しているのが、「Debug Bar Console」で、このプラグインをインストールすると、PHPやSQLスクリプトを実行できるコンソールが追加される。

もっぱら、PHPプログラムの実行テストに使用しているが、このコンソールは良く出来ており、ちょっとした検証程度のことならここで出来てしまう。

例えば、プラグインなどで定義されたものを含め、WordPressの関数も実行できる。

下記の例では、get_posts()関数を使って最近の10件の記事を取り出している。

$posts = get_posts(array('numberposts'=>10));
foreach($posts as $post) {
	echo($post->post_content);
}

左側に入力したスクリプトの実行結果はコンソール右側に表示される。

ただし、実行結果を表示する部分は、ブラウザとして機能するため、実行結果にHTMLタグが含まれる場合は、タグは処理されてしまう。

上記の例であれば、エスケープする処理を加えれば、タグも確認できる。

$posts = get_posts(array('numberposts'=>10));
foreach($posts as $post) {
	echo(esc_html($post->post_content));
}

WordPressがグローバルスコープで定義している変数を使用する場合は、Global宣言が必要となる。つまりスコープが異なる。

下記は、WordPressの変数$localeを使用する場合の例である。

global $locale;
echo($locale);

同じ要領でプラグインが定義している変数も取得できる。

管理バー自体は、WordPressの管理画面以外にフロントエンドでも表示できるが、投稿ページでコンソールを開こうが、アーカイブページで開こうが、このコンソールは、管理画面の一部として機能する。

つまりis_admin()は、常にtrueを返す。

従って、現在のページの記事やコメントを取得すると言った事は出来ないが、IDで指定して取得する方法もあるので、全く不可能ではない。

万能ではないが、癖さえ理解してしまえば、「Debug Bar Console」は、かなり使えるツールになるはずだ。

Ver.0.1　2011/10/22

最新の「TinyMCE Backslash Button」をダウンロードする

日本語環境では、「\」は、「\」として表示されてしまうが、「TinyMCE Backslash Button」を使えば「\」の入力が可能となる。

標準のビジュアルエディター（TinyMCE）に追加されるボタンを使って簡単に「\」を入力でき、「\」になること無く「\」をそのまま表示させることが可能。

仕組みとしては、欧文フォントを「\」に適用しているだけのため、クライアントの環境によっては「\」と表示されず、「\」となる場合もある。