PHP の出力結果にこだわりを (2007-09-29)

はじめに
自己紹介
アジェンダ
出力結果に眼を向けよう
1. そもそも PHP とは何の略か
2. 出力されるものはハイパーテキスト
3. サンプルコードだって気をつかおう
4. 出力結果よりもプログラムコードが肝か？
5. コピペされることを考えよう
6. 出力結果の一例
PHP と XML 宣言
1. PHP 中の XML 宣言について
2. PHP でハイパーテキストを生成する、ということは
まとめ
おわりに

PHP in Fukuoka: 2007-09-29

はじめに

このスライドは、http://hxxk.jp/2007-09-29にていつでも閲覧可能です。
- 全ての項目を書き写したり、写真に残したりする必要はありません。
- ただ、スライドはあくまで最低限のことしか書いていないので、ポイントは適宜メモ等をお願いします。
今回の内容も PHP 特有の内容ではありません。
PHP に限らず言える内容……とは思いますが、いちおう PHP を主眼にして進めます。
また、今回の内容は適宜ホップ本を参照するようにしています（解説が冗長になってしまうので）。

自己紹介

プログラマにあらず、デザイナにあらず、 IT と無縁の職で食を得ています。
- 一応共著で XHTML&CSS の本を書いているので、無理矢理名乗るならテクニカルライターとも言えるかもしれません。
- しかし、基本的には日々現場に足を運んだり膨大な書類とにらめっこしたり。
- この半年、ロクに PC を触らなくなってきました。
- 平日の長時間拘束の反動か、休日もどこかに出かけてばかりいます。
- 明日は休日出勤の予定ですが……。
もっと詳しい自己紹介は http://hxxk.jp/2007-05-20 で行っているので、帰宅後にご覧ください。

アジェンダ

今日の主なテーマは 2 つ。
- PHP で何らかの結果を出力することも大事だけど、その出力される結果にも眼を向けよう！
- そこに眼を向けていくと、 PHP ならでは（？）のつまづきポイントが発生するので、その解説と解決策を。

出力結果に眼を向けよう

目標を見逃すな！

そもそも PHP とは何の略か

PHP: Hypertext Preprocessor
- 以前は PHP/FI (Personal Home Page/Forms Interpreter) とも。（→杉山さん作成の資料を参照）
- 再帰的頭字語
  - GNU is Not Unix!
  - Luxin is Not Linux!
    - これは twitter で @Luxin と呼ぶところを @Linux と間違われた際に飛び出した返しで、頭字語とも違うんですが。

出力されるものはハイパーテキスト

PHP: Hypertext Preprocessor
- ハイパーテキストのプリプロセッサ（そのままやん）。
- ハイパーテキストは説明いらない……ですよね。
- プリプロセッサとは、 e-Words の解説から引用すると、ソフトウェア開発ツールの一つ。コンパイルの前に前処理を行なうプログラムのこと。「前処理系」とも言う。
- 最終的に出力されるもの（この場合、ブラウザ等のリクエストに対するレスポンス）は HTML や XHTML などのハイパーテキストで、プログラムのコードは出力されない。

サンプルコードだって気をつかおう

PHP の書籍に書かれているサンプルコードや、ハンズオントレーニングで提示されるサンプルコードの出力結果でたまに見る例
- ```
<html>
  <head>
    <title>Sample</title>
  </head>
  <body>
    <p>
    今年のビアフェスでは、
    Die with a beer in your hand!
    というメッセージが書かれていた T シャツを着ていた人を見かけました。
    </p>
  </body>
</html>
```
- 悪くもないけど決して良くもない。
- 第6回勉強会のサンプルコードはこのような形ではありませんでした。良い意味で。

出力結果よりもプログラムコードが肝か？

さっきの例のどこが良くないのか？
- HTML もしくは XHTML っぽい文書だとは思われるけれど、この例では推測の域を越えない。
- HTML か XHTML か、またそのパースのされ方によって必要・不要は分かれるけれど、文字コード等の指定は？
- その他、必須ではないが書いておいた方が良いと思われる記述が無い。
- と言っても、とりあえず出力ができれば良いんじゃ？どうやって出力にこぎつけるか、までをサンプルで示すのでは？

コピペされることを考えよう

過程のみを重視して、出力結果を軽視したサンプルで学習を深める人は？
- サンプルと同じような出力が得られるようにコードを書く。
- HTML/XHTML の知識があれば、サンプルの出力にプラスアルファを付け加えるかもしれない。
- PHP も HTML/XHTML もこれから頑張る！という人は、同じ出力が得られれば OK だと思ってしまうかも？
- 出力に至る PHP プログラムのコードをしっかり作るのはもちろん、その出力テキスト自体もしっかり作るのが良サンプル。
- ……当たり前の話じゃないか、と思われるかもしれないけど、その当たり前を失念しているサンプルが多い。

