Установка
Требования к серверу
Фреймворк Laravel имеет несколько системных требований. Все эти требования удовлетворяются виртуальной машиной Laravel Homestead, поэтому настоятельно рекомендуется использовать «Homestead» в качестве локальной среды разработки Laravel.
Однако, если вы не используете «Homestea»d, вам необходимо убедиться, что ваш сервер соответствует следующим требованиям:
- 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 для управления своими зависимостями. Поэтому перед использованием Laravel убедитесь, что на вашем компьютере установлен «Composer».
Через установщик Laravel
Сначала загрузите установщик Laravel с помощью «Composer»:
composer global require laravel/installer
Убедитесь, что вы разместили системный каталог vendor bin в $PATH, чтобы исполняемый файл laravel мог быть найден вашей системой. Этот каталог существует в разных местах в зависимости от операционной системы, однако некоторые общие места включают:
- macOS: $HOME/.composer/vendor/bin
- Windows: %USERPROFILE%\AppData\Roaming\Composer\vendor\bin
- GNU/Linux Distributions: $HOME/.config/composer/vendor/bin or $HOME/.composer/vendor/bin
Вы также можете найти глобальный путь установки composer, запустив «composer global about» и посмотрев первые строки.
После установки новая команда laravel создаст новую установку Laravel в указанном каталоге. Например, «laravel new blog» создаст каталог с именем «blog», содержащий новую установку Laravel со всеми уже установленными зависимостями Laravel:
laravel new blog
Через 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.
Конфигурация
Каталог public
После установки Laravel вы должны настроить директорию public. Index.php в этом каталоге служит фронт-контроллером для всех HTTP-запросов, поступающих в ваше приложение.
Конфигурационные файлы
Все файлы конфигурации для платформы 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 в url-адресе. Перед обслуживанием 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 будут настроены автоматически.