Установка и настройка Symfony2

Цель этой главы помочь вам настроить и запустить рабочее приложение, созданное при помощи Symfony. К счастью, Symfony предлагает “дистрибутивы”, которые представляют собой базовые проекты, которые вы можете загрузить и незамедлительно начать разработку.

Tip

Если вы ищите руководство по созданию нового проекта и размещению его в системе контроля версий, перейдите к секции Использование системы контроля версий.

Загрузка дистрибутива Symfony2

Tip

Прежде всего, удостоверьтесь, что у вас установлен и настроен Web-сервер (например, Apache) и интерпретатор PHP 5.3.2 или более новый. Более подробную информацию о системных требованиях Symfony2 в можете найти в разделе Системные требования.

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

Начнём со страницы загрузки Symfony2 http://symfony.com/download. На этой странице вы можете видеть дистрибутив Symfony Standard Edition, который является основным дистрибутивом. Теперь вам нужно принять 2 решения:

  • Загрузить либо .tgz либо .zip архив - они идентичны, просто вопрос предпочтений.
  • Загрузить дистрибутив, включающий сторонние библиотеки или же не включающий (with/without vendors). Если у вас установлен Git, вы можете загрузить Symfony2 “without vendors”, так так это даст вам немного больше возможностей по включению сторонних библиотек/вендоров.

Загрузите один из архивов в root-директорию вашего локального web-сервера и распакуйте его. В командной строке UNIX это можно выполнить при помощи одной из этих команд (заменяя ### актуальным именем файла):

# for .tgz file
tar zxvf Symfony_Standard_Vendors_2.0.###.tgz

# for a .zip file
unzip Symfony_Standard_Vendors_2.0.###.zip

Когда вы выполните эту операцию, у вас будет директория Symfony/, которая будет выглядеть примерно так:

www/ <- root директория вашего веб-сервера
    Symfony/ <- распакованный архив
        app/
            cache/
            config/
            logs/
        src/
            ...
        vendor/
            ...
        web/
            app.php
            ...

Обновление Вендоров

Далее, если вы загрузили архив “без вендоров” (without vendors), необходимо их установить, выполнив следующую команду:

php bin/vendors install

Эта команда загрузит все необходимые библиотеки, включая собственно Symfony, в директорию vendor/. Более подробную информацию о том, как управлять сторонними библиотеками в Symfony2 вы можете получить в разделе “cookbook-managing-vendor-libraries”.

Конфигурация и настройка

На текущий момент все необходимые сторонние библиотеки теперь располагаются в директории vendor/. Также в директории app/ расположены настройки по-умолчанию, а в директории src/ пример кода.

Symfony2 поставляется с визуальным тестером конфигурации веб-сервера, для того чтобы помочь вам определить, подходит ли конфигурация вашего сервера и PHP для Symfony. Используйте следующий URL для проверки конфигурации:

http://localhost/Symfony/web/config.php

Если проверка показывает какие-либо несоответствия - исправьте их, прежде чем двигаться далее.

Настройка прав доступа

Одно из типовых замечаний заключается в том, что директории app/cache и app/logs должны иметь права на запись как для веб-сервера, так и для пользователя, от имени которого выполняются команды из командной строки. В UNIX-системах, если пользователь, из-под которого запускается веб-сервер отличается от пользователя командной строки, вы можете выполнить следующие команды, для того чтобы быть уверенными, что права доступа настроены верно. Заменяйте www-data на пользователя веб-сервера и yourname на вашего пользователя командной строки:

1. Использование ACL в системах, которые поддерживают chmod +a

Многие системы позволяют использовать команду chmod +a. Попробуйте выполнить её, и если вы получите сообщение об ошибке - пробуйте следующий метод:

rm -rf app/cache/*
rm -rf app/logs/*

sudo chmod +a "www-data allow delete,write,append,file_inherit,directory_inherit" app/cache app/logs
sudo chmod +a "yourname allow delete,write,append,file_inherit,directory_inherit" app/cache app/logs

2. Использование Acl на системах, которые не поддерживают chmod +a

Некоторые системы не поддерживают chmod +a, но поддерживают другую утилиту, setfacl. Возможно, вам потребуется включить поддержку ACL на вашем разделе и установить setfacl перед тем как использовать (это может потребоваться, например, если вы используете Ubuntu):

sudo setfacl -R -m u:www-data:rwx -m u:yourname:rwx app/cache app/logs
sudo setfacl -dR -m u:www-data:rwx -m u:yourname:rwx app/cache app/logs

3. Без использования ACL

Если у вас нет прав на изменение ACL для директорий, вам потребуется изменить umask таким образом, чтобы директории cache и log были доступны на запись группе или же всем (world-writable) в зависимости от того находятся ли пользователи веб-сервера и командной строки в одной группе или нет. Для этого нужно вставить следующую строчку в начало файлов app/console, web/app.php и web/app_dev.php:

umask(0002); // Разрешает использовать права 0775

// или

umask(0000); // Разрешает использовать права 0777

Имейте в виду, что использование ACL предпочтительнее, когда вы имеете доступ к ним на сервере, потому что смена umask не является thread-safe.

Когда все необходимые приготовления выполнены, кликните на ссылку “Go to the Welcome page” и перейдите на вашу первую “настоящую” страницу Symfony2:

http://localhost/Symfony/web/app_dev.php/

Symfony2 поздоровкается и поздравит вас с проделанной тяжелой работой!!

images/quick_tour/welcome.jpg

Начало разработки

Теперь, когда мы имеем настроенное Symfony2 приложение, вы можете начать разработку. Ваш дистрибутив может содержать примеры кода - прочтите файл README.rst из дистрибутива (это обычный текстовый файл) для того чтобы ознакомиться с тем, какие примеры включены в данный дистрибутив и как их можно будет удалить позднее.

Если вы новичок в Symfony, ознакомьтесь с руководством “Создание страниц в Symfony2”, где вы узнаете, как создавать страницы, изменять настройки и вообще делать всё необходимое для создания нового приложения.

Использование системы контроля версий

Если вы используете систему контроля версий типа Git или Subversion, вы можете настроить вашу систему и начать коммитить ваш проект как вы это делаете обычно. Symfony Standard - это точка отсчёта для вашего нового проекта.

Более подробные инструкции о том, как лучше всего настроить проект для хранения в git, загляните сюда: /cookbook/workflow/new_project_git.

Игнорируем директорию vendor/

Если вы загрузили архив без вендоров вы можете спокойно игнорить директорию vendor/ целиком и не коммитить её содержимое в систему контроля версий. В Git этого можно добиться, создав файл .gitignore и добавив в него следующую строку:

vendor/

После этого директория vendor не будет участвовать в коммитах. Это здорово (правда-правда!), потому что когда кто-то еще клонирует или выгрузит ваш проект он сможет запросто выполнить скрипт php bin/vendors install и загрузить все необходимые библиотеки.