出力結果の一例 (1)

ということで、これくらいは最低限書いておこう、という出力結果の一例（この例では DTD は HTML 4.01 Strict 、文字コードは UTF-8 としています）。

<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01//EN" "http://www.w3.org/TR/html4/strict.dtd">
<html lang="ja">
  <head profile="http://purl.org/net/ns/metaprof">
    <meta http-equiv="Content-Type" content="text/html;charset=UTF-8">
    <meta http-equiv="Content-Style-Type" content="text/css">
    <meta http-equiv="Content-Script-Type" content="text/javascript">
    <link rev="made" href="mailto:nobeernolife@example.com">
    <title>Sample</title>
  </head>
  <body>
    <p>
    今年のビアフェスでは、
    <span lang="en">Die with a beer in your hand!</span>
    というメッセージが書かれていた T シャツを着ていた人を見かけました。
    </p>
  </body>
</html>

出力結果の一例 (2)

DTD を HTML 4.01 Strict としているので、 DOCTYPE 宣言で DTD を明示。
html 要素の lang 属性で、文書全体の言語を明示。
- 途中の英文のみ span 要素でマークアップして lang="en" を指定。
- これは過剰なマークアップかもしれません。ただ、「なんで英文だけ span で囲んでいるのかな？」と、考えを深めさせるきっかけになります。
link 要素で、文書作成者の連絡先を明示。
- ただし、 rev="made" というリンクタイプの値は Link types 中に定義されていないため、 head 要素の profile 属性にてその値の定義を示しています。
- これはホップ本の p.57-58 で詳しく解説しているので、お持ちの方は併せてお読みください。
この例では内部スタイルシートも適用していないし内部スクリプトも用いていないので、 Content-Style-Type や Content-Script-Type は必ずしも書く必要はありません。
- でも、サンプル中に全く書かないでいると、サンプルだけを見て学習する人はそういった記述があることすら知らないままになります。
- また、後から内部スタイルシートや内部スクリプトが記述される可能性も考えられます。
- もちろん、サンプルだけを見るんじゃなくて HTML/XHTML の仕様を読むのが一番なのですが、実際にはそこまで読み進める人はそう多くありません。

出力結果の一例 (3)

今回示したのはあくまで一例で、絶対の正解ではありません。
しかし、常々より良い記述をできるように眼を向けていれば、自然とそのための知識が身に付いていきますし、また貴方のソースを見た「誰か」がメリットを得られることになります。
逆に、貴方が誰かのソースを参考にするときも、参考にしてはいけないソース、ぜひ参考にすべきソースの見極めができるようになります。
- 個人サイトだと、 The Web KANZAKI
- 企業サイトだと、 [bA] Business Architects Inc. やキッス合同会社など
- ……が、このスライドを作成するときにぱっと思い浮かんだ「参考にしたいソース」のサイトです。

PHP 中の XML 宣言について (1)

出力結果を HTML ではなくて XHTML にしたいなら、 XML 宣言についても少し考慮しましょう。
- XML 宣言は処理命令と同じように <? で書き出すため、 PHP ファイルにそのまま記述したらエラーになる場合があります。
  - short_open_tag ディレクティブを off にしていればエラーになりません。
  - short_open_tag ディレクティブが on であると、 <?php ... ?> だけでなく <? ... ?> も PHP プログラムコードと識別されるため。
  - もしくは、 <?php echo '<?xml version="1.0" encoding="UTF-8"?>'."\n";?> のように echo 命令で書き出すという解決策もあります。
- XML 宣言は省略できる場合もありますが、基本的には「記述すべき」とされています。
  - これはホップ本の p.36-41 で詳しく解説しているので、お持ちの方は併せてお読みください。

PHP 中の XML 宣言について (2)

XML 宣言は XHTML 文書であれば「記述すべき」なのですが……。
- IE 6 では DOCTYPE 宣言より前に空白文字以外の何らかの文字があると、後方互換モードとしてレンダリングするという有名かつ切実なバグがあります。（また、 Opera 7.0 も XML 宣言がされていると後方互換モードとなるようです。）
  - これはホップ本の p.40 および p.410-411 で詳しく解説しているので、お持ちの方は併せてお読みください。
  - また、 2xup.org の上ノ郷谷さん（←ちょうナイスガイ）が、各表示モードによる CSS 解釈の違いをまとめたドキュメントを共有にて、これらのレンダリングの違いを分かりやすくかつ徹底的に解説しているので、是非読んでください。
  - この IE 6 等の実装を根拠に、 XML 宣言を省略できる条件を整えて、 XML 宣言は省略してしまおうという解説がよくなされています。
    - 先日発売されたWeb プロフェッショナルのための黄金則 XHTML+CSS 虎の巻でも最初の項で「 XML 宣言は付けない」と解説されています。
  - でも、せっかく PHP でハイパーテキストを動的に生成するのであれば、一部のブラウザの実装のために一律に省略するんじゃなくて、一部のブラウザからリクエストがあった場合にのみ、 XML 宣言を省略するということもできます。

