nuclear 6 июн 2011 в 12:20

Простейший блог на Symfony 2

10 мин

50K

Привет, %username%!
symfony — популярный PHP-фреймворк, на котором создано не мало серьезных проектов. Но в русскоязычном сообществе он распространен гораздо меньше. То ли это связано с более высоким порогом входа, то ли с отсутствием русскоязычной документации.
В этом статье я хочу рассказать о создании простейшего блога на symfony2.

Шаг 0. Требования к ПО

Веб-сервер (например, Apache) с 5.3.2 или выше.
Сервер базы данных. Мы будем использовать MySQL.
Git (опционально).

Шаг 1. Установка.

Есть два пути: скачать архив с сайта или использовать git. Мы пойдем по второму, т.к. многие бандлы обновляются вслед за репозитарием.
В корне веб-сервера выполняем команды:

git clone https://github.com/symfony/symfony-standard.git symfony

cd symfony

php bin/vendors.php

Переходим по ссылке http://localhost/symfony/web/config.php. Тут symfony напишет требования и рекомендации по настройке веб-сервера.
В моем случае нужно только указать директиву date.timezone в php.ini.
Там же, внизу страницы написано расположение вашего php.ini.
После того как вы исправите все проблемы, вас ждет самое интересное.
Перейдите по ссылке, с той же страницы, http://localhost/symfony/web/app_dev.php/_configurator/.
Сдесь можно настроить соединение с базой данных и выставить секретный ключ для предотвращение CSRF-аттак.
После этого symfony будет настроена, ну или предложит сама ввести полученую конфигурацию, если файл app/config/parameters.ini не доступен для записи.
Тут стоит упоминуть о бандлах. В данном случае мы будем использовать AcmeDemoBundle — уже созданный бандл, для создания демо-приложений. Углубляться в бандлы я не буду, скажу лишь, что в symfony2 из них, как из кирпичиков, строится ваше приложение.
Так же нам понадобится еще один бандл — FOSUserBundle. Он предоставляет все необходимое для работы с пользователями — вход, регистрация, подтверждение пароля и другое.
Скачиваем:

git submodule add -f git://github.com/FriendsOfSymfony/UserBundle.git vendor/bundles/FOS/UserBundle

Добавляем новое пространство имен(namespace) в app/autoload.php:

