Базовые пакеты

2. Установка

Для начала добавьте пакеты зависимости:

php composer.phar require sonata-project/notification-bundle
php composer.phar require videlalvaro/php-amqplib --no-update # optional
php composer.phar require liip/monitor-bundle --no-update     # optional
php composer.phar update

php composer.phar require sonata-project/notification-bundle

php composer.phar require videlalvaro/php-amqplib --no-update # optional

php composer.phar require liip/monitor-bundle --no-update # optional

php composer.phar update

Теперь добавьте новый пакет SonataNotificationBundle в ядро:

<?php
public function registerbundles()
{
    return array(
        // Application Bundles
        new Sonata\NotificationBundle\SonataNotificationBundle(),
    );
}

<?php

public function registerbundles()

{

return array(

// Application Bundles

new Sonata\NotificationBundle\SonataNotificationBundle(),

);

}

Затем добавьте эти пакеты в настройки отображения определения:

doctrine:
    dbal:
        # ...

        types:
            json: Sonata\Doctrine\Types\JsonType

    orm:
        # ...
        entity_managers:
            default:
                    # ...
                mappings:
                    # ...
                    SonataNotificationBundle: ~
                    ApplicationSonataNotificationBundle: ~

doctrine:

dbal:

# ...

types:

json: Sonata\Doctrine\Types\JsonType

orm:

# ...

entity_managers:

default:

# ...

mappings:

# ...

SonataNotificationBundle: ~

ApplicationSonataNotificationBundle: ~

Настройка Чтобы использовать SonataNotificationBundle, добавьте следующие строки в конфигурационный файл вашего приложения. Доступные Backend: sonata.notification.backend.runtime: прямой вызов, ни какой пользы, но полезен в целях тестирования sonata.notification.backend.postpone: post-pone the messages to be dispatched …

1. Вступление

Notification bundle (пакет уведомлений) позволяет генерировать сообщения, которые могут быть получены по средством backend и обработанный специальными действиями. Этот пакет не пытается воспроизвести реальную систему очереди сообщений, так как этот он может использоваться с ней.

11. Команда

Вы можете создать дамп файл с информацией схемы сущности. Для каждой сущности вы получите имя таблицы и сопоставление между полем и названия столбца (связанные поля сущностей не будут отображены)

Usage:
 sonata:core:dump-doctrine-metadata -r "/ProductBundle/" -f /tmp/dump.json

Options:
 --filename (-f)       If filename is specified, result will be dumped into this file under json format.
 --entity-name (-E)    If entity-name is set, dump will only contain the specified entity and all its extended classes.
 --regex (-r)          If regex is set, dump will only contain entities which name match the pattern.
 --help (-h)           Display this help message.
 --quiet (-q)          Do not output any message.
 --verbose (-v|vv|vvv) Increase the verbosity of messages: 1 for normal output, 2 for more verbose output and 3 for debug.
 --version (-V)        Display this application version.
 --ansi                Force ANSI output.
 --no-ansi             Disable ANSI output.
 --no-interaction (-n) Do not ask any interactive question.
 --shell (-s)          Launch the shell.
 --process-isolation   Launch commands from shell as a separate process.
 --env (-e)            The Environment name. (default: "dev")
 --no-debug            Switches off debug mode.

Usage:

sonata:core:dump-doctrine-metadata -r "/ProductBundle/" -f /tmp/dump.json

Options:

--filename (-f) If filename is specified, result will be dumped into this file under json format.

--entity-name (-E) If entity-name is set, dump will only contain the specified entity and all its extended classes.

--regex (-r) If regex is set, dump will only contain entities which name match the pattern.

--help (-h) Display this help message.

--quiet (-q) Do not output any message.

--verbose (-v|vv|vvv) Increase the verbosity of messages: 1 for normal output, 2 for more verbose output and 3 for debug.

--version (-V) Display this application version.

--ansi Force ANSI output.

--no-ansi Disable ANSI output.

--no-interaction (-n) Do not ask any interactive question.

--shell (-s) Launch the shell.

--process-isolation Launch commands from shell as a separate process.

--env (-e) The Environment name. (default: "dev")

--no-debug Switches off debug mode.

10. Встраиваемая валидация

Встроенная проверка о делегировании валидации модели в выделенном сервисе. Текущая валидация реализованная в Symfony 2 очень мощная, так как она позволяет объявить валидацию на класс, поле и геттер. Однако эти объявления могут занять некоторое время для сложных правил. Так как для правил должны быть установлены экземпляры Constraint и Validator Встроенная валидация пытается обеспечить хорошее решение, …

9. API

Пакет поставляется с удобным методом FormHelper::removeField , который может быть использован для удаления полей формы, если связанное представление данных не предоставлено. Поведение по умолчанию формы компонента установит «null«, если поле формы определено, но не представлены данные для этого конкретного поля. Это очень раздражает пока строится API и клиент отправляет только часть данных для обновления сущности …

8. Сериализация

