Doctrineは一行もテストを書かずにDoctrineをテストするために設定をまったくしなくてよいDoctrine実装の特別なパッケージも提供します。ダウンロードページから入手できます。

サンドボックスの実装は本番アプリケーションには推奨されません。これはDoctrineの探求と地井さんテストの実行だけを目的としています。

SVNとexternalsオプションを通してDoctrineを使うことを大いにお勧めします。SVNから最新のバグ修正を入手できて最良の経験が保証されるのでこのオプションがベストです。

プロジェクトで既にSVNでバージョン管理されている場合、DoctrineをインストールするためにSVN externalsを使うのがお勧めです。

ターミナルでプロジェクトをチェックアウトすることから始めます:

$ cd /var/www/my_project

プロジェクトをチェックアウトしたので、ターミナルから次のコマンドを実行してDoctrineをSVN externalとしてセットアップします:

$ svn propedit svn:externals lib/vendor

上記のコマンドでエディタを開き次のテキストを押し込んで保存します:

doctrine http://svn.doctrine-project.com/branches/1.1/lib

svn updateを実行することでDoctrineをインストールできます:

$ svn update

このコマンドによってDoctrineは次のパスでインストールされます: /var/www/my_project/lib/vendor/doctrine

SVN externalsへの変更をコミットすることをお忘れなく。

$ svn commit

Doctrineはサーバーでインストールとアップデート用のPEARサーバーも提供します。
次のコマンドでDoctrineを簡単にインストールできます:

$ pear install pear.doctrine-project.org/Doctrine-1.1.x

1.1.xをインストールしたいバージョンに置き換えます。例えば"1.2.1"です。

PEARでインストールしたくないもしくはPEARがインストールされていない場合、公式サイトからパッケージを手動でダウンロードできます。サーバーにパッケージをダウンロードした後でlinuxでは次のコマンドを利用してこれを展開できます。

$ tar xzf Doctrine-1.2.1.tgz

最初に行わなければならないことはアプリケーションで読み込むことができるようにコアクラスを格納するDoctrine.phpファイルを見つけることです。Doctrine.phpファイルは前のセクションでダウンロードしたDoctrineのlibフォルダに存在します。

Doctrineライブラリをdoctrine_testディレクトリからdoctrine_test/lib/vendor/doctrineフォルダに移動させる必要があります:

$ mkdir lib
$ mkdir lib/vendor
$ mkdir lib/vendor/doctrine
$ mv /path/to/doctrine/lib doctrine

もしくはSVNを利用しているのであれば、externalsを使います:

$ svn co http://svn.doctrine-project.org/branches/1.1/lib lib/vendor/doctrine

svn externalsにパスを追加します:

$ svn propedit svn:externals lib/vendor

テキストエディタを開き次の内容を入力して保存します:

doctrine http://svn.doctrine-project.org/branches/1.1/lib

SVN updateを行うとDoctrineのライブラリは更新されます:

$ svn update lib/vendor

Doctrineとすべての設定をブートストラップするためのPHPコードが必要です。
bootstrap.phpという名前のファイルを作り次のコードをファイルに加えます:

// bootstrap.php

/**
 * Bootstrap Doctrine.php, register autoloader specify
 * configuration attributes and load models.
 */

require_once(dirname(__FILE__) . '/lib/vendor/doctrine/Doctrine.php');

Doctrineクラスの準備が終わったので、ブートストラップファイルでクラスのオートローダー関数を登録する必要があります:

// bootstrap.php

// ...
spl_autoload_register(array('Doctrine', 'autoload'));

Doctrine_Managerシングルトンインスタンスも作り$managerという名前の変数に割り当てます:

// bootstrap.php

// ...
$manager = Doctrine_Manager::getInstance();

後の章とセクションでこのブートストラップクラスを使うので作ってください！

作成したブートストラップファイルの内容は次のようになります:

// bootstrap.php

/**
 * Bootstrap Doctrine.php, register autoloader specify
 * configuration attributes and load models.
 */

require_once(dirname(__FILE__) . '/lib/vendor/doctrine/Doctrine.php');
spl_autoload_register(array('Doctrine', 'autoload'));
$manager = Doctrine_Manager::getInstance();

この新しいブートストラップファイルは実装の変更を行う場所でありまた段階的にDoctrineの使い方を学ぶのでこのファイルはこの本で何度も参照されます。

上記で説明された接続属性はDoctrineの機能です。Configurationの章で属性の詳細とこれらのゲッター/セッターを学びます。

Doctrineの機能に関して学ぶので様々なテストを実行するために利用できるシンプルなテストスクリプトを作りましょう。

doctrine_testディレクトリの中でtest.phpという名前の新しいファイルを作成し内部に次の内容を置きます:

// test.php

require_once('bootstrap.php');

echo Doctrine::getPath();

これでコマンドラインからテストスクリプトを実行できます。これはこの章全体でDoctrineでテストを実行する方法です。動作しているか確認してください！Doctrineがインストールされている場所のパスが出力されます。

$ php test.php
/path/to/doctrine/lib