$loader->registerNamespaces(array( 'FOS' => __DIR__.'/../vendor/bundles', // your other namespaces ); 

Добавляем новый бандл в наше приложение в файле app/AppKernel.php:

public function registerBundles() { return array( // ... new FOS\UserBundle\FOSUserBundle(), // ... ); } 

В app/config/security.yml заменяем параметр providers:

security: providers: fos_userbundle: id: fos_user.user_manager 

А так же изменяем firewalls и access_control чтобы разрешить анонимный доступ для всех страниц, кроме страницы создания сообщения.

firewalls: main: pattern: .* form_login: provider: fos_userbundle login_path: /login use_forward: false check_path: /login_check failure_path: null logout: true anonymous: true access_control: - { path: /post/new, role: ROLE_USER } - { path: /.*, roles: IS_AUTHENTICATED_ANONYMOUSLY}

В app/config/config.yml удаляем auto_mapping: true и добавляем следующее:

doctrine: orm: mappings: FOSUserBundle: ~ AcmeDemoBundle: ~ # your other bundles 

и в конце файла дописываем:

 fos_user: db_driver: orm firewall_name: main class: model: user: Acme\DemoBundle\Entity\User 

Так же нужно добавить в framework translator, чтобы включить перевод строк. В частности строк FOSUserBundle.

framework: translator: { fallback: en } 

Шаг 2. Создание моделей.

Создадим файлы в директории src/Acme/DemoBundle/Entity. Если такой папки нет — создайте её.
Post.php:

<?php namespace Acme\DemoBundle\Entity; use Doctrine\ORM\Mapping as ORM; /** * * @ORM\Entity */ class Post { /** * @var integer $id * * @ORM\Id * @ORM\Column(name="id", type="integer") * @ORM\GeneratedValue(strategy="AUTO") */ private $id; /** * @ORM\ManyToOne(targetEntity="User", inversedBy="posts") * @ORM\JoinColumn(name="user_id", referencedColumnName="id") */ public $user; /** * @var string $title * * @ORM\Column(name="title", type="string", length=255) */ public $title; /** * @var text $description * * @ORM\Column(name="description", type="text") */ public $description; }

Комментарии перед переменными — аннотации. В их использовании не должно возникнуть сложностей, если, конечно, не задаваться вопросом «как оно работает?».
User.php:

<?php namespace Acme\DemoBundle\Entity; use FOS\UserBundle\Entity\User as BaseUser; use Doctrine\ORM\Mapping as ORM; /** * @ORM\Entity * @ORM\Table(name="fos_user") */ class User extends BaseUser { /** * @ORM\Id * @ORM\Column(type="integer") * @ORM\generatedValue(strategy="AUTO") */ protected $id; /** * @ORM\OneToMany(targetEntity="Post", mappedBy="fos_user") */ public $posts; public function __construct() { parent::__construct(); // your own logic } }

Мы наследуемся от FOS\UserBundle\Entity\User, так что кроме двух заданных нами будут сгенерированы еще несколько полей, включая username, password и email.
После написания моделей мы можем смело создать таблицы:

php app/console doctrine:schema:create

Шаг 3. Создание контроллера.

Создадим файл PostController.php в папке src/Acme/DemoBundle/Controller/:

<?php namespace Acme\DemoBundle\Controller; use Symfony\Bundle\FrameworkBundle\Controller\Controller; use Acme\DemoBundle\Entity\Post; use Sensio\Bundle\FrameworkExtraBundle\Configuration\Template; class PostController extends Controller { /** * @Template() */ public function indexAction() { $em = $this->get('doctrine')->getEntityManager(); $posts = $em->getRepository('AcmeDemoBundle:Post')->findAll(); return array('posts' => $posts); } /** * @Template() */ public function newAction() { $post = new Post(); // Получаем пользователя и присваиваем новому посту $post->user = $this->get('security.context')->getToken()->getUser(); // Создаем форму, по хорошему следовало бы создать отдельный класс, но можно и так $form = $this->get('form.factory') ->createBuilder('form', $post) ->add('title', 'text') ->add('description', 'textarea') ->getForm(); $request = $this->get('request'); if ($request->getMethod() == 'POST') { $form->bindRequest($request); if ($form->isValid()) { $em = $this->get('doctrine')->getEntityManager(); $em->persist($post); $em->flush(); return $this->redirect($this->generateUrl('post_index')); } } return array('form' => $form->createView()); } }

Зачем нужен Template() перед каждым экшеном? Без него вместо

return array('posts' => $posts);

нам бы пришлось писать

return $this->render('AcmeDemoBundle:Post:index.html.twig', array('posts' => $posts));

Шаг 4. Шаблоны.

В src/Acme/DemoBundle/Resources/views/Post создадим вид для каждого экшена.
index.html.twig:

{% extends 'AcmeDemoBundle::layout.html.twig' %} {% block content %} {% if is_granted('ROLE_USER') %} <div><a href="{{ path("post_new") }}">New Post</a></div> {% endif %} {% for post in posts %} <h2>{{ post.title}}</h2> {{ post.description }} <div>by {{ post.user.username }}</div> {% else %} Пока в блоге нет статей. {% endfor %} {% endblock %} 

new.html.twig:

{% extends 'AcmeDemoBundle::layout.html.twig' %} {% block content %} <h1>New Post</h1> <form action="{{ path("post_new") }}" method="post"> {{ form_widget(form) }} <input type="submit" class="symfony-button-grey" value="Create" /> </form> {% endblock %} 

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

Шаг 5. Роуты.

В app/config/routing.yml прописываем наши роуты и не забываем про UserBundle

post_index: pattern: /post defaults: { _controller: AcmeDemoBundle:Post:index } post_new: pattern: /post/new defaults: { _controller: AcmeDemoBundle:Post:new } fos_user_security: resource: "@FOSUserBundle/Resources/config/routing/security.xml" fos_user_user: resource: "@FOSUserBundle/Resources/config/routing/user.xml" prefix: /user * This source code was highlighted with Source Code Highlighter.

Теперь наш блог будет доступен по ссылке http://localhost/symfony/web/app_dev.php/post, а при попытке зайти на http://localhost/symfony/web/app_dev.php/post/new вы будете перенаправлены на страницу входа.

Послесловие

Я не претендую на полное руководство и оригинальность, это скорее заметка по быстрому старту приложения для себя.
Буду рад если кому то пригодится, так же не откажусь от помощи и критики.
У кого будут вопросы — задавайте, думаю на хабре есть люди которые занимаются этим фреймворком.
Кроме того у нас есть jabber-конференция symfony@conference.jabber.ru

Теги:

Хабы:

Symfony

Простейший блог на Symfony 2

Шаг 0. Требования к ПО

Шаг 1. Установка.

Шаг 2. Создание моделей.

Шаг 3. Создание контроллера.

Шаг 4. Шаблоны.

Шаг 5. Роуты.

Послесловие

Публикации

Истории

Работа

Ближайшие события