生産性を高める

Fabien Potencier 著

symfony を使うこと自体が Web 開発者としてのあなたの生産性を高めるためのすばらしい方法です。もちろん、だれもがすでに symfony の詳細な例外情報と Web デバッグツールバーが生産性を大いに高めていることを知っています。この章では新しいもしくはあまり知られていない symfony の機能を使うことであなたの生産性をもっと高めるいくつかのヒントとこつをお教えします。

より速く始める: プロジェクト作成プロセスをカスタマイズする

symfony CLI ツールのおかげで、新しい symfony のプロジェクトを作るのは速くてシンプルです:

$ php /path/to/symfony generate:project foo --orm=Doctrine

generate:project タスクは新しいプロジェクトのデフォルトのディレクトリ構造を生成し、適切なデフォルトを持つ設定ファイルを作成します。アプリケーションを作成する、プラグインをインストールする、モデルを設定するなどのほかの symfony タスクを使うことができます。

しかし新しいプロジェクトを作成する最初のステップは通常はほとんど同じです: メインアプリケーションを作成する、プラグインをインストールする、リンクのコンフィギュレーションのデフォルトを調整する、などです。

symfony 1.3 に関して、プロジェクト作成プロセスはカスタマイズかつ自動化が可能です。

generate:project タスクは --installer オプションをとります。このタスクは PHP スクリプトでプロジェクト作成プロセスの間に実行されます:

$ php /path/to/symfony generate:project --installer=/somewhere/my_installer.php

/somewhere/my_installer.php スクリプトは sfGenerateProjectTask インスタンスのコンテキストで実行されるので、$this オブジェクトを使うことでタスクのメソッドにアクセスできます。次のセクションでプロジェクト作成プロセスをカスタマイズするために使うことのできるすべてのメソッドを説明します。

 $ symfony generate:project
 --installer=http://example.com/sf_installer.php

installDir()

installDir() メソッドは新しく作られたプロジェクトのディレクトリ構造 (サブディレクトリとファイルで構成される) を反映します:

$this->installDir(dirname(__FILE__).'/skeleton');

runTask()

runTask() メソッドはタスクを実行します。これはタスクの名前と、複数の引数として渡したい引数とオプションを表す文字列をとります:

$this->runTask('configure:author', "'Fabien Potencier'");

引数とオプションは配列としても渡すことができます:

$this->runTask('configure:author', array('author' => 'Fabien Potencier'));

$this->runTask('cc');

もちろんこのメソッドはプラグインをインストールするのにも使うことができます:

$this->runTask('plugin:install', 'sfDoctrineGuardPlugin');

特定のバージョンのプラグインをインストールするには、必要なオプションを渡すだけです:

$this->runTask('plugin:install', 'sfDoctrineGuardPlugin', array('release' => '10.0.0', 'stability' => beta'));

$this->reloadTasks();

新しいアプリケーションを作り generate:module のような特定のアプリケーションに依存するタスクを使いたい場合、コンフィギュレーションのコンテキストを自分自身で変更しなければなりません:

$this->setConfiguration($this->createConfiguration('frontend', 'dev'));

ロガー

インストーラスクリプトを実行するとき、開発者にフィードバックをするためにとても簡単にロギングできます:

// シンプルなロギング
$this->log('some installation message');
 
// ブロックをロギングする
$this->logBlock('Fabien\'s Crazy Installer', 'ERROR_LARGE');
 
// セクションでロギングする
$this->logSection('install', 'install some crazy files');

ユーザーとのやりとり

askConfirmation()、askAndValidate() と ask() メソッドはあなたに質問をしインストールプロセスは動的に設定できるようになります。

確認だけが必要であれば、askConfirmation() メソッドを使います:

if (!$this->askConfirmation('Are you sure you want to run this crazy installer?'))
{
  $this->logSection('install', 'You made the right choice!');
 
  return;
}

ask() メソッドを使うことで質問をしてユーザーの回答を文字列として得ることができます:

$secret = $this->ask('Give a unique string for the CSRF secret:');

質問を検証したいのであれば、askAndValidate() メソッドを使います:

$validator = new sfValidatorEmail(array(), array('invalid' => 'hmmm, it does not look like an email!'));
$email = $this->askAndValidate('Please, give me your email:', $validator);

ファイルシステムのオペレーション

ファイルシステムを変更したいのであれば、symfony のファイルシステムオブジェクトにアクセスします:

$this->getFilesystem()->...();

$ php symfony generate:project --installer=/path/to/symfony/data/bin/sandbox_installer.php

インストーラスクリプトは単なる別の PHP ファイルです。ですので、思いどおりのことができます。新しい symfony プロジェクトを作成するたびに同じタスクを何度も実行する代わりに、独自のインストーラスクリプトを作り思いどおりに symfony のプロジェクトのインストール方法を調整できます。インストーラで新しいプロジェクトを作るのははるかに速く、ステップを見失うのを防ぎます。インストーラスクリプトをほかの人と共有することもできます！

開発をより速くする

PHP コードから CLI タスクまで、プログラムを組むことはたくさんの打ち込みをすることを意味します。打ち込みを最小限に減らすやり方を見てゆきましょう。

IDEを選ぶ

IDE を使うことは複数の方法で開発者をより生産的にすることを手助けします。

最初に、最新の IDE は設定をしなくても PHP の自動入力補完を提供します。このことは必要なことはメソッド名の最初の数文字を入力するだけであることを意味します。このことはメソッド名を覚えたくない場合でも、API を見ることなく IDE が現在のオブジェクトの利用可能なすべてのメソッドを提示することも意味します。

加えて、PHPEdit もしくは Netbeans のような IDE は、symfony に精通しており symfony プロジェクトとの特別な統合を提供します。

symfony をサポートする IDE を使う

IDE のなかには、PHPEdit 3.4 と NetBeans 6.8 のように、symfony のネイティブサポートがあるので、symfony とのきめ細かい統合を提供します。これらの symfony 固有のサポートおよび、これが開発をどのように手助けしてくれるのか学ぶためにはそれらのドキュメントを見てください。

IDE を助ける

IDE での PHP 自動入力補完は PHP コードで明示的に定義されたメソッドにのみ機能します。しかしコードが __call() もしくは __get() "マジック"メソッドを使う場合、IDEが 利用可能なメソッドもしくはプロパティを推測する方法はありません。よい知らせは PHPDoc ブロックでメソッドかつ/もしくはプロパティを提供することでたいていの IDE を手助けすることができます (それぞれ @method と @property アノテーションを使うことで)。

動的なプロパティ (message) と動的なメソッド (getMessage()) を持つ Message クラスがあるとします。次のコードは IDE が PHP コードでの明示的なコードなしでこれらをわかる様子を示すものです:

/**
 * @property clob $message
 *
 * @method clob getMessage() Returns the current message value
 */
class Message
{
  public function __get()
  {
    // ...
  }
 
  public function __call()
  {
    // ...
  }
}

getMessage() メソッドが存在しなくても @method アノテーションがあるので、IDE によりこのメソッドが認識されます。message プロパティについても @property アノテーションを追加したので、同様に認識されます。

このテクニックは doctrine:build-model タスクで使われています。たとえば、2つのカラム(messageとpriority) をもつ Doctrine の MailMessage クラスは次のようになります:

/**
 * BaseMailMessage
 *
 * This class has been auto-generated by the Doctrine ORM Framework
 *
 * @property clob $message
 * @property integer $priority
 *
 * @method clob        getMessage()  Returns the current record's "message" value
 * @method integer     getPriority() Returns the current record's "priority" value
 * @method MailMessage setMessage()  Sets the current record's "message" value
 * @method MailMessage setPriority() Sets the current record's "priority" value
 *
 * @package    ##PACKAGE##
 * @subpackage ##SUBPACKAGE##
 * @author     ##NAME## <##EMAIL##>
 * @version    SVN: $Id: Builder.php 6508 2009-10-14 06:28:49Z jwage $
 */
abstract class BaseMailMessage extends sfDoctrineRecord
{
    public function setTableDefinition()
    {
        $this->setTableName('mail_message');
        $this->hasColumn('message', 'clob', null, array(
             'type' => 'clob',
             'notnull' => true,
             ));
        $this->hasColumn('priority', 'integer', null, array(
             'type' => 'integer',
             ));
    }
 
    public function setUp()
    {
        parent::setUp();
        $timestampable0 = new Doctrine_Template_Timestampable();
        $this->actAs($timestampable0);
    }
}

ドキュメントを見つけるのを速くする

symfony は多くの機能を持つ大きなフレームワークなので、可能性のあるコンフィギュレーションもしくはすべてのクラスとメソッドを思いどおりにすべて覚えるのは簡単であるとは限りません。これまで見てきたとおり、IDE を使うことは自動入力補完で大きな効果があります。回答をできるかぎり速く見つけるために既存のツールがどのようにてこいれされるのか調べてみましょう。

オンライン API

クラスもしくはメソッドに関するドキュメントを見つけるための最速の方法は、オンライン API を眺めることです。

よりおもしろいものは組み込みの API 検索エンジンです。結果は数タッチでクラスもしくはメソッドを素早く見つけることができます。数文字を API ページの検索ボックスに入力した後で、クイックサーチの結果ボックスは役に立つ提示内容とともにリアルタイムで表示されます。

クラス名の最初を入力することで検索できます:

もしくはメソッド名でもできます:

すべての利用可能なメソッドの一覧を表示するにはクラス名の後に :: をつけます:

もしくはさらなる候補を精選するためにメソッドの始めを入力します:

すべてのクラスのパッケージのリストを表示したければ、パッケージの名前を打ち込んでリクエストを投稿します。

symfony API 検索をブラウザに統合するさえできます。この方法では、何かを探すために、symfony 公式サイトに移動する必要はありません。これが可能なのは symfony API のネイティブの OpenSearch サポートが提供されているからです。

Firefox を使っているのであれば、symfony API 検索エンジンは検索エンジンのメニューに自動的に現れます。ブラウザの検索ボックスにこれらの1つを追加するために API ドキュメントのセクションから「API OpenSearch」のリンクをクリックすることもできます。

チートシート

symfony の主要な部分に関する情報に素早くアクセスしたいのであれば、チートシートの大きなコレクションを利用できます:

• ディレクトリ構造と CLI
• ビュー
• ビュー: パーシャル、コンポーネント、スロットとコンポーネントスロット
• Lime によるユニットテストと機能テスト
• ORM
• Propel
• Propel スキーマ
• Doctrine

オフラインドキュメント

コンフィギュレーションに関する質問は symfony リファレンスによってもっとよく回答されています。 symfony を開発するときはぜひこの本を手元に置いておくべきです。この本はとても詳細な目次、用語の索引、章内部の相互参照、表などのおかげで利用可能なすべてのコンフィギュレーションを見つけるための最速の手段です。

オンラインで読む、印刷されたものを購入する、もしくは PDF バージョンをダウンロードできます。

オンラインツール

この章の始めで見てきたとおり、symfony はより速く始めるための手助けをしてくれるすばらしいツールセットを提供します。最後にはプロジェクトを終わらせ、運用サーバーにデプロイするときが来ます。

プロジェクトの開発の準備が整っているか確認するには、オンラインの開発チェックリストを使うことができます。このサイトは運用環境に移行する前にチェックする必要のある主要な項目をカバーしています。

より速くデバッグをする

開発環境でエラーが起きるとき、symfony は役に立つ情報で満たされたすばらしい例外ページを表示します。たとえば、実行されてきたスタックトレースとファイルを見ることができます。settings.yml 設定ファイル (下記を参照) で sf_file_link_format 設定をセットアップする場合、ファイル名でクリックすれば関連ファイルは好きなテキストエディタもしくは IDE で即座に開かれます。これは問題をデバッグするときたくさんの時間を節約してくれるとても小さな機能のすばらしい例です。

デフォルトでは、sf_file_link_format は空で PHP コンフィギュレーションの xdebug.file_link_format の値が存在する場合はそれが symfony のデフォルトとなります (最新バージョンの XDebug にて php.ini に xdebug.file_link_format をセットすることで、スタックトレースですべてのファイル名へのリンクを追加することを許可します)。

sf_file_link_format の値は IDE と OS に依存します。たとえば、TextMate でファイルを開きたい場合、次のコードを settings.yml に追加します:

dev:
  .settings:
    file_link_format: txmt://open?url=file://%f&line=%l

%f プレースホルダはファイルの絶対パスに置き換えられ、%l プレースホルダは行数に置き換えられます。

VIM を使うのであれば、コンフィギュレーションはより複雑でありオンラインの symfony と XDebug で説明されています。

より速くテストする

機能テストを記録する

機能テストはアプリケーションのすべてのピースの統合をテストすることを通してユーザーとのやりとりをシミュレートします。 機能テストを書くのは簡単ですが時間がかかります。それぞれの機能テストのファイルはユーザーがブラウザで Web サイトにアクセスするのをシミュレートするシナリオであり、アプリケーションにブラウザでアクセスするほうが PHP のコードを書くよりも速いので、ブラウザセッションを記録して PHP コードに自動的に変換できるとしたらどうしますか？ありがたいことに、symfony にはこのためのプラグインがあります。これは swFunctionalTestGenerationPlugin と呼ばれ、ほんの数分でカスタマイズの準備ができているテストスケルトンを生成することを可能にします。もちろん、より便利にするために適切なテスター呼び出しを追加する必要がありますが、それにも関わらずこれはすばらしく時間を節約してくれます。

プラグインは symfony のフィルタを登録することで動きます。すべてのリクエストを傍受し、これらを機能テストのコードに変換します。プラグインを通常のやり方でインストールした後で、これを有効にする必要があります。アプリケーションの filters.yml を開きコメント行の後に次の行を追加します:

functional_test:
  class: swFilterFunctionalTest

次に、ProjectConfiguration クラスでプラグインを有効にします:

// config/ProjectConfiguration.class.php
class ProjectConfiguration extends sfProjectConfiguration
{
  public function setup()
  {
    // ...
 
    $this->enablePlugin('swFunctionalTestGenerationPlugin');
  }
}

プラグインはメインのユーザーインターフェイスとして Web デバッグツールバーを使うので、これが有効になっていることを確認してください (開発環境でのデフォルトのケース)。有効にされているとき、"Functional Test" という名前の新しいメニューが利用できるようになります。このパネルにおいて、"Activate" のリンクをクリックすればセッションの記録が始まり、"Reset" をクリックすれば現在のセッションがリセットされます。これを行うとき、ファイルをテストしてカスタマイズするためにテキストエリアからコピー＆ペーストします。

より速くテストスイートを実行する

大きなテストスイートがあるとき、変更をするたびに、とりわけ一部のテストが通らない場合、すべてのテストを立ち上げるのにとても時間がかかることがあります。テストを修正するたびに、ほかのテストを壊していないことを再度確認するために全体のテストを実行することになります。ただし通らないテストが修正されないかぎり、ほかのすべてのテストを再実行するのは無意味です。このプロセスを速くするために、test:all タスクには以前の実行で通らなかったテストのみを再実行するように強制する --only-failed (ショートカットは -f) オプションがあります:

$ php symfony test:all --only-failed

最初の実行では、すべてのテストがいつものとおりに実行されます。しかし次回以降のテストでは、最後に通らなかったテストのみが実行されます。コードを修正するにつれて、テストの一部が通り、次回以降の実行から除外されます。すべてのテストが再び通るとき、フルテストスイートが実行され、きれいにすることができます。