ฉันเพิ่งสร้างโครงการ Symfony 2.5 ใหม่ด้วยคำสั่งผู้แต่งปกติ:
php composer.phar create-project symfony/framework-standard-edition path/ 2.5.0
Terminal ถามฉันว่า:
คุณต้องการใช้โครงสร้างไดเร็กทอรี Symfony 3 หรือไม่
โครงสร้างไดเร็กทอรี Symfony 3นี้คืออะไร ไม่เคยเห็นมาก่อนเลยครับ ... ใหม่ตั้งแต่ 2.5?
ประโยชน์ของการใช้งานคืออะไร?
มีวิธีการจำลองโครงสร้างไดเร็กทอรีนี้หรือไม่?
คำตอบ:
คำถาม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
หากคุณต้องการสำหรับโครงการใดโครงการหนึ่งเท่านั้น (ปิดครั้งเดียว) คุณสามารถใช้:
SENSIOLABS_ENABLE_NEW_DIRECTORY_STRUCTURE=true composer create-project symfony/framework-standard-edition path/ "2.5.*"
ถ้าตัวแปรสภาพแวดล้อมSENSIOLABS_ENABLE_NEW_DIRECTORY_STRUCTUREมีการตั้งค่าและการตั้งค่าไปtrue, composerจะถามว่าคุณต้องการที่จะใช้โครงสร้างไดเรกทอรีใหม่
อ่านต่อด้านล่างสำหรับการเปลี่ยนแปลงทั้งหมดระหว่างโครงสร้างSymfony2และSymfony3ไดเร็กทอรี
(และมีผลอย่างไรกับฉันและขั้นตอนการทำงานของฉัน)
ฉันตรวจสอบสิ่งนี้โดยการสร้าง 2 โปรเจ็กต์หนึ่งโปรเจ็กต์มีsymfony-2.5.0โครงสร้างไดเร็กทอรีหนึ่งด้วยsymfony-3(เปลี่ยนโครงสร้างไดเร็กทอรีเท่านั้น)
สร้างหนึ่งในแต่ละโครงการ:
# 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 ไดเร็กทอรีที่แตกต่างกันที่เราต้องการเปรียบเทียบ
differenceคุณสามารถ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นี่คือรายละเอียดของทุกอย่างในความแตกต่าง
# 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
โครงสร้างไดเร็กทอรีใหม่มีประโยชน์หลายประการซึ่งทั้งหมดนี้เป็นเพียงเล็กน้อยและอาจต้องมีการเปลี่ยนแปลงขั้นตอนการทำงานของคุณเพียงเล็กน้อย
phpunit สามารถรันจากรูทโปรเจ็กต์โดยไม่ต้องระบุพา ธ ของไฟล์คอนฟิกูเรชันอย่างชัดเจน
# Symfony2
phpunit -c app/phpunit.xml
# Symfony3 (no need to specify the configuration file location)
phpunit
ไฟล์ไบนารีทั้งหมดในขณะนี้ทั้งหมดตั้งอยู่ในสถานที่เดียว - The binไดเรกทอรี(คล้ายกับยูนิกซ์เหมือน 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ไดเรกทอรีมีไฟล์ที่ระบบเขียนข้อมูลลงในช่วงของการดำเนินงานของ(คล้ายกับยูนิกซ์เหมือน OS)
นอกจากนี้ยังช่วยให้เพิ่มสิทธิ์ได้ง่ายขึ้น/varเว็บเซิร์ฟเวอร์ของคุณควรเขียนไดเร็กทอรีทั้งหมดได้ คุณสามารถทำตามคำแนะนำ Symfony2 สำหรับการตั้งค่าการอนุญาต (การแทนที่app/cache&& app/logsด้วยvar) ไฟล์อื่น ๆ ที่คุณต้องการเขียนในเครื่องอาจอยู่ที่นี่
# default symfony3 `var` directory
var/bootstrap.php.cache
var/cache
var/logs
การรัน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 The Architecture
ดูเหมือนจะห่างไกลจากกระบวนการเผยแพร่(น่าอ่าน) :
http://symfony.com/doc/current/contributing/community/releases.html
(ที่มา: symfony.com )
SENSIOLABS_ENABLE_NEW_DIRECTORY_STRUCTURE=true(ดูด้านบนของคำตอบของฉันสำหรับรายละเอียดทั้งหมด)
นี่คือรายการการเปลี่ยนแปลงระหว่างโครงสร้างไดเร็กทอรีเก่าและใหม่:
varแนะนำโฟลเดอร์ใหม่app/console ถูกย้ายไปที่ bin/consoleapp/check.php ถูกย้าย / เปลี่ยนชื่อเป็น bin/symfony_requirementsapp/phpunit.xml.dist ถูกย้ายไปยังโฟลเดอร์รากapp/SymfonyRequirements.php ถูกย้ายไปที่ var/SymfonyRequirements.phpapp/cacheและapp/logsโฟลเดอร์ได้ถูกย้ายไปvar/cacheและvar/logsตามลำดับ(ขณะนี้ไฟล์เก่าบางไฟล์ไม่ได้ถูกลบออกทั้งหมดดังนั้นคุณอาจต้องดำเนินการด้วยตนเองก่อนที่จะกำหนดไฟล์ทั้งหมดในการควบคุมเวอร์ชันดูปัญหานี้ )
การเปลี่ยนแปลงเหล่านี้มีประโยชน์สองสามประการ ก่อนอื่นไฟล์และโฟลเดอร์ทั้งหมดที่ควรเขียนได้สำหรับ Symfony จะอยู่ในvarโฟลเดอร์นี้ สิ่งนี้จะทำให้การกำหนดค่าสิทธิ์ง่ายขึ้นมาก: เพียงแค่รับรองสิทธิ์การเขียนไปยังvarโฟลเดอร์เท่านี้ก็เสร็จสิ้น สิ่งนี้แนะนำในบล็อกโพสต์นี้ - ฉันยังไม่ได้ลองทำด้วยตัวเอง
ประการที่สองไฟล์ปฏิบัติการทั้งหมดรวมถึงconsoleตอนนี้อยู่ในbinโฟลเดอร์ ที่ช่วยให้ผู้ใช้ Bash สามารถเพิ่มสิ่งนี้ลงใน.profileไฟล์ได้:
# set PATH so it includes current bin folder
PATH="./bin:$PATH"
ตอนนี้คุณไม่จำเป็นต้องพิมพ์bin/consoleอีกต่อไปก็consoleเพียงพอแล้ว (โปรดทราบว่าฉันต้องรีบูตเพื่อให้สิ่งนี้ทำงานได้)
มีการปรับปรุงอื่น ๆ เช่นกัน app/check.phpตอนนี้เป็นไฟล์ปฏิบัติการแล้วดังนั้นคุณสามารถเรียกมันโดยใช้bin/symfony_requirementsแทนphp app/check.phpไฟล์. (ใช้.profileเคล็ดลับที่ฉันอธิบายไว้ก่อนหน้านี้ก็symfony_requirementsเพียงพอแล้วเช่นกัน)
และสุดท้าย แต่ไม่ท้ายสุดคุณไม่จำเป็นต้องระบุตำแหน่งของไฟล์กำหนดค่าอีกต่อไปเมื่อเรียกใช้ PHPUnit ดังนั้นแทนที่จะคุณก็สามารถดำเนินการphpunit -c appphpunit
ตามค่าเริ่มต้นคุณจะได้รับเฉพาะคำถาม "คุณต้องการใช้โครงสร้างไดเรกทอรีใหม่" เมื่อสร้างโครงการใหม่ (โดยใช้composer create-project symfony/framework-standard-edition path/ "2.5.*")
อย่างไรก็ตามเป็นไปได้ที่จะอัปเกรดแอปพลิเคชัน Symfony ที่มีอยู่ แต่เป็นโซลูชันที่ค่อนข้างแฮ็ค ตอนนี้ฉันจัดการกับแอปพลิเคชันจำนวนมากแล้วและคุณสามารถอ่านขั้นตอนในส่วนสำคัญนี้ได้ อย่างไรก็ตามเนื่องจากไม่ได้ออกแบบมาสำหรับสิ่งนี้ฉันจึงไม่สามารถรับประกันได้ว่าจะใช้งานได้ตลอดไป
ปรากฎว่า Symfony ไม่ถามคุณอีกต่อไปว่าคุณต้องการใช้โครงสร้างไดเร็กทอรีใหม่หรือไม่เมื่อสร้างแอปพลิเคชัน Symfony ใหม่ผ่าน Composer อย่างไรก็ตามยังคงเป็นไปได้ที่จะสร้างโปรเจ็กต์ Symfony ด้วยโครงสร้างไดเร็กทอรีใหม่โดยใช้ตัวแปรสภาพแวดล้อม สำหรับข้อมูลเพิ่มเติมโปรดดูที่ฉันจะสร้างโครงการ Symfony ใหม่ด้วยโครงสร้างไดเรกทอรีใหม่ได้อย่างไร
.profileคุณคุณสามารถหาแหล่งไฟล์ในเชลล์ปัจจุบันของคุณใหม่หรือปิดและเริ่มเชลล์ใหม่ได้ การรัน. ~/.profileจะทำให้ไฟล์เป็นแหล่งที่มาใหม่อีกครั้ง (สังเกตช่องว่างด้านบน)