Laravel установить: Установка | Laravel по-русски
Установка (Laravel 5.4) — Laravel Framework Russian Community
Установка
Предпочитаете визуальное обучение? На Laracasts вы можете найти бесплатное и подробное введение в Laravel для новичков. Это отличная отправная точка вашего путешествия.
Требования к серверу
Фреймворк Laravel предъявляет некоторые системные требования. Конечно же, виртуальная машина Laravel Homestead соответствует всем этим требованиям, поэтому настоятельно рекомендуется использовать Homestead в качестве основной локальной среды разработки с Laravel.
Однако, если вы не используете Homestead, вам необходимо убедиться, что ваш сервер соответствует следующим требованиям:
- PHP >= 5.6.4
- Расширение PHP OpenSSL
- Расширение PHP PDO
- Расширение PHP Mbstring
- Расширение PHP Tokenizer
- Расширение PHP XML
Установка Laravel
Laravel использует Composer для управления своими зависимостями, поэтому убедитесь в том, что Composer установлен на вашей машине.
С помощью установщика Laravel
Сначала скачайте установщик Laravel с помощью Composer:
composer global require "laravel/installer"
Проверьте, чтобы директория $HOME/.composer/vendor/bin
(или аналогичная в зависимости от вашей ОС) находилась в переменной $PATH, что позволит вашей системе найти и выполнить команду laravel
.
После установки команда laravel new
создаёт свежую установку Laravel в указанной вами директории. Например, laravel new blog
создаст директорию с названием blog
, которая будет содержать свежую установку Laravel со всеми зависимостями:
laravel new blog
С помощью Composer Create-Project
В качестве альтернативы вы можете использовать Composer для установки Laravel с помощью команды create-project
:
composer create-project --prefer-dist laravel/laravel blog "5.4.*"
Локальный сервер разработки
Если локально у вас уже установлен PHP и вы хотели бы использовать встроенный сервер для работы вашего приложения, то вы можете использовать команду Artisan serve
. Эта команда запустит сервер разработки по адресу http://localhost:8000
:
php artisan serve
Конечно же, Homestead и Valet предоставляют наиболее надежные способы локальной разработки.
Настройка
Общедоступная директория
После установки 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, такие как:
Настройка веб-сервера
«Красивые» URL
Apache
В Laravel есть файл public/.htaccess
, который используется для отображения ссылок без указания фронт-контроллера index.php
в запрашиваемом адресе. Перед началом работы Laravel с сервером Apache, убедитесь, что модуль mod_rewrite
включен, он необходим для корректной обработки файла .htaccess
.
Если поставляемый с Laravel файл .htaccess
не работает с вашим сервером Apache, то попробуйте альтернативу:
Options +FollowSymLinks
RewriteEngine On
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 будет работать без дополнительных настроек.
Установка | Laravel по-русски
- 1. Установка Composer
- 2. Установка Laravel
- 2.1. С помощью установщика Laravel
- 2.2. С помощью создания проекта Composer
- 2.3. Загрузка архива
- 3. Требования к серверу
- 4. Настройка
- 4.1. Права доступа
- 4.2. Пути
- 5. Красивые URL
- 5.1. Apache
- 5.2. Nginx
Этот перевод актуален для англоязычной документации на
(ветка
4.2) ,
(ветка
4.1) и
(ветка
4.0).
Опечатка? Выдели и нажми Ctrl+Enter.
Установка Composer
Laravel использует Composer для управления зависимостями. Для начала скачайте файл composer.phar. Дальше вы можете либо оставить этот Phar-архив в своей локальной папке с проектом, либо переместить его в /usr/local/bin, чтобы использовать его в рамках всей системы. Для Windows вы можете использовать официальный установщик.
Установка Laravel
С помощью установщика Laravel
+
4.2
добавлено в
4.2
()
Сначала загрузите установщик Laravel с помощью Composer.
shcomposer global require "laravel/installer=~1.1"
Не забудьте поместить каталог ~/.composer/vendor/bin в вашу переменную PATH, чтобы исполняемый файл laravel мог быть найден при запуске команды shlaravel
в терминале.
После установки простая команда shlaravel new
произведёт установку свежего Laravel в указанный каталог. Например, shlaravel new blog
создаст каталог с именем blog, содержащий свежий Laravel со всеми установленными зависимостями. Этот способ установки намного быстрее, чем установка с помощью Composer.
+
4.1
добавлено в
4.1
()
Способ появился в 4.1, но был вскоре удалён.
Во-первых, скачайте PHAR-архив http://laravel.com/laravel.phar установщика Laravel. Для удобства переименуйте файл в laravel и переместите его в /usr/local/bin. После установки простая команда shlaravel new
произведёт установку свежего Laravel в указанный каталог. Например, shlaravel new blog
создаст каталог с именем blog, содержащий свежий Laravel со всеми установленными зависимостями. Этот способ установки намного быстрее, чем установка с помощью Composer.
С помощью создания проекта Composer
Вы также можете установить Laravel с помощью команды shcreate-project
:
shcomposer create-project laravel/laravel --prefer-dist
Загрузка архива
Как только Composer установлен, скачайте последнюю версию фреймворка и извлеките архив в папку на вашем сервере. Дальше, в корне вашего приложения на Laravel выполните shphp composer.phar install
(или shphp composer install
) для установки всех зависимостей библиотеки. Этот процесс требует, чтобы на сервере был установлен Git.
Если вы хотите обновить Laravel, выполните команду shphp composer.phar update
.
Требования к серверу
У Laravel всего несколько требований к вашему серверу:
- PHP >= 5.4 (для Laravel 4.1 и ниже — 5.3.7)
- MCrypt (расширение для PHP)
Для PHP 5.5 в некоторых дистрибутивах ОС может потребоваться вручную установить расширение PHP JSON. В Ubuntu это можно сделать командой shapt-get install php5-json
.
Настройка
Laravel практически не требует начальной настройки — вы можете сразу начинать разработку. Однако вам может пригодиться файл app/config/app.php и его документация — он содержит несколько настроек вроде timezone и locale, которые вам может потребоваться изменить в соответствии с нуждами вашего приложения.
В Laravel 3 и в ранних версиях Laravel 4 единственная настройка, которую вам нужно было изменить — key в файле app/config/app.php. Это значение должно быть случайной строкой длиной 32 символа. Оно используется при шифровании и зашифрованные строки не будут безопасными, пока вы не измените эту настройку. Теперь в Laravel 4 это делается автоматически. Вы также можете быстро его установить с помощью следующей команды: shphp artisan key:generate
.
После установки Laravel вам также надо настроить локальное окружение. Это позволит вам получать подробные сообщения об ошибках при разработке на локальной машине. По умолчанию подробные отчёты об ошибках отключены в файле рабочей конфигурации.
Никогда не оставляйте параметр app.debug со значением true в рабочем приложении. Никогда не делайте этого.
Права доступа
Для Laravel может потребоваться, чтобы у сервера были права на запись в папку app/storage.
Пути
Некоторые системные пути Laravel — настраиваемые; для этого обратитесь к файлу bootstrap/paths.php.
Красивые URL
Apache
Laravel поставляется вместе с файлом public/.htaccess, который настроен для обработки URL без указания index.php. Если вы используете Apache в качестве веб-сервера, обязательно включите модуль mod_rewrite.
Если стандартный .htaccess не работает для вашего Apache, попробуйте следующий:
confOptions +FollowSymLinks RewriteEngine On RewriteCond %{REQUEST_FILENAME} !-d RewriteCond %{REQUEST_FILENAME} !-f RewriteRule ^ index.php [L]
Nginx
При использовании Nginx следующая директива в настройках вашего сайта позволит применить «красивые» URL:
conflocation / { try_files $uri $uri/ /index.php?$query_string; }
Установка Laravel разными способами в подробностях
Переведено лично мной, без изысков и умных терминов (как есть). Кому надо — читайте, но помните — мною могут быть допущены ошибки.
Требования к серверу
Фреймворк 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 будут настроены автоматически.
Помощь проекту!
Не забудьте подписаться на обновления:
Поделиться с друзьями:
Похожие записи
Оставить свой комментарий
Установка (Laravel 6.x) — Laravel Framework Russian Community
Установка
Требования к серверу
Фреймворк Laravel предъявляет некоторые системные требования. Конечно же, виртуальная машина Laravel Homestead соответствует всем этим требованиям, поэтому настоятельно рекомендуется использовать Homestead в качестве основной локальной среды разработки с Laravel.
Однако, если вы не используете Homestead, вам необходимо убедиться, что ваш сервер соответствует следующим требованиям:
- PHP >= 7.2.0
- Расширение PHP BCMath
- Расширение PHP Ctype
- Расширение PHP Fileinfo
- Расширение PHP JSON
- Расширение PHP Mbstring
- Расширение PHP OpenSSL
- Расширение PHP PDO
- Расширение PHP Mbstring
- Расширение PHP Tokenizer
- Расширение PHP XML
Установка Laravel
Laravel использует Composer для управления своими зависимостями, поэтому убедитесь в том, что Composer установлен на вашей машине.
С помощью установщика Laravel
Сначала скачайте установщик Laravel с помощью Composer:
composer global require laravel/installer
Проверьте, чтобы директория composer’а vendor/bin
находилась в переменной $PATH, что позволит вашей системе найти и выполнить команду laravel
. Эта директория располагается в разных местах в зависимости от вашей операционной системы, но обычно она находится тут:
- macOS:
$HOME/.composer/vendor/bin
- Windows:
%USERPROFILE%\AppData\Roaming\Composer\vendor\bin
- Linux:
$HOME/.config/composer/vendor/bin
или$HOME/.composer/vendor/bin
Также вы можете определить директорию выполнив команду composer global about
(смотрите первую строчку вывода).
После установки команда laravel new
создаёт свежую установку Laravel в указанной вами директории. Например, laravel new blog
создаст директорию с названием blog
, которая будет содержать свежую установку Laravel со всеми зависимостями:
laravel new blog
С помощью Composer Create-Project
В качестве альтернативы вы можете использовать Composer для установки Laravel с помощью команды create-project
:
composer create-project --prefer-dist laravel/laravel blog "6.*"
Локальный сервер разработки
Если локально у вас уже установлен PHP и вы хотели бы использовать встроенный сервер для работы вашего приложения, то вы можете использовать команду Artisan serve
. Эта команда запустит сервер разработки по адресу http://localhost:8000
:
php artisan serve
Конечно же, Homestead и Valet предоставляют наиболее надежные способы локальной разработки.
Настройка
Общедоступная директория
После установки 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 всегда должен располагаться за пределами директории, доступной из web. Не нужно размещать приложение в поддиректории «web root». Попытка сделать это может привести к раскрытию конфиденциальной информации, содержащейся в файлахвашего приложения.
«Красивые» URL
Apache
В Laravel есть файл public/.htaccess
, который используется для отображения ссылок без указания фронт-контроллера index.php
в запрашиваемом адресе. Перед началом работы Laravel с сервером Apache, убедитесь, что модуль mod_rewrite
включен, он необходим для корректной обработки файла .htaccess
.
Если поставляемый с Laravel файл .htaccess
не работает с вашим сервером 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 будет работать без дополнительных настроек.
Установка (Laravel 5.0) — Laravel Framework Russian Community
Перевод сильно отстаёт от оригинала, может быть неактуален
Установка Composer
Laravel использует Composer для управления зависимостями. Поэтому прежде чем ставить Laravel вы должны установить Composer.
Установка Laravel
При помощи установщика Laravel
Используя Composer скачайте установщик Laravel.
composer global require "laravel/installer=~1.1"
Указав в качестве PATH директорию ~/.composer/vendor/bin
, станет возможным использование команды laravel
.
После установки, простая команда laravel new
создаст свеженькое Laravel приложение в директории, которую вы укажете. Например, laravel new blog
создаст директорию blog
и установит туда Laravel со всеми зависимостями. Этот метод установки намного быстрее, чем установка через Composer:
laravel new blog
При помощи Composer
Вы также можете установить Laravel используя команду Composer create-project
:
composer create-project laravel/laravel --prefer-dist
Требования к серверу
У Laravel всего несколько требований к вашему серверу:
- PHP >= 5.4
- Mcrypt PHP Extension
- OpenSSL PHP Extension
- Mbstring PHP Extension
Начиная с PHP 5.5, в некоторых операционных системах может понадобиться ручная установка PHP JSON extension. В Ubuntu, например, это можно сделать при помощи sudo apt-get install php5-json
.
Настройка
Первое, что вы должны сделать после установки Laravel — установить ключ шифрования сессий и кук. Это случайная строка из 32 символов, находится в файле .env
, параметр ‘APP_KEY’. Если вы устанавливали Laravel при помощи Composer, то ключ уже сгенерен. Вы можете сгенерить его вручную artisan-командой key:generate
. Если ключ шифрования отсутствует, ваши сессии, куки другая шифруемая информация не будет зашифрована надежным образом..
Laravel практически не требует другой начальной настройки — вы можете сразу начинать разработку. Однако может быть полезным изучить файл config/app.php
— он содержит несколько настроек вроде timezone
и locale
, которые вам может потребоваться изменить в соответствии с нуждами вашего приложения.
Далее вы можете сконфигурить настройки среды выполнения.
Примечание: Никогда не устанавливайте настройку
app.debug
вtrue
на рабочем (продакшн) окружении.
Права на запись
Папки внутри storage
должны быть доступны веб-серверу для записи. Если вы устанавливаете фреймворк на Linux или MacOS — открыть папки на запись можно командой chmod -R 777 storage
Красивые URL
Apache
Laravel поставляется вместе с файлом public/.htaccess
, который настроен для обработки URL без указания index.php
. Если вы используете Apache в качестве веб-сервера обязательно включите модуль mod_rewrite
.
Если стандартный .htaccess
не работает для вашего Apache, попробуйте следующий:
Options +FollowSymLinks
RewriteEngine On
RewriteCond %{REQUEST_FILENAME} !-d
RewriteCond %{REQUEST_FILENAME} !-f
RewriteRule ^ index.php [L]
Nginx
Если вы используете в качестве веб-сервера Nginx, то используйте для ЧПУ следующую конструкцию:
location / {
try_files $uri $uri/ /index.php?$query_string;
}
Если вы используете Homestead, то вам ничего делать не нужно, там всё это уже настроено.
Быстрая установка Laravel в Ubuntu при помощи Composer 🎼
Фреймворк Laravel пользуется популярностью за счет ряда факторов:
- он объектно-ориентированный;
- соблюдается модель MVC;
- доступна поддержка нескольких баз данных.
Кроме того, в нем доступна масса инструментов для развертывания приложений и упрощения веб-разработки. Рассмотрим, как выглядит установка Laravel на Ubuntu.
Подготовка к установке
Чтобы запустить на веб-сервере Laravel, в Ubuntu необходимо удовлетворить ряд зависимостей. Все необходимые для работы компоненты имеются в наличии на виртуальной машине Laravel Homestead. Поэтому разработчики рекомендуют использовать именно ее для запуска на локальной машине.
Тем не менее, развертывать и тестировать приложения в основном придется на веб-серверах с Linux, а не на Homestead. Чтобы установить Laravel на таком веб-сервере, на нем должны быть установлена версия PHP >= 7.2.0 и следующие расширения PHP:
- BCMath PHP Extension;
- Ctype PHP Extension;
- JSON PHP Extension;
- Mbstring PHP Extension;
- OpenSSL PHP Extension;
- PDO PHP Extension;
- Tokenizer PHP Extension;
- XML PHP Extension.
В Ubuntu эти зависимости можно установить при помощи команды в терминале:
sudo apt install php php-mysql php-mbstring php-tokenizer php-xml php-json php-common
Об успешной установке будут свидетельствовать следующие строки в терминале:
Установка через Composer
Чтобы работать с Laravel потребуется предварительно установить Composer, поскольку фреймворк управляет с его помощью своими зависимостями:
sudo apt install composer
После установки появится сообщение об автоматической настройке следующих пакетов:
Теперь можно переходить непосредственно к установке фреймворка. Сначала необходимо загрузить его установщик через Composer:
composer global require laravel/installer
В некоторых случаях выполнение этой команды может занять определенное время.
Далее, обязательно нужно поместить общесистемный каталог bin от Composer в свой каталог $PATH. Это позволит Ubuntu распознать исполняемый файл Laravel.
Этот каталог расположен в разных местах, в зависимости от дистрибутива. В Ubuntu он располагается по следующему пути:
$HOME/.config/composer/vendor/bin
Пользователи других дистрибутивов могут поискать здесь:
$HOME/.composer/vendor/bin
Использование Laravel Installer
Запустить установщик Laravel в Composer можно следующей командой в терминале:
composer global about
После ее выполнения отобразится список, где фреймворк будет расположен в первых рядах.
Далее достаточно ввести команду laravel new, после чего свежий фреймворк Laravel будет установлен в заранее указанном каталоге. К примеру, данная команда позволит создать папку под названием blog, где будут находиться Laravel со всеми установленными зависимостями:
laravel new blog
Запуск фреймворка через Composer Create-Project
В Composer поддерживается возможность установки Laravel через команду сomposer create-project:
composer create-project --prefer-dist laravel/laravel blog
Эту команду необходимо выполнять, предварительно перейдя в папку, где будет храниться будущий сайт. Например, на локальном сервере Apache по умолчанию это каталог: cd /var/www/.
Работа на локальном сервере
После того, как Laravel установлен, следует убедиться в его работоспособности с помощью скрипта командной строки artisan (Artisan CLI). Для этого надо активировать встроенный в PHP локальный сервер с помощью команды:
php artisan serve
После ее ввода станет доступен локальный сервер по адресу http://localhost:8000. Перейдя по нему, можно увидеть заставку-приветствие «You have arrived» («Вы прибыли»).
Чтобы увидеть полный список команд для artisan, введите:
php artisan list
Последующая настройка
Публичная директория
Когда Laravel будет успешно установлен, сразу же потребуется настроить перенаправление файлов приложения в общедоступную папку /public. Файл index.php в этом каталоге используется как фронт-контроллер для всех HTTP-запросов, поступающих в создаваемое приложение.
Файлы настроек
Конфигурационные файлы — это PHP-скрипты, хранящиеся в application/config и вложенных подпапках.
Сами файлы представляет собой набор пар ключ массива => значение, где «ключ» — имя отдельной опции.
Права на доступ
В большинстве случаев, при настройке Laravel будет нужно отредактировать права доступа к директории /var/www, где по умолчанию хранятся веб-приложения. В противном случае фреймворк не сможет нормально функционировать.
Как получить права доступа
1. Добавить себя в группу владельцев веб-сервера www-data:
sudo usermod -a -G www-data $USER
Если пользователь вошел с root правами, этот пункт опускается.
2. Изменить права владельца на Laravel-проект командой:
sudo chgrp -R www-data /var/www/html/project
3. Даются права на запись в папку-хранилище storage:
sudo chmod -R 775 /var/www/html/project/storage
Для пользователя root (помимо первого пункта) из алгоритма исключается команда sudo.
Ключ приложения
Еще одна необходимая вещь, которую обязательно стоит сделать, когда Laravel установлен на хостинге – создать ключ приложения. При отсутствии установленного ключа приложения сеансы пользователей и другая конфиденциальная информация не будут защищены.
Он представляет собой случайно сгенерированную строку в 32 символа. Если для установки использовался Composer или установщик Laravel, ключ автоматически создается указанной командой:
php artisan key:generate
После создания ключ следует вписать как параметр в файл окружения .env. Если такой файл первоначально существовал в Laravel с расширением .env.example, то следует обязательно изменить расширение на .env.
Дополнительная настройка
Laravel сразу же после установки почти не нуждается в более подробном конфигурировании. Однако при желании можно ознакомиться с файлом конфигурации config/app.php и его документацией.
В нем указано несколько параметров, включая часовой пояс и локализацию, которые можно изменить с учетом особенностей разрабатываемого приложения.
Настройка веб-сервера
Настройка общедоступной директории
После установки и настройки Laravel нужно обязательно указать встроенную во фреймворк папку public в качестве корневого каталога веб-сервера. К этой общедоступной папке будут идти все входящие обращения из Сети. Обрабатывать входящие HTTP-запросы будет расположенный в public файл фронт-контроллер index.php.
Настройка веб-адресов
Apache
В установленном Laravel по умолчанию присутствует файл public/.htaccess. Он используется для того, чтобы URL-адреса отображались без указания фронт-контроллера index.php. Если Laravel установлен на веб-сервере Apache, для этого следует активировать модуль mod_rewrite. Тогда веб-сервер будет учитывать опции файла .htaccess.
Возможно, включенный в Laravel файл .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; }
Laravel 5.5. Установка фреймворка Laravel под Windows
Требования к серверу для Laravel 5.5:
- PHP ≥ 7.0.0
- php-расширение OpenSSL
- php-расширение PDO
- php-расширение Mbstring
- php-расширение Tokenizer
- php-расширение XML
Установка и настройка Composer
Laravel использует Composer для управления зависимостями, поэтому сначала установим Composer: Установка и настройка Composer под Windows
Установка Laravel
Установка Laravel через Laravel installer:
composer global require "laravel/installer"
Теперь ещё раз добавляем в системную переменную пользователя PATH путь %USERPROFILE%\AppData\Roaming\Composer\vendor\bin
, в нём и будет лежать исполняемый файл laravel.
Для linux это путь $HOME/.composer/vendor/bin
После установки команда laravel new
произведёт установку свежего Laravel в указанный каталог. Например, laravel new blog
создаст каталог с именем blog, содержащий свежий Laravel со всеми установленными зависимостями:
laravel new blog
Или можно установить с помощью создания проекта Composer
composer create-project --prefer-dist laravel/laravel blog "5.5"
так же будет создана папка blog с установленным laravel фреймворком.
Локальный сервер для разработки
Если на вашей локальной машине установлен PHP, и вы хотите использовать встроенный в него сервер для разработки вашего приложения, вы можете использовать Artisan-команду serve. Эта команда запустит сервер на http://localhost:8000:
php artisan serve
Проверка работы Laravel фреймворка
Чтобы проверить работу фреймворка, необходимо указать вебсерверу Apache путь до каталога public
, который находится внутри созданного каталога blog
.
Так как я использую OpenServer, мне пришлось в ручную добавить домен, где папка домены была \test.local\blog\public
https://laravel.ru/docs/v5/installation
http://www.itmathrepetitor.ru/dokumentaciya-laravel-5-5-ustanovka-freymvorka/
http://www.itmathrepetitor.ru/laravel-5-russkaya-dokumentaciya/
https://dka-develop.ru/blog/article/1-ustanovka-laravel-pervye-shagi-composer-laravel-55-0209171749
https://youtu.be/qgeeJ_P3v0Q
Установка
(Laravel 8.x) — Русское сообщество Laravel Framework
Перевод отсутсвует
Установка
Требования к серверу
У фреймворка Laravel есть несколько системных требований. Всем этим требованиям удовлетворяет виртуальная машина Laravel Homestead, поэтому настоятельно рекомендуется использовать Homestead в качестве локальной среды разработки Laravel.
Однако, если вы не используете Homestead, вам необходимо убедиться, что ваш сервер соответствует следующим требованиям:
- PHP> = 7.3
- Расширение BCMath PHP
- Ctype PHP-расширение
- Fileinfo Расширение PHP
- Расширение PHP JSON
- Mbstring PHP-расширение
- Расширение PHP OpenSSL
- PDO PHP-расширение
- Расширение PHP для токенизатора
- Расширение XML PHP
Установка Laravel
Laravel использует Composer для управления своими зависимостями. Итак, перед использованием Laravel убедитесь, что на вашем компьютере установлен Composer.
Через установщик Laravel
Сначала загрузите установщик Laravel с помощью Composer:
composer global требуется laravel / installer
Обязательно поместите общесистемный каталог bin поставщика Composer в ваш $ PATH
, чтобы исполняемый файл laravel мог быть обнаружен вашей системой. Этот каталог существует в разных местах в зависимости от вашей операционной системы; однако некоторые общие местоположения включают:
- macOS:
$ HOME / .composer / vendor / bin
- Windows:
% ПРОФИЛЬ ПОЛЬЗОВАТЕЛЯ% \ AppData \ Roaming \ Composer \ vendor \ bin
- Дистрибутивы GNU / Linux:
$ HOME /.config / composer / vendor / bin
или$ HOME / .composer / vendor / bin
Вы также можете найти глобальный путь установки композитора, запустив composer global около
и посмотрев вверх с первой строки.
После установки команда laravel new
создаст новую установку Laravel в указанном вами каталоге. Например, laravel new blog
создаст каталог с именем blog
, содержащий новую установку Laravel со всеми уже установленными зависимостями Laravel:
новый блог laravel
Хотите создать проект Laravel с уже созданными для вас функциями входа, регистрации и другими функциями? Проверьте Laravel Jetstream.
Через Composer Create-Project
В качестве альтернативы вы также можете установить Laravel, введя команду Composer create-project
в своем терминале:
composer create-project --prefer-dist блог laravel / laravel
Локальный сервер разработки
Если у вас установлен PHP локально и вы хотите использовать встроенный сервер разработки PHP для обслуживания своего приложения, вы можете использовать Artisan-команду serve
. Эта команда запустит сервер разработки по адресу http: // localhost: 8000
:
php artisan serve
Более надежные варианты местного развития доступны через Homestead и Valet.
Конфигурация
Общедоступный каталог
После установки Laravel вы должны сконфигурировать корневой каталог документов / веб-сервера вашего веб-сервера как общедоступный каталог
. index.php
в этом каталоге служит фронт-контроллером для всех HTTP-запросов, поступающих в ваше приложение.
Файлы конфигурации
Все файлы конфигурации для фреймворка Laravel хранятся в каталоге config
. Каждый параметр задокументирован, поэтому не стесняйтесь просматривать файлы и знакомиться с доступными вам вариантами.
Разрешения каталога
После установки Laravel вам может потребоваться настроить некоторые разрешения. Каталоги в хранилище
и каталогах начальной загрузки / кеширования
должны быть доступны для записи вашим веб-сервером, иначе Laravel не будет работать. Если вы используете виртуальную машину Homestead, эти разрешения уже должны быть установлены.
Ключ приложения
Следующее, что вам нужно сделать после установки Laravel, — это установить для ключа приложения случайную строку.Если вы установили Laravel через Composer или установщик Laravel, этот ключ уже был установлен для вас с помощью ключа php artisan: generate
.
Обычно эта строка должна состоять из 32 символов. Ключ может быть установлен в файле среды .env
. Если вы не скопировали файл .env.example
в новый файл с именем .env
, вам следует сделать это сейчас. Если ключ приложения не задан, ваши пользовательские сеансы и другие зашифрованные данные не будут защищены!
Дополнительная конфигурация
Laravel практически не требует другой конфигурации из коробки.Вы можете начать разработку! Однако вы можете просмотреть файл config / app.php
и его документацию. Он содержит несколько параметров, таких как часовой пояс
и локаль
, которые вы можете изменить в соответствии с вашим приложением.
Вы также можете настроить несколько дополнительных компонентов Laravel, например:
Конфигурация веб-сервера
Конфигурация каталога
Laravel всегда должен обслуживаться из корня «веб-каталога», настроенного для вашего веб-сервера.Вы не должны пытаться обслуживать приложение Laravel из подкаталога «веб-каталога». Попытка сделать это может открыть доступ к конфиденциальным файлам, присутствующим в вашем приложении.
Красивые URL-адреса
Apache
Laravel включает общедоступный файл / .htaccess
, который используется для предоставления URL-адресов без фронт-контроллера index.php
в пути. Перед обслуживанием Laravel с Apache обязательно включите модуль mod_rewrite
, чтобы файл .index.php [L]
Nginx
Если вы используете Nginx, следующая директива в конфигурации вашего сайта будет направлять все запросы на фронт-контроллер index.php
:
местонахождение / {
try_files $ uri $ uri / /index.php?$query_string;
}
При использовании Homestead или Valet красивые URL-адреса будут настроены автоматически.
.Установка
(Laravel 7.x) — Русское сообщество Laravel Framework
Перевод отсутсвует
Установка
Требования к серверу
У фреймворка Laravel есть несколько системных требований. Всем этим требованиям удовлетворяет виртуальная машина Laravel Homestead, поэтому настоятельно рекомендуется использовать Homestead в качестве локальной среды разработки Laravel.
Однако, если вы не используете Homestead, вам необходимо убедиться, что ваш сервер соответствует следующим требованиям:
- PHP> = 7.2,5
- Расширение BCMath PHP
- Ctype PHP-расширение
- Fileinfo Расширение PHP
- Расширение PHP JSON
- Mbstring PHP-расширение
- Расширение PHP OpenSSL
- PDO PHP-расширение
- Расширение PHP для токенизатора
- Расширение XML PHP
Установка Laravel
Laravel использует Composer для управления своими зависимостями. Итак, перед использованием Laravel убедитесь, что на вашем компьютере установлен Composer.
Через установщик Laravel
Сначала загрузите установщик Laravel с помощью Composer:
composer global требуется laravel / installer
Обязательно поместите общесистемный каталог bin поставщика Composer в ваш $ PATH
, чтобы исполняемый файл laravel мог быть обнаружен вашей системой. Этот каталог существует в разных местах в зависимости от вашей операционной системы; однако некоторые общие местоположения включают:
- macOS:
$ HOME / .composer / vendor / bin
- Windows:
% ПРОФИЛЬ ПОЛЬЗОВАТЕЛЯ% \ AppData \ Roaming \ Composer \ vendor \ bin
- Дистрибутивы GNU / Linux:
$ HOME /.config / composer / vendor / bin
или$ HOME / .composer / vendor / bin
Вы также можете найти глобальный путь установки композитора, запустив composer global около
и посмотрев вверх с первой строки.
После установки команда laravel new
создаст новую установку Laravel в указанном вами каталоге. Например, laravel new blog
создаст каталог с именем blog
, содержащий новую установку Laravel со всеми уже установленными зависимостями Laravel:
новый блог laravel
Через Composer Create-Project
В качестве альтернативы вы также можете установить Laravel, введя команду Composer create-project
в своем терминале:
composer create-project --prefer-dist laravel / laravel: ^ 7.0 блог
Локальный сервер разработки
Если у вас установлен PHP локально и вы хотите использовать встроенный сервер разработки PHP для обслуживания своего приложения, вы можете использовать Artisan-команду serve
. Эта команда запустит сервер разработки по адресу http: // localhost: 8000
:
php artisan serve
Более надежные варианты местного развития доступны через Homestead и Valet.
Конфигурация
Общедоступный каталог
После установки Laravel вы должны сконфигурировать корневой каталог документов / веб-сервера вашего веб-сервера как общедоступный каталог
. index.php
в этом каталоге служит фронт-контроллером для всех HTTP-запросов, поступающих в ваше приложение.
Файлы конфигурации
Все файлы конфигурации для фреймворка Laravel хранятся в каталоге config
. Каждый параметр задокументирован, поэтому не стесняйтесь просматривать файлы и знакомиться с доступными вам вариантами.
Разрешения каталога
После установки Laravel вам может потребоваться настроить некоторые разрешения.Каталоги в хранилище
и каталогах начальной загрузки / кеширования
должны быть доступны для записи вашим веб-сервером, иначе Laravel не будет работать. Если вы используете виртуальную машину Homestead, эти разрешения уже должны быть установлены.
Ключ приложения
Следующее, что вам нужно сделать после установки Laravel, — это установить для ключа приложения случайную строку. Если вы установили Laravel через Composer или установщик Laravel, этот ключ уже был установлен для вас с помощью ключа php artisan: generate
.
Обычно эта строка должна состоять из 32 символов. Ключ может быть установлен в файле среды .env
. Если вы не скопировали файл .env.example
в новый файл с именем .env
, вам следует сделать это сейчас. Если ключ приложения не задан, ваши пользовательские сеансы и другие зашифрованные данные не будут защищены!
Дополнительная конфигурация
Laravel практически не требует другой конфигурации из коробки. Вы можете начать разработку! Однако вы можете просмотреть файл config / app.php
и документацию к нему. Он содержит несколько параметров, таких как часовой пояс
и локаль
, которые вы можете изменить в соответствии с вашим приложением.
Вы также можете настроить несколько дополнительных компонентов Laravel, например:
Конфигурация веб-сервера
Конфигурация каталога
Laravel всегда должен обслуживаться из корня «веб-каталога», настроенного для вашего веб-сервера. Вы не должны пытаться обслуживать приложение Laravel из подкаталога «веб-каталога».Попытка сделать это может открыть доступ к конфиденциальным файлам, присутствующим в вашем приложении.
Красивые URL-адреса
Apache
Laravel включает общедоступный файл / .htaccess
, который используется для предоставления URL-адресов без фронт-контроллера index.php
в пути. Перед обслуживанием Laravel с Apache обязательно включите модуль mod_rewrite
, чтобы файл .htaccess
был обработан сервером.
Если файл .htaccess
, поставляемый с Laravel, не работает с вашей установкой Apache, попробуйте следующий вариант:
Параметры + FollowSymLinks -Индексы
RewriteEngine On
RewriteCond% {HTTP: авторизация}.index.php [L]
Nginx
Если вы используете Nginx, следующая директива в конфигурации вашего сайта будет направлять все запросы на фронт-контроллер index.php
:
местонахождение / {
try_files $ uri $ uri / /index.php?$query_string;
}
При использовании Homestead или Valet красивые URL-адреса будут настроены автоматически.
.
Laravel admin | Laravel-админ
laravel-admin
— это построитель административного интерфейса для laravel, который может помочь вам создавать бэкенды CRUD всего с помощью нескольких строк кода.
Поскольку у меня не так много времени на поддержку этого проекта, laravel-admin поддерживает только LTS-версию Laravel (в настоящее время Laravel 5.5).
Демо используйте имя пользователя / пароль: admin / admin
На основе SleepingOwlAdmin и rapyd-laravel.
Документация |中文 文档
Для этого пакета требуются PHP 7+ и Laravel 5.5+
Сначала установите laravel 5.5 и убедитесь, что настройки подключения к базе данных верны.
композитору требуется бис / laravel-admin
Затем выполните эти команды, чтобы опубликовать активы и настроить :
Поставщик php artisan: publish --provider = "Encore \ Admin \ AdminServiceProvider"
После выполнения команды вы можете найти файл конфигурации в config / admin.php
, в этом файле вы можете изменить каталог установки, соединение с базой данных или имена таблиц.
Наконец, выполните следующую команду, чтобы завершить установку.
php artisan admin: установить
Откройте http: // localhost / admin /
в браузере, используйте имя пользователя admin
и пароль admin
для входа.
Файл в config / admin.php
содержит массив настроек, вы можете найти там настройки по умолчанию.
laravel-admin
на основе следующих плагинов или служб:
Помогите продолжить развитие проекта, сделав небольшое пожертвование.Заранее спасибо.
laravel-admin
находится под лицензией MIT License (MIT).
.