Laravel 5.5
Установка фреймворка
Установка
Если вы лучше воспринимаете видео, чем текст, то смотрите на Laracast бесплатный курс для начинающих (версия 5.4)
Требования к серверу
В качестве локального сервера для разработки рекомендуется использовать виртуальную среду Laravel Homestead, которая удовлетворяет всем необходимым требованиям, а именно:
- PHP \(\ge\) 7.0.0
- php-расширение OpenSSL
- php-расширение PDO
- php-расширение Mbstring
- php-расширение Tokenizer
- php-расширение XML
Установка Laravel
Для управлением зависимостями Laravel использует Composer. Поэтому необходимо убедиться, что он установлен.
Laravel Installer
Установить Laravel можно через Laravel installer, который загружается командой:
1 2 3 |
composer global require "laravel/installer" |
Но предварительно стоит убедиться, что в переменную $PATH добавлена директория $HOME/.composer/vendor/bin (или аналогичная в зависимости от вашей операционной системы).
После установки станет доступна команда new для создания нового приложения в указанной вами директории. Например, команда laravel new blog создаст папку blog с новым приложением laravel вместе со всеми зависимостями:
1 2 3 |
laravel new blog |
Команда create-project в composer
Другой способ установки Laravel заключается в использовании команды create-project:
1 2 3 |
composer create-project --prefer-dist laravel/laravel blog |
Локальный сервер разработки
Если вы установили php локально и хотите использовать встроенный в php сервер для своего приложения, то можете воспользоваться artisan-командой serve. Сервер станет доступным по адресу http://localhost:8000
1 2 3 |
php artisan serve |
Конечно, более надежными вариантами для локальной разработки являются Homestead и Valet.
Настройки
Директория с открытым доступом
После установки Laravel вы должны проверить, что папка public является корнем директории (web root) для вашего приложения. Файл index.php в этой папке обрабатывает все http-запросы вашего приложения.
Файлы конфигурации
Все файлы конфигурации находятся в папке config. Рекомендуем просмотреть их все и прочитать описание каждой опции.
Права доступа
После установки Laravel может возникнуть необходимость настроить права доступа: в директориях storage и bootstrap/cache должна быть разрешена запись для вашего веб-сервера, иначе Laravel не будет запускаться. В Homestead права доступа настроены по умолчанию.
Ключ приложения
После установки Laravel необходимо указать ключ приложения в виде случайной строки. При установке Laravel через Laravel installer или Composer этот ключ будет сгенерирован автоматически с помощью команды php artisan key:generate.
Как правило, ключ состоит из 32 символов. Его можно изменить в файле настройки окружения .env. Переименуйте файл .env.example в .env, если вы это еще не сделали. Если ключ приложения не указан, то сессии пользователей и другие зашифрованные данные не будут безопасными!
Дополнительные настройки
Чтобы приступить к разработке приложения, больше не нужны никакие дополнительные настройки Тем не менее вы можете изучить файл config/app.php и изменить, например, timezone и locale.
Также можно настроить компоненты Laravel, например:
- Cache
- Database
- Session
Настройки веб-сервера
Pretty URLs
Apache
В Laravel есть файл public/.htaccess, который содержит правила для удаления index.php из URL. При работе с Apache обязательно включите модуль mod_rewrite.
Если вариант по умолчанию файла .htaccess не работает с вашей конфигурацией Apache, попробуйте другой способ:
1 2 3 4 5 6 7 8 |
Options +FollowSymLinks RewriteEngine On RewriteCond %{REQUEST_FILENAME} !-d RewriteCond %{REQUEST_FILENAME} !-f RewriteRule ^ index.php [L] |
Nginx
Если вы используете Nginx, то следующая директива перенаправит все запросы в index.php:
1 2 3 4 5 |
location / { try_files $uri $uri/ /index.php?$query_string; } |
При использовании Homestead или Valet url уже будут настроены.