[ ZendFramework1 ] プロジェクトの作成 (zf create project)

2017年4月14日まさお Comment

ここでは、Zend Framework プロジェクトの作成例を掲載しています。なお、環境は、OS が WIndows で、WEBサーバは apache です。

Zend Framework ライブラリへのパス設定（php.ini）

Zend Framework をダウンロードして、任意の場所に展開します。そして、php.ini に次の Zend Framework ライブラリのパスを追加します。これで、PHP から Zend Framework ライブラリを使用することができるようになります。

php.ini

; Windows: "\path1;\path2"
include_path = ".;C:\ZendFramework-1.11.3\library"

これだけでも、Zend フレームワークのライブラリの機能を使用することができますが、ここでは、Zend Framework プロジェクトを作成しますので、もう少し各種設定が必要になります。

rewrite_module の有効化

Zend Framework では MVC を採用し、コントローラにすべてのリクエストを集約・振り分けを行いますので、リクエストをコントローラに集約するために Web サーバのリライト設定を行う必要があります。httpd.conf 次のように修正し、apache のリライトモジュールを有効化してリライト機能を使用させます。

httpd.conf

#LoadModule rewrite_module modules/mod_rewrite.so コメント解除する
LoadModule rewrite_module modules/mod_rewrite.so

　　・
　　・　

<Directory "C:/Apache2.2/htdocs">

    (省略)
    
    # AllowOverride controls what directives may be placed in .htaccess files.
    # It can be "All", "None", or any combination of the keywords:
    #   Options FileInfo AuthConfig Limit

    #AllowOverride None　⇒　All　に変更
    AllowOverride All

    (省略)
</Directory>

.htaccess の設定例

DocumentRoot に .htaccess を配置することでサイト全体のリスエストを index.php が受け付けるようにします。なお、以下の .htaccess ファイルの内容は、Zend Framework で推奨されている設定例そのものです。

RewriteEngine On
RewriteCond %{REQUEST_FILENAME} -s [OR]
RewriteCond %{REQUEST_FILENAME} -l [OR]
RewriteCond %{REQUEST_FILENAME} -d
RewriteRule ^.*$ - [NC,L]
RewriteRule ^.*$ index.php [NC,L]

※　なお、httpd.conf のドキュメントルートおよび、.htaccess ファイルの格納場所は、後述に示すプロジェクト作成後に変更します。

しかし、apache の立場としては .htaccess ファイルは性能面やセキュリティの観点からむしろ使わないほうが良いといっているようです。

Apache チュートリアル: .htaccess ファイル

Zend Framework-1.11 プロジェクトの作成

これまでの手順で前準備が完了しましたので、次にプロジェクトを作成します。

プロジェクトを作成するには、プロジェクトの雛形を生成する zf コマンドを使用します。zf コマンドはフレームワークをインストールしたディレクトリの bin ディレクトリにあります。

以下の例では、D:\sample_project フォルダにプロジェクトを生成しています。

# php.exe へのパスが通っている場合は不要
D:\zf-1.11.3\bin>set PATH=d:\php5;%PATH% 

D:\zf-1.11.3\bin>zf create project D:\sample_project
Creating project at D:/sample_project
Note: This command created a web project, for more information setting up your VHOST, please see docs/README

すでに作成済みの .htaccess ファイルをプロジェクトフォルダに作成された public フォルダに配置します。そして、httpd.conf の DocumentRoot には public ディレクトリを指定します。これで、プロジェクトの作成は完了です。

プロジェクトの動作確認

作成したプロジェクトにはデフォルトで index および error コントローラとアクションが作成されます。次の URI にリクエストを要求して、ページが表示されるか確認します。

URI の構成

Zend Framework の URI は以下の構成となっています。

http://（Webサーバアドレス）/（コントローラ名）/（アクション名）

http://localhost/index/index

次の画面が表示されれば、動作確認はOKです。

動作確認結果