Структура папок¶

Структура папок приложения (application) на Symfony2 довольно гибкая, но типичная и рекомендованная структура папок показана в песочнице Symfony2:

• app/: Эта папка содержит конфигурацию приложения;
• src/: Весь PHP код хранится здесь;
• web/: Это папка должна быть корневой web директорией.

// web/app.php
require_once __DIR__.'/../app/AppKernel.php';

use Symfony\Component\HttpFoundation\Request;

$kernel = new AppKernel('prod', false);
$kernel->handle(new Request())->send();

// app/AppKernel.php
require_once __DIR__.'/../src/autoload.php';

// src/autoload.php
$vendorDir = __DIR__.'/vendor';

require_once $vendorDir.'/symfony/src/Symfony/Component/HttpFoundation/UniversalClassLoader.php';

use Symfony\Component\HttpFoundation\UniversalClassLoader;

$loader = new UniversalClassLoader();
$loader->registerNamespaces(array(
    'Symfony'                        => $vendorDir.'/symfony/src',
    'Application'                    => __DIR__,
    'Bundle'                         => __DIR__,
    'Doctrine\\Common\\DataFixtures' => $vendorDir.'/doctrine-data-fixtures/lib',
    'Doctrine\\Common'               => $vendorDir.'/doctrine-common/lib',
    'Doctrine\\DBAL\\Migrations'     => $vendorDir.'/doctrine-migrations/lib',
    'Doctrine\\MongoDB'              => $vendorDir.'/doctrine-mongodb/lib',
    'Doctrine\\ODM\\MongoDB'         => $vendorDir.'/doctrine-mongodb-odm/lib',
    'Doctrine\\DBAL'                 => $vendorDir.'/doctrine-dbal/lib',
    'Doctrine'                       => $vendorDir.'/doctrine/lib',
    'Zend'                           => $vendorDir.'/zend/library',
));
$loader->registerPrefixes(array(
    'Swift_'           => $vendorDir.'/swiftmailer/lib/classes',
    'Twig_Extensions_' => $vendorDir.'/twig-extensions/lib',
    'Twig_'            => $vendorDir.'/twig/lib',
));
$loader->register();

Система бандлов¶

Этот раздел кратко поведает вам об одной из существеннейших и наиболее мощных особенностей Symfony2, о системе бандлов bundle.

Бандл в некотором роде как плагин в других программах. Почему его назвали бандл, а не плагин? Потому что всё что угодно в Symfony2 это бандл, от ключевых особенностей фреймворка до кода, который вы пишете для приложения. Бандлы это высшая каста в Symfony2. Это даёт вам гибкость в применении как уже встроенных особенностей сторонних бандлов, так и в написании своих собственных. Бандл позволяет выбрать необходимые для приложения особенности и оптимизировать их как вы этого хотите.

Приложение составлено из бандлов, объявленных в методе registerBundles() класса AppKernel:

// app/AppKernel.php
public function registerBundles()
{
    $bundles = array(
        new Symfony\Bundle\FrameworkBundle\FrameworkBundle(),
        new Symfony\Bundle\TwigBundle\TwigBundle(),

        // enable third-party bundles
        new Symfony\Bundle\ZendBundle\ZendBundle(),
        new Symfony\Bundle\SwiftmailerBundle\SwiftmailerBundle(),
        new Symfony\Bundle\DoctrineBundle\DoctrineBundle(),
        //new Symfony\Bundle\DoctrineMigrationsBundle\DoctrineMigrationsBundle(),
        //new Symfony\Bundle\DoctrineMongoDBBundle\DoctrineMongoDBBundle(),

        // register your bundles
        new Application\HelloBundle\HelloBundle(),
    );

    if ($this->isDebug()) {
        $bundles[] = new Symfony\Bundle\WebProfilerBundle\WebProfilerBundle();
    }

    return $bundles;
}

В дополнение к HelloBundle, о котором мы недавно говорили, заметьте что ядро также включает FrameworkBundle, DoctrineBundle, SwiftmailerBundle и ZendBundle. Все они части ядра фрэймворка.

Каждый бандл может быть настроен при помощи конфигурационных файлов, написанных на YAML, XML, или PHP. Взгляните на конфигурацию по умолчанию:

Каждая запись app.config указывает на настройку для бандла.

Каждое окружение (environment) может переопределять стандартную конфигурацию, задавая специфичный конфигурационный файл:

В предыдущей участке кода вы могли убедиться что приложение состоит из бандлов, определённых в методе registerBundles(). Но откуда Symfony2 знает где их искать? Symfony2 и здесь достаточно гибок. Метод registerBundleDirs() должен возвратить ассоциативный массив, который связывает пространства имён с любой доступной папкой (локальной или глобальной):

public function registerBundleDirs()
{
    return array(
        'Application'     => __DIR__.'/../src/Application',
        'Bundle'          => __DIR__.'/../src/Bundle',
        'Symfony\\Bundle' => __DIR__.'/../src/vendor/symfony/src/Symfony/Bundle',
    );
}

Таким образом, когда вы ссылаетесь на HelloBundle в имени контроллера или в имени шаблона, Symfony2 будет искать их в данных директориях.

Теперь вы понимаете почему Symfony2 такой гибкий? Делитесь вашими бандлами между приложениями, храните их локально или глобально, всё на ваш выбор.

Применение вендоров¶

Скорее всего ваше приложение будет зависеть и от сторонних библиотек. Они должны хранится в папке src/vendor/. Она уже содержит библиотеки Symfony2, библиотеку SwiftMailer, Doctrine ORM, систему шаблонизации Twig и выборку из классов Zend Framework.

Кэширование и Логи¶

Symfony2 пожалуй одна из быстрейших среди многофункциональных фреймворков. Но откуда взяться такой скорости когда она анализирует и интерпретирует десятки YAML и XML для каждого запроса? Отчасти это благодаря системе кэширования. Конфигурация приложения анализируется только при первом запросе, затем она компилируется в чистый PHP и хранится в cache/ папке приложения. В среде разработки Symfony2 достаточно умён чтобы очищать кэш когда вы измените файл. Но в производственной среде, когда вы изменяете код или конфигурацию, то ответственность по очистке кэша перекладывается на вас.

Когда разрабатывается web приложение, многое может пойти не так. Логи в logs/ в папке приложения расскажут вам всё о запросах и помогут быстро решить проблемы.

Интерфейс командной строки¶

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

Запустите консоль без агрументов, чтобы получить представление о её возможностях:

$ php app/console

Опция --help поможет вам уточнить возможности использования команды:

$ php app/console router:debug --help

Заключительное слово¶

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

Для начала этого достаточно. Вам ещё предстоит многому научиться, от тестирования до отправки почты, чтобы стать мастером Symfony2. Готовы погрузиться в чтение сейчас? Следуйте на официальную страницу руководств (guides) и выбирайте любую тему.