Обновление до 5.3.0 с 5.2
Примерное время обновления — 2-3 часа
Мы стараемся предоставить полный список всех потенциально опасных изменений фреймворка. Но многие из них могут никак не повлиять на ваше приложение.
Обновление зависимостей
Обновите ваши laravel/framework зависимости в файле composer.json до 5.3.*.
А также в том же файле обновите зависимости symfony/css-selector и symfony/dom-crawler в секции require-dev до 3.1.*.
PHP и HHVM
Laravel 5.3 требует PHP 5.6.4 или выше. HHVM теперь официально не поддерживается, поскольку в ней нет тех языковых возможностей, которые есть в PHP 5.6+.
Рудименты
Из фреймворка были удалены все зависимости, перечисленные в разделе обновления до Laravel 5.2. Вам надо просмотреть этот список и убедиться, что вы больше не используете эти устаревшие возможности.
Сервис-провайдеры приложения
Вы можете удалить аргументы из метода PHPboot()
в классах EventServiceProvider, RouteServiceProvider и AuthServiceProvider. Вместо всех обращений к этим аргументам можно использовать эквивалентный фасад. Например, вместо обращений метода к аргументу PHP$dispatcher
вы можете просто вызвать фасад Event. А также вместо обращений метода к аргументу PHP$router
вы можете вызвать фасад Route, а вместо обращений метода к аргументу PHP$gate
вы можете вызвать фасад Gate.
При изменении обращений метода на вызов фасадов не забудьте импортировать класс фасада в свой сервис-провайдер.
Массивы
Изменение порядка Ключ/Значение
Методы PHPfirst()
, PHPlast()
и PHPwhere()
класса Arr теперь передают «value» первым параметром передаваемого замыкания обратного вызова. Например:
Arr::first($array, function ($value, $key) {
return ! is_null($value);
});
В предыдущих версиях Laravel первым передавался PHP$key
. А поскольку в большинстве случаев нужно только PHP$value
, теперь оно передаётся первым. Вам надо сделать «глобальный поиск» этих методов в своём приложении, чтобы убедиться в том, что вы ожидаете PHP$value
первым аргументом своего замыкания.
Artisan
Команда shmake:console
переименована в shmake:command
.
Аутентификация
Подготовка заготовок для аутентификации
Два стандартных встроенных в фреймворк контроллера аутентификации были разделены на четыре небольших контроллера. Это изменение даёт нам более простые и более узконаправленные стандартные контроллеры. Самый простой способ обновить контроллеры аутентификации в вашем приложении — скачать свежие копии каждого контроллера с GitHub и скопировать их в приложение.
Также вам надо убедиться, что вы вызываете метод PHPAuth::routes()
в своём файле routes/web.php. Этот метод зарегистрирует правильные маршруты для новых контроллеров аутентификации.
После размещения контроллеров в приложении вам возможно потребуется заново реализовать все изменения, которые вы делали в этих контроллерах. Например, если вы изменяли защитника аутентификации, вам может потребоваться переопределить метод контроллера PHPguard()
. Вы можете проверить каждый типаж контроллера аутентификации, чтобы определить, какие методы надо переопределить.
Если вы не изменяли контроллеры аутентификации, вам будет достаточно скопировать новые контроллеры с GitHub и проверить, что вы вызываете метод PHPAuth::routes()
в своём файле routes/web.php.
Письма для сброса пароля теперь используют новую функцию уведомлений Laravel. Если вы хотите изменить отправку уведомлений со ссылками для смены пароля, вам надо переопределить метод PHPsendPasswordResetNotification()
типажа Illuminate\Auth\Passwords\CanResetPassword.
Ваша модель User должна использовать новый типаж Illuminate\Notifications\Notifiable, чтобы письма со ссылками для сброса пароля могли быть доставлены:
<?php
namespace App;
use Illuminate\Notifications\Notifiable;
use Illuminate\Foundation\Auth\User as Authenticatable;
class User extends Authenticatable
{
use Notifiable;
}
Не забудьте зарегистрировать Illuminate\Notifications\NotificationServiceProvider в массиве PHPproviders
в файле настроек config/app.php.
Метод PHPAuth::routes()
теперь регистрирует маршрут POST для /logout вместо маршрута GET. Это препятствует другим веб-приложениям осуществлять «выход» пользователей из вашего приложения. Для обновления вы должны либо конвертировать ваши запросы «выхода», чтобы использовать в них HTTP-метод POST, либо зарегистрировать ваш собственный GET маршрут для URI /logout:
Route::get('/logout', 'Auth\LoginController@logout');
Авторизация
Вызов методов политик с именами классов
Некоторые методы политик получают только текущего аутентифицированного пользователя, но не экземпляр модели, которую они авторизуют. Эта ситуация наиболее распространена при авторизации действий create. Например, при создании блога вам понадобиться проверять, что пользователь авторизован для создания статьи.
При определении методов политик, которые не будут получать экземпляр модели, таких как метод PHPcreate()
, имя класса больше не будет передаваться в метод вторым аргументом. Ваш метод должен ожидать только экземпляр аутентифицированного пользователя:
/**
* Определение, может ли данный пользователь создавать статьи.
*
* @param \App\User $user
* @return bool
*/
public function create(User $user)
{
//
}
Типаж AuthorizesResources теперь объединён с типажом AuthorizesRequests. Вам надо удалить типаж AuthorizesResources из файла app/Http/Controllers/Controller.php.
Blade
В предыдущих версиях Laravel при регистрации пользовательских директив Blade с помощью метода PHPdirective()
передаваемое в обратный вызов вашей директивы $expression содержало внешнюю скобку. В Laravel 5.3 эта внешняя скобка не включена в передаваемое в обратный вызов вашей директивы выражение. Загляните в документацию по наследованию Blade и проверьте, что ваши собственные директивы Blade по-прежнему работают правильно.
Вещание
Laravel 5.3 содержит значительные улучшения вещания событий. Вам надо добавить новый BroadcastServiceProvider в вашу папку app/Providers получив свежую копию из источника на GitHub. После определения нового сервис-провайдера вы должны добавить его в массив providers в файле настроек config/app.php.
Кэш
Привязка наследующего замыкания и PHP$this
При вызове метода PHPCache::extend()
с замыканием PHP$this
будет привязан к экземпляру CacheManager, позволяя вам вызвать его методы в вашем наследующем замыкании:
Cache::extend('memcached', function ($app, $config) {
try {
return $this->createMemcachedDriver($config);
} catch (Exception $e) {
return $this->createNullDriver($config);
}
});
Cashier
Если вы используете Cashier, вам надо обновить ваш пакет laravel/cashier до версии ~7.0. В этой версии Cashier обновлены только несколько внутренних методов для совместимости с Laravel 5.3, поэтому сохранена обратная совместимость.
Коллекции
Изменения порядка Ключ/Значение
Методы коллекций PHPfirst()
, PHPlast()
и PHPcontains()
передают «value» первым параметром передаваемого замыкания обратного вызова. Например:
$collection->first(function ($value, $key) {
return ! is_null($value);
});
В предыдущих версиях Laravel первым передавался PHP$key
. А поскольку в большинстве случаев нужно только PHP$value
, теперь оно передаётся первым. Вам надо сделать «глобальный поиск» этих методов в своём приложении, чтобы убедиться в том, что вы ожидаете PHP$value
первым аргументом своего замыкания.
Методы сравнения коллекций PHPwhere()
по умолчанию «нестрогие»
Теперь метод коллекций PHPwhere()
по умолчанию выполняет «нестрогое» сравнение вместо строгого. Если вы хотите сделать строгое сравнение, используйте метод PHPwhereStrict()
.
Также метод PHPwhere()
теперь не принимает третий аргумент для обозначения «строгости». Вы должны явно вызывать либо PHPwhere()
, либо PHPwhereStrict()
, в зависимости от того, какое сравнение вам нужно.
Настройка
Добавьте в файл настроек config/app.php следующую опцию:
conf'name' => 'Your Application Name',
Контроллеры
В предыдущих версиях Laravel вы могли обращаться к переменным сессии или к аутентифицированному пользователю в конструкторе вашего контроллера. Но это никогда не считалось явной особенностью фреймворка. В Laravel 5.3 вы не можете обращаться к переменным сессии или к аутентифицированному пользователю в конструкторе вашего контроллера, поскольку ещё не запущен посредник.
В качестве альтернативы вы можете определить посредника на основе замыкания прямо в конструкторе вашего контроллера. Перед использованием этой возможности убедитесь, что ваше приложение использует Laravel 5.3.4 или выше:
<?php
namespace App\Http\Controllers;
use App\User;
use Illuminate\Support\Facades\Auth;
use App\Http\Controllers\Controller;
class ProjectController extends Controller
{
/**
* Все проекты текущего пользователя.
*/
protected $projects;
/**
* Создание нового экземпляра контроллера.
*
* @return void
*/
public function __construct()
{
$this->middleware(function ($request, $next) {
$this->projects = Auth::user()->projects;
return $next($request);
});
}
}
Разумеется, вы также можете обращаться к данным сессии запроса или к аутентифицированному пользователю указывая тип класса Illuminate\Http\Request для действия вашего контроллера:
/**
* Show all of the projects for the current user.
*
* @param \Illuminate\Http\Request $request
* @return Response
*/
public function index(Request $request)
{
$projects = $request->user()->projects;
$value = $request->session()->get('key');
//
}
База данных
Теперь конструктор запросов возвращает экземпляры Illuminate\Support\Collection вместо простых массивов, благодаря чему стали согласованы типы результатов, возвращаемых конструктором запросов и Eloquent.
Если вы не хотите мигрировать результаты конструктора запросов в экземпляры Collection, вы можете прицепить метод PHPall()
к вашим вызовам методов конструктора запросов PHPget()
и PHPpluck()
. Тогда результатом будет простой PHP-массив, что позволит вам сохранить обратную совместимость:
$users = DB::table('users')->get()->all();
$usersIds = DB::table('users')->pluck('id')->all();
Метод Eloquent PHPgetRelation()
Метод Eloquent PHPgetRelation()
больше не выбрасывает BadMethodCallException, если отношение не может быть загружено. Вместо этого он выбросит Illuminate\Database\Eloquent\RelationNotFoundException. Это измненение затронет ваше приложение, только если вы ловили BadMethodCallException вручную.
Свойство Eloquent PHP$morphClass
Свойство PHP$morphClass
, которое можно было определять на моделях Eloquent, теперь удалено в пользу определения «морфинговой карты». Определение морфинговой карты обеспечивает поддержку активной загрузки и решает дополнительные проблемы с полиморфными отношениями. Если раньше вы использовали свойство PHP$morphClass
, то вам надо мигрировать на PHPmorphMap
с помощью следующего синтаксиса:
Relation::morphMap([
'YourCustomMorphName' => YourModel::class,
]);
Например, если раньше вы определили такой PHP$morphClass
:
class User extends Model
{
protected $morphClass = 'user'
}
Вам надо определить такую PHPmorphMap
в методе PHPboot()
вашего AppServiceProvider:
use Illuminate\Database\Eloquent\Relations\Relation;
Relation::morphMap([
'user' => User::class,
]);
Теперь заготовки Eloquent чувствительны к логике, стоящей в начале ограничения. Например, если вы начали свою заготовку с ограничения PHPorWhere
, теперь оно не будет конвертировано в обычное PHPwhere
. Если вы использовали эту возможность (например, добавляли несколько ограничений PHPorWhere
в цикле), то вам надо проверить, что первое условие — обычное PHPwhere
, чтобы избежать возможных проблем с логикой.
Если ваша заготовка начинается с ограничений PHPwhere
, то делать ничего не надо. Помните, вы можете проверить SQL-код своего запроса, с помощью метода PHPtoSql()
на запросе:
User::where('foo', 'bar')->toSql();
Класс JoinClause был переписан для унификации его синтаксиса с конструкотором запросов. Необязательный параметр PHP$where
оператора PHPon
был удалён. Для добавления условий «where» вам надо явно использовать один из методов PHPwhere
, предлагаемых конструктором запросов:
$query->join('table', function ($join) {
$join->on('foo', 'bar')->where('bar', 'baz');
});
Оператор PHPon
теперь проверяется и больше не может содержать некорректных значений. Если вы использовали эту возможность (например, PHP$join->on('foo', 'in', DB::raw('("bar")'))
), вам надо переписать условие, используя подходящий оператор PHPwhere
:
$join->whereIn('foo', ['bar']);
Также удалено свойство PHP$bindings
. Вы можете использовать метод PHPaddBinding()
, чтобы напрямую управлять привязками PHPjoin
:
$query->join(DB::raw('('.$subquery->toSql().') table'), function ($join) use ($subquery) {
$join->addBinding($subquery->getBindings(), 'join');
});
Шифрование
Шифратор Mcrypt считается устаревшим ещё с версии Laravel 5.1.0, вышедшей в июне 2015 года. Этот шифратор полностью удалён в версии 5.3.0, вместо него используется новая реализация шифрования на базе OpenSSL, которая используется по умолчанию во всех версиях, начиная с Laravel 5.1.0.
Если вы по-прежнему используете cipher (шифр) на базе Mcrypt в своём файле config/app.php, вам надо обновить шифр на AES-256-CBC и задать ваш ключ — строку из 32 случайных байтов, которую можно безопасно сгенерировать с помощью команды shphp artisan key:generate
.
Если вы храните шифрованные данные в своей базе данных с помощью шифратора Mcrypt, вы можете установить пакет laravel/legacy-encrypter, который содержит реализацию устаревшего шифратора Mcrypt. Вам надо использовать этот пакет, чтобы дешифровать ваши зашифрованные данные, и перешифровать их с помощью нового шифратора OpenSSL. Например, вы можете сделать что-то подобное в собственной Artisan-команде:
$legacy = new McryptEncrypter($encryptionKey);
foreach ($records as $record) {
$record->encrypted = encrypt(
$legacy->decrypt($record->encrypted)
);
$record->save();
}
Обработчик исключений
Базовый класс обработчика исключений теперь требует передачи в его конструктор экземпляра Illuminate\Container\Container. Это изменение затронет ваше приложение, только если вы определили свой метод PHP__construct()
в файле app/Exceptions/Handler.php. Если вы это сделали, вам надо передать экземпляр контейнера в метод PHPparent::__construct()
:
parent::__construct(app());
Вам надо добавить метод PHPunauthenticated()
в свой класс App\Exceptions\Handler. Этот метод будет конвертировать исключения аутентификации в HTTP-ответы:
/**
* Конвертирование исключения аутентификации в неаутентифицированный ответ.
*
* @param \Illuminate\Http\Request $request
* @param \Illuminate\Auth\AuthenticationException $exception
* @return \Illuminate\Http\Response
*/
protected function unauthenticated($request, AuthenticationException $exception)
{
if ($request->expectsJson()) {
return response()->json(['error' => 'Unauthenticated.'], 401);
}
return redirect()->guest('login');
}
Посредники
Изменение пространства имён посредника can
Надо обновить посредник can, указанный в свойстве PHP$routeMiddleware
вашего HTTP-ядра, на следующий класс:
'can' => \Illuminate\Auth\Middleware\Authorize::class,
Исключение аутентификации посредника can
Теперь посредник can будет выбрасывать экземпляр Illuminate\Auth\AuthenticationException, если пользователь не аутентифицирован. Если вы вручную ловили другой тип исключения, вам надо изменить приложение, чтобы ловить это исключение. В большинстве случаев это изменение не затронет ваше приложение.
Привязка модели маршрута теперь осуществляется с помощью посредника. Все приложения должны добавить Illuminate\Routing\Middleware\SubstituteBindings в группу посредников web в вашем файле app/Http/Kernel.php:
\Illuminate\Routing\Middleware\SubstituteBindings::class,
Также вам надо зарегистрировать посредника маршрута для привязки замены в свойстве PHP$routeMiddleware
вашего HTTP-ядра:
'bindings' => \Illuminate\Routing\Middleware\SubstituteBindings::class,
После регистрации этого посредника маршрута вам надо добавить его в группу посредников api:
'api' => [
'throttle:60,1',
'bindings',
],
Уведомления
Laravel 5.3 содержит новую систему уведомлений на основе драйверов. Вам надо зарегистрировать Illuminate\Notifications\NotificationServiceProvider в массиве providers в файле настроек config/app.php.
Также вам надо добавить фасад Illuminate\Support\Facades\Notification в массив aliases в файле настроек config/app.php.
И наконец, вы можете использовать типаж Illuminate\Notifications\Notifiable на модели User или на любой другой модели, где вы хотите получать уведомления.
Страничный вывод
В Laravel 5.3 намного проще по сравнению с предыдущими версиями Laravel 5.x изменять генерируемый для страничного вывода HTML. Вместо определения класса «Presenter», вам надо только определить простой шаблон Blade. Самый простой способ изменить представления страничного вывода — экспортировать их в вашу папку resources/views/vendor командой shvendor:publish
:
php artisan vendor:publish --tag=laravel-pagination
Эта команда поместит представления в папку resources/views/vendor/pagination. В этой папке находится файл default.blade.php, соответствует стандартному представлению страничного вывода. Просто отредактируйте этот файл, чтобы изменить HTML страничного вывода.
Не забудьте ознакомиться с полной документацией по страничному выводу.
Очереди
В настройке ваших очередей все элементы expire должны быть переименованы в retry_after. А также в настройке Beanstalk элемент ttr должен быть переименован в retry_after. Это изменение имён даёт более ясное представление о назначении этих опций.
Больше не поддерживается очередь замыканий. Если вы в своём приложении ставите в очередь замыкания, вам надо конвертировать замыкание в класс и ставить в очередь экземпляр класса:
dispatch(new ProcessPodcast($podcast));
Типаж Illuminate\Queue\SerializesModels теперь правильно сериализует экземпляры Illuminate\Database\Eloquent\Collection. Это, скорее всего, не станет серьёзным изменением для подавляющего большинства приложений, но если ваше приложение полностью зависит от того, что коллекции не будут повторно извлекаться из базы данных задачами из очереди, вам надо убедиться, что это изменение не навредит вашему приложению.
Больше нет необходимости указывать опцию sh--daemon
при вызове Artisan-команды shqueue:work
. Запуск команды shphp artisan queue:work
автоматически приведёт к запуску обработчика в режиме демона. Если вы хотите обработать одну задачу, вы можете использовать опцию sh--once
для этой команды:
// Запуск обработчика очереди в режиме демона...
php artisan queue:work
// Обработка одной задачи...
php artisan queue:work --once
Если вы используете драйвер database для хранения ваших задач в очереди, вам надо удалить из таблицы jobs индекс jobs_queue_reserved_reserved_at_index, а затем удалить столбец reserved. Этот столбец больше не требуется при использовании драйвера database. Когда вы завершите эти изменения, вам надо добавить новый составной индекс для столбцов queue и reserved_at.
Ниже приведён пример миграции, которую вы можете использовать для выполнения необходимых изменений:
public function up()
{
Schema::table('jobs', function (Blueprint $table) {
$table->dropIndex('jobs_queue_reserved_reserved_at_index');
$table->dropColumn('reserved');
$table->index(['queue', 'reserved_at']);
});
Schema::table('failed_jobs', function (Blueprint $table) {
$table->longText('exception')->after('payload');
});
}
public function down()
{
Schema::table('jobs', function (Blueprint $table) {
$table->tinyInteger('reserved')->unsigned();
$table->index(['queue', 'reserved', 'reserved_at']);
$table->dropIndex('jobs_queue_reserved_at_index');
});
Schema::table('failed_jobs', function (Blueprint $table) {
$table->dropColumn('exception');
});
}
Различные события задач в очереди, такие как JobProcessing и JobProcessed, больше не содержат свойства PHP$data
. Вам надо изменить своё приложение, чтобы вызывать PHP$event->job->payload()
для получения эквивалентных данных.
Если вы вызываете метод PHPQueue::failing()
в вашем AppServiceProvider, вам надо изменить описание метода на следующее:
use Illuminate\Queue\Events\JobFailed;
Queue::failing(function (JobFailed $event) {
// $event->connectionName
// $event->job
// $event->exception
});
Расширение для контроля процессов
Если ваше приложение использует параметр sh--timeout
для обработчиков очереди, вам надо убедиться, что установлено расширение pcntl.
Сериализация моделей для задач в очереди, использующих устаревший стиль
Обычно задачи в Laravel ставятся в очередь с помощью передачи нового экземпляра задачи в метод PHPQueue::push()
. Но некоторые приложения могут ставить задачи в очередь с помощью такого устаревшего синтаксиса:
Queue::push('ClassName@method');
Если вы ставите задачи в очередь с помощью этого синтаксиса, то модели Eloquent теперь не будут автоматически сериализованы и заново получены очередью. Если вы хотите, чтобы очередь могла автоматически сериализовать ваши Eloquent модели, вам надо использовать типаж Illuminate\Queue\SerializesModels на классе вашей задачи и ставить задачи в очередь с помощью нового синтаксиса PHPpush
:
Queue::push(new ClassName);
Маршрутизация
Параметры-ресурсы в единственном числе по умолчанию
В предыдущих версиях Laravel параметры маршрута, регистрируемые с помощью PHPRoute::resource
, не переводились в единственное число. Это могло привести к неожиданному поведению при регистрации привязок модели маршрута. Например, возьмём такой вызов PHPRoute::resource
:
Route::resource('photos', 'PhotoController');
Для маршрута show будет определён следующий URI:
/photos/{photos}
В Laravel 5.3 все параметры-ресурсы маршрутов по умолчанию приводятся к единственному числу. Поэтому такой же вызов PHPRoute::resource
зарегистрирует следующий URI:
/photos/{photo}
Если вам нужна старая логика вместо автоматического приведения к единственному числу, вы можете сделать следующий вызов метода PHPsingularResourceParameters()
в вашем AppServiceProvider:
use Illuminate\Support\Facades\Route;
Route::singularResourceParameters(false);
Имена ресурсов маршрута больше не дополняются префиксами
Префиксы URL больше не влияют на имена маршрутов, назначенные на маршруты с помощью PHPRoute::resource
, поскольку такое поведение противоречит самой цели использования имён маршрутов на первом месте.
Если в вашем приложении используется PHPRoute::resource
в вызове PHPRoute::group
с указанием опции prefix, вам необходимо проверить все ваши вызовы вспомогательной функции PHProute()
и PHPUrlGenerator::route
, чтобы убедиться, что вы не добавляете префикс URI в имя маршрута.
Если это изменение привело к тому, что у вас теперь есть два маршрута с одним именем, то у вас есть два варианта. Первый — вы можете использовать опцию names при вызове PHPRoute::resource
, чтобы указать нужное вам имя для данного маршрута. Подробнее читайте в документации по маршрутизации ресурсов. Второй — вы можете добавить опцию as в вашу группу маршрутов:
Route::group(['as' => 'admin.', 'prefix' => 'admin'], function () {
//
});
Проверка ввода
Если проверка ввода запроса формы закончилась ошибкой, то теперь Laravel выбросит экземпляр Illuminate\Validation\ValidationException вместо экземпляра HttpException. Если вы отлавливали выброшенный запросом формы экземпляр HttpException вручную, вам надо изменить ваши блоки PHPcatch
, чтобы ловить ValidationException.
Если раньше вы использовали метод PHPhas()
для определения наличия сообщений в экземпляре Illuminate\Support\MessageBag, то теперь вам надо использовать метод PHPcount()
. Метод PHPhas()
теперь требует указание параметра и определяет только то, есть ли конкретный ключ в корзине сообщений.
Примитивы с разрешённым значением Null
Теперь при проверке ввода массивов, логических типов, целых и вещественных чисел и строк значение PHPnull
не считается корректным, если в наборе правил нет правила nullable:
Validate::make($request->all(), [
'field' => 'nullable|max:5',
]);
Обновление до 5.2.0 с 5.1
Примерное время обновления — меньше 1 часа
Мы стараемся предоставить полный список всех потенциально опасных изменений фреймворка. Но многие из них могут никак не повлиять на ваше приложение.
Обновление зависимостей
Обновите свой файл composer.json до laravel/framework 5.2.*.
Добавьте в раздел require-dev этого файла "symfony/dom-crawler": "~3.0" и "symfony/css-selector": "~3.0".
Аутентификация
Вам надо заменить свой файл настроек config/auth.php на этот: [https://github.com].
После замены файла на новый задайте необходимые настройки аутентификации на основе их значений из старого файла. Если вы будете использовать обычные сервисы аутентификации на основе Eloquent, которые были доступны в Laravel 5.1, то большинство значений должны остаться без изменений.
Обратите особое внимание на параметр passwords.users.email в новом файле настроек auth.php и проверьте, что путь к представлению совпадает с реальным расположением представления в вашем приложении, так как в Laravel 5.2 путь по умолчанию к этому представлению изменился. И если они не совпадают, то измените параметр конфигурации.
Если вы реализуете контракт Illuminate\Contracts\Auth\Authenticatable, но не используете типаж PHPAuthenticatable
, то вам надо добавить новый метод PHPgetAuthIdentifierName()
в вашу реализацию контракта. Обычно этот метод будет возвращать имя столбца «первичного ключа» вашей аутентифицируемой сущности. Например, id.
Это вряд ли повлияет на ваше приложение, если вы не реализовали этот интерфейс вручную.
Если вы используете метод PHPAuth::extend()
для определения своего собственного метода получения пользователей, то теперь вам надо использовать PHPAuth::provider()
для определения своего собственного провайдера для пользователей. После определения своего провайдера вы можете настроить его в массиве providers в своём новом файле auth.php.
Подробнее о пользовательских провайдерах аутентификации читайте в полной документации.
Метод PHPloginPath()
удалён из Illuminate\Foundation\Auth\AuthenticatesUsers, поэтому больше не надо добавлять переменную PHP$loginPath
в PHPAuthController
. По умолчанию при ошибках аутентификации типаж всегда будет переадресовывать пользователя обратно в его предыдущее расположение.
Illuminate\Auth\Access\UnauthorizedException переименован в Illuminate\Auth\Access\AuthorizationException. Это не повлияет на ваше приложение, если вы не отлавливаете это исключение вручную.
Коллекции
Экземпляр коллекции Eloquent теперь возвращает базовую коллекцию (Illuminate\Support\Collection) для следующих методов: PHPpluck()
, PHPkeys()
, PHPzip()
, PHPcollapse()
, PHPflatten()
, PHPflip()
.
Методы PHPslice()
, PHPchunk()
и PHPreverse()
теперь сохраняют ключи коллекции. Если вы не хотите, чтобы эти методы сохраняли ключи, используйте метод PHPvalues()
на экземпляре PHPCollection
.
Класс Composer
Класс Illuminate\Foundation\Composer перемещён в Illuminate\Support\Composer. Это не повлияет на ваше приложение, если вы не использовали этот класс вручную.
Команды и обработчики
Вам больше не надо реализовывать контракт PHPSelfHandling
в ваших задачах / командах. Теперь все задачи по умолчанию самообрабатываемые, поэтому вы можете удалить этот интерфейс из своих классов.
Отдельные команды и обработчики
Командная шина Laravel 5.2 теперь поддерживает только самообрабатываемые команды, и больше не поддерживает отдельные команды и обработчики.
Если вы хотите продолжать использовать отдельные команды и обработчики, вы можете установить пакет Laravel Collective, который обеспечивает обратную совместимость: [https://github.com].
Конфигурация
Добавьте параметр env в файл настроек app.php, он выглядит вот так:
'env' => env('APP_ENV', 'production'),
Если вы используете команду shconfig:cache
во время развёртывания, то вы должны убедиться, что вызываете функцию PHPenv
только из файлов настроек, и не вызываете где-либо ещё в вашем приложении.
Если вы вызываете PHPenv
из приложения, то крайне рекомендуется вместо этого добавить нужные значения в файлы настроек и вызывать PHPenv
именно оттуда, что позволит вам конвертировать вызовы PHPenv
в вызовы PHPconfig
.
Если в файле (t)config/compile.phpPHPв массиве
(t)files%% есть эти строки, то удалите их:
realpath(__DIR__.'/../app/Providers/BusServiceProvider.php'),
realpath(__DIR__.'/../app/Providers/ConfigServiceProvider.php'),
Если этого не сделать, то может возникнуть ошибка при запуске shphp artisan optimize
, если указанные сервис-провайдеры не существуют.
CSRF проверка
Теперь CSRF проверка не выполняется автоматически при запуске юнит-тестов. Это не повлияет на ваше приложение.
База данных
Начиная с MySQL 5.7, PHP0000-00-00 00:00:00
больше не считается корректной датой, поскольку «строгий» режим включён по умолчанию. Все столбцы, хранящие отметки времени, должны получать корректное значение по умолчанию, когда вы вставляете записи в базу данных. Вы можете использовать метод PHPuseCurrent()
в своих миграциях, чтобы задать текущее время в качестве значения по умолчанию для этих столбцов, или вы можете сделать их PHPnullable
, чтобы разрешить значение PHPnull
:
$table->timestamp('foo')->nullable();
$table->timestamp('foo')->useCurrent();
$table->nullableTimestamps();
Теперь тип столбца json создаёт настоящие JSON-столбцы при использовании драйвера MySQL. Если вы используете MySQL ниже версии 5.7, то этот тип будет недоступен для вас. Вместо этого используйте в своих миграциях тип text.
Теперь при выполнении загрузки начальных данных в БД все модели Eloquent по умолчанию незащищённые. Раньше был необходим вызов PHPModel::unguard()
. Вы можете вызвать PHPModel::reguard()
в начале своего класса PHPDatabaseSeeder
, если вы хотите, чтобы модели были защищены во время загрузки начальных данных.
Eloquent
Теперь любые атрибуты, добавленные в свойство PHP$casts
, такие как PHPdate
или PHPdatetime
, будут конвертироваться в строку при вызове PHPtoArray()
на модели или коллекции моделей. Это делает преобразование при приведении типа дат согласованным с датами, указанными в вашем массиве PHP$dates
.
Реализация глобальных заготовок была переписана с целью упрощения их использования. Теперь вашим глобальным заготовкам не нужен метод PHPremove()
, его можно удалить из всех написанных вами глобальных заготовок.
Если вы вызывали PHPgetQuery()
на конструкторе запросов Eloquent для обращения к нижележащему экземпляру конструктора запросов, теперь вам надо вызывать PHPtoBase()
.
Если вы по какой-то причине вызывали метод PHPremove()
, вам надо заменить этот вызов на PHP$eloquentBuilder->withoutGlobalScope($scope)
.
В конструктор запросов Eloquent были добавлены новые методы PHPwithoutGlobalScope()
и PHPwithoutGlobalScopes()
. Все вызовы PHP$model->removeGlobalScopes($builder)
можно заменить на простое PHP$builder->withoutGlobalScopes()
.
По умолчанию Eloquent считает ваши первичные ключи числовыми (integer) и автоматически приводит их числовому типу. Для всех не числовых первичных ключей вы должны изменить значение свойства PHP$incrementing
модели Eloquent на PHPfalse
:
/**
* Указывает, являются ли ID автоинкрементными.
*
* @var bool
*/
public $incrementing = true;
События
Теперь некоторые события ядра, вызываемые Laravel, используют объекты событий вместо строковых имён событий и динамических параметров. Ниже приведён список старых имён событий и соответствующих им новых событий на основе объектов:
Старое | Новое |
---|---|
artisan.start | Illuminate\Console\Events\ArtisanStarting |
auth.attempting | Illuminate\Auth\Events\Attempting |
auth.login | Illuminate\Auth\Events\Login |
auth.logout | Illuminate\Auth\Events\Logout |
cache.missed | Illuminate\Cache\Events\CacheMissed |
cache.hit | Illuminate\Cache\Events\CacheHit |
cache.write | Illuminate\Cache\Events\KeyWritten |
cache.delete | Illuminate\Cache\Events\KeyForgotten |
connection.{name}.beginTransaction | Illuminate\Database\Events\TransactionBeginning |
connection.{name}.committed | Illuminate\Database\Events\TransactionCommitted |
connection.{name}.rollingBack | Illuminate\Database\Events\TransactionRolledBack |
illuminate.query | Illuminate\Database\Events\QueryExecuted |
illuminate.queue.before | Illuminate\Queue\Events\JobProcessing |
illuminate.queue.after | Illuminate\Queue\Events\JobProcessed |
illuminate.queue.failed | Illuminate\Queue\Events\JobFailed |
illuminate.queue.stopping | Illuminate\Queue\Events\WorkerStopping |
mailer.sending | Illuminate\Mail\Events\MessageSending |
router.matched | Illuminate\Routing\Events\RouteMatched |
Каждый из этих объектов событий содержит в точности те же параметры, которые передавались в обработчик событий в Laravel 5.1. Например, если в 5.1.* вы использовали PHPDB::listen()
, вы можете обновить свой код для 5.2.* вот так:
DB::listen(function ($event) {
dump($event->sql);
dump($event->bindings);
});
Вы можете заглянуть в каждый класс новых объектов событий, чтобы увидеть их общедоступные свойства.
Обработка исключений
Свойство PHP$dontReport
вашего класса App\Exceptions\Handler надо изменить — включить по крайней мере следующие типы исключений:
use Illuminate\Validation\ValidationException;
use Illuminate\Auth\Access\AuthorizationException;
use Illuminate\Database\Eloquent\ModelNotFoundException;
use Symfony\Component\HttpKernel\Exception\HttpException;
/**
* Список типов исключений, о которых не надо сообщать.
*
* @var array
*/
protected $dontReport = [
AuthorizationException::class,
HttpException::class,
ModelNotFoundException::class,
ValidationException::class,
];
Вспомогательные функции
Вспомогательная функция PHPurl()
теперь возвращает экземпляр Illuminate\Routing\UrlGenerator, когда не предоставлен никакой путь.
Неявная привязка моделей
В Laravel 5.2 появилась «неявная привязка моделей» — новая удобная фича для автоматического внедрения экземпляров моделей в маршруты и контроллеры на базе их идентификаторов, указанных в URI. Но при этом изменилось поведение маршрутов и контроллеров, которые используют указание типов экземпляров моделей.
Если в вашем маршруте или контроллере вы использовали указание типа экземпляра модели и ожидали, что будет внедрён пустой экземпляр модели, то вам надо удалить это указание типа и создать пустой экземпляр модели непосредственно в маршруте или контроллере. Иначе Laravel попытается получить из БД существующий экземпляр модели по идентификатору, указанному в URI маршрута.
IronMQ
Драйвер очереди IronMQ переехал в свой собственный пакет и больше не поставляется с ядром фреймворка.
Задачи / Очередь
Теперь команда shphp artisan make:job
по умолчанию создаёт определение класса задачи «для очереди». Если вы хотите создать «синхронную» задачу, используйте опцию sh--sync
при запуске команды.
Почта
Удалён параметр настройки почты PHPpretend
. Вместо этого используйте драйвер почты log, который выполняет ту же функцию, что и PHPpretend
, и записывает даже больше информации о почтовом сообщении.
Страничный вывод
Для согласования с остальными URL, генерируемыми фреймворком, URL страничного вывода больше не содержат завершающий слэш. Это не повлияет на ваше приложение.
Сервис-провайдеры
Из списка сервис-провайдеров в файле настроек app.php надо удалить Illuminate\Foundation\Providers\ArtisanServiceProvider.
Из списка сервис-провайдеров в файле настроек app.php надо удалить Illuminate\Routing\ControllerServiceProvider.
Сессии
Из-за изменений в системе аутентификации все существующие сессии будут отключены при обновлении до Laravel 5.2.
Для фреймворка написан новый драйвер сессий database, он содержит больше информации о пользователе, такой как ID пользователя, IP-адрес и user-agent. Если вы хотите продолжить использовать старый драйвер, вы можете указать драйвер legacy-database в файле настроек session.php.
Если вы хотите использовать новый драйвер, вам надо добавить в таблицу сессий столбцы user_id (nullable integer), ip_address (nullable string) и user_agent (text).
Stringy
Библиотека «Stringy» больше не входит в состав фреймворка. Если вы хотите использовать её в своём приложении, то можете установить её вручную через Composer.
Проверка ввода
Теперь типаж PHPValidatesRequests
выбрасывает экземпляр Illuminate\Foundation\Validation\ValidationException вместо экземпляра Illuminate\Http\Exception\HttpResponseException. Это не повлияет на ваше приложение, если вы не ловили это исключение вручную.
Рудименты
Следующие функции Laravel устарели и будут полностью удалены в релизе Laravel 5.3 в июне 2016:
- Контракт Illuminate\Contracts\Bus\SelfHandling. Его можно удалить из задач.
- Метод
PHPlists()
на коллекции, конструкторе запросов и объектах конструктора запросов Eloquent был переименован вPHPpluck()
. Сигнатура метода осталась прежней. - Устарели неявные маршруты контроллера с использованием
PHPRoute::controller()
. Пожалуйста, используйте явную регистрацию маршрутов в файле маршрутов. Вероятно, это будет вынесено в отдельный пакет. - Удалены вспомогательные функции маршрутов
PHPget()
,PHPpost()
и другие. Вместо этого вы можете использовать фасадPHPRoute
. - Драйвер сессии database из 5.1 был переименован в legacy-database и будет удалён. Подробнее описано выше в описании «драйвера сессии database».
- Отказались от функции
PHPStr::randomBytes()
в пользу нативной PHP-функцииPHPrandom_bytes()
. - Отказались от функции
PHPStr::equals()
в пользу нативной PHP-функцииPHPhash_equals()
. - Отказались от Illuminate\View\Expression в пользу Illuminate\Support\HtmlString.
- Удалён драйвер кэша WincacheStore.
Обновление до 5.1.11
Laravel 5.1.11 поддерживает авторизацию и политики. Добавить эти новые фичи в ваше существующее приложение очень просто.
Это обновление не обязательное, и если вы его пропустите, это не скажется на вашем приложении.
Сначала создайте пустую папку app/Policies в своём приложении.
Создание/регистрация AuthServiceProvider и фасада Gate
Создайте файл AuthServiceProvider в своей папке app/Providers. Вы можете скопировать в него содержимое провайдера по умолчанию с GitHub. Не забудьте изменить пространство имён провайдера, если в вашем приложении используется своё пространство имён. После создания провайдера не забудьте зарегистрировать его в своём файле настроек app.php в массиве providers.
Также вам надо зарегистрировать фасад Gate в вашем файле app.php:
'Gate' => Illuminate\Support\Facades\Gate::class,
Теперь используйте типаж Illuminate\Foundation\Auth\Access\Authorizable и контракт Illuminate\Contracts\Auth\Access\Authorizable в своей модели App\User:
<?php
namespace App;
use Illuminate\Auth\Authenticatable;
use Illuminate\Database\Eloquent\Model;
use Illuminate\Auth\Passwords\CanResetPassword;
use Illuminate\Foundation\Auth\Access\Authorizable;
use Illuminate\Contracts\Auth\Authenticatable as AuthenticatableContract;
use Illuminate\Contracts\Auth\Access\Authorizable as AuthorizableContract;
use Illuminate\Contracts\Auth\CanResetPassword as CanResetPasswordContract;
class User extends Model implements AuthenticatableContract,
AuthorizableContract,
CanResetPasswordContract
{
use Authenticatable, Authorizable, CanResetPassword;
}
Обновление базового контроллера
Затем добавьте в свой базовый контроллер App\Http\Controllers\Controller использование типажа Illuminate\Foundation\Auth\Access\AuthorizesRequests:
<?php
namespace App\Http\Controllers;
use Illuminate\Foundation\Bus\DispatchesJobs;
use Illuminate\Routing\Controller as BaseController;
use Illuminate\Foundation\Validation\ValidatesRequests;
use Illuminate\Foundation\Auth\Access\AuthorizesRequests;
abstract class Controller extends BaseController
{
use AuthorizesRequests, DispatchesJobs, ValidatesRequests;
}
Обновление до 5.1.0
Примерное время обновления — меньше 1 часа
Обновление bootstrap/autoload.php
Обновите переменную PHP$compiledPath
в файле bootstrap/autoload.php на следующую:
$compiledPath = __DIR__.'/cache/compiled.php';
Создание папки bootstrap/cache
Создайте в папке bootstrap подпапку cache (bootstrap/cache). И поместите в неё файл .gitignore с таким содержимым:
* !.gitignore
В эту папку должна быть разрешена запись, она будет использоваться фреймворком для хранения временных файлов оптимизации, таких как: compiled.php, routes.php, config.php и services.json.
Добавление провайдера BroadcastServiceProvider
Добавьте Illuminate\Broadcasting\BroadcastServiceProvider в массив providers файла config/app.php.
Аутентификация
Если вы используете провайдер AuthController, в котором используется типаж AuthenticatesAndRegistersUsers, то вам надо внести несколько изменений в процесс проверки и создания новых пользователей.
Во-первых, вам больше не надо передавать экземпляры Guard и Registrar в базовый конструктор. Вы можете полностью удалить эти зависимости из конструктора своего контроллера.
Во-вторых, больше не нужен класс App\Services\Registrar, который использовался в Laravel 5.0. Вы можете просто скопировать методы PHPvalidator()
и PHPcreate()
из этого класса прямо в свой AuthController. Больше в этих методах ничего менять не надо, но вам надо не забыть импортировать фасад Validator и модель User в начале вашего AuthController.
Встроенный PasswordController больше не требует никаких зависимостей в своем конструкторе. Вы можете удалить обе зависимости, необходимые в версии 5.0.
Проверка ввода
Если вы переопределяете метод PHPformatValidationErrors()
в своём базовом классе контроллера, то теперь вам надо указать тип контракта Illuminate\Contracts\Validation\Validator вместо конкретного экземпляра Illuminate\Validation\Validator.
И также если вы переопределяете метод PHPformatErrors()
в базовом классе запроса формы, то вам надо указать тип контракта Illuminate\Contracts\Validation\Validator вместо конкретного экземпляра Illuminate\Validation\Validator.
Миграции
Если у вас есть миграции, изменяющие название столбца или удаляющие столбцы из базы данных SQLite, то вам надо добавить зависимость doctrine/dbal в файл composer.json и выполнить в терминале команду shcomposer update
для установки библиотеки.
Eloquent
Метод Eloquent PHPcreate()
теперь может быть вызван без параметров. Если вы переопределяете метод PHPcreate()
в своих моделях, задайте значение по умолчанию для параметра PHP$attributes
как массив:
public static function create(array $attributes = [])
{
// Ваша собственная реализация
}
Если вы переопределяете метод PHPfind()
в своих моделях и вызываете в нём PHPparent::find()
, то вам надо изменить этот вызов на вызов метода PHPfind()
построителя запросов Eloquent:
public static function find($id, $columns = ['*'])
{
$model = static::query()->find($id, $columns);
// ...
return $model;
}
Теперь метод PHPlists()
возвращает для запросов Eloquent экземпляр Collection вместо простого массива. Если вы хотите конвертировать Collection в простой массив, используйте метод PHPall()
:
User::lists('id')->all();
Но помните, что метод PHPlists()
построителя запросов по-прежнему возвращает массив.
Раньше формат хранения полей с датами в Eloquent можно было изменить переопределив метод PHPgetDateFormat()
в своей модели. Это по-прежнему возможно, но для удобства вы можете просто указать свойство PHP$dateFormat
в модели, вместо переопределения метода.
Формат даты теперь также применяется при сериализации модели в PHParray
или JSON. Это может изменить формат ваших JSON-сериализованных полей с датами при миграции с Laravel 5.0 на 5.1. Чтобы указать формат дат для сериализованных моделей, вы можете переопределить метод PHPserializeDate(DateTime $date)
в своей модели. Этот метод предоставляет вам точный контроль над форматированием сериализованных полей с датами в Eloquent, не изменяя формат их хранения.
Класс Collection
Метод PHPsort()
теперь возвращает новый экземпляр коллекции вместо изменения существующей коллекции:
$collection = $collection->sort($callback);
Метод PHPsortBy()
Метод PHPsortBy()
теперь возвращает новый экземпляр коллекции вместо изменения существующей коллекции:
$collection = $collection->sortBy('name');
Метод PHPgroupBy()
Метод PHPgroupBy()
теперь возвращает экземпляры Collection для каждого элемента родительской Collection. Если вы хотите конвертировать все элементы обратно в простые массивы, вы можете сделать с ними map:
$collection->groupBy('type')->map(function ($item)
{
return $item->all();
});
Метод PHPlists()
Метод PHPlists()
теперь возвращает экземпляр Collection вместо простого массива. Если вы хотите конвертировать Collection в простой массив, используйте метод PHPall()
:
$collection->lists('id')->all();
Команды и обработчики
Папка app/Commands переименована в app/Jobs. Но вам не надо перемещать все ваши команды в новое место, и вы по-прежнему можете использовать Artisan-команды shmake:command
и shhandler:command
для генерирования своих классов.
Также папка app/Handlers переименована в app/Listeners и теперь содержит только слушатели событий. Но вам не надо перемещать или переименовывать ваши существующие команды и обработчики событий, вы по-прежнему можете использовать команду shhandler:event
для генерирования обработчиков событий.
Благодаря обратной совместимости со структурой папок Laravel 5.0, вы можете обновить своё приложение до Laravel 5.1 и постепенно обновлять свои события и команды в их новом месте расположения, когда это удобно для вас или вашей команды.
Blade
Методы PHPcreateMatcher()
, PHPcreateOpenMatcher()
и PHPcreatePlainMatcher()
удалены из компилятора Blade. Используйте новый метод PHPdirective()
для создания своих директив для Blade в Laravel 5.1. За подробностями загляните в документацию по расширению Blade.
Тесты
Добавьте защищённое свойство PHP$baseUrl
в файл tests/TestCase.php:
protected $baseUrl = 'http://localhost';
Файлы перевода
Папка по умолчанию для размещения языковых файлов для сторонних пакетов переехала. Переместите все языковые файлы сторонних пакетов из resources/lang/packages/{locale}/{namespace} в папку resources/lang/vendor/{namespace}/{locale}. Например, файл английского языка пакета Acme/Anvil пространства имён acme/anvil::foo надо переместить из resources/lang/packages/en/acme/anvil/foo.php в папку resources/lang/vendor/acme/anvil/en/foo.php.
SDK веб-сервисов Amazon
Если вы используете драйвер очереди AWS SQS или драйвер почты AWS SES, вам надо обновить версию вашего AWS PHP SDK до 3.0.
Если вы используете драйвер файловой системы Amazon S3, вам надо обновить соответствующий пакет Flysystem с помощью Composer:
- Amazon S3: league/flysystem-aws-s3-v3 ~1.0
Рудименты
Следующие функции Laravel устарели и будут полностью удалены в релизе Laravel 5.2 в декабре 2015:
- Отказались от фильтров маршрутов в пользу посредников.
- Устарел контракт Illuminate\Contracts\Routing\Middleware. Для ваших посредников не нужен контракт. В придачу, устарел и контракт TerminableMiddleware. Вместо реализации интерфейса, просто определите метод
PHPterminate()
в своём посреднике. - Отказались от контракта Illuminate\Contracts\Queue\ShouldBeQueued в пользу Illuminate\Contracts\Queue\ShouldQueue.
- Отказались от «push-очередей» Iron.io в пользу обычных очередей и слушателей очереди.
- Устарел типаж Illuminate\Foundation\Bus\DispatchesCommands и был переименован в Illuminate\Foundation\Bus\DispatchesJobs.
- Illuminate\Container\BindingResolutionException перемещён в Illuminate\Contracts\Container\BindingResolutionException.
- Отказались от метод сервис-контейнера
PHPbindShared()
в пользу методаPHPsingleton()
. - Устарел метод Eloquent и построителя запросов
PHPpluck()
и был переименован вPHPvalue()
. - Отказались от метода коллекции
PHPfetch()
в пользу методаPHPpluck()
. - Отказались от вспомогательной функции
PHParray_fetch()
в пользу методаPHParray_pluck()
.
Обновление до 5.0.16
В файле bootstrap/autoload.php обновите значение переменной $compiledPath на:
$compiledPath = __DIR__.'/../vendor/compiled.php';
Сервис-провайдеры
Из списка сервис-провайдеров в файле настроек app.php можно удалить App\Providers\BusServiceProvider.
Из списка сервис-провайдеров в файле настроек app.php можно удалить App\Providers\ConfigServiceProvider.
Обновление до 5.0 с 4.2
Новая установка, затем миграция
Рекомендуемый способ обновления — создать новую установку Laravel 5.0, а затем скопировать уникальные файлы вашего приложения 4.2 в новое приложение. Это касается контроллеров, маршрутов, моделей Eloquent, Artisan-команд, контента и другого кода, специфичного для вашего приложения.
Для начала установите новое приложение Laravel 5 в чистую папку в вашу локальную среду. А каждую часть процесса миграции мы обсудим более подробно далее.
Зависимости и пакеты Composer
Не забудьте скопировать все дополнительные зависимости Composer в ваше 5.0-приложение. В том числе сторонний код, такой как SDK.
Некоторые пакеты, предназначенные для Laravel, могут быть несовместимы со свежей версией. Проверьте на сайте разработчика пакета, какую версию необходимо использовать с Laravel 5. После добавления всех дополнительных зависимостей Composer необходимо выполнить команду shcomposer update
.
Пространства имён
По умолчанию приложения Laravel 4 не используют пространства имён в коде вашего приложения. Например, все модели Eloquent и контроллеры просто живут в пространстве имён «global». Для ускорения миграции вы можете просто оставить эти классы в глобальном пространстве имён и в Laravel 5.
Настройка
Миграция переменных среды
Скопируйте новый файл .env.example в .env, который в 5.0 соответствует старому файлу .env.php. Задайте в нём все соответствующие значения, такие как APP_ENV и APP_KEY (ваш ключ шифрования), данные для подключения к вашей БД, и ваши драйверы кэша и сессий.
Вдобавок, скопируйте и задайте значения из вашего старого файла .env.php и вставьте их и в .env (действующие значения для вашей локальной среды), и в .env.example (примеры значений для других участников команды).
Более подробно о настройке среды читайте в полной документации.
Внимание: Вам необходимо поместить соответствующий файл .env с необходимыми значениями на ваш продакшн-сервер перед развёртыванием вашего приложения на Laravel 5.
Конфигурационные файлы
В Laravel 5.0 больше не используются каталоги app/config/{environmentName}/ для расположения конкретных файлов настроек для каждой среды. Вместо этого поместите все значения настроек, которые зависят от среды, в .env, а затем обращайтесь к ним из ваших конфигурационных файлов с помощью confenv('key', 'default value')
. Примеры можно увидеть в файле настроек config/database.php.
Настройте конфигурационные файлы в папке config/ в соответствии с теми значениями, которые необходимы для ваших сред, или настройте их на использование PHPenv()
для загрузки значений, зависящих от среды.
Не забывайте при добавлении новых параметров в файл .env добавлять значения для примера и в файл .env.example. Это поможет другим участникам вашей команды создавать собственные файлы .env.
Маршруты
Скопируйте и вставьте ваш старый файл routes.php в ваш новый app/Http/routes.php.
Контроллеры
Затем поместите все ваши контроллеры в каталог app/Http/Controllers. Поскольку в этой статье мы не собираемся мигрировать в полное пространство имён, добавьте каталог app/Http/Controllers в директиву classmap вашего файла composer.json. Теперь вы можете удалить пространство имён из абстрактного базового класса app/Http/Controllers/Controller.php. Проверьте, что ваши мигрированные контроллеры наследуют этот базовый класс.
В вашем файле app/Providers/RouteServiceProvider.php задайте значение для свойства PHPnamespace
равное PHPnull
.
Фильтры маршрутов
Скопируйте ваши привязки маршрутов из app/filters.php и вставьте их в метод PHPboot()
в app/Providers/RouteServiceProvider.php. Добавьте строку PHPuse Illuminate\Support\Facades\Route;
в файл app/Providers/RouteServiceProvider.php, чтобы продолжить использование фасада Route.
Нет необходимости копировать какие-либо фильтры Laravel 4.0 по умолчанию, такие как auth и csrf, — они у вас уже есть, но в виде посредников. Редактируйте любые маршруты и контроллеры, которые соответствуют старым фильтрам по умолчанию (например, PHP['before' => 'auth']
), и измените их в соответствии с новым посредником (например, PHP['middleware' => 'auth']
).
Фильтры не удалены из Laravel 5. Вы по-прежнему можете привязывать и использовать собственные фильтры с помощью PHPbefore
и PHPafter
.
Глобальная CSRF-защита
По умолчанию CSRF-защита включена для всех маршрутов. Если захотите отключить её, или включить только для нескольких маршрутов вручную, удалите эту строчку массива middleware из App\Http\Kernel:
conf'App\Http\Middleware\VerifyCsrfToken',
Если хотите использовать её где-либо ещё, добавьте эту строчку в PHP$routeMiddleware
:
'csrf' => 'App\Http\Middleware\VerifyCsrfToken',
Теперь вы можете добавить посредников в отдельные маршруты / контроллеры с помощью PHP['middleware' => 'csrf']
для маршрута. Подробнее о посредниках читайте в полной документации.
Модели Eloquent
Для хранения своих моделей Eloquent вы свободно можете создать новую папку app/Models. И опять, добавьте эту папку в директиву classmap в файле composer.json.
Обновляйте любые модели с помощью SoftDeletingTrait для использования PHPIlluminate\Database\Eloquent\SoftDeletes
.
Кэширование Eloquent
В Eloquent теперь нет метода PHPremember
для кэширования запросов. Теперь вы сами отвечаете за ручное кэширование ваших запросов с помощью функцииPHPCache::remember
. Подробнее об этом читайте в полной документации.
Модель авторизации пользователя
Для обновления вашей модели User для системы авторизации Laravel 5 следуйте этим инструкциям:
Удалите эти строки из блока PHPuse
:
use Illuminate\Auth\UserInterface;
use Illuminate\Auth\Reminders\RemindableInterface;
Добавьте эти строки в блок PHPuse
:
use Illuminate\Auth\Authenticatable;
use Illuminate\Auth\Passwords\CanResetPassword;
use Illuminate\Contracts\Auth\Authenticatable as AuthenticatableContract;
use Illuminate\Contracts\Auth\CanResetPassword as CanResetPasswordContract;
Удалите интерфейсы UserInterface и RemindableInterface.
Отметьте класс, как реализующий следующие интерфейсы:
implements AuthenticatableContract, CanResetPasswordContract
Включите следующие типажи в объявление класса:
use Authenticatable, CanResetPassword;
Если они использовались, то удалите Illuminate\Auth\Reminders\RemindableTrait и Illuminate\Auth\UserTrait из вашего блока PHPuse
и объявления класса.
Изменения пользователя Cashier
Изменились названия типажа и интерфейса, используемые для Laravel Cashier. Вместо BillableTrait используйте типаж Laravel\Cashier\Billable. А вместо Laravel\Cashier\BillableInterface реализуйте интерфейс Laravel\Cashier\Contracts\Billable. Больше никаких изменений методов не требуется.
Artisan-команды
Переместите все ваши классы команд из старой папки app/commands в новую app/Console/Commands. Затем добавьте эту папку app/Console/Commands в директиву classmap в файле composer.json.
Затем скопируйте ваш список Artisan-команд из start/artisan.php в массив commands в файле app/Console/Kernel.php.
Миграции и наполнение начальными данными БД
Удалите две миграции, включённые в Laravel 5.0, поскольку у вас уже есть таблица пользователей в БД.
Переместите все ваши классы миграций из старой папки app/database/migrations в новую database/migrations. Все ваши начальные данные должны быть перемещены из app/database/seeds в database/seeds.
Глобальные привязки IoC
Если у вас есть привязки IoC в start/global.php, переместите их в метод PHPregister
файла app/Providers/AppServiceProvider.php. Вам может понадобиться импортировать фасад App.
Как вариант, вы можете разбить эти привязки на отдельные сервис-провайдеры по категориям.
Шаблоны
Переместите ваши шаблоны из app/views в новую папку resources/views.
Изменения тегов Blade
Для лучшей защищённости по умолчанию Laravel 5.0 экранирует весь вывод от обеих директив Blade — {{ }} и {{{ }}}. Была введена новая директива {!! !!} для отображения сырого, неэкранированного вывода. Самый безопасный вариант при обновлении вашего приложения — использовать новую директиву {!! !!}, только когда вы уверены, что выводить сырые данные безопасно.
Но если вам необходимо использовать старый синтаксис Blade, добавьте следующие строки в конец AppServiceProvider@register:
\Blade::setRawTags('{{', '}}');
\Blade::setContentTags('{{{', '}}}');
\Blade::setEscapedContentTags('{{{', '}}}');
К этому следует отнестись серьёзно, так как ваше приложение может стать более уязвимым к XSS-эксплоитам. Также перестанет работать комментирование кода с помощью {{--.
Языковые файлы
Переместите ваши языковые файлы из app/lang в новую папку resources/lang.
Общая папка
Скопируйте общий контент вашего приложения из каталога public вашего приложения 4.2 в каталог public вашего нового приложения. Не забудьте сохранить файл index.php версии 5.0.
Тесты
Переместите свои тесты из app/tests в новую папку tests.
Другие файлы
Скопируйте остальные файлы в свой проект. Например, .scrutinizer.yml, bower.json и другие похожие файлы настроек инструментария.
Вы можете расположить ваши Sass, Less и CoffeeScript где пожелаете. Хорошим местом по умолчанию может послужить папка resources/assets.
Вспомогательные функции форм и HTML
Если вы используете вспомогательные функции форм или HTML, то столкнётесь с ошибкой «класс Form не найден» или «класс Html не найден». Вспомогательные функции форм и HTML упразднены в Laravel 5.0, но есть разработанные сообществом замены для них, такие как разработанная командой Laravel Collective.
Например, вы можете добавить PHP"laravelcollective/html": "~5.0"
в раздел PHPrequire
своего файла composer.json.
Вам также надо будет добавить фасады Form и HTML и сервис-провайдер. Отредактируйте config/app.php — вставьте эту строку в массив PHPproviders
:
'Collective\Html\HtmlServiceProvider',
Затем добавьте эти строки в массив PHPaliases
:
'Form' => 'Collective\Html\FormFacade',
'Html' => 'Collective\Html\HtmlFacade',
CacheManager
Если в ваш код был внедрён Illuminate\Cache\CacheManager для получения бесфасадной версии кэша Laravel, то внедрите вместо него Illuminate\Contracts\Cache\Repository.
Страничный вывод
Замените все вызовы PHP$paginator->links()
на PHP$paginator->render()
.
Замените все вызовы PHP$paginator->getFrom()
и PHP$paginator->getTo()
на PHP$paginator->firstItem()
и PHP$paginator->lastItem()
соответственно.
Удалите префикс «get» из вызовов PHP$paginator->getPerPage()
, PHP$paginator->getCurrentPage()
, PHP$paginator->getLastPage()
и PHP$paginator->getTotal()
(например, PHP$paginator->perPage()
).
Очереди Beanstalk
Laravel 5.0 требует PHP"pda/pheanstalk": "~3.0"
вместо PHP"pda/pheanstalk": "~2.1"
.
Компонент Remote
Компонент Remote был упразднён.
Компонент Workbench
Компонент Workbench был упразднён.
Обновление на 4.2 с 4.1
PHP 5.4+
Laravel 4.2 требует PHP 5.4.0 или выше.
Настройки шифрования
Добавьте новый параметр cipher в свой файл конфигурации app/config/app.php. Значение этого параметра должно быть MCRYPT_RIJNDAEL_256.
confcipher => MCRYPT_RIJNDAEL_256
Этот параметр используется для управления шифром по умолчанию для средств шифрования Laravel.
В Laravel 4.2 шифр по умолчанию — это MCRYPT_RIJNDAEL_128 (AES). Он считается самым безопасным шифром. Необходимо изменение значения шифра назад на MCRYPT_RIJNDAEL_256, чтобы расшифровывать cookies/values, которые были зашифрованы в Laravel 4.1.
Модели безопасного удаления теперь используют типажи
Если вы используете модели безопасного удаления, знайте, что теперь параметр softDeletes удалён. Теперь надо использовать SoftDeletingTrait:
use Illuminate\Database\Eloquent\SoftDeletingTrait;
class User extends Eloquent {
use SoftDeletingTrait;
}
Также надо вручную добавить поле deleted_at в параметр dates:
class User extends Eloquent {
use SoftDeletingTrait;
protected $dates = ['deleted_at'];
}
API для операций безопасного удаления остался прежним.
SoftDeletingTrait не может быть применён на базовую модель. Он должен быть в классе реальной модели.
Переименованы классы View и Pagination
Если вы непосредственно ссылаетесь на класс Illuminate\View\Environment или класс Illuminate\Pagination\Environment, обновите свой код на Illuminate\View\Factory и Illuminate\Pagination\Factory вместо них. Новое название лучше отражает их функции.
Дополнительный параметр в Pagination Presenter
Если вы наследуете класс Illuminate\Pagination\Presenter, то теперь в абстрактный метод PHPgetPageLinkWrapper
добавился параметр rel:
abstract public function getPageLinkWrapper($url, $page, $rel = null);
Шифрование очереди Iron.Io
Если вы используете драйвер очереди Iron.io, вам нужно будет добавить новый параметр encrypt в конфигурационный файл очереди:
conf'encrypt' => true
Обновление до 4.1.29 с 4.1.x
В Laravel 4.1.29 улучшено квотирование столбцов для всех драйверов баз данных. Это защищает ваше приложение от некоторых уязвимостей массового назначения, когда в модели не используется параметр fillable. Если вы используете параметр fillable для защиты от массового назначения, ваше приложение не является уязвимым. Однако, если вы используете guarded и передаёте пользовательские массивы в функции типа «update» или «save», вы должны скорей обновиться до 4.1.29, так как ваше приложение находится под угрозой массового назначения.
Чтобы обновить Laravel до 4.1.29, просто запустите shcomposer update
. В этом релизе нет критических изменений.
Обновление до 4.1.26 с 4.1.25
В Laravel 4.1.26 входят улучшения в области безопасности для cookies «запомнить меня». До этого обновления, если злоумышленник перехватывал cookie «запомнить меня», то этот cookie оставался действующим в течение длительного периода времени, даже после того как настоящий владелец аккаунта изменил свой пароль, вышел из системы и т.д.
Это изменение требует добавления нового столбца remember_token в таблицу базы данных users (или её аналог). После этого изменения новый токен будет присваиваться пользователю каждый раз, когда он подключается к вашему приложению. Токен также будет обновлён, когда пользователь выйдет из приложения. Последствия этого изменения: если cookie «запомнить меня» перехвачен, простой выход из приложения обновит этот cookie.
Обновление Path
Во-первых, добавьте в таблицу users новый, занулённый столбец remember_token типа VARCHAR(100), TEXT, или эквивалентного типа.
Во-вторых, если вы используете драйвер аутентификации Eloquent, добавьте в класс User следующие три метода:
public function getRememberToken()
{
return $this->remember_token;
}
public function setRememberToken($value)
{
$this->remember_token = $value;
}
public function getRememberTokenName()
{
return 'remember_token';
}
Все существующие сессии «запомнить меня» станут недействительны после этого изменения, так что все пользователи будут вынуждены повторно зайти в ваше приложение.
Создатели пакетов
Два новых метода были добавлены в интерфейс Illuminate\Auth\UserProviderInterface. Примеры реализации можно найти в драйверах по умолчанию:
public function retrieveByToken($identifier, $token);
public function updateRememberToken(UserInterface $user, $token);
Illuminate\Auth\UserInterface также получил три новых метода, описанные выше в разделе «Обновление Path».
Обновление до 4.1 с 4.0
Обновление зависимостей Composer
Чтобы обновить своё приложение Laravel до 4.1, измените версию вашего laravel/framework на 4.1.* в файле composer.json.
Замена файлов
Замените свой файл public/index.php на эту свежую копию из репозитория.
Замените свой файл artisan на эту свежую копию из репозитория.
Добавление файлов конфигурации и параметров
Обновите свои массивы aliases и providers в своём конфигурационном файле app/config/app.php. Обновлённые значения для этих массивов можно найти в этом файле. Не забудьте заново добавить в массивы свои пользовательские и пакетные поставщики услуг и алиасы.
Добавьте новый файл app/config/remote.php из репозитория.
Добавьте новый параметр конфигурации expire_on_close в свой файл app/config/session.php. По умолчанию значение должно быть установлено в false.
Добавьте новую секцию failed в свой файл app/config/queue.php. По умолчанию значения секции должны быть следующими:
conf 'failed' => [ 'database' => 'mysql', 'table' => 'failed_jobs', ],
(Необязательно) Обновите параметр pagination в файле app/config/view.php на pagination::slider-3.
Обновление контроллера
Если app/controllers/BaseController.php содержит use вверху, измените use Illuminate\Routing\Controllers\Controller; на use Illuminate\Routing\Controller;
Обновление сброса паролей
Сброс паролей был перестроен для большей гибкости. Вы можете изучить новый контроллер, выполнив Artisan-команду shphp artisan auth:reminders-controller
(запускайте только после выполнения других изменений ниже). Вы можете также просмотреть обновленную документацию и обновить своё приложение в соответствии с ней.
Обновите свой языковой файл app/lang/en/reminders.php на этот
Обновление обнаружения среды
Из соображений безопасности URL-домены больше не используются для обнаружения среды приложения. Эти значения легко подменить, а это позволит злоумышленникам изменить среду для запроса. Используйте для обнаружения среды имена хостов (команда shhostname
на Mac, Linux и Windows).
Более простые лог-файлы
Laravel теперь генерирует единственный файл журнала: app/storage/logs/laravel.log. Однако вы по-прежнему можете настроить ведение журналов с помощью файла app/start/global.php.
Удаление завершающего слеша для переадресации
В вашем файле bootstrap/start.php удалите вызов PHP$app->redirectIfTrailingSlash()
. Этот метод больше не нужен, так как это функция теперь реализована в файле .htaccess, включенном в фреймворк.
Затем замените файл .htaccess вашего Apache на этот новый файл, который обрабатывает завершающие слешы.
Доступ к текущему маршруту
Текущий маршрут теперь доступен с помощью PHPRoute::current()
вместо PHPRoute::getCurrentRoute()
.
Обновление Composer
Как только вы завершили все перечисленные выше обновления, вы можете выполнить команду shcomposer update
, чтобы обновить файлы ядра приложения! Если у вас появляются ошибки загрузки класса, попытайтесь выполнить команду shupdate
с параметром sh--no-scripts
:
shcomposer update --no-scripts
На Linux вам может потребоваться сделать shsudo composer update
, если вы получаете ошибку доступа.
Слушатели событий по шаблону
Слушатели событий по шаблону теперь не передают события в параметры ваших функций-обработчиков. Если вам надо найти событие, которое было запущено, вы должны использовать PHPEvent::firing()
.
Комментарии (1)
После добавления
PHP"laravelcollective/html": "~5.0"
в composer.json нужно сделать composer update.И только после этого добавлять строки в config/app.php
И не
PHPCollective\Html\HtmlServiceProvider
, аPHPCollective\Html\HtmlServiceProvider::class
.