Düzenli bir besteci komutuyla yeni bir Symfony 2.5 projesi oluşturdum:

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

Terminal bana soruyor:

Symfony 3 dizin yapısını kullanmak ister misiniz?

Bu Symfony 3 dizin yapısı nedir? Daha önce hiç görmedim ... 2.5'ten beri yeni mi?

Kullanmanın faydaları nelerdir?

Bu dizin yapısını kopyalamanın herhangi bir yolu var mı?

Yeni Symfony 3 dizin yapısını kullanmak istiyorum ama soruyu görmüyorum?

Neden Would you like to use Symfony 3 directory structure?olduğu karışıklık nedeniyle yeni bir proje oluşturulurken soru kaldırıldı. Aşağıdakileri kullanarak dizin yapısını kullanmaya zorlayabilirsiniz:

Yeni yapıyı tercih ederseniz, ortam değişkenini SENSIOLABS_ENABLE_NEW_DIRECTORY_STRUCTUREkendinize .bashrcveya .bash_profilebenzer şekilde ekleyebilirsiniz :

Gelecekteki tüm projelerin yeni yapıyı istemesini sağlayın

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

YALNIZCA BU projeyi yeni yapıyı kullanmak isteyip istemediğimizi sorun.

Yalnızca belirli bir proje için istiyorsanız (tek seferlik), şunları kullanabilirsiniz:

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

Ortam değişkeni ise SENSIOLABS_ENABLE_NEW_DIRECTORY_STRUCTUREset ve ayarlandığında true, composeryeni dizin yapısını kullanmak istiyorsanız soracaktır.

Symfony2Ve Symfony3dizin yapısı arasındaki tüm değişiklikler için aşağıyı okumaya devam edin .

Yeni Symfony 3 dizin yapısı nedir?

(ve beni ve iş akışımı nasıl etkiler)

Biri symfony-2.5.0dizin yapılı, biri symfony-3(sadece dizin yapısı değişikliği) olan 2 proje oluşturarak bu konuya baktım .

Her projeden birini yapın:

# 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

Şimdi karşılaştırmak istediğimiz 2 farklı dizine sahibiz.

diffErence bul

Şunları diffkullanarak 2 dizin arasında yapabilirsiniz :

$ 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
*/

Bu, 2 sürümde farklılık gösteren dosyaları gösterir.

Dağılımı diff

İşte farktaki her şeyin bir dökümü.

# 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 dizin yapısının faydaları

Yeni dizin yapısının, hepsi küçük olan ve iş akışınızda minimum değişiklik gerektirebilecek bir dizi avantajı vardır.

PHPUnit

phpunit yapılandırma dosyasının yolunu açıkça belirtmek zorunda kalmadan proje kökünden çalıştırılabilir.

# Symfony2
phpunit -c app/phpunit.xml

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

İkili Yürütülebilir Dosyalar

Tüm çalıştırılabilir ikili dosyalar artık tek bir konumda bulunuyor - bindizin (unix benzeri bir os'a benzer) .

# 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

Yeni /vardizin

Yeni /vardizin, sistemin çalışması sırasında veri yazdığı dosyaları içerir (unix benzeri bir os'a benzer) .

Bu ayrıca izin eklemeyi kolaylaştırır, /vardizinin tamamı web sunucunuz tarafından yazılabilir olmalıdır. İzinleri ayarlamak için ( app/cache&& app/logsyerine var) Symfony2 kılavuzunu takip edebilirsiniz , yerel olarak yazmak istediğiniz diğer dosyalar da burada bulunabilir.

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

Symfony gereksinimleri kontrolü

Çalıştırmak symfony_requirements, zorunlu ve isteğe bağlı ortam yapılandırmalarını çıkarır.
Örneğin:

********************************
* '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)
'

Sonuç

Sensio Labs tarafından iyi düzenli up gibi görünüyor, her şeyden değişiklikler mükemmel mantıklı, onlar dan yükseltme zaman uygulamak kolay olmalı 2.5için 3.x, bu muhtemelen sorunlarının en küçüğü olacak!

Belgeleri okuyun

Symfony 2.x => 3.0 Belgeleri buradan yükseltin
Symfony 3.0 Mimarisi

Symfony 3 için Çıkış Tarihi

Yayın sürecine çok uzak görünüyor (okumaya değer) :

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

_{(kaynak: symfony.com )}

Eski ve yeni dizin yapısı arasındaki değişikliklerin bir listesi:

• Yeni bir varklasör tanıtıldı
• app/console taşındı bin/console
• app/check.php taşındı / yeniden adlandırıldı bin/symfony_requirements
• app/phpunit.xml.dist kök klasöre taşınır
• app/SymfonyRequirements.php taşındı var/SymfonyRequirements.php
• app/cacheve app/logsklasörler taşındı var/cacheve var/logssırasıyla

(Şu anda eski dosyaların tümü kaldırılmış görünmüyor, bu nedenle tüm dosyaları sürüm kontrolüne almadan önce bunu manuel olarak yapmak isteyebilirsiniz. Bu soruna bakın )

Öyleyse faydası nedir?

Bu değişikliklerin birkaç faydası var. Öncelikle Symfony için yazılabilir olması gereken tüm dosya ve klasörler artık varklasörde. Bu, izinleri yapılandırmayı çok daha kolaylaştırmalıdır: sadece varklasöre yazma erişimini sağlayın ve işiniz bitti. Bu, bu blog gönderisinde önerilmektedir - bunu henüz kendim denemedim.

İkincisi, dahil tüm çalıştırılabilir dosyalar consoleartık binklasörde. Bu, örneğin Bash kullanıcılarının bunu dosyalarına eklemesine izin verir .profile:

# set PATH so it includes current bin folder
PATH="./bin:$PATH"

Artık yazmak zorunda bile değilsin bin/console, sadece consoleyeterli olacak (bunun çalışması için yeniden başlatmam gerektiğini unutmayın).

Başka iyileştirmeler de var. app/check.phpartık bir yürütülebilir dosya olduğundan, bin/symfony_requirementsyerine kullanarak çağırabilirsiniz php app/check.php. (Daha .profileönce anlattığım numarayı kullanmak symfony_requirementsda yeterli olacaktır)

Ve son olarak, PHPUnit'i çalıştırırken konfigürasyon dosyasının konumunu artık belirtmeniz gerekmiyor. Yani bunun yerine phpunit -c appbasitçe uygulayabilirsiniz phpunit.

Mevcut projeleri de bu yeni yapıya yükseltebilir miyim?

Varsayılan olarak, yeni bir proje oluştururken (kullanarak composer create-project symfony/framework-standard-edition path/ "2.5.*") yalnızca 'Yeni dizin yapısını kullanmak istiyor musunuz' sorusunu alırsınız .

Bununla birlikte, mevcut bir Symfony uygulamasını yükseltmek mümkündür, ancak bu biraz hilekar bir çözümdür. Şimdi bunu bir dizi uygulamayla başardım ve bu özetteki adımları okuyabilirsiniz . Ancak bunun için tasarlanmadığı için, her zaman işe yarayacağını garanti edemem.

Güncelleme

Composer aracılığıyla yeni bir Symfony uygulaması oluştururken, Symfony'nin artık yeni dizin yapısını kullanmak isteyip istemediğinizi sormadığı ortaya çıktı. Ancak yine de bir ortam değişkeni kullanarak yeni dizin yapısı ile Symfony projeleri oluşturmak mümkündür. Daha fazla bilgi için bkz . Yeni dizin yapısıyla nasıl yeni bir Symfony projesi oluşturabilirim?