Upgrading

Table of Contents

1. 1.0.0-rc4
   1. Files to Copy
   2. Files to Manually Update
2. 1.0.0-rc3
   1. Files to Manually Update
3. 1.0.0-rc1
   1. Classes to Update
4. 1.0.0-beta7
   1. Files to Copy
   2. Files to Manually Update
5. 1.0.0-beta6
   1. Files to Delete
   2. Files to Copy
   3. Files to Manually Update

1.0.0-rc4

Estimated Upgrade Time: 5 minutes

This release focused on fixing unit tests on Windows machines and making it easier to run Opulence on localhost.

Files to Copy

Unless you've customized any of the following files, you can just copy the updated versions from the skeleton project.

• phpunit.xml
• src/Project/Application/Bootstrappers/Http/Sessions/SessionBootstrapper.php
• src/Project/Application/Bootstrappers/Http/Views/ViewBootstrapper.php

Files to Manually Update

• Add Environment::setVar("VIEW_CACHE", \Opulence\Views\Caching\FileCache::class); to your .env.app.php and .env.example.php

1.0.0-rc3

Estimated Upgrade Time: 2 minutes

This release fixed an issue that would prevent users from clearing Opulence's framework cache when bootstrappers were deleted.

Files to Manually Update

Unless you've customized any of the following files, you can just copy the updated versions from the skeleton project.

• bootstrap/console/start.php
• bootstrap/http/start.php
• config/application.php

1.0.0-rc1

Estimated Upgrade Time: 2 minutes

This release removed deprecated classes from previous betas. If you're upgrading from v1.0.0-beta7, then follow the steps below. If you're upgrading from older versions, first upgrade to v1.0.0-beta7.

Classes to Update

The Opulence\Events\Event and IEvent classes do not exist anymore. Instead, your event classes should be plain-old PHP objects (POPO). So, stop extending/implementing Event and IEvent. Any code that may have called stopPropagation() should also be removed. Event listeners that were explicitly accepting an Event or IEvent instance should also be changed to accept any POPO.

1.0.0-beta7

Estimated Upgrade Time: 5 minutes

This beta was mostly about changing Opulence\Environments\Environment to a static class. Additionally, there are some performance boosts and bug fixes. If you're upgrading from v1.0.0-beta6, then follow the steps below. If you're upgrading from an even older version, first upgrade to v1.0.0-beta6.

Files to Copy

Unless you've customized any of the following files, you can just copy the updated versions from the skeleton project.

• bootstrap/http/start.php
• bootstrap/console/start.php
• config/environment.php

Files to Manually Update

Update any instances of $environment->getVar(...) to \Opulence\Environments\Environment::getVar(...) and $environment->setVar(..., ...) to \Opulence\Environments\Environment::setVar(..., ...) in the following files:

• config/environment/.env.app.php
• config/environment/.env.example.php
• config/http/sessions.php

Update $environment->getName() to \Opulence\Environments\Environment::getName() in the following file:

• config/http/exceptions.php

Remove $container->bindInstance(Environment::class, $environment); from config/application.php

Remove $this->environment = require __DIR__ . "/../../../../../config/environment.php"; from the following files:

• tests/src/{PROJECT_NAME}/Application/Console/IntegrationTestCase.php
• tests/src/{PROJECT_NAME}/Application/Http/IntegrationTestCase.php

1.0.0-beta6

Estimated Upgrade Time: 20-40 minutes

This beta primarily focused on the overhauling of bootstrappers. Bootstrappers now reside in the Ioc library, and no longer have dependencies on the Opulence\Applications\Tasks\Dispatchers\ITaskDispatcher, Opulence\Bootstrappers\Paths, or Opulence\Environments\Environment classes.

Files to Delete

The following files need to be deleted manually from your server:

• tmp/framework/console/cachedBootstrapperRegistry.json
• tmp/framework/http/cachedBootstrapperRegistry.json

Files to Copy

Unless you've customized any of the following files, you can just copy the updated versions from the skeleton project. Just be sure not to overwrite namespace {PROJECT_NAME}\...; at the top of your classes.

• bootstrap/console/start.php
• bootstrap/http/start.php
• config/application.php
• config/environment/.env.example.php
• config/http/sessions.php
• config/paths.php
• src/{PROJECT_NAME}/Application/Bootstrappers/Cache/RedisBootstrapper.php
• src/{PROJECT_NAME}/Application/Bootstrappers/Console/Commands/CommandsBootstrapper.php
• src/{PROJECT_NAME}/Application/Bootstrappers/Databases/SqlBootstrapper.php
• src/{PROJECT_NAME}/Application/Bootstrappers/Events/EventDispatcherBootstrapper.php
• src/{PROJECT_NAME}/Application/Bootstrappers/Http/Routing/RouterBootstrapper.php
• src/{PROJECT_NAME}/Application/Bootstrappers/Http/Sessions/SessionBootstrapper.php
• src/{PROJECT_NAME}/Application/Bootstrappers/Http/Views/ViewBootstrapper.php
• src/{PROJECT_NAME}/Application/Bootstrappers/Orm/UnitOfWorkBootstrapper.php
• src/{PROJECT_NAME}/Application/Bootstrappers/Validation/ValidatorBootstrapperBootstrapper.php
• src/{PROJECT_NAME}/Application/Http/Middleware/CheckCsrfToken.php
• src/{PROJECT_NAME}/Application/Http/Middleware/Session.php
• tests/src/{PROJECT_NAME}/Application/Console/IntegrationTestCase.php
• tests/src/{PROJECT_NAME}/Application/Http/IntegrationTestCase.php

Files to Manually Update

• In your application's bootstrappers, change:
  • use Opulence\Bootstrappers\Bootstrapper; to use Opulence\Ioc\Bootstrappers\Bootstrapper;
  • use Opulence\Bootstrappers\ILazyBootstrapper; to use Opulence\Ioc\Bootstrappers\ILazyBootstrapper;
  • $this->environment->getVar({VAR_NAME}) to getenv({VAR_NAME})
  • $this->environment->getName() to getenv("ENV_NAME")
  • $this->paths[{PATH}] to Config::get("paths", {PATH})
• In config/environment/.env.app.php, add:
  • $environment->setVar("SESSION_COOKIE_DOMAIN", "");
  • $environment->setVar("SESSION_COOKIE_IS_SECURE", false);
  • $environment->setVar("SESSION_COOKIE_PATH", "/");