PHP でハイパーテキストを生成する、ということは

HTTP_USER_AGENT で UA 情報を取得して、特定の UA の場合（もしくは特定の UA 以外の場合）は XML 宣言を省略（もしくは記述）するように振り分け。
- ……ということは、 HTTP_ACCEPT あたりを活用することで、 IE が未だに対応してくれないせいで適用に二の足を踏む application/xhtml+xml も有効利用できるのではないでしょうか。
  - というのも、 HTML 互換性ガイドラインに準拠した XHTML 文書であれば text/html とする（≒ IE で閲覧できるようにする）ことが可能になりますが、それでは XHTML 文書としてのメリットが殆ど得られないため、対応している UA には application/xhtml+xml を用いて XML 文書としてパースされることを期待したいのです。
  - ちなみに、出力結果の一例では meta 要素の http-equiv 属性で文書情報を示していましたが、 XML 文書として扱われる場合は meta 要素の http-equiv 属性による指定は推奨されないため、 HTML 文書として扱う UA にのみ http-equiv 属性を記述するようにもしたいです（→ホップ本 p.19 および p.59）。
  - ということで、ブラウザ判別の習作も兼ねて、どなたかこの辺りの UA 振り分け処理を今後のネタにしませんか？

まとめ

出力結果に眼を向ける、ということは、即ちフロントエンドに現れる部分に眼を向けるということ。
- これはプログラマやデザイナやコーダやディレクタなどの職種に関わらず、意識すべきことだと思います。（と、全くこれらの職に関係していない私が言ってみる）
  - バックエンドがしっかり構築されていて、セキュリティ対策もばっちり、でも見た目上のデザインや HTML/XHTML コードとしてのデザインが疎か
  - 見た目上のデザインや HTML/XHTML コードとしてのデザインはばっちり、でもセキュリティ対策や意図しない動作への対処が疎か
  - ……という片手落ちの状態にならないためには、それぞれの職種間での理解もさることながら、プロダクト全体で共通の「良いもの」を認識していることが重要。
PHP と XML 宣言が一例
- とある中堅サイトで、「 .php では XML 宣言を行うとエラーになるから XML 宣言は消しましょう」という解説を見たことがあります。
  - 「何故エラーになるのか」あるいは「エラーになるからといって書かなくても良いものなのか」という点に眼を向けていれば、そういった誤解を招く解説を振りまくことにはなりません。
  - むしろ PHP は動的にハイパーテキストを生成できるのだから、 XML 宣言を基本的に書きつつ、書いてしまうと CSS が残念なことになるブラウザのみやむなく XML 宣言を書かない、ということだってできます。
  - 逆転の発想で、 XML 宣言があってもなくても大丈夫な（ DOCTYPE スイッチに左右されない） CSS を心がけることを行って、 XML 宣言を必ず書いても良いですが。

おわりに

質問やツッコミはこの後の懇親会で！
- ……と言いたいところですが、今日はちょっと予定が重複してしまったので、このセッションが終わったら脱出しますごめんなさい
  - 松尾さんからの重要な訓示 - コミュニティや勉強会の注意点を1点。懇親会には極力出席するようにしましょう。
  - すみませんすみません
- また何かの機会で私を捕まえてください
- 不定期飲みオフ「ホップオアダイ福岡」も主催しています！
- 次回 Vol.4 は開催未定（開催情報は私の twitter で突発的に発表！）
- 
- 
-

PHP の出力結果にこだわりを (2007-09-29)

はじめに

自己紹介

アジェンダ

出力結果に眼を向けよう

そもそも PHP とは何の略か

出力されるものはハイパーテキスト

サンプルコードだって気をつかおう

出力結果よりもプログラムコードが肝か？

コピペされることを考えよう

出力結果の一例 (1)

出力結果の一例 (2)

出力結果の一例 (3)

PHP と XML 宣言

PHP 中の XML 宣言について (1)

PHP 中の XML 宣言について (2)

PHP でハイパーテキストを生成する、ということは

まとめ

おわりに