Migration zum Zend Framework 3

WebinarWebinar
Migration zum Zend Framework 3Migration zum Zend Framework 3

Ralf EggertRalf Eggert
CEO Travello GmbH, PHP Entwickler,CEO Travello GmbH, PHP Entwickler,
Zend Framework Trainer, Autor & Coach sowieZend Framework Trainer, Autor & Coach sowie
Amazon Alexa Skill EntwicklerAmazon Alexa Skill Entwickler

Ralf EggertRalf Eggert 33 vonvon 6868
Agenda
Teil 1: Neuerungen im Zend Framework 3
Teil 2: Überblick ZendExpressive
Teil 3: Vorbereitungen für Migration
Teil 4: Migration vom ZF1 MVC zu ZF3 Middleware
Teil 5: Migration vom ZF2 MVC zu ZF3 MVC
Teil 6: Migration vom ZF3 MVC zu ZF3 Middleware

Teil 1Teil 1
Neuerungen im Zend Framework 3Neuerungen im Zend Framework 3

Fakten zum ZF3
ZF1 Support
endete 09/2016
PHP 7
kompatibel
ZF2 LTS
bis 03/2018
PHP 5.6
vorausgesetzt
Über 160 Mio.
installierte
Pakete
ZF3 erschienen
im 07/2016
Über 60
Komponenten

Auswahl Komponenten
MVC
Formulare
Middleware
Input-Filter
Validatoren
View
Filter
Authentifizierung
Autorisierung Cache
Session
Konfiguration
Datenbanken
Dateien
Service-Manager
Event-Manager Modul-Manager
Hydrator

Framework Silos 2006 - 2015

Ende Framework Silos seit 2016

Performance Optimierungen
Zend Framework 2 Zend Framework 34x schneller

Standardisierung: www.php-fig.org

Verbesserte Dokumentation

Entkopplung der Komponenten
ZendMvc 2.5
4 feste Abhängigkeiten, z.B. zu
ZendForm
19 optionale Abhängigkeiten,
z.B. zu ZendI18n oder
ZendAuthentication
0 Integrationskomponenten
0 Plugin-Komponenten
ZendMvc 3.0
7 feste Abhängigkeiten, z.B. zu
ZendServiceManager
9 optionale Abhängigkeiten,
z.B. zu ZendMvcI18n oder
ZendMvcPluginIdentity
2 Integrationskomponenten
4 Plugin-Komponenten

Kontinuität & Community

Migration Guide

Diversifikation
Ich bin zwei
Öltanks
FRAMEWORKS

Middleware vs. MVC
ZendMvcZendExpressive
Neues
Konzept
Wenige
Module
Middleware
Pipeline
Schwerere
Integration
unerfahrene
Entwickler
Neue
Projekte
Migration
komplexer
sehr
performant
erprobt
& stabil
viele
Module
Migration
einfach
Leichte
Integration
erfahrene
Entwickler
Event
Manager
Bestands-
projekte
weniger
performant
Zukunft Gegenwart

Entscheidungsmatrix für Migration
Projektlaufzeit
Kurzfristig
(wenige Monate)
Projektlaufzeit
Mittelfristig
(einige Jahre)
Projektlaufzeit
Langfristig
(mehrere Jahre)
Projektbasis
Zend Framework 2
Upgrade auf die neuesten
ZF2 Komponenten
Upgrade auf ZF3 MVC Upgrade auf ZF3
Middleware
Projektbasis
Zend Framework 1
Upgrade auf die neueste
ZF1 Version und Daumen
drücken
Upgrade auf ZF3
Middleware
(übergangsweise
Parallelbetrieb mit ZF1)
Upgrade auf ZF3
Middleware
(übergangsweise
Parallelbetrieb mit ZF1)
Projektbasis
Kein Zend Framework
Daumen drücken Upgrade auf ZF3
Middleware
(übergangsweise
Parallelbetrieb mit Legacy
Anwendung)
Upgrade auf ZF3
Middleware
(übergangsweise
Parallelbetrieb mit Legacy
Anwendung)

Teil 2Teil 2
Überblick ZendExpressiveÜberblick ZendExpressive

Was ist der PSR-7?

Was ist der PSR-15?

Zend Framework Komponenten
ZEND
DIACTOROS
ZENDSTRATIGILITY
ZENDEXPRESSIVE
HTTP MESSAGES /PSR-7
MIDDLEWARE / PSR-15
MIDDLEWARE
APPLICATIONS

ZendExpressive Komponenten
Router DI Container Template Renderer Error Handler
Aura.Router
FastRoute
ZendRouter
Weitere Router
Aura.DI
Pimple-interop
Zend
ServiceManager
Weitere
DI Container
Plates
Twig
ZendView
Weitere
Template-Engines
Whoops
Weitere
Error-Handler

Klassischer HTTP Request
CLIENT WEBSERVER
HTTP
REQUEST
HTTP
RESPONSE

Middleware-Request
HTTP
Request
HTTP
Response
Middleware-Pipeline

Middleware-Pipeline
HTTP
Request
HTTP
Response
Routing
Middleware
Authorization
Middleware
Dispatching
Middleware

