Symfony フレームワークのインストールとセットアップ
Symfony へようこそ!新しい Symfony プロジェクトを開始するのは簡単で、最初に動作する Symfony プログラムは数分で設定できます。
新しいプログラムの作成を簡単にするために、Symfony はインストーラーを提供しています。これをダウンロードすることが最初のステップです。
Symfony インストーラーのインストール ¶
Symfony インストーラー を使用することが、新しい Symfony プロジェクトを作成する唯一の推奨方法です。インストーラーは単なる php プログラムであり、一度インストールするだけで、無制限の数の Symfony プログラムを作成できます。
インストーラーには php5.4 以降が必要です。レガシー php5.3 をまだ使用している場合は、Symfony インストーラーを使用できません。
WAMP、XAMP、MAMP などのパッケージ化されたソリューションを使用している場合は、最新バージョンの PHP が使用されているかどうかを確認してください。コマンドラインで次のコマンドを使用して、PHP バージョンを確認できます:
$ php --version
オペレーティング システムによっては、Symfony インストーラーのインストール方法も異なります。
Linux および MAC OS X システム ¶
コマンド ライン ツールを開いて次のコマンドを実行します:
$ sudo curl -LsS https://symfony.com/installer -o /usr/local/bin/symfony $ sudo chmod a+x /usr/local/bin/symfony
これにより、システムに対するグローバル Symfony コマンドが作成されます。
Windows システム ¶
Windows では、次のコマンドを実行します。
c:\>php -r "readfile('http://symfony.com/installer');" > symfony
これは、symfony
ファイルをダウンロードし、そのファイルを次の場所に移動します。 Symfony プロジェクトを作成するフォルダーに移動したら、次のコマンドを実行してさまざまなインストールを起動できます:
c:\>move symfony c:\projects c:\projects\> php symfony
Symfony プログラムの作成 ¶
Symfony インストーラーがセットアップされたら、新しいコマンド new
を使用して、Symfony プロジェクトを作成します:
# Linux, Mac OS X $ symfony new my_project_name # Windows c:\> cd projects/ c:\projects\> php symfony new my_project_name
このコマンドは、新しい my_project_name
ディレクトリを作成します。 Symfony プログラムの最新の安定バージョンの新しいプロジェクトに基づくディレクトリ。さらに、インストーラーは、システムが Symfony プログラムを実行するための技術要件を備えているかどうかもチェックします。満たされていない場合は、「何を変更する必要があるか」の要件のリストが表示されます。
セキュリティ上の理由から、Symfony のすべてのバージョンは配布前にデジタル署名されています。プログラムに統合されているバージョン番号を確認する必要がある場合は、この記事の手順に従ってください。
インストーラーが動作しない、または何も出力しない場合は、システムに phar 拡張機能がインストールされ有効になっていることを確認してください。
プログラムを特定の Symfony バージョンで実行する ¶
特定の Symfony バージョンでプロジェクトを実行する必要がある場合は、2 番目のオプションを指定して new
コマンドを使用します。 パラメーター:
# use the most recent version in any Symfony branch 不同分支的最新版本 $symfony new my_project_name 2.8 $symfony new my_project_name 3.0 # use a specific Symfony version 指定版本 $symfony new my_project_name 2.7.3$ symfony new my_project_name 2.8.1 # use a beta or RC version (useful for testing new Symfony versions) 新版可用于测试 $symfony new my_project 3.0.0-BETA1$ symfony new my_project 2.7.0-RC1
インストーラーは、最新の長期保守バージョンである Symfony LTS バージョンである特別なバージョン lts
もサポートしています。
$ symfony new my_project_name lts
詳しく理解するには、Symfony のリリース プロセスを参照してください。なぜ存在するのか どのバージョンのフレームワークが存在し、どのバージョンがプロジェクトにより適しているのか。
インストーラーを使用せずに Symfony プログラムを作成する ¶
まだ php5.3 を使用している場合、または何らかの理由でインストーラーを実行できない場合は、composer に基づいて Symfony をインストールできます。
Composer は、最新の PHP プログラムで広く使用されている依存関係マネージャーであり、Symfony フレームワークのインストールにも使用できます。 Composer をグローバルにインストールする必要がない場合は、以下をお読みください。
Composer をグローバルにインストールする ¶
「Composer をグローバルにインストールする」を参照してください。
Composer を使用して Symfony プログラムを作成する ¶
Composer をインストールしている場合は、create-project
コマンドを実行して、Symfony プログラム ベースの Symfony プログラムを作成します。安定バージョンの場合:
$ composer create-project symfony/framework-standard-edition my_project_name
バージョンを指定する必要がある場合は、create-project
$ composer create-project symfony/framework-standard-edition my_project_name "3.0.*"
-vvv フラグを追加して、Composer が実行しているすべての詳細を出力します。
¶
開発時に、Symfony は PHP の組み込み Web サーバーを利用します。したがって、プロジェクトが存在するディレクトリで Symfony プログラムを実行し、次のコマンドを実行します:$ cd my_project_name/ $ php bin/console server:run次に、ブラウザを開いて
http://localhost:8000/ リンクにアクセスします。 Symfony のウェルカム ページを表示するには :
仮想ホスト) を設定する必要があります。
server:run
コマンドは開発段階にのみ適しています。 Apache や Nginx などの従来の Web サーバーを使用する場合は、「Web サーバーの構成」の記事を参照してください。
Symfony 実行環境の構成を確認する ¶
Symfony プログラムには、関連する設定が Symfony に適しているかどうかを示すサーバー環境チェッカーが組み込まれています。以下のリンクにアクセスして確認してください:
http://localhost:8000/config.php
表示の問題がある場合は、Symfony の使用を続ける前に問題を修正してください。
Symfony プログラムの更新 ¶
この時点で、すぐに開発できる完全に機能する Symfony プロジェクトが作成されました。 symfony プログラムは多数の外部クラス ライブラリに依存しています。これらのライブラリは vendor/
ディレクトリにダウンロードでき、Composer によって排他的に管理されます。
これらのサードパーティ ライブラリを頻繁に更新することは、バグや脆弱性を防ぐためのベスト プラクティスです。 Composer の update
コマンドを実行して、すべてを一度に更新します。
$ cd my_project_name/ $ composer update
プロジェクトの複雑さによっては、この更新方法が完了するまでに数分かかります。
Symfony は、プロジェクトの依存関係に既知の重大なセキュリティ脆弱性が含まれているかどうかを確認するためのコマンドも提供します:
$ php bin/console security:check
このコマンドを定期的に実行することをお勧めします。できるだけ早く更新または交換できます。
Symfony デモ プログラムをインストールする ¶
Symfony デモ プログラムは完全に機能し、推奨される開発アプローチを示します。これは、Symfony 初心者向けの学習ツールとして意図されており、ソースコードには広範なコメントと役立つヒントが含まれています。
デモ プログラムをダウンロードするには、システム上のどこからでも、Symfony インストーラーの demo
コマンドを実行します:
# Linux, Mac OS X $ symfony demo # Windows c:\projects\> php symfony demo
ダウンロードしたら、symfony_demo
ディレクトリに移動し、PHP 組み込み Web サーバーを実行し、php bin/console server:run
コマンドを実行して、ブラウザの http://localhost:8000
リンクにアクセスします。 start Symfony デモ プログラムを使用します。
Symfony 配布パッケージをインストールする ¶
Symfony プロジェクトの「配布パッケージ」とは、Symfony コア クラス ライブラリ、必要なバンドルのセット、および適切なディレクトリ構造のセットといくつかのデフォルト構成。実際、上記のように Symfony プログラムを作成すると、Symfony が提供する Symfony Standard Edition (Symfony Standard Edition) というデフォルトの配布パッケージがダウンロードされます。
Symfony Standard Edition は現在最も人気のあるディストリビューションであり、Symfony 開発者にとって最初の選択肢です。ただし、Symfony コミュニティでは、選択できる他の配布パッケージも提供しています。
Symfony CMF Standard Edition は、Symfony CMF を必要とする推奨配布パッケージです。CMF は、Symfony に基づくオープンソース プロジェクトであり、開発者が CMS (コンテンツ管理システム) 機能を簡単に追加できます。フレームワーク。
Symfony REST Edition では、RESTFul API プログラムを構築する方法を示します。このディストリビューションには、FOSRestBundle とその他のいくつかの関連バンドルが統合されています。
ソース管理を使用する ¶
Git などのバージョン管理システムを使用している場合は、すべてのプロジェクト コードを安全にコミットできます。これは、Symfony プログラムには、Symfony 用に特別に用意された .gitignore
ファイルがすでに含まれているためです。
Git でプロジェクト コードをホストすることが「どれほど優れているか」については、「Git で Symfony プロジェクトを作成して保存する方法」を参照してください。
バージョン管理された Symfony プログラムを確認する ¶
Composer を使用してプログラムの依存関係を管理する場合、コードをリポジトリフォルダーに送信するときに、vendor
ファイル全体を無視することをお勧めします。これは、Git リポジトリから Symfony プログラムを表示すると、その中に vendor
ディレクトリが存在せず、当然ながらプログラム全体を起動するのが困難であることを意味します。
プログラムを実行するには、Symfony プログラムを確認し、install
この Composer コマンドにより、プログラムに必要なすべての依存関係がダウンロードされ、インストールされます:
$ cd my_project_name/ $ composer install
理由Composer は、どの特別な依存関係をインストールする必要があるかを知っていますか?これは、Symfony プログラムがリポジトリに送信されるときに、composer.json
および composer.lock
ファイルも送信されるためです。これら 2 つのファイルは、Symfony のインストール時にどの依存関係 (およびその特定のバージョン) が必要であるかを Composer に伝えます。
開発を開始する ¶
完全に機能する Symfony プログラムが完成したので、開発を開始できます。配布パッケージにはサンプル コードが含まれています。配布パッケージ内のルーチンの詳細については、プログラム内の README.md
ファイル (メモ帳で開きます) を参照してください。
Symfony を初めて使用する場合は、「最初の Symfony ページの作成」を参照してください。ここでは、ページの作成方法、設定の変更方法、および新しいプログラムで実行したいその他のことを学ぶことができます。