Установка

Статистика: Символов — 4 498/3 854 без пробелов (3 554/3 048 без кода):, слов — 507
Разметка: Wiki
{{TOC}}

{{DOCVER 4.0=0da300f6445bec5a70d007f503834fce957b065b 16.10.2014 5:19:26, 4.1=efd541a0b218b1c6aafb73f0051c18ed150e3c24 25.05.2014 6:21:03, 4.2=d7b13440c003218ed79e9d508706eca01990122f 4.12.2014 5:01:15}}

== Установка Composer ==
Laravel использует ((http://getcomposer.org/ Composer)) для управления зависимостями. Для начала скачайте файл %%(t)composer.phar%%. Дальше вы можете либо оставить этот ((phpdoc:book.phar Phar-архив)) в своей локальной папке с проектом, либо переместить его в %%(t)/usr/local/bin%%, чтобы использовать его в рамках всей системы. Для Windows вы можете использовать ((https://getcomposer.org/Composer-Setup.exe официальный установщик)).

== Установка Laravel ==

=== С помощью установщика Laravel ===
%%(DOCNEW 4.2=d7b13440c003218ed79e9d508706eca01990122f 4.12.2014 5:01:15)
Сначала загрузите установщик Laravel с помощью Composer.
%%(sh)
  composer global require "laravel/installer=~1.1"
~%%

Не забудьте поместить каталог %%(t)~/.composer/vendor/bin%% в вашу переменную PATH, чтобы исполняемый файл %%(t)laravel%% мог быть найден при запуске команды %%(sh)laravel%% в терминале.

После установки простая команда %%(sh)laravel new%% произведёт установку свежего Laravel в указанный каталог. Например, %%(sh)laravel new blog%% создаст каталог с именем %%(t)blog%%, содержащий свежий Laravel со всеми установленными зависимостями. Этот способ установки намного быстрее, чем установка с помощью Composer.
%%

%%(DOCNEW 4.1=efd541a0b218b1c6aafb73f0051c18ed150e3c24 25.05.2014 6:21:03)
.(tl_note)
Способ появился в 4.1, но был вскоре удалён.

Во-первых, скачайте PHAR-архив --%%(t)http://laravel.com/laravel.phar%%-- установщика Laravel. Для удобства переименуйте файл в %%(t)laravel%% и переместите его в %%(t)/usr/local/bin%%. После установки простая команда %%(sh)laravel new%% произведёт установку свежего Laravel в указанный каталог. Например, %%(sh)laravel new blog%% создаст каталог с именем %%(t)blog%%, содержащий свежий Laravel со всеми установленными зависимостями. Этот способ установки намного быстрее, чем установка с помощью Composer.
%%

=== С помощью создания проекта Composer ==
Вы также можете установить Laravel с помощью команды %%(sh)create-project%%:
%%(sh)
  composer create-project laravel/laravel --prefer-dist
%%

=== Загрузка архива ==
Как только Composer установлен, скачайте ((git:laravel/archive/master.zip последнюю версию фреймворка)) и извлеките архив в папку на вашем сервере. Дальше, в корне вашего приложения на Laravel выполните %%(sh)php composer.phar install%% (или %%(sh)php composer install%%) для установки всех зависимостей библиотеки. Этот процесс требует, чтобы на сервере был установлен Git.

Если вы хотите обновить Laravel, выполните команду %%(sh)php composer.phar update%%.

== Требования к серверу ==
У Laravel всего несколько требований к вашему серверу:
  * **PHP** >= 5.4 (для Laravel 4.1 и ниже - 5.3.7)
  * **((phpdoc:book.mcrypt MCrypt))** (расширение для PHP)

Для PHP 5.5 в некоторых дистрибутивах ОС может потребоваться вручную установить расширение PHP JSON. В Ubuntu это можно сделать командой %%(sh)apt-get install php5-json%%. 

== Настройка ==
Laravel практически не требует начальной настройки - вы можете сразу начинать разработку. Однако вам может пригодиться файл %%(t)app/config/app.php%% и его документация - он содержит несколько настроек вроде **timezone** и **locale**, которые вам может потребоваться изменить в соответствии с нуждами вашего приложения.

.(alert)
В Laravel 3 и в ранних версиях Laravel 4 единственная настройка, которую вам нужно было изменить - %%(t)key%% в файле %%(t)app/config/app.php%%. Это значение должно быть случайной строкой длиной 32 символа. Оно используется при шифровании и зашифрованные строки не будут безопасными, пока вы не измените эту настройку. Теперь в Laravel 4 это делается автоматически. Вы также можете быстро его установить с помощью следующей команды: %%(sh)php artisan key:generate%%.

После установки Laravel вам также надо ((/docs/v4/configuration#среда настроить локальное окружение)). Это позволит вам получать подробные сообщения об ошибках при разработке на локальной машине. По умолчанию подробные отчёты об ошибках отключены в файле рабочей конфигурации.

.(alert)
Никогда не оставляйте параметр %%(t)app.debug%% со значением %%(t)true%% в рабочем приложении. Никогда не делайте этого.

=== Права доступа ==
Для Laravel может потребоваться, чтобы у сервера были права на запись в папку %%(t)app/storage%%.

=== Пути ==
Некоторые системные пути Laravel - настраиваемые; для этого обратитесь к файлу %%(t)bootstrap/paths.php%%.

== Красивые URL ==

=== Apache ==
Laravel поставляется вместе с файлом %%(t)public/.htaccess%%, который настроен для обработки URL без указания %%(t)index.php%%. Если вы используете Apache в качестве веб-сервера, обязательно включите модуль **mod_rewrite**.

Если стандартный %%(t).htaccess%% не работает для вашего Apache, попробуйте следующий:
%%(conf)
  Options +FollowSymLinks
  RewriteEngine On

  RewriteCond %{REQUEST_FILENAME} !-d
  RewriteCond %{REQUEST_FILENAME} !-f
  RewriteRule ^ index.php [L]
%%

=== Nginx ==
При использовании Nginx следующая директива в настройках вашего сайта позволит применить "красивые" URL:
%%(conf)
  location / {
    try_files $uri $uri/ /index.php?$query_string;
  }
%%