Middleware-Aktionen
HTTP
Request
HTTP
Response
Routing
Middleware
Action
Middleware
Authorization
Middleware
Dispatching
Middleware

Beispiele für Action-Middleware

Teil 3Teil 3
Vorbereitungen für MigrationVorbereitungen für Migration

1. Eigener Branch für Migration

2. Upgrade auf PHP 7

3. Composer installieren

4. Autoloading nur per Composer

5. Alle Pakete (!) per Composer

6. Anwendung lauffähig machen

7. Expressive Skeleton installieren

Checkliste Vorbereitungen
Eigenen Branch für Migration einrichten1
Upgrade auf PHP 72
Composer installieren (falls noch nicht geschehen)3
Autoloading ausschließlich über Composer einrichten4
Alle Pakete und Abhängigkeiten per Composer installieren5
Anwendung lauffähig machen6
Expressive Skeleton in separatem Verzeichnis installieren7

Teil 4Teil 4
Migration vom ZF1 MVC zu ZF3 MiddlewareMigration vom ZF1 MVC zu ZF3 Middleware

Migration ZF1 MVC ZF3 MW→
Legacy Anwendung in eigenes Verzeichnis schieben1
ZendExpressive manuell installieren2
Middleware für Legacy Anwendung einrichten3
Test-Aktion mit neuer Route einrichten und Design anpassen4
ZF1 Application Ressourcen & MVC Plugins zum ZF3 portieren5
Controller-Aktionen zu Middleware-Aktionen migrieren6
Restliche ZF1 Komponenten ersetzen7

1. Eigenes Legacy Verzeichnis
Verzeichnis /legacy im Projekt erstellen
Nur /application und /library nach /legacy verschieben
Assets wie Grafiken, JS, CSS nicht verschieben
Verzeichnis /data und /tmp nicht verschieben
Verzeichnis /vendor nicht verschieben
Autoloading anpassen (Composer)
Anwendung zum Laufen bekommen

2. ZendExpressive installieren
Verzeichnis der Skeleton Application aus Vorbereitungen öffnen
Alle Pakete aus composer.json mit Composer installieren
Verzeichnis /config übernehmen und anpassen
Verzeichnis /module übernehmen mit Application Modul
Vorhandene /public/index.php in /public/index.bak.php umbenennen
/public/index.php aus Skeleton Application übernehmen
Skeleton Application zum Laufen bekommen

3. Legacy Application Middleware
Middleware für Legacy Application in Pipeline integrieren
Middleware leitet bei erfolgreichem ZF3 Routing weiter
Andernfalls führt Middleware die ZF1 Legacy Anwendung aus
Beispiele
Startseite für ZF3 und restliche Seiten für ZF1 testen
ZF3 Startseite entfernen und ZF1 Startseite testen
Anwendung lauffähig machen

Legacy ZF1 Front-Controller
<?php
define('APPLICATION_PATH', realpath(dirname(__FILE__) . '/../legacy/application'));
define('PROJECT_PATH', realpath(dirname(__FILE__) . '/..'));
$hostParts = explode('.', $_SERVER['HTTP_HOST']);
switch ($hostParts[0]) {
case 'dev':
define('APPLICATION_ENV', 'development');
break;
case 'mobile':
define('APPLICATION_ENV', 'mobile');
break;
case 'www':
default:
define('APPLICATION_ENV', 'production');
break;
}
require_once PROJECT_PATH . '/vendor/autoload.php';
$application = new Zend_Application(
APPLICATION_ENV,
APPLICATION_PATH . '/configs/application.ini'
);
$application->bootstrap();
$application->run();

Expressive ZF3 Front-Controller
<?php
use InteropContainerContainerInterface;
use ZendExpressiveApplication;
define('APPLICATION_PATH', realpath(dirname(__FILE__) . '/../legacy/application'));
define('PROJECT_PATH', realpath(dirname(__FILE__) . '/..'));
$hostParts = explode('.', $_SERVER['HTTP_HOST']);
switch ($hostParts[0]) {
case 'dev':
define('APPLICATION_ENV', 'development');
break;
case 'www':
default:
define('APPLICATION_ENV', 'production');
break;
}
require_once PROJECT_PATH . '/vendor/autoload.php';
/** @var ContainerInterface $container */
$container = require PROJECT_PATH . '/config/container.php';
/** @var Application $application */
$application = $container->get(Application::class);

Legacy Application Middleware
namespace LegacyMiddleware;
use InteropHttpServerMiddlewareDelegateInterface;
use InteropHttpServerMiddlewareMiddlewareInterface;
use PsrHttpMessageServerRequestInterface;
use ZendDiactorosResponseHtmlResponse;
use ZendExpressiveRouterRouteResult;
class LegacyApplicationMiddleware implements MiddlewareInterface
{
public function process(ServerRequestInterface $request, DelegateInterface $delegate)
{
$result = $request->getAttribute(RouteResult::class, false);
if ($result instanceof RouteResult) {
return $delegate->process($request);
}
ob_start();
$application = new Zend_Application(
APPLICATION_ENV, APPLICATION_PATH . '/configs/application.ini'
);
$application->bootstrap();
$output = ob_get_contents();
ob_end_clean();
return new HtmlResponse($output);
}
}

