Версия фреймворка: 8.x 5.4 4.2 4.1

Установка

Установка Composer

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

Установка Laravel

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

Загрузите Laravel installer PHAR archive. Если у вас Mac OS или Linux, переименуйте его в laravel и положите в /usr/local/bin. Если у вас Windows, положите laravel.phar в папку, которая у вас прописана в PATH, плюс в этой же папке создайте файл laravel.bat со следующим содержимым:

@php "%~dp0laravel.phar" %*

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

При помощи Composer

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

composer create-project laravel/laravel --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 практически не требует начальной настройки - вы можете сразу начинать разработку. Однако вам может пригодиться файл 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;
}