プロジェクトの初期化¶

新しい Symfony のプロジェクトを、前章で説明した symfony CLI ツールで作成しましょう。

1
2

$ symfony new guestbook --version=5.2
$ cd guestbook

このコマンドは Composer コマンドの薄いラッパーで、Symfony プロジェクトを作成することを簡単にしてくれます。このコマンドは、最小限の依存のみを含んでいます。それは、どんなプロジェクトでも必要になるコンソールツールや HTTP アブストラクションなどのWebアプリケーションを作成するのに必要なSymfony コンポーネントの依存を含んだ プロジェクトのスケルトン を使用します。

スケルトンの GitHub のリポジトリを見てみると、ほとんど何もないことに気づくでしょう。 composer.json のみです。しかし、 guestbook ディレクトリはファイルがたくさん入っています 。どうやってやっているのでしょうか？答えは symfony/flex パッケージです。 Symfony Flex は Composer のプラグインで、インストールの処理をフックしています。Symfony Flex が レシピ を検知すると、実行してくれるのです。

この Symfony レシピのマニフェストファイルで、Symfony アプリケーション内のパッケージを自動登録するように記述してあります。README を読まなくても Symfony のパッケージをインストールす ることができます。自動化が Symfony の鍵となる機能ですから。

Git が自分の開発パソコンにインストールされていれば、 symfony new コマンドは Git リポジトリも作成してくれ、最初のコミットも追加してくれます。

ディレクトリ構造を見てみましょう:

1
2
3
4
5
6
7
8
9

├── bin/
├── composer.json
├── composer.lock
├── config/
├── public/
├── src/
├── symfony.lock
├── var/
└── vendor/

bin/ ディレクトリは、よく使う CLI コマンドの console が入っています。これからたくさん使うことなります。

config/ ディレクトリは、デフォルトと注意が必要な設定の一式が入っています。各パッケージで1つのファイルとなります。ほとんど変更することもないと思います。デフォルト設定を使用するのは良いアイデアですね。

public/ ディレクトリは、Webルートのディレクトリで、すべての HTTP のリソースのエントリーポイントである index.php ファイルがあります。

src/ ディレクトリは、あなたが書くことになるコードが入る場所で、開発時のほとんどはここを使用することになります。デフォルトでは、このディレクトリに入る全てのクラスは App ネームスペースを使用することになります。

var/ ディレクトリは、キャッシュやログやアプリケーションによってラインタイムで生成されるファイルが格納されます。触る必要はありません。このディレクトリのみが本番において、書き込み可能な場所になります。

vendor/ ディレクトリは Symfony 自体も含め、Composer によってインストールされたすべてのパッケージが格納されます。ここがより生産的になるのに重要な秘密兵器になります。車輪の再発明は止めましょう。大変な作業は既存のライブラリに任せる方が良いです。このディレクトリは Composer によって管理されているので触らないでください。

現段階で、知る必要があるのはこれだけです。

公開するファイルの作成¶

public/ 配下のファイルはブラウザからアクセスが可能です。例えば、アニメーションGIFファイルを public/images/ ディレクトリに移動したなら、 https://localhost/images/under-construction.gif のような URL で参照できるでしょう。

GIF 画像をここからダウンロードしてください:

1
2

$ mkdir public/images/
$ php -r "copy('http://clipartmag.com/images/website-under-construction-image-6.gif', 'public/images/under-construction.gif');"

ローカルのWebサーバの起動¶

symfony CLI コマンドは、開発用に最適化されたWebサーバとしても機能します。Symfony とうまく連携してくれるのですが、開発用としての使用のみで、決して本番環境では使用してはいけません。

プロジェクトのディレクトリからバックグラウンドでWebサーバを動かしましょう (-d フラグ):

1

$ symfony server:start -d

サーバは 8000 番からはじまる使用可能なポートで立ち上がります。ショートカットを使用して、 CLI からブラウザでwebサイトを開いてみましょう:

1

$ symfony open:local

あなたのデフォルトのブラウザが立ち上がり、次のようなページが表示されると思います:

/images/under-construction.gif を見てください。こんな感じになりましたか？

では、今作成したものをコミットしましょう。

1
2

$ git add public/images
$ git commit -m'Add the under construction image'

favicon を追加する¶

favicon がないので、ブラウザからのリクエストでによってログに 404 HTTP エラー が書かれしまうので、追加しましょう:

1
2
3

$ php -r "copy('https://symfony.com/favicon.ico', 'public/favicon.ico');"
$ git add public/
$ git commit -m'Add a favicon'

本番の準備¶

本番に今までの作業内容をデプロイしてみましょう。まだユーザーにウェルカムを表示するための HTML ページもないのはわかっています。しかし、まず、 "under construction" イメージを表示できるようにすることは、最初のステップとしては良いものだと思います。そして、 速く頻繁にデプロイする というモットーですね。

PHP をサポートしているどんなプロバイダーでもこのアプリケーションをホストすることが可能です。つまり、世の中のほとんどのホスティングプロバイダーが対象となります。しかし、少しチェックすることがあります。PHP のバージョンが最新であり、データベースやキューなどのサービスをホストできるプロバイダーが良いですね。

私が選択したのは SymfonyCloud です。 SymfonyCloud は私達が必要なものをすべて提供してくれますし、Symfony の開発の資金ともなってもいます。

symfony CLI コマンドは SymfonyCloud のビルトインサポートがありますので、ぜひ SymfonyCloud プロジェクトを初期化してみましょう:

1

$ symfony project:init

このコマンドは SymfonyCloud で必要になるファイルを作成します。それらは、 .symfony/services.yaml, .symfony/routes.yaml, .symfony.cloud.yaml です。

Git に追加してコミットしましょう。

1
2

$ git add .
$ git commit -m"Add SymfonyCloud configuration"

本番へ¶

デプロイの時間？

新しい SymfonyCloud プロジェクトを作成してください:

1

$ symfony project:create --title="Guestbook" --plan=development

このコマンドはたくさんのことを行います:

• はじめてこのコマンドを使用すると、 SymfonyConnect のクレデンシャルの認証前では、認証を行います。
• 新しい SymfonyCloud のプロジェクトを用意します(すべての開発プロジェクトで、7日間は 無料 で使用できます)。

デプロイしましょう:

1

$ symfony deploy

Git リポジトリにプッシュされ、コードはデプロイされます。コマンドの最後に、アクセス可能なドメイン名を一つ持つことになります。

デプロイがうまくいったかチェックしましょう:

1

$ symfony open:remote

404 ページになるはずですが、/images/under-construction.gif が表示されます。

SymfonyCloud 上ではきれいなデフォルトの Symfony のページは表示されません。それは Symfony は環境の機能があり、SymfonyCloud は、自動的にコードを本番環境としてデプロイしているからです。