Сериализация — процесс конвертирования сложной структуры языка программирования в строку, для компактной передачи данных. Десериализация — процесс конвертирования строки полученной при сериализации обратно в сложную структуру. Пользовательские обработчики Пакет поставляется с BaseSerializerHandler, чтобы дать вам настроить сущности; этот обработчик используется для сериализации/десериализации сущьности в/из его id. Но вы вольны создать ваш собственный обработчик для специфических …

7. DOCTRINE базовый менеджер сущьности

Пакет поставляется с абстрактным классом для вашего менеджера сущностей и документов Sonata\CoreBundle\Model\BaseEntityManager, SonataCoreBundleModelBaseDocumentManager и Sonata\CoreBundle\Model\BasePHPCRManager. Использование в ваших менеджерах Вы просто расширяете ваш менеджер Sonata\CoreBundle\Model\BaseEntityManager, Sonata\CoreBundle\Model\BaseDocumentManager или Sonata\CoreBundle\Model\BasePHPCRManager, например:

<?php

namespace Acme\Bundle\Entity;

use Sonata\CoreBundle\Model\BaseEntityManager;

class ProductManager extends BaseEntityManager
{

}

<?php

namespace Acme\Bundle\Entity;

use Sonata\CoreBundle\Model\BaseEntityManager;

class ProductManager extends BaseEntityManager

{

}

6. TWIG помощники

SONATA_SLUGIFY Создаёт slug (правильнее всего на русский язык будет перевести, как ЧПУ (человеко-понятные url)) из строки:


{{ "my string"|sonata_slugify }} => my-string

{{ "my string"|sonata_slugify }} => my-string

SONATA_FLASHMESSAGES_GET AND SONATA_FLASHMESSAGES_TYPES Смотрите Флеш сообщения для более подробной информации SONATA_URLSAFEID Получает идентификаторы объекта как строку, которая безопасна для использования в url

5. Флеш сообщения

Пакет поставляется c Флеш менеджером для обработки сессий некоторых типов flash messages, для которых вы можете указать в конфигурации, чтобы был возвращён тип успех, предупреждение или ошибка (или даже все ваши пользовательские типы, которые вы хотите добавить). Кроме того, вы можете добавить раздел css_class, для каждого флеш сообщения, который будет отображаться при рендеринге Настройка

sonata_core:
    flashmessage:
        success:
            types:
                - { type: my_custom_bundle_success, domain: MyCustomBundle }
                - { type: my_other_bundle_success, domain: MyOtherBundle }
        warning:
            types:
                - { type: my_custom_bundle_warning, domain: MyCustomBundle }
                - { type: my_other_bundle_warning } #  если ничего не указано, SonataCoreBundle установит значение по умолчанию
        error:
            css_class: danger # optionally, a CSS class can be defined
            types:
                - { type: my_custom_bundle, domain: MyCustomBundle }
        custom_type: # Вы также можете добавить пользовательский тип
            types:
                - { type: custom_bundle_type, domain: MyCustomBundle }

sonata_core:

flashmessage:

success:

types:

- { type: my_custom_bundle_success, domain: MyCustomBundle }

- { type: my_other_bundle_success, domain: MyOtherBundle }

warning:

types:

- { type: my_custom_bundle_warning, domain: MyCustomBundle }

- { type: my_other_bundle_warning } # если ничего не указано, SonataCoreBundle установит значение по умолчанию

error:

css_class: danger # optionally, a CSS class can be defined

types:

- { type: my_custom_bundle, domain: MyCustomBundle }

custom_type: # Вы также можете добавить пользовательский тип

types:

- { type: custom_bundle_type, domain: MyCustomBundle }

…

4. TWIG помошники состояний

Пакет поставляется с TWIG помощниками позволяющими вам генерировать имена CSS классов в зависимости от сущности поля Определение службы Каждая служба которую вы хотите определить должна реализовывать Sonata\CoreBundle\Component\Status\StatusClassRendererInterface интерфейс. Например:

<?php

namespace Sonata\Component\Order;

use Sonata\CoreBundle\Component\Status\StatusClassRendererInterface;

class OrderStatusRenderer implements StatusClassRendererInterface
{
    public function handlesObject($object, $statusName = null)
    {
        // Logic validating if the render is applicable for the given object
    }

    public function getStatusClass($object, $statusName = null, $default = "")
    {
        // Label to render
    }
}

<?php

namespace Sonata\Component\Order;

use Sonata\CoreBundle\Component\Status\StatusClassRendererInterface;

class OrderStatusRenderer implements StatusClassRendererInterface

{

public function handlesObject($object, $statusName = null)

{

// Logic validating if the render is applicable for the given object

}

public function getStatusClass($object, $statusName = null, $default = "")

{

// Label to render

}

Теперь когда мы определили нашу службу, мы можем добавить её используя тег sonata.status.renderer, следующим образом:

<service id="sonata.order.status.renderer" class="Sonata\Component\Order\OrderStatusRenderer">
    <tag name="sonata.status.renderer"></tag>
</service>

</service>

Использование службы Теперь можно вызвать помощник в шаблоне TWIG …