4. Neue Test-Aktion & Design
Neue Test-Aktion anlegen (darf in Legacy Anwendung nicht existieren)
Eigene Route, eigene Middleware & eigenes Template
Layout der ZF3 Anwendung an ZF1 Anwendung anpassen
Ggf. weitere Anpassungen für korrekte Darstellung vornehmen
Neue Test-Aktion in ZF3 Expressive lauffähig machen
Sicherstellen, dass ZF1 Legacy weiterhin lauffähig ist

5. Ressourcen & Plugins portieren
Zend_Application Ressourcen nach ZF3 portieren
Zend_Controller Plugins nach ZF3 portieren
ZF1 Bootstrap Klasse nicht vergessen
Portierung in Konfigurationsdateien und Middleware Pipeline
Beispiele: Config für Datenbanken, Caching, Mailsettings, etc.
Plugins: Authentifizierung, Autorisierung, Internationalisierung, etc.

6. Aktionen migrieren
Erst nur eine Controller Action migrieren
Routing für Aktion in ZF3 Expressive definieren
Action Middleware erstellen mit Code aus Controller Action
Template aus ZF1 Anwendung in ZF3 Anwendung schieben
Aktion unter ZF3 lauffähig bekommen und ZF1 aufräumen
Mit allen anderen Aktionen fortfahren

7. ZF1 Komponenten ersetzen
ZF1 Komponenten schrittweise durch ZF3 Komponenten austauschen
Zend_Registry → ZendServiceManager (Dependency Injection)
Zend_Db → ZendDb (Modelklassen und Datenbankanbindung)
Zend_Form → ZendForm (Formulare)
Alle weitere ZF1 Komponenten durch ZF3 Komponenten austauschen
Alte Legacy Anwendung komplett entfernen

Teil 5Teil 5
Migration vom ZF2 MVC zu ZF3 MVCMigration vom ZF2 MVC zu ZF3 MVC

Migration ZF2 MVC ZF3 MVC→
Zend Framework Meta-Package entfernen1
ZF3 Service Manager installieren2
ZF3 Event Manager installieren3
ZF3 Mvc installieren4
Weitere ZF3 Komponenten installieren5

1. Meta-Package entfernen
Zend Framework Meta-Package aus composer.json entfernen
Zend Component Installer installieren
Aktuellste ZF2 Komponenten installieren

2. ZF3 Service Manager installieren
ZendServiceManager 3 installieren
In Controllern alle Abhängigkeiten injizieren
ServiceLocatorAwareInterface entfernen
Invokables → InvokableFactory
Service Identifier mit Klassennamen statt String
Migration Guide beachten

3. ZF3 Event Manager installieren
ZendEventManager 3 installieren
Migration abhängig vom Einsatz im Projekt
Vereinfachte API in trigger() Methoden
Entfernte Interfaces und Methoden beachten

4. ZF3 MVC installieren
Controller anpassen (siehe Service Manager)
Jeder Controller braucht (in der Regel) eine Factory
Integrationskomponenten beachten (Konsole, I18n, Plugins, etc.)
ZendMvc 3 installieren

5. Weitere ZF3 Komponenten
ZendStdlib 3 installieren
ZendConfig 3 installieren
ZendTest 3 installieren
ZendCode 3 installieren
ZendCrypt 3 installieren
ZendJson 3 installieren
ZendMath 3 installieren

Teil 6Teil 6
Migration vom ZF3 MVC zu ZF3 MiddlewareMigration vom ZF3 MVC zu ZF3 Middleware

Migration ZF3 MVC ZF3 MW→
ZendExpressive manuell installieren1
Module migrieren2
MVC Event Listener Middleware Pipeline→3
Projekt aufräumen4

1. ZendExpressive installieren
Verzeichnis der Skeleton Application aus Vorbereitungen öffnen
Composer-Konfiguration für ZendExpressive übernehmen
Anwendungskonfiguration übernehmen
Front-Controller anpassen
App Modul aus Skeleton übernehmen und Testen

2. Module migrieren
Config Provider anlegen
Konfiguration migrieren
Routen migrieren
Controller Aktionen Action Middleware migrieren→
Templates migrieren
Für alle Module wieder holen

3. MVC Event Listener migrieren
MVC Event Listener identifizieren
Für jeden MVC Event Listener eine eigene Middleware erstellen
Neue Middleware in Pipeline übernehmen
Beispiel: Authentifizierung, Autorisierung, Internationalisierung, etc.

4. Projekt aufräumen
ZendMvc deinstallieren
Alle alten MVC Bestandteile entfernen

Danke!Danke!
Fragen an ralf@travello.deFragen an ralf@travello.de

Migration zum Zend Framework 3

Recommandé

Recommandé

Contenu connexe

Tendances

Tendances (20)

Similaire à Migration zum Zend Framework 3

Similaire à Migration zum Zend Framework 3 (20)

Plus de Ralf Eggert

Plus de Ralf Eggert (20)

Migration zum Zend Framework 3