Установка Laravel 8.x
Установка
Требования к серверу
Фреймворк Laravel имеет несколько системных требований. Всем этим требованиям удовлетворяет виртуальная машина Laravel Homestead, поэтому настоятельно рекомендуется использовать Homestead в качестве локальной среды разработки Laravel.
Однако, если вы не используете Homestead, вам необходимо убедиться, что ваш сервер соответствует следующим требованиям:
- PHP >= 7.3
- BCMath PHP Extension
- Ctype PHP Extension
- Fileinfo PHP Extension
- JSON PHP Extension
- Mbstring PHP Extension
- OpenSSL PHP Extension
- PDO PHP Extension
- Tokenizer PHP Extension
- XML PHP Extension
Установка Laravel
Laravel использует Composer для управления своими зависимостями. Итак, перед использованием Laravel убедитесь, что на вашем компьютере установлен Composer.
Через установщик Laravel
Сначала загрузите установщик Laravel с помощью Composer:
composer global require laravel/installerОбязательно поместите общесистемный каталог bin поставщика Composer в переменную $PATH, чтобы исполняемый файл laravel мог быть обнаружен вашей системой. Этот каталог существует в разных местах в зависимости от вашей операционной системы; однако некоторые общие местоположения включают:
- macOS:
$HOME/.composer/vendor/bin - Windows:
%USERPROFILE%\AppData\Roaming\Composer\vendor\bin - GNU / Linux дистрибутивы:
$HOME/.config/composer/vendor/bin or $HOME/.composer/vendor/bin
Вы также можете найти глобальный путь установки composer'а, запустив composer global about и выполнив поиск с первой строки.
После установки команда laravel new создаст новую установку Laravel в указанном вами каталоге. Например, laravel new blog создаст каталог с именем blog, содержащий новую установку Laravel со всеми уже установленными зависимостями Laravel:
laravel new blogWant to create a Laravel project with login, registration, and more features already built for you? Check out Laravel Jetstream.
Через Composer Create-Project
В качестве альтернативы вы также можете установить Laravel, выполнив команду Composer create-project в своем терминале:
composer create-project --prefer-dist laravel/laravel blogЛокальный сервер разработки
Если у вас PHP установлен локально и вы хотите использовать встроенный сервер разработки PHP для обслуживания своего приложения, вы можете использовать Artisan команду serve. Эта команда запустит сервер разработки по адресу http://localhost:8000:
php artisan serveБолее надежные варианты локальной разработки доступны через Homestead и Valet.
Конфигурация
Публичный каталог
После установки Laravel вы должны настроить корневой каталог документов / веб-сервера в качестве общедоступного каталога public. Файл index.php в этом каталоге служит фронт-контроллером для всех HTTP-запросов, поступающих в ваше Larvel приложение.
Файлы конфигурации
Все файлы конфигурации для фреймворка Laravel хранятся в каталоге config. Каждый параметр задокументирован, поэтому не стесняйтесь просматривать файлы и знакомиться с доступными вариантами использования.
Разрешения директорий
После установки Laravel вам может потребоваться настроить некоторые разрешения. Каталог storage и каталог bootstrap/cache должны быть доступны для записи вашим веб-сервером, иначе Laravel не запустится. Если вы используете виртуальную машину Homestead, эти разрешения уже должны быть уже установлены.
Ключ приложения
Следующее, что вам нужно сделать после установки Laravel, - это установить для ключа приложения случайную строку. Если вы установили Laravel через Composer или установщик Laravel, этот ключ уже был установлен для вас с помощью команды php artisan key:generate.
Обычно эта строка должна состоять из 32 символов. Ключ можно задать в конфигурационном файле .env. Если вы не скопировали файл .env.example в новый файл с именем .env, вам следует сделать это сейчас. Если ключ приложения не установлен, ваши пользовательские сеансы и другие зашифрованные данные не будут в безопасности!
Дополнительная конфигурация
Laravel почти не нуждается в другой конфигурации после установки из коробки. Вы можете начать разработку! Однако вы можете просмотреть файл config/app.php и его документацию. Он содержит несколько параметров, таких как часовой пояс (timezone) и языковой стандарт (locale), которые вы можете изменить в соответствии с вашим приложением.
Вы также можете настроить несколько дополнительных компонентов Laravel, например:
Конфигурация веб-сервера
Конфигурация каталога
Laravel всегда должен запускаться из корня «веб-каталога», настроенного для вашего веб-сервера. Вы не должны пытаться запускать приложение Laravel из подкаталога «веб-каталога». Попытка сделать это может открыть доступ к конфиденциальным файлам, присутствующим в вашем приложении.
Красивые URL (ЧПУ)
Apache
Laravel включает файл public/.htaccess, который используется для предоставления URL-адресов без обозначения файла index.php в пути. Перед запуском Laravel с Apache обязательно включите модуль mod_rewrite, чтобы файл .htaccess обрабатывался сервером.
Если файл .htaccess, поставляемый с Laravel, не работает с вашей установкой Apache, попробуйте следующий вариант:
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, красивые URL-адреса (ЧПУ) будут настроены автоматически.
