Фреймворк Laravel

Что необходимо

IDE
PhpStorm
Atom 
Sublime Text
Notepad++
И др.
https://getcomposer.org/ установка (обновление) Laravel, добавление (обновление) дополнительных

Требования

PHP> = 5.6.4
Расширение OpenSSL PHP
Расширение PDO PHP
Расширение Mbstring PHP
Расширение Tokenizer PHP
Расширение

Установка

composer global require "laravel/installer«
Обязательно поместите каталог (или эквивалентный каталог для

Конфигурация

Публичный каталог
После установки Laravel вы должны настроить корневой документ / корневой

Конфигурация

Ключ приложения
Следующее, что вам нужно сделать после установки Laravel, - это

Laravel Mix

CSS, JS, Less, Saas, Stylus, PostCSS

Laravel Forge

Laravel Forge – Автоматическое развёртывания из Git
DigitalOcean, Linode 

СТРУКТУРА LARAVEL

app — место, где хранятся наши контроллеры, модели
bootstrap — системная

.env — файл с настройками “рабочей среды”
.gitignore — настройки для работы

2 варианта первоначальной настройки:
Прописать все настройки внутри config/app.php, config/database.php
Создать новый файл

В начале Laravel подтягивает настройки среды запуска (из .env) и только

ENVIRONMENT: РАБОЧАЯ СРЕДА LARAVEL

Назначение рабочей среды:
разделять настройки для разработки/тестирования/production
изолировать свои настройки

НАСТРОЙКА РАБОЧЕЙ СРЕДЫ LARAVEL 5

APP_ENV — название рабочей среды
APP_KEY — ключ

ARTISAN: ОСНОВНЫЕ КОМАНДЫ

Список команд:

php artisan list

Список команды определенного блока:

php artisan list

Используемая рабочая среда:

php artisan env

Используемая версия Laravel:

php artisan --version

Генерация ключа приложения:

php

Выключение приложения:

php artisan down

Включение приложения:

php artisan up

Запуск миграций:

php artisan migrate

ARTISAN: ОСНОВНЫЕ

МАРШРУТИЗАЦИЯ

Client HTTP Request

Router

МАРШРУТИЗАЦИЯ: РЕГИСТРАЦИЯ МАРШРУТОВ

метод get говорит о том, что запрос пришел по

МАРШРУТИЗАЦИЯ: ROUTER

Поддерживаемые методы для регистрации маршрутов:
Route::get($uri, $callback); Route::post($uri, $callback); Route::put($uri, $callback);

МАРШРУТИЗАЦИЯ: ROUTER

Иногда нужно перечислить сразу несколько методов для маршрута:

Route::match(['get', 'post'], '/',

МАРШРУТИЗАЦИЯ: ПАРАМЕТРЫ МАРШРУТОВ

В данном случае все, что будет стоять после user/

МАРШРУТИЗАЦИЯ: ПАРАМЕТРЫ МАРШРУТОВ

передаются маршруты в том же порядке, в котором они

МАРШРУТИЗАЦИЯ: ПАРАМЕТРЫ МАРШРУТОВ

Параметры у маршрута могут быть необязательными: указываются с “?”.

Route::get('user/{id?}',

МАРШРУТИЗАЦИЯ: ПРИВЯЗКА К ДЕЙСТВИЮ

2й параметр в регистрации маршрутов — привязка к

Для одного маршрута должно быть зарегистрировано одно действие.

МАРШРУТИЗАЦИЯ: ПРИВЯЗКА К ДЕЙСТВИЮ

Скачано

МАРШРУТИЗАЦИЯ: ПРИОРИТЕТ МАРШРУТОВ

Каждый следующий маршрут перекрывает предыдущий, если они пересекаются по

МАРШРУТИЗАЦИЯ: ДОПОЛНИТЕЛЬНЫЕ ВОЗМОЖНОСТИ

Это позволит упростить роутер и повысить читаемость кода.
Появились методы

Указание параметра маршрута через регулярные выражения:

Route::get('user/{name}', function ($name) {
//
})->where('name', '[A-Za-z]+');
Route::get('user/{id}', function

КОНТРОЛЛЕРЫ

Контроллеры — это классы, которые содержат (организовывают) логику обработки запроса, работу

Client HTTP Request

Router

Controller

КОНТРОЛЛЕРЫ

КОНТРОЛЛЕРЫ: СОЗДАНИЕ

Создание контроллера:

php artisan make:controller UserController

В конце метода обычно возвращается представление

Возможно создание контроллера в нужной области видимости внутри директории app/Http/Controllers:

php artisan

КОНТРОЛЛЕРЫ: ПАРАМЕТРЫ МАРШРУТА

каждый переданный в маршруте параметр требуется обработать в контроллере
значения

namespace App\Http\Controllers; use Illuminate\Http\Request;
class PagesController extends Controller
{
public function user($userId)
{
//$userId - это

BLADE: ПРЕДСТАВЛЕНИЯ

Для удобства работы со страницами в Laravel существуют представления (view).

ПРЕДСТАВЛЕНИЯ

Client HTTP Request

Router

Controller

BLADE: ПОДКЛЮЧЕНИЕ ПРЕДСТАВЛЕНИЙ

Представления подключаются через view(), где первый параметр - название

BLADE: ПЕРЕДАЧА ДАННЫХ В ПРЕДСТАВЛЕНИЕ

Пример подразумевает наличие переменной $data в методе

BLADE: ОТОБРАЖЕНИЕ ДАННЫХ В ШАБЛОНЕ

Для отображения значения переменной в представлении используется

BLADE: УПРАВЛЯЮЩИЕ КОНСТРУКЦИИ

Blade поддерживает следующие управляющие конструкции:
if, if … else, isset,

@isset($user)
@foreach($users as $user)

{{ $user->name }} @if($user->approved())
Пользователь подтвержден
@endif

BLADE: УПРАВЛЯЮЩИЕ

ДЕБАГ ПАНЕЛЬ BARRYVDH

Полезный инструмент для разработчика: пакет barryvdh/laravel-debugbar

composer require barryvdh/laravel-debugbar --dev

В

Для среды production убрать вывод ошибок и информацию для дебага:
В app\Providers\AppServiceProvider.php

Решение №1
dump файл Проблемы:
при каждом обновлении этого файла придётся запускать этот

Решение №2
Разбить dump-файл на отдельные файлы, с каждым изменением добавлять новые

Решение №3
Добавить timestamp в названия файлов и создать таблицу, где записывать

Решение №4
Для каждого файла создавать файл-дублёр, который позволит вернуться на шаг

МИГРАЦИИ: ЧТО ТАКОЕ МИГРАЦИИ

Миграции — встроенный механизм в Laravel, позволяющий решить

Метод up() содержит в себе инструкции, которые запускаются при запуске миграции.
Метод

Создаются миграции через artisan:

php artisan make:migration create_new_table

create_new_table — название миграции.
создаст файл

дополнительные флаги:
--create=tableName — создание таблицы tableName
--table=tableName — изменение таблицы tableName

МИГРАЦИИ: СОЗДАНИЕ

Schema::create — создание таблицы
Schema::table — обновление таблицы
Schema::drop — удаление таблицы
create &

increments('id') — создает автоинкрементное поле с названием id
timestamps() — создает 2

Класс Blueprint содержит:
методы, названные по типу поля, которое оно создает (bigInteger,

В методах создания полей параметры:
название поля
длина поля, массив значения (для enum)
для

php artisan migrate

миграции будут запущены в порядке создания
если это первый запуск

Выполнятся все не выполненные ранее миграции.
После того, как миграции будут выполнены

SQLSTATE[42000]: Syntax error or access violation: 1071 Specified key was too

откат миграций:

php artisan migrate:rollback

откат миграций только конкретного количества миграций:

php artisan migrate:rollback

откатить сразу все миграции

php artisan migrate:reset

выполнить откат и запуск всех миграций

МИГРАЦИИ: ВНЕСЕНИЕ ИЗМЕНЕНИЙ

При необходимости внести изменения в миграцию (таблицу), если она

При переключении между ветками в git может возникнуть проблема:
в базе данных

ЗАПРОСЫ В БАЗУ ДАННЫХ

Написание запросов:
$users = DB::select('select * from users');
$results =

КОНСТРУКТОР ЗАПРОСОВ В БД

$user = DB::table('users')->where('name', 'John')->first();
where() имеет 2 или 3

Выбрать все значения из таблицы можно методами all() и get():
$users =

value() возвращает одно значение:
$email = DB::table('users')->where('name', 'John')->value('email'); pluck()
возвращает коллекцию -

Кроме того, возможно задавать, какие конкретно поля нужно выбирать:
$users = DB::table('users')->select('name',

В конструкторе также реализована поддержка как innerJoin:
$users = DB::table('users')
->join('contacts', 'users.id', '=',

А также «перемножения» таблиц:
$users = DB::table('sizes')->crossJoin('colours')->get(); Доступны и методы groupBy() и

orWhere('fieldName', 'value1')
whereBetween('fieldName', ['value1', 'value2'])
whereNotBetween('fieldName', ['value1', 'value2'])
whereIn('fieldName', ['value1', 'value2', ...])
whereNotIn('fieldName', ['value1', 'value2',

Сортировка методом orderBy():
$users = DB::table('users')->orderBy('sort');
$users = DB::table('users')->orderBy('sort', desc,);

КОНСТРУКТОР ЗАПРОСОВ В БД

Конструктор поддерживает построение запросов и для INSERT, UPDATE, DELETE.
DB::table('users')->insert(['email' => 'john@example.com',

Для того, чтобы посмотреть, какой запрос формирует конструктор запросов, есть метод

Результат выполнения запроса — коллекция. Коллекция — это объект, содержащий набор

Все данные в коллекции лежат в свойствах объектов.
$user = DB::table('users')->where('name', 'John')->first();
Свойство

count()
toArray()
toJson()
first()
last()
filter()
map() — проходит по всем элементам коллекции, выполняя действия с каждым
sort()

БАЗА ДАННЫХ: SEEDER

Первичные данные задаются через Seeder.
Seeder — это класс с

SEEDER: ЗАПУСК

php artisan db:seed

php artisan migrate --seed

php artisan db:seed --class=MySeeder

При этом,

Недостаток: нет информации, запускался ли Seeder.
Решение: Подключить seeder в миграцию (new

МОДЕЛИ

Модель – это класс, используемый для описания некоторой сущности.
Модель позволяет абстрагироваться

МОДЕЛИ ELOQUENT

Eloquent — красивая и простая реализация шаблона ActiveRecord в Laravel

МОДЕЛИ ELOQUENT: СОЗДАНИЕ

Создание модели:

php artisan make:model Name

Name — название модели в

МОДЕЛИ ELOQUENT: СОЗДАНИЕ

Создание модели в другой области видимости:

php artisan make:model Admin/User

Свойство

МОДЕЛИ ELOQUENT: СОЗДАНИЕ

use Illuminate\Database\Eloquent\Model; class Name extends Model
{
protected $table

МОДЕЛИ ELOQUENT: TIMESTAMPS

При работе с таблицей через модель, при создании записи

МОДЕЛИ ELOQUENT: TIMESTAMPS

Формат значения полей created_at & updated_at задается свойством $dateformat
Константы

МОДЕЛИ ELOQUENT: ПОЛУЧЕНИЕ ЗАПИСЕЙ

Для получения всех записей из таблицы, используется метод

МОДЕЛИ ELOQUENT: КОНСТРУКТОР ЗАПРОСОВ

Eloquent позволяет строить запросы через конструктор запросов:
$posts =

МОДЕЛИ ELOQUENT: АГРЕГИРУЮЩИЕ ФУНКЦИИ

$count = App\Post::where('active', 1)->count();
$min = App\Post::min('updated_at');
$min = App\Post::max('id');

МОДЕЛИ ELOQUENT: ПОЛУЧЕНИЕ ЗАПИСЕЙ

Получить вместо коллекции одну первую запись:
$post = App\Post::first();
Получение

МОДЕЛИ ELOQUENT: ПОЛУЧЕНИЕ ЗАПИСЕЙ

Получение нескольких записей по id (вернет коллекцию):
$post =

МОДЕЛИ ELOQUENT: ПОЛУЧЕНИЕ ЗАПИСЕЙ

Вызов 404 ошибки (Not Found Exceptions) при отсутствии

МОДЕЛИ ELOQUENT: ПОРЯДОК ЗАПИСЕЙ

Метод orderBy() работает с конструктором запросов.
$posts = Post::orderBy('sort')->get();

МОДЕЛИ ELOQUENT: ПОРЯДОК ЗАПИСЕЙ

Сортировка в обратном порядке в конструкторе запросов:
$posts =

МОДЕЛИ ELOQUENT: ДОСТУП К ЗНАЧЕНИЯМ

$posts = Post::all();
foreach ($posts as $post) {

МОДЕЛИ ELOQUENT: СОЗДАНИЕ ЗАПИСИ

Создание новой записи — метод save():
$post = new

МОДЕЛИ ELOQUENT: СОЗДАНИЕ ЗАПИСИ

При использовании метода create():
$post = App\Post::create([title' => 'Some

МОДЕЛИ ELOQUENT: ОБНОВЛЕНИЕ ЗАПИСИ

Для обновления записи нужно изменить свойства записи и

МОДЕЛИ ELOQUENT: ОБНОВЛЕНИЕ ЗАПИСИ

Использование метода update():
$post = App\Post::find($id)->update([title' => 'Some title']);
При

МОДЕЛИ ELOQUENT: УДАЛЕНИЕ ЗАПИСИ

Удаление записи модели Eloquent методом delete(): App\Post::find($id)->delete();
Метод destroy()

МОДЕЛИ ELOQUENT: SCOPE

Scope в Laravel («область запроса») — это некоторые условия

МОДЕЛИ ELOQUENT: LOCAL SCOPE

Local scope уже содержат в себе конкретные условия

МОДЕЛИ ELOQUENT: LOCAL SCOPE

Воспользоваться данным методом можно через:
$users = User::active()->where('age', '>=',

МОДЕЛИ ELOQUENT: DYNAMIC SCOPE

Если в scope нужно передать какой-то динамический параметр

МОДЕЛИ ELOQUENT: АКСЕССОРЫ (GETTER)

Аксессоры — возможность изменить значение поля при обращении

МОДЕЛИ ELOQUENT: МУТАТОРЫ (SETTER)

Мутатор — метод, который вызывается перед заданием конкретного

CARBON

Для работы с датой/временем в Laravel подключена библиотека Carbon.
По умолчанию поля

CARBON

Carbon позволяет создавать дату (экземпляр класса Carbon) из входных параметров:
$dtToronto =

Полный список методов API можно найти на странице документации: http://carbon.nesbot.com/docs/

CARBON

Для данной

BLADE: ПОДШАБЛОНЫ @include

@include('field', ['name' => 'Age', value=> $age])
первый параметр - blade-шаблон,

BLADE: ПОДШАБЛОНЫ @component

@component('components.footer', ['name' => 'Age', value=> $age])
...
@endcomponent
1й и 2й аргументы

BLADE: ПОДКЛЮЧЕНИЕ МАСТЕР ШАБЛОНА

Дочерний шаблон:
@extends('layout.master')
@section('title', 'Небольшую строку можно указать так') @section('content')
Это

BLADE: ПОДКЛЮЧЕНИЕ МАСТЕР ШАБЛОНА

Мастер шаблон:





@yield('content')


Для extends также можно передать 2м параметром

ОБРАБОТКА ЗАПРОСА

Illuminate\Http\Request
При работе с запросом подключаем класс 1м параметром.
Остальные параметры указываются

ОБРАБОТКА ЗАПРОСА: ПОЛУЧЕНИЕ URL

Получить часть запроса без параметров uri:
$uri = $request->path();
Получить

ОБРАБОТКА ЗАПРОСА: ПОЛУЧЕНИЕ МЕТОДА

Получение названия метода запроса:
$method = $request->method();
Проверка на соответствие

ОБРАБОТКА ЗАПРОСА: ПОЛУЧЕНИЕ ДАННЫХ

Для получения переменной из запроса есть метод input():
$name

ОБРАБОТКА ЗАПРОСА: ПОЛУЧЕНИЕ ДАННЫХ

Получение данных запроса, через свойства объекта:
$name = $request->name;

Использование

ОБРАБОТКА ЗАПРОСА: ПОЛУЧЕНИЕ ДАННЫХ

Получение всех данные из запроса с помощью метода

ОБРАБОТКА ЗАПРОСА: ПРОВЕРКА ДАННЫХ

Проверка существования переменной в запросе:
if ($request->has('name')) {
}
Возможно проверять

ОБРАБОТКА ЗАПРОСА: СОХРАНЕНИЕ ФАЙЛА

Проверка отправки файла в запросе:
request()->hasFile('image')

Получить путь к файлу

ОБРАБОТКА ЗАПРОСА: РАБОТА С ФАЙЛОМ

path() — получает путь сохраненного файла:
$request->file('image')->path();
extension() —

ОБРАБОТКА ЗАПРОСА: СОХРАНЕНИЕ ЗАГРУЖЕННОГО ФАЙЛА

Сохранение загруженного файла в директории.
$request->file('image')->store($destination, $disk);
$destination —

STORAGE: РАБОТА С ФАЙЛАМИ

Позволяет использовать несколько хранилищ (дисков/подключений):
локальное хранилище
FTP
сервис S3 (Amazon)
сервис

STORAGE: НАСТРОЙКА ПОДКЛЮЧЕНИЙ

config/filesystems.php
default — подключение по-умолчанию
disks (массив) — сами подключения.
По умолчанию

STORAGE: НАСТРОЙКА ПОДКЛЮЧЕНИЙ

driver (для работы с файловой системой используется драйвер local)
root

STORAGE: ОСНОВНЫЕ МЕТОДЫ

Чтобы воспользоваться методами Storage обязательно нужно указать его использование:
use

STORAGE: ОСНОВНЫЕ МЕТОДЫ

Получение файла:
$contents = Storage::get('file.jpg'); Формирование пути (url):
$url = Storage::url('file1.jpg');

STORAGE: ОСНОВНЫЕ МЕТОДЫ

Получение даты последнего изменения файла:
$time = Storage::lastModified('file1.jpg'); Записать информацию

STORAGE: ОСНОВНЫЕ МЕТОДЫ

Копирование файла:
Storage::copy('old/file1.jpg', 'new/file1.jpg'); Перемещение файла: Storage::move('old/file1.jpg', 'new/file1.jpg'); Удаление файла:
Storage::delete('file.jpg');

STORAGE: ОСНОВНЫЕ МЕТОДЫ

При использовании методов copy(), move() - стоит помнить, что

STORAGE: ОСНОВНЫЕ МЕТОДЫ

Создание и удаление директорий:
Storage::makeDirectory($directory); Storage::deleteDirectory($directory);

STORAGE: ГЕНЕРАЦИЯ URL

Формирование пути к файлу для веб-сервера — Storage::url()
Если хост

STORAGE: ГЕНЕРАЦИЯ URL

Кроме этого, Laravel для генерации url к файлам использует

ВАЛИДАЦИЯ В LARAVEL

В фреймворке имеются встроенные средства для валидации запроса.
При отправке

Валидация в Laravel

Есть 2 варианта, как можно добавить валидацию в методе

ВАЛИДАЦИЯ В LARAVEL ВНУТРИ МЕТОДА

Валидация внутри метода контроллера:
public function store(Request $request)
{
$this->validate($request,

ВАЛИДАЦИЯ В LARAVEL: ОБЪЕКТ REQUEST

Для вынесения валидации в отдельный объект, нужно

ВАЛИДАЦИЯ В LARAVEL: ОБЪЕКТ REQUEST

файл запроса будет создан в папке app/Http/Requests
2

ВАЛИДАЦИЯ В LARAVEL: ПРАВИЛА ВАЛИДАЦИИ

Правила валидации указываются внутри массива, где ключом

ВАЛИДАЦИЯ В LARAVEL: ПРАВИЛА ВАЛИДАЦИИ

between:max,min — значение между min и max
boolean

ВАЛИДАЦИЯ В LARAVEL: ПРАВИЛА ВАЛИДАЦИИ

max:value — не более value символов
min:value —

ВАЛИДАЦИЯ В LARAVEL: СООБЩЕНИЯ

Переопределение сообщений об ошибке:
При валидации методом validate() внутри

ВАЛИДАЦИЯ В LARAVEL: СООБЩЕНИЯ

Сообщения об ошибках валидации указываются по схеме:
ключ —

ВАЛИДАЦИЯ В LARAVEL: СООБЩЕНИЯ

В сообщении можно использовать
:attribute — имя поля
параметры из

ВАЛИДАЦИЯ В LARAVEL: СООБЩЕНИЯ

При этом, можно для каждого поля указать свои

ВАЛИДАЦИЯ В LARAVEL: ОТОБРАЖЕНИЕ

В представлении, если были получены ошибки валидации, появится

ФОРМЫ И ЗАПОЛНЕННЫЕ ПОЛЯ И ХЕЛПЕР OLD

Данные из запроса можно получить

MIDDLEWARE

Middleware или «Посредники» — представляют из себя удобный механизм фильтрации запросов.
Кроме

MIDDLEWARE: ВСТРОЕННЫЕ

Middleware, проверяющий CSRF-токен в запросе:
\App\Http\Middleware\VerifyCsrfToken Middleware убирающий лишние пробелы (trim):
\Illuminate\Foundation\Http\Middleware\TrimStrings
Middleware,

MIDDLEWARE: СОЗДАНИЕ

Создание Middlewaren:

php artisan make:middleware MyMiddleware

Создаст файл app/Http/Middleware/MyMiddleware.php с классом MyMiddleware
В

MIDDLEWARE: СОЗДАНИЕ

В методе handle() обрабатывается запрос.
После выполнения действий внутри middleware, будет

MIDDLEWARE: КАК ПОДКЛЮЧИТЬ К МАРШРУТУ

Для подключения middleware к маршруту в Laravel

MIDDLEWARE: КАК ПОДКЛЮЧИТЬ

Зарегистрировать для группы маршрутов:
В файле app\Http\Kernel.php указать в свойстве

MIDDLEWARE: РЕГИСТРАЦИЯ

Для регистрации алиаса middleware — его следует зарегистрировать в файле

ROUTE: ИМЕНОВАННЫЕ МАРШРУТЫ

Каждый маршрут может иметь своё имя. Задается оно следующим

ROUTE: ИМЕНОВАННЫЕ МАРШРУТЫ

Зачем нужны именованные маршруты?
Чтобы нигде жестко не привязывать никакие

ROUTE: ФОРМИРОВАНИЕ ССЫЛОК

Формируются ссылки по маршрутам хелпером route():
1-м аргументом передается имя

ROUTE: ФОРМИРОВАНИЕ ССЫЛОК

Если параметров несколько, они должны быть переданы в том

ROUTE: СПИСОК МАРШРУТОВ

Вывод списка маршрутов в консоли:

php artisan route:list

ROUTE: РЕДИРЕКТ ПО МАРШРУТУ

Кроме формирования ссылок, маршруты можно использовать и при

ROUTE: ПРОВЕРКА МАРШРУТА

Проверка маршрута по имени:
public function handle($request, Closure $next)
{
if ($request->route()->named('profile'))

ROUTE: ГРУППИРОВКА ЗАПРОСОВ

Указание группе маршрутов посредника (Middleware): Route::middleware(['auth'])->group(function() {
Route::get('admin', 'Controller@index'); Route::get('dashboard',

ROUTE: ГРУППИРОВКА ЗАПРОСОВ

Указание Namespace для группы маршрутов: Route::namespace('Auth')->group(function() {
Route::get('admin', 'Controller@index'); Route::get('dashboard',

ROUTE: ГРУППИРОВКА ЗАПРОСОВ

Методы, позволяющие работать и с именами маршрутов (name()), и

ROUTE: ГРУППИРОВКА ЗАПРОСОВ

Методы группировки можно вкладывать друг в друга: Route::prefix('panel')->group(function() {
Route::name('panel.')->group(function()

ROUTE: ГРУППИРОВКА ЗАПРОСОВ

Метод group() позволяет указать сразу несколько условий: Route::group([
'namespace' =>

ROUTE: ПОЛУЧЕНИЕ ИНФОРМАЦИИ

Также доступ к объекту маршрута можно получить через:
$route =

ROUTESERVICEPROVIDER

Вся организация работы роутера видна в данном провайдере:
Метод map() описывает маршруты
Методы