Переведено лично мной, без изысков и умных терминов (как есть). Кому надо - читайте, но помните - мною могут быть допущены ошибки.

Установка

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

Фреймворк 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 будут настроены автоматически.

Вам понравилась статья?
плохохорошо (Пока оценок нет)
Загрузка...