3.1 documentation

  1. Upgrading from 3.0 to 3.1
  2. Upgrading from 2.1 to 2.2
  3. Upgrading from 2.0 to 2.1

Upgrading from 3.0 to 3.1

Update bootstrap/autoload.php

Update the $compiledPath variable in bootstrap/autoload.php to the following:

$compiledPath = __DIR__.'/cache/compiled.php';

Create bootstrap/cache Directory

Within your bootstrap directory, create a cache directory (bootstrap/cache). Place a .gitignore file in this directory with the following contents:

*
!.gitignore

This directory should be writable, and will be used by the framework to store temporary optimization files like compiled.php, routes.php, config.php, and services.json.

Upgrading Your Composer Dependency

To upgrade to Orchestra Platform 3.1, change your "orchestra/foundation" version to "3.1.*" in your composer.json file.

As a pre-caution, run php artisan clear-compiled before executing composer update.

Adding Configuration Files & Options

Update your aliases and providers arrays in your resources/config/app.php configuration file. The updated values for these arrays can be found in this file (raw). Be sure to add your custom and package service providers / aliases back to the arrays.

Provides Action
Illuminate\Broadcasting\BroadcastServiceProvider Add
Orchestra\Foundation\Providers\FilterServiceProvider Remove
Orchestra\Foundation\Providers\RouteServiceProvider Add

Add the new resources/config/broadcasting.php file from the repository (raw).

Full Skeleton Changes

You can review the full application skeleton changes by viewing the full changes.

Laravel Changes

You can also check out the full Upgrading Guide for Laravel 5.1 as well as Laravel 5.1 Release Note.

Upgrading from 2.1 to 2.2

Upgrading Your Composer Dependency

To upgrade to Orchestra Platform 2.2, change your "orchestra/foundation" version to "2.2.*" in your composer.json file.

As a pre-caution, remove bootstrap/compiled.php file if it exist to avoid possible error during upgrade.

Adding Configuration Files & Options

Add the new cipher configuration option to your app/config/app.php file. The default value should be MCRYPT_RIJNDAEL_256 constant.

'cipher' => MCRYPT_RIJNDAEL_256,

Add the new fallback_locale configuration option to your app/config/app.php file. The default value should be en.

'fallback_locale' => 'en',

Add the new alias to your app/config/app.php.

'SoftDeletingTrait' => 'Illuminate\Database\Eloquent\SoftDeletingTrait',

Add new app/config/services.php file from the repository (raw).

Upgrading from 2.0 to 2.1

Upgrading Your Composer Dependency

To upgrade to Orchestra Platform 2.1, change your "orchestra/foundation" version to "2.1.*" in your composer.json file.

As a pre-caution, remove bootstrap/compiled.php file if it exist to avoid possible error during upgrade.

Replace Files

Replace your public/index.php file with this fresh copy from the repository (raw).

Replace your artisan file with this fresh copy from the repository (raw).

Adding Configuration Files & Options

Update your aliases and providers arrays in your app/config/app.php configuration file. The updated values for these arrays can be found in this file (raw). Be sure to add your custom and package service providers / aliases back to the arrays.

Provides Action
Illuminate\Foundation\Providers\CommandCreatorServiceProvider Remove
Illuminate\Foundation\Providers\ComposerServiceProvider Remove
Illuminate\Foundation\Providers\ConsoleSupportServiceProvider Add
Illuminate\Foundation\Providers\KeyGeneratorServiceProvider Remove
Illuminate\Foundation\Providers\MaintenanceServiceProvider Remove
Illuminate\Foundation\Providers\OptimizeServiceProvider Remove
Illuminate\Foundation\Providers\RouteListServiceProvider Remove
Illuminate\Remote\RemoteServiceProvider Add
Illuminate\Foundation\Providers\ServerServiceProvider Remove
Illuminate\Foundation\Providers\TinkerServiceProvider Remove
Orchestra\Debug\DebugServiceProvider Add
Orchestra\Notifier\NotifierServiceProvider Add
Orchestra\Optimize\OptimizeServiceProvider Add
Orchestra\Auth\CommandServiceProvider Remove
Orchestra\Extension\CommandServiceProvider Remove
Orchestra\Memory\CommandServiceProvider Remove
Orchestra\Foundation\ConsoleSupportServiceProvider Add

Update redis.cluster configuration section to false in your app/config/database.php.

Add the new app/config/remote.php file from the repository (raw).

Add the new expire_on_close configuration option to your app/config/session.php file. The default value should be false.

Add the new failed configuration section to your app/config/queue.php file. Here are the default values for the section:

'failed' => array(
    'database' => 'mysql', 'table' => 'failed_jobs',
),

Optional

Update the pagination configuration option in your app/config/view.php file to pagination::slider-3 (if you're using Twitter Bootstrap 3 instead of Bootstrap 2).

E-mail Templates

Update app/views/emails/auth/reminder.blade.php file with this fresh copy from the repository (raw).

Add new app/views/emails/auth/register.blade.php file with this fresh copy from the repository (raw).

Controller Updates

If app/controllers/BaseController.php has a use statement at the top, change use Illuminate\Routing\Controllers\Controller; to use Illuminate\Routing\Controller;.

Password Reminders Updates

Password reminders have been overhauled for greater flexibility. Update your app/lang/en/reminders.php language file to match this updated file (raw).

Environment Detection Updates

For security reasons, URL domains may no longer be used to detect your application environment. These values are easily spoofable and allow attackers to modify the environment for a request. You should convert your environment detection to use machine host names (hostname command on Mac & Ubuntu).

Simpler Log Files

Laravel now generates a single log file: app/storage/logs/laravel.log. However, you may still configure this behavior in your app/start/global.php file.

Removing Redirect Trailing Slash

In your bootstrap/start.php file, remove the call to $app->redirectIfTrailingSlash(). This method is no longer needed as this functionality is now handled by the .htaccess file included with the framework.

Next, replace your Apache .htaccess file with this new one (raw) that handles trailing slashes.

Current Route Access

The current route is now accessed via Route::current() instead of Route::getCurrentRoute().

Composer Update

Once you have completed the changes above, you can run the composer update function to update your core application files!