Установка

Содержание:

Установка

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

У фреймворка Ларавел очень небольшие системные требования. И все эти требовния удовлетворены средой разработки Laravel Homestead. Поэтому настоятельно рекомендуем пользоваться именной этой средой для локалькой разработки.

Тем не менее, если вы не используете Homestead, необходимо убедиться в том, что ваша среда соответсвует следующим требованиям:

  • PHP >= 7.2.0
  • BCMath PHP Extension
  • Ctype PHP Extension
  • JSON PHP Extension
  • Mbstring PHP Extension
  • OpenSSL PHP Extension
  • PDO PHP Extension
  • Tokenizer PHP Extension
  • XML PHP Extension

Установка Laravel

Для управления зависимостями, в фреймворке Laravel используется Composer. Убедитесь в том, что Composer установлен на вашей машине перед тем, как использовать Ларавел.

Через установщик Ларавел

Во-первых, загрузите установщик Laravel используя Composer: 

composer global require laravel/installer

Убедитесь в том, что пути Composer прописаны в $PATH, и ваша система может выполнить такой тип команд. Эта директория существует в различных локащиях, в зависимости от вашей операционной системы. Наиболее частые варианты расположения:

  • macOS and GNU / Linux Distributions: $HOME/.composer/vendor/bin
  • Windows: %USERPROFILE%\AppData\Roaming\Composer\vendor\bin

После установки, команда laravel new создасть новый установщик Laravel в папке, которую вы указали. А команда laravel new blog создаст папку с именем blog, внутри которой будет располагаться новый установщик со всеми установленными зависимостями: 

laravel new blog

Через команду Composer "Create-Project"

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

composer create-project --prefer-dist laravel/laravel blog

Сервер Локальной разработки

Команда Artisan serve запустит сервер по адресу http://localhost:8000 

php artisan serve

Больше информации про настройу локальной разработки можно в статье в Окружение

Конфигурация

Папка Public

После установки Laravel, вы должны настроить сервер таким образом, чтобы папка public в целом и файл index.php стали точкой вхота всех запросов на ваше веб-приложение.

Файлы конфигурации

По умолчанию, все файлы конфигурации располагаются в папке config. Каждая опция описана, поэтому можете взглянуть и ознакомиться с содержимым файлов и опциями, доступными для вас.

Разрешения папок

После установки Ларавел, вам необходимо настроить некоторые разрешения. Папки storage и bootstrap/cache должны быть доступны для записи для веб-сервера. В случае, если это не так, фреймворк Ларавел не запустится. Если вы используете локальную среду Homestead всё должно быть уже настроено по умолчанию.

Ключ приложения

Следующий шаг, который необходимо сделать после установки Laravel, это указать ключ вашего приложения. Если вы использовали утановщик Ларавел или Composer такой ключ должен быть указан через команду: php artisan key:generate command.

Обычно это набор символов длинною в 32 знака. Ключ может быть установлен в файле .env. Если вы не переименовали файл .env.example в .env, то лучше сделать это сейчас. В случае если ключ не установлен, то пользовательские сессии и другие данные не будут безопасными.

Дополнительная конфигурация

Фрейворку Laravel не требуется никакой другой конфигурации из коробки. С этого момента можно начинать разработку приложения. Возможно, вы захотите пересмотреть файл config/app.php и документацию к нему. В этом фале содержатся некоторые опции, такие как timezone и locale, которые вы можете изменить для своего приложения.

Возможно, вы захотите настроить другие компоненты Ларавел, такие как:

Конфигурация веб-сервера

Красивые URLs

Apache

Ларавел включает файл public/.htaccess, который обеспечивает URLs без index.php. Поэтому убедитесь в том, что модуль Apache mod_rewrite включен и работает.

Если файл .htaccess не работает, то можно попробовать следующий вариант: 

Options +FollowSymLinks -Indexes
RewriteEngine On

RewriteCond %{HTTP:Authorization} .
RewriteRule .* - [E=HTTP_AUTHORIZATION:%{HTTP:Authorization}]

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

Nginx

Если вы используете Nginx, следующие настройки перенаправят все запросы на файл index.php. 

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

Преимущество использования среды разработки Homestead или Valet заключается в том, что это уже всё работает по умолчанию.