はじめに
本連載では、PHP上で動作するアプリケーションフレームワークであるZend Frameworkについて紹介していきます。今回はページ間で共有できる部分の管理を行うモジュール「Zend_Layout」を説明します。
同じウェブサイト内のページでは、同じデザインのサイドバーやメニューを利用することが多いと思います(このようなページ間で共有できる部分を「共通レイアウト」と呼ぶことにします)。Zend_Layoutは共通レイアウトを管理するためのモジュールで、通常の処理にZend_Layoutの処理を追加することでページ固有の部分(以降、「本文」と表記)に変更を加えずに共通レイアウトを描画することができます。
対象読者
PHPの基本構文は一通り理解しているが、フレームワークを利用したことはないという方を対象としています。
必要な環境
Zend FrameworkはPHP 5.1.4以降とWebサーバがインストールされている環境で利用可能です。本稿ではWebサーバとしてApache 2.2を、OSにWindows XPを採用し、アプリケーションを作成していきます。
以下に、今回アプリケーション作成/動作確認に用いた環境を示します。インストールにあたっては最新安定版の使用を推奨します。各項目の詳細なインストール手順は、「サーバサイド技術の学び舎 - WINGS」より「サーバサイド環境構築設定手順」を参照ください。
- Windows XP SP2
- PHP 5.2.6
- Apache 2.2.10
LinuxやFreeBSDなどUNIX系OSをお使いの方もコマンドはほぼ一緒ですので、パスなどは適宜読み替えてください。
Zend_Layoutの機能
部品を配置するための仕組みはZend_Viewにもありましたが、これとZend_Layoutとはどのように違うのでしょうか? 最大の違いは、図1のようにZend_Layoutではページ間で共通なレイアウトとページの本文とを分けて管理することにあります。共通レイアウトの各部品と本文の配置は「レイアウトスクリプト」と呼ばれるスクリプトに記述されており、本文の内容とは独立に管理することができます。
Zend_Layoutの利用
ここではZend_LayoutをZend FrameworkのMVC機能と併せて使う方法について解説します。この例で考えているのは図2のように、左側にメニューがあり右側に本文があるページです。このうち左側のメニューはページ間で共通している部分となります。
ファイルの配置
まず、最初にファイルの配置を確認しておきます(リスト1)。ここからの説明ではindex.phpが「C:\codezine\htdocs」に、Zend FrameworkのMVC関係のファイルが「C:\codezine\zendapps」以下にあるとします。レイアウトスクリプトは「C:\codezine\zendapps\views\layouts」の「layout.phtml」と「table.phtml」です。
C:\ codezine/ htdocs/ .htaccess index.php フロントコントローラ codezine.css スタイルシートファイル zendapps/ controls/ IndexController.php 標準で使われるアクションコントローラ ErrorController.php エラー処理の際に使われるアクションコントローラ models/ views/ filters/ helpers/ layouts/ layout.phtml CSSを利用したレイアウトスクリプト table.phtml テーブルを利用したレイアウトスクリプト scripts/ index/ index.phtml 本文を出力するビュースクリプト another.phtml index.phtmlとは別の本文を出力するビュースクリプト error/ error.phtml エラー処理の際に使われるビュースクリプト menu.phtml 共通レイアウトのメニュー
Zend_Layoutを使わない場合の大まかな処理の流れは、フロントコントローラ(index.php)→アクションコントローラ(IndexController.php)→ビュースクリプト(index.phtml)となっています(図3の左)。ここにZend_Layoutと追加すると、最後にもう一段レイアウトスクリプト(layout.phtml)が加わります(図3の右)。