Установка

Установка Composer

Laravel использует Composer для управления зависимостями. Для начала скачайте файл composer.phar. Дальше вы можете либо оставить этот Phar-архив в своей локальной папке с проектом, либо переместить его в usr/local/bin, чтобы использовать его в рамках всей системы. Для Windows вы можете использовать официальный установщик.

Установка Laravel

При помощи установщика Laravel

Загрузите установщик Laravel при помощи Composer:

composer global require "laravel/installer=~1.1"

Убедитесь, что ~/.composer/vendor/bin (C:\Users\username\AppData\Roaming\Composer\vendor\bin если у вас Windows) добавлена в переменную окружения операционной системы PATH.

Теперь, к примеру, если вы исполните в терминале команду laravel new blog, будет создана папка blog, в которую будет загружен фреймворк с уже подтянутыми зависимостями composer. Этот способ установки Laravel наиболее быстрый, особенно на Windows, где Composer работает довольно медленно.

При помощи Composer

Вы можете установить Laravel с помощью команды create-project:

composer create-project laravel/laravel {directory} 4.2 --prefer-dist

Загрузка архива

Cкачайте последнюю версию фреймворка и извлеките архив в папку на вашем сервере. Далее скачайте Composer в эту же папку и выполните в этой папке php composer.phar install (или composer install, если composer у вас уже установлен в системе глобально) для установки всех зависимостей библиотеки. Этот процесс также требует, чтобы у вас был установлен Git.

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

Требования к серверу

У Laravel всего несколько требований к вашему серверу:

  • PHP >= 5.3.7
  • MCrypt PHP Extension

Настройка

Первое, что вы должны сделать после установки Laravel - установить ключ шифрования сессий и кук. Это строка из 32 символов, находится в app/config/app.php, параметр 'key'. Если вы устанавливали Laravel при помощи Composer, то ключ уже сгенерен, так как инсталлятор в конце процесса запускает команду php artisan key:generate. Вы также можете дать эту команду в терминале вручную. Если ключ шифрования отсутствует в конфиге, ваши сессии, куки и т.п. не будут зашифрованы надежным образом.

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

ВЫ можете также о определить среду выполнения и отредактировать конфиг-файлы фреймворка - например, разрешить отображение ошибок для вашей среды выполнения (параметр debug в конфиге app.php).

Примечание: Никогда не устанавливайте app.debug в true на производственном (продакшн) окружении.

Права доступа

Laravel требует, чтобы у сервера были права на запись в папку app/storage.

Пути

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

Примечание: Laravel спроектирован так, чтобы защитить код вашего приложения и локальное хранилище - для этого общедоступные файлы помещаются в папку public. Подразумевается, что эта папка является корневой папкой вашего сайта (DocumentRoot в Apache).

Красивые URL

Apache

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

Если стандартный .htaccess не работает для вашего Apache, попробуйте следующий:

Options +FollowSymLinks
RewriteEngine On

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

Nginx

Если вы используете в качествет веб-сервера Nginx, то используйте для ЧПУ следующую конструкцию:

location / {
    try_files $uri $uri/ /index.php?$query_string;
}