1. ホーム
  2. symfony

[解決済み] Symfony 3 の新しいディレクトリ構造は何ですか?

2023-03-27 13:38:32

質問

通常のcomposerコマンドでsymfony 2.5のプロジェクトを作成したところです。

php composer.phar create-project symfony/framework-standard-edition path/ 2.5.0

端末が聞いてくる。

symfony 3 のディレクトリ構造を使いたいですか?

これは何ですか? symfony 3 のディレクトリ構造は? 今まで見たことがありません... 2.5から新しくなったのでしょうか?

使用するメリットは何ですか?

このディレクトリ構造を再現する方法はありますか?

どのように解決するのですか?

新しいSymfony 3のディレクトリ構造を使いたいのですが、質問が見当たりません?

質問の Would you like to use Symfony 3 directory structure? は、混乱を招いたため、新しいプロジェクトを作成する際に削除されました。以下のようにして、強制的にディレクトリ構造を使用させることができます。

新しい構造を好む場合は、環境変数 SENSIOLABS_ENABLE_NEW_DIRECTORY_STRUCTURE をあなたの .bashrc または .bash_profile のように

将来のすべてのプロジェクトが新しい構造を要求するようにする

# .bash_profile
# ALL new composer installs will ask `Would you like to use the new Symfony3 strucure?`
export SENSIOLABS_ENABLE_NEW_DIRECTORY_STRUCTURE=true

ONLY THIS プロジェクトが新しい構造を使用するかどうか尋ねるようにする。

特定のプロジェクトだけ(ワンオフ)に欲しかったら、使える。

SENSIOLABS_ENABLE_NEW_DIRECTORY_STRUCTURE=true composer create-project symfony/framework-standard-edition path/ "2.5.*"

もし、環境変数 SENSIOLABS_ENABLE_NEW_DIRECTORY_STRUCTURE が設定され true , composer は、新しいディレクトリ構造を使用するかどうかを尋ねます。

の間のすべての変更点については、以下を読み進めてください。 Symfony2Symfony3 というディレクトリ構造になっています。


symfony 3 の新しいディレクトリ構造は何ですか?

(そして、私のワークフローにどのような影響があるのでしょうか?)

私は2つのプロジェクトを作成することでこれを調べました。 symfony-2.5.0 ディレクトリ構造、1つは symfony-3 というディレクトリ構造になっています(ディレクトリ構造の変更のみ)。

各プロジェクトを1つずつ作成します。

# say `N` to `Would you like to use Symfony 3 directory structure?`
$ composer create-project symfony/framework-standard-edition symfony-2.5.0/ 2.5.0

# say `Y` to `Would you like to use Symfony 3 directory structure?`
$ composer create-project symfony/framework-standard-edition symfony-3/ 2.5.0

これで、比較したい2種類のディレクトリができました。


ディレクトリを検索します。 diff を探す

あなたは diff を使って、2つのディレクトリの間で

$ diff -rq symfony-2.5.0/ symfony-3/
/** (Returned from the diff)
Files symfony-2.5.0/.gitignore and symfony-3/.gitignore differ
Files symfony-2.5.0/.travis.yml and symfony-3/.travis.yml differ
Only in symfony-2.5.0/app: bootstrap.php.cache
Only in symfony-2.5.0/app: cache
Only in symfony-2.5.0/app: console
Only in symfony-2.5.0/app: logs
Only in symfony-2.5.0/app: phpunit.xml.dist
Only in symfony-3/bin: console
Only in symfony-3/bin: symfony_requirements
Files symfony-2.5.0/composer.json and symfony-3/composer.json differ
Only in symfony-3/: phpunit.xml.dist
Only in symfony-3/: var
Files symfony-2.5.0/vendor/autoload.php and symfony-3/vendor/autoload.php differ
Files symfony-2.5.0/vendor/composer/autoload_real.php and symfony-3/vendor/composer/autoload_real.php differ
Files symfony-2.5.0/web/app.php and symfony-3/web/app.php differ
Files symfony-2.5.0/web/app_dev.php and symfony-3/web/app_dev.php differ
*/

2つのバージョンで異なるファイルを表示しています。


のブレークダウン diff

diffに含まれるすべての内訳です。

# These files still exist in both versions (with different content)
.gitignore
.travis.yml
composer.json
vendor/autoload.php
vendor/composer/autoload_real.php
web/app.php
web/app_dev.php

# The following files have been removed from 2.5.0
# {RemovedFile2.5}      |  {ReplacedWith3.0}
app/cache               |  var/cache
app/logs                |  var/log
app/bootstrap.php.cache |  var/bootstrap.php.cache
app/console             |  bin/console
app/phpunit.xml.dist    |  phpunit.xml.dist

# The following files are new in 3.0
bin/symfony_requirements # run via CLI


symfony 3 のディレクトリ構造の利点

新しいディレクトリ構造には多くの利点があり、これらはすべて些細なことで、ワークフローに最小限の変更を必要とするかもしれません。

PHPUnit

phpunit は、設定ファイルのパスを明示的に指定しなくても、 プロジェクトのルートから実行することができます。

# Symfony2
phpunit -c app/phpunit.xml

# Symfony3 (no need to specify the configuration file location)
phpunit

バイナリ実行可能ファイル

すべてのバイナリ実行ファイルは、単一の場所、つまり bin ディレクトリにあります。 (unix ライクな os に似ています) .

# you can update your `PATH` to include the `bin` directory
PATH="./bin:$PATH"

# From your project root you can now run executables like so:
console
symfony_requirements
doctrine

# else with no `PATH` update
bin/console
bin/symfony_requirements
bin/doctrine

新しい /var ディレクトリ

新しい /var ディレクトリには、システムが動作中にデータを書き込むファイル (unix ライクな os に似ています) .

これはまた、パーミッションの追加を容易にするために、全体の /var ディレクトリ全体が書き込み可能である必要があります。を追うことができます。 パーミッションを設定するためのsymfony2ガイド (代わりの app/cache && app/logsvar のように)、ローカルに書き込みたい他のファイルもここに置くことができます。

# default symfony3 `var` directory
var/bootstrap.php.cache
var/cache
var/logs

symfonyの要件チェック

実行中 symfony_requirements を実行すると、必須の&と、オプションの環境設定が出力されます。

など。

********************************
* 'Symfony requirements check' *
********************************

* Configuration file used by PHP: /usr/local/php5/lib/php.ini

/** ATTENTION **
*  The PHP CLI can use a different php.ini file
*  than the one used with your web server.
*  To be on the safe side, please also launch the requirements check
*  from your web server using the web/config.php script.
*/

** Mandatory requirements **
'
 OK       PHP version must be at least 5.3.3 (5.5.11 installed)
 OK       PHP version must not be 5.3.16 as Symfony wont work properly with it
 OK       Vendor libraries must be installed
 OK       var/cache/ directory must be writable
 OK       var/logs/ directory must be writable
 OK       date.timezone setting must be set
 OK       Configured default timezone "Europe/London" must be supported by your installation of PHP
 OK       json_encode() must be available
 OK       session_start() must be available
 OK       ctype_alpha() must be available
 OK       token_get_all() must be available
 OK       simplexml_import_dom() must be available
 OK       APC version must be at least 3.1.13 when using PHP 5.4
 OK       detect_unicode must be disabled in php.ini
 OK       xdebug.show_exception_trace must be disabled in php.ini
 OK       xdebug.scream must be disabled in php.ini
 OK       PCRE extension must be available
'
** Optional recommendations **
'
 OK       xdebug.max_nesting_level should be above 100 in php.ini
 OK       Requirements file should be up-to-date
 OK       You should use at least PHP 5.3.4 due to PHP bug #52083 in earlier versions
 OK       When using annotations you should have at least PHP 5.3.8 due to PHP bug #55156
 OK       You should not use PHP 5.4.0 due to the PHP bug #61453
 OK       When using the logout handler from the Symfony Security Component, you should have at least PHP 5.4.11 due to PHP bug #63379 (as a workaround, you can also set invalidate_session to false in the security logout handler configuration)
 OK       You should use PHP 5.3.18+ or PHP 5.4.8+ to always get nice error messages for fatal errors in the development environment due to PHP bug #61767/#60909
 OK       PCRE extension should be at least version 8.0 (8.34 installed)
 OK       PHP-XML module should be installed
 OK       mb_strlen() should be available
 OK       iconv() should be available
 OK       utf8_decode() should be available
 OK       posix_isatty() should be available
 OK       intl extension should be available
 OK       intl extension should be correctly configured
 OK       intl ICU version should be at least 4+
 OK       a PHP accelerator should be installed
 OK       short_open_tag should be disabled in php.ini
 OK       magic_quotes_gpc should be disabled in php.ini
 OK       register_globals should be disabled in php.ini
 OK       session.auto_start should be disabled in php.ini
 OK       PDO should be installed
 OK       PDO should have some drivers installed (currently available: mysql, sqlite, dblib, pgsql)
'


結論

Sensio Labs による良い整理整頓のようです。上記の変更はすべて理にかなっており、 からアップグレードする際に簡単に実装できるはずです。 2.5 から 3.x に変更する必要がありますが、これらはおそらくあなたの問題のうちで最も少ないものでしょう!

ドキュメントを読む

symfony 2.x => 3.0アップグレードのドキュメントはこちらです。

symfony 3.0 のアーキテクチャ

symfony 3 のリリース日

リリースプロセスを見ていると、ずいぶん遠くにあるように見えますが (一読の価値あり) :

http://symfony.com/doc/current/contributing/community/releases.html



(ソース symfony.com )