Symfony スタンダード・エディション

Symfony スタンダード・エディションへようこそ。Symfony スタンダード・エディションは、完全に動く Symfony2 アプリケーションで、新しくウェブサイトを作る際のスケルトンとして使用することができます。

このドキュメントでは、Symfony2 のダウンロード方法、インストール方法、そして Symfony の始め方を説明します。より詳細な説明は、 Symfony のドキュメントの Installation の章を参照してください。

1) スタンダード・エディションをインストールする

Symfony スタンダード・エディションをインストールするには以下のいくつかの方法があります。

Symfony は、依存関係を管理するために Composer を使用しています。新しくプロジェクトを作成する際には、この Composer の使用を推奨します。

Composer をまだダウンロードしていなければ、 http://getcomposer.org/ の説明に沿ってダウンロードするか、次のコマンドを実行してください。

curl -s http://getcomposer.org/installer | php

そして、 create-project コマンドを使用して Symfony アプリケーションを生成します。

composer.phar create-project symfony/framework-standard-edition path/to/install

Composer は path/to/install ディレクトリ以下に Symfony2 と全ての依存関係のあるパッケージをインストールします。

簡単に Symfony の動作をテストするには、スタンダード・エディションのアーカイブをダウンロードして、ウェブサーバのルートディレクトリ以下などに展開することもできます。

“without vendors” のアーカイブをダウンロードする際には、全ての依存関係のあるパッケージをインストールする必要があります。その際には、上記の説明にあったように Composer をダウンロードして次のコマンドを実行してください。:

php composer.phar install

設定を始める前に、あなたのローカルのシステム上で Symfony が正しく動作するかチェックします。次の２つのチェックをしてください。

まず、コマンドラインから check.php スクリプトを実行してください。:

php app/check.php

そして、ブラウザからも config.php スクリプトにアクセスしてください。:

http://localhost/path/to/symfony/app/web/config.php

Warning や Recommendation が表示された際には、次に進む前に修正してください。

おめでとうございます！ここまでくれば、Symfony を使用する準備ができました。

config.php のページから　”Bypass Configuration and go to the Welcome page” のリンクをクリックして、最初の Symfony のページをロードします。

また、 config.php ページの “Configure Application online” リンクをクリックすれば、ウェブベースのコンフィギュレーターを使用することもできます。

実際に動作する Symfony のアクションを見るには、次のページへアクセスしてみてください。:

web/app_dev.php/demo/hello/Fabien

このディストリビューションは、あなたの Symfony アプリケーションのスターティングポイントとなります。また、少しサンプルコードが付いてきており、学び、遊ぶことができます。

Symfony を学び始めるのに Quick Tour を見るのが良いでしょう。 Quick Tour では、 Symfony2 の基本的な機能を全て網羅しています。

学習してみて準備ができたら、公式の Symfony2 book を読み進めてください。

デフォルトのバンドルである AcmeDemoBundle で Symfony2 の動作を確認することができます。それでいくつか遊んで試したら、次のステップでこの AcmeDemoBundle を削除することができます。:

src/Acme ディレクトリを削除する
app/config/routing_dev.yml にある AcmeBundle を参照しているルーティングのエントリを削除する
app/AppKernel.php 内の登録されているバンドルから AcmeBundle を削除する
web/bundles/acmedemo ディレクトリを削除する
app/config/config.yml 内のセキュリティコンフィグレーションのインクルードを削除する（ - { resource: security.yml} の行を削除する）、もしくは、あなたのアプリケーションのニーズにフィットするセキュリティコンフィグレーションに修正する。

Symfony スタンダード・エディションは次のデフォルトを使用するように設定されています。:

そして、次のバンドルを設定してあります。:

FrameworkBundle - Symfony のコアフレームワークバンドル
SensioFrameworkExtraBundle - テンプレートとルーティングにアノテーション機能を追加するなどいくつかの便利な機能を追加
DoctrineBundle - Doctrine ORM のサポートを追加
TwigBundle - Twig テンプレートエンジンのサポートを追加
SecurityBundle - Symfony のセキュリティコンポーネントの統合によるセキュリティ機能を追加
SwiftmailerBundle - メール送信を行う Swiftmailer のサポートを追加
MonologBundle - ロギングライブラリである Monolog のサポートを追加
AsseticBundle - アセット処理のライブラリである Assetic のサポートを追加
JMSSecurityExtraBundle - アノテーションを介したセキュリティの追加を有効化
JMSDiExtraBundle - より強力なディペンデンシーインジェクション機能の追加
WebProfilerBundle (in dev/test env) - プリファイリングの機能とウェブデバッグツールバーを追加
SensioDistributionBundle (in dev/test env) - Symfony のディストリビューションでの設定と動作の機能を追加
SensioGeneratorBundle (in dev/test env) - コード生成の機能の追加
AcmeDemoBundle (in dev/test env) - サンプルコードのデモバンドル