Установка
Установка Composer
Laravel использует Composer для управления зависимостями. Поэтому прежде чем ставить Laravel вы должны установить Composer.
Установка Laravel
При помощи установщика Laravel
Используя Composer скачайте установщик Laravel.
composer global require "laravel/installer=~1.1"
Указав в качестве PATH директорию ~/.composer/vendor/bin
, станет возможным использование команды laravel
.
После установки, простая команда laravel new
создаст свеженькое Laravel приложение в директории, которую вы укажете. Например, laravel new blog
создаст директорию blog
и установит туда Laravel со всеми зависимостями. Этот метод установки намного быстрее, чем установка через Composer:
laravel new blog
При помощи Composer
Вы также можете установить Laravel используя команду Composer create-project
:
composer create-project laravel/laravel --prefer-dist
Требования к серверу
У Laravel всего несколько требований к вашему серверу:
- PHP >= 5.4
- Mcrypt PHP Extension
- OpenSSL PHP Extension
- Mbstring PHP Extension
Начиная с PHP 5.5, в некоторых операционных системах может понадобиться ручная установка PHP JSON extension. В Ubuntu, например, это можно сделать при помощи sudo apt-get install php5-json
.
Настройка
Первое, что вы должны сделать после установки Laravel - установить ключ шифрования сессий и кук. Это случайная строка из 32 символов, находится в файле .env
, параметр 'APP_KEY'. Если вы устанавливали Laravel при помощи Composer, то ключ уже сгенерен. Вы можете сгенерить его вручную artisan-командой key:generate
. Если ключ шифрования отсутствует, ваши сессии, куки другая шифруемая информация не будет зашифрована надежным образом..
Laravel практически не требует другой начальной настройки - вы можете сразу начинать разработку. Однако может быть полезным изучить файл config/app.php
- он содержит несколько настроек вроде timezone
и locale
, которые вам может потребоваться изменить в соответствии с нуждами вашего приложения.
Далее вы можете сконфигурить настройки среды выполнения.
Примечание: Никогда не устанавливайте настройку
app.debug
вtrue
на рабочем (продакшн) окружении.
Права на запись
Папки внутри storage
должны быть доступны веб-серверу для записи. Если вы устанавливаете фреймворк на Linux или MacOS - открыть папки на запись можно командой chmod -R 777 storage
Красивые 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;
}
Если вы используете Homestead, то вам ничего делать не нужно, там всё это уже настроено.