Symfony 2 для разработчиков на symfony 1.x

Автозагрузка

Одной из отличительных черт современных фреймворков является то, что разработчику не нужно беспокоиться о подключении файлов. С использованием автозагрузчика вы можете ссылаться на любой класс в вашем проекте и быть уверенными что он доступен. В Symfony2 автозагрузчик был доработан, стал более универсальным, более быстрым и не требующим очистки кеша.

В symfony1 автозагрузчик выполнял поиск PHP классов по всему проекту и кешировал эту информацию в гигантском массиве. Этот массив устанавливал строгое соответствие какой файл содержит тот или иной класс. В продуктовом окружении эта операция требовала очистки кеша при добавлении нового класса или перемещении уже существующего.

В Symfony2 за этот процесс отвечает класс UniversalClassLoader. Идея его проста: имя класса (включая пространство имен) должно соответствовать пути к файлу, который содержит класс. Давайте рассмотрим HelloController из песочницы Symfony2 в качестве примера:

namespace SensioHelloBundleController;
use SymfonyBundleFrameworkBundleControllerController;
class HelloController extends Controller
{
    // ...

Сам файл располагается по пути src/Sensio/HelloBundle/Controller/HelloController.php. Как вы видите, расположение файла соответствует пространству имен класса. А именно, пространство имен SensioHelloBundleController, сообщает что директория, где будет расположен файл – srcSensioHelloBundleController.

Если файл не будет найден по ожидаемому пути, вы получите ошибку: Class "SensioHelloBundleControllerHelloController" does not exist.. В Symfony2 ошибка “class does not exist” означает, что пространство имен класса и его физическое расположение на диске не совпадают. Таким образом, Symfony2 ищет класс в одном единственном месте, которое ему положено. Кроме того, для того чтобы класс был автозагружен, вам никогда не придется очищать кеш в Symfony2.

Тем не менее, для того чтобы автозагрузчик работал правильно, ему нужно знать, что пространство имен Sensio расположено в директории src и, например, что пространство имен Doctrine располагается в директории vendor/doctrine/lib/. Данные правила полностью контролируются разработчиком (вами) посредством файла app/autoload.php.

Консоль

В symfony1 консоль располагалась в корневой директории вашего проекта и называлась symfony.

В Symfony2 консоль располагается в суб-директории приложения и называется console.

Консоль обслуживает только одно окружение (например dev, prod). Это поведение отличается от symfony1, где некоторые задачи (task) позволяли вам указать окружение через опцию env=. Распространённой практикой является создание отдельного командного файла для каждого окружения. Как правило это означает наличие файла console для prod и console_dev для dev окружений.

Приложения

В проекте на symfony1 обычной практикой было создавать несколько приложений: например frontend и backend.

В проекте на Symfony2 вам нужно создать лишь одно приложение (блог, интранет-портал…). В большинстве случаев, если вы захотите создать еще одно приложение, вы можете вместо этого создать еще один проект и обеспечить доступность необходимых пакетов между ними.

И если вы хотите разделить frontend и backend функциональность в пакетах, вы можете создать вложенные пространства имен для контроллеров, субдиректории для шаблонов, различную семантику конфигурационных файлов, различные правила маршрутизации и т.д.

Конечно же, наличие нескольких приложений в проекте не будет совершенно неправильным шагом, но это целиком ваш выбор. Второе приложение будет означать новую директорию, например my_app/, с настройками, аналогичными тем, которые находятся в директории app/.

Совет: почитайте определения проекта, приложения, и пакета в глоссарии.

Пакеты и плагины

В проекте symfony1 плагин должен содержать конфигурацию, модули, PHP библиотеки, ассеты и все прочее, относящееся к вашему проекту. В Symfony2 место плагина заняли пакеты (bundles). Пакет даже более функционален нежели плагин, потому что ядро Symfony2 состоит из последовательности пакетов. В Symfony2 пакет это гражданин высшего сорта, настолько гибкий, что даже ядро это пакет.

В symfony1 плагин должен быть активирован в классе ProjectConfiguration:

// config/ProjectConfiguration.class.php
public function setup()
{
    $this->enableAllPluginsExcept(array(/* some plugins here */));
}

В Symfony2 пакеты активируются внутри ядра приложения:

// app/AppKernel.php
public function registerBundles()
{
    $bundles = array(
        new SymfonyBundleFrameworkBundleFrameworkBundle(),
        new SymfonyBundleTwigBundleTwigBundle(),
        // ...
        new SensioHelloBundleHelloBundle(),
    );

    return $bundles;
}

Также необходимо удостовериться что пространство имен Sensio присутствует в автозагрузчике:

// app/autoload.php
$loader = new UniversalClassLoader();
$loader->registerNamespaces(array(
    'Symfony'                        => __DIR__.'/../vendor/symfony/src',
    'Sensio'                         => __DIR__.'/../src',
    // ...
));

В symfony1 конфигурационные файлы routing.yml и app.yml загружались автоматически для любого плагина. В Symfony2 маршруты и конфигурация приложения из пакета должны быть подключены вручную. Например, чтобы подключить маршрутизацию из пакеты, вы должны выполнить следующее:

# app/config/routing.yml
hello:
    resource: @HelloBundle/Resources/config/routing.yml

Таким образом, чтобы получить конфигурацию пакета, вам нужно ее импортировать в конфигурации вашего приложения.

Оригинал тут: http://docs.symfony-reloaded.org/guides/symfony1.html

Перевод авторский 😉