Sunshine php practical-zf1-zf2-migration


Published on

One thing we do at Zend is provide consulting services to companies around the world, and many of those consulting engagements involve planning migrations from ZF1 to ZF2. Learn some techniques that we have found work quite well to help ease that migration effort and answer questions like "What are the low hanging fruit? How can I reuse ZF1 resources in a ZF2 application?" We shows the codez!

Published in: Technology
1 Like
  • Be the first to comment

No Downloads
Total views
On SlideShare
From Embeds
Number of Embeds
Embeds 0
No embeds

No notes for slide

Sunshine php practical-zf1-zf2-migration

  1. 1. Practical ZF1 to ZF2 Migration: Lessons from the Field Clark Everetts, Zend Technologies, Inc. Sunshine PHP Uncon
  2. 2. What are we going to talk about? Higher-Level (ROI, Organizational, Planning, Goals, Constraints) Getting from Here Suggestions / Best Practices to Here Lower-Level (Coding Suggestions, Tools, Resources, Best Practices) 2
  3. 3. Who am I? •Clark Everetts – Professional Services Consultant for Zend Technologies – Onsite and Remote Consulting – Linux, IBM iSeries, Windows ● Software Architecture Audits and Code Reviews ● Performance Audits ● Continuous Delivery Assessments Online / Onsite Training in PHP, ZF, Studio, Server, etc. – SmartStarts: Training and Onsite Guided Development •Past Life: Independent Consultant (2002 - 2012) – Web Sites and Web Applications – Contract Instructor for Zend •Past, Past Life: Contractor for US Army and NASA (1990 - 2002) – Interceptor Ground Control Software; Green Screen Db Applications – – 3 Space Station: Real-time, Embedded Software; Science Platforms, Life Support
  4. 4. Who are You? • Your role: Manager, developer, stakeholder/decision-maker? • Size: Small to large companies; small to large dev teams • Have you migrated applications from ZF1 to ZF2? • Migrating now? How far along in the process are you? • What challenges did you face / are you facing? • What tools did you use, or wish existed? • What did you do before you started? • Did you expect to accomplish anything besides “the migration?” 4
  5. 5. What (I think) You Want to Know •Available Tools? How much do they do? •Low-hanging fruit; most difficulties? •Cost/Benefit? Expected gains? – Short-term? – Long-term? – When not to migrate? •How to plan a migration; what factors affect the planning? •Developer skills / skill levels required? •Budget, schedule is expected for a given project size? •Other resources?
  6. 6. Where this talk comes from • Zend's Collective Experience – 6 Planning, Guiding, Implementing Migrations
  7. 7. The Prospect of Migration... 7
  8. 8. Decisions, decisions... • Write new ZF2 application from scratch? • Run ZF1 and ZF2 side-by-side? – Use ZF2 components in existing ZF1 application – Use ZF1 components in new ZF2 application – Some URLs (existing capabilities) ZF1, with other URLs (entirely new features) implemented in ZF2 – Convert models, controllers, utility functions, helpers, etc. • Which ZF2 components are easiest to use in a ZF1 app? 8
  9. 9. More Decisions! •New URLs for new features of application: can do in ZF2, but will likely rely upon existing ZF1 models, helpers, etc., especially if you took the effort to make those components reusable in the first place •Build and test ZF2 version and then cut over from old site to new one, or iterate existing ZF1 production site into a new ZF2-based site? •Select a minimum PHP version – PHP 5.3.3 is minimum for ZF2; current are 5.5.4 and 5.4.20. PHP 5.3.27+ will receive only security fixes through much of 2014 (Zend supports PHP 5.2 for Enterprise customers on particular product versions; will continue to support PHP 5.3) – Consider most recent PHP version you can; this implies parallel migrations (PHP version as well as ZF2), Look at for removal of /changes to legacy features and new capabilities – Consider impact to other PHP apps on the server
  10. 10. No One Migration Strategy to Rule Them All * There is no single, one-size-fits all, “correct” migration path for all applications and organizations. Many factors, including project size, team size and experience with ZF1 and ZF2, structure and quality of the ZF1 codebase, all affect the path to take. * 10
  11. 11. Remember the Planned Migration Layer? •Remember the planned Migration Layer? – Was to allow ZF1 code to run on the ZF2 “engine” – Work started during ZF2 betas; too much change between beta releases to keep such a tool current – Emulating ZF1 behaviour in ZF2 would have taken unacceptable amount of developer time away from ZF2 development •Though many people desired it, a full Migration Layer isn't strictly necessary – PHP 5.3 Namespaces – Migration: tedious, but not as hard as you think ● Depends on the code you're starting with! ● Fat controllers w/ data access, business logic, HTML :-(
  12. 12. Some Tools Exist to Help •ZF2 Documentation Page ● GitHub: EvanDotPro/zf-2-for-1 ZF2 Form View Helpers, could be extended to other features Check out the forks, which have more features. – • Not for the long-term; it is a deliberately temporary solution! GitHib: prolic/HumusMvcSkeletonApplication integrates ModuleManager and ServiceManager into ZF1 application See
  13. 13. ZF1 Compatibility Module - Overview • Custom ZF2 Module that you write – simple, straightforward • Use existing ZF1-based application resources with minimal initial code rewrite: – Database – Translation – Session • That is, Any Zend_Application_Resource plugin • Obtain and use these resources as ZF2 Services via ServiceManager • Only for Application-wide, “global” resources 13
  14. 14. The Prospect of Migration... Starting to Feel Better? 14
  15. 15. Planning • What you do depends on what you want – Delay a complete rewrite ● – Phased approach, reusing much of your ZF1 code Refactor and clean up “bad” code • Smaller Application, perhaps non mission-critical – 15 Rewrite, use as a learning experience for a larger migration effort
  16. 16. ZF1 Compatibility Module – Add Module to config // config/application.config.php 'modules' => array( 'Application', 'Zf1', // <-- your ZF1 compatibility module // you will add other modules to the list as you progress ), // remainder of config array 16
  17. 17. ZF1 Compatibility Module – Autoload ZF1 Classes // module/Zf1/Module.php namespace Zf1; use ZendModuleManagerFeatureAutoloaderProviderInterface; use ZendMvcMvcEvent; class Module implements AutoloaderProviderInterface { public function getAutoloaderConfig() { $zf1path = getenv('ZF1_PATH'); // SetEnv in Apache vhost/.htaccess if (!$zf1path) { throw new Exception('Define ZF1 library path'); } /// more coming... 17
  18. 18. ZF1 Compatibility Module – Autoload ZF1 (cont.) // module/Zf1/Module.php getAutoloaderConfig() return array( 'ZendLoaderStandardAutoloader' => array ( 'namespaces' => array( __NAMESPACE__ => __DIR__ . '/src/' . str_replace('', '/', __NAMESPACE__) ), 'prefixes' => array('Zend' => $zf1path) ) ); 18
  19. 19. ZF1 Compat. Module – Resources become Services // module/Zf1/config/module.config.php 'service_manager' => array ( 'factories' => array( 'zf1-db' => 'Zf1ServiceFactoryDatabase', 'zf1-translate'=> 'Zf1ServiceFactoryTranslate', // other ZF1-based resources... ), 'aliases' => array ( 'translate' => 'zf1-translate', ) ) 19
  20. 20. ZF1 Compat. Module – Factories to Create Services namespace Zf1ServiceFactory; use ZendServiceManager; class Database implements ServiceManagerFactoryInterface { } 20 public function createService( ServiceManagerServiceLocatorInterface $serviceLocator ) { $config = $serviceLocator->get('config'); $adapter = Zend_Db::factory( $config['zf1-db']['adapter'], $config['zf1-db']['params'] ); return $adapter; }
  21. 21. ZF1 Compatibility Module – Register the Services // module/Zf1/Module.php public function onBootstrap(MvcEvent $e) { $services = $e->getApplication()->getServiceManager(); $dbAdapter = $services->get('zf1-db'); Zend_Db_Table_Abstract::setDefaultAdapter($dbAdapter); // Perhaps your views need config. For now, in views, access config // directly via registry. Later, use code that injects config into view $config = $services->get('config'); Zend_Registry::set('config', Util::arrayToObject($config)); // In audits, we often find ZF1 models accessing the db via registry // What you see here is not “best practice,” but a baby step toward // injecting this dependency in a later phase of migration $database = $services->get('zf1-db'); Zend_Registry::set('database', $database); $services = $e->getApplication()->getServiceManager(); Zend_Registry::set('session', $services->get('auth')->getStorage()>read()); } 21
  22. 22. ZF1 Compatibility Module – Review • Temporary, stop-gap measure for reusing ZF1 resources • Avoids major up-front rewrite • Obtain and use these resources as ZF2 Services via ServiceManager: – Add it to the list of modules used by your ZF2 app – Set up autoloading to find ZF1 library – Identify Resources as Services to the ServiceManager – Write Factories to create the services – Register the Services • Only for Application-wide, “global” resources • Remember: This Module will GO AWAY in a later phase! 22
  23. 23. General Migration Practices - MWOP • Do as much as practical to separate your business logic OUT of your controllers. Controllers should be thin, and primarily gather arguments to pass to the domain model, and then gather the response to pass on to the view. • Try to remove use of plugins such as "ActionStack" and "Forward" whenever possible. The latter has an equivalent in ZF2 but operates slightly differently; ActionStack is unnecessary, as you can directly call on other controllers more easily in ZF2. • Rewrite a module at a time; this will help you identify patterns for migration, and give you confidence as you go forward. • Make sure you identify any dependencies on other modules early, so you can migrate cleanly. Avoids major up-front rewrite. • This talk shows how you can map ZF1 "application resources" as services in ZF2. • A module to bootstrap ZF1 config, autoloading, and resources makes it 23 easier to re-use resources written for ZF1 inside a ZF2 app; the bulk of the work of migration will then be in the MVC, particularly in controllers and forms.
  24. 24. The Prospect of Migration... How are you feeling? 24
  25. 25. Reusing ZF1 Configuration - Overview • ZF1 Configuration – .ini, .xml, .json, .yaml • ZF2 Configuration – arrays • Reuse existing ZF1 configuration files in ZF2 application 25
  26. 26. Reusing ZF1 Configuration - .ini files // module/SomeModule/Module.php public function getConfig () { $path = __DIR__ . '/config/config.ini'; $config = new Zend_Config_Ini($path, $section); $oldConfig = $config->toArray(); if (defined('ZF1_COMPAT')) { $oldConfig['zf1-db'] = $oldConfig['db']; } // Fix 1: for the database options $dbParams = array ('driver' => $oldConfig['db']['adapter']); $dbParams = array_merge($dbParams, $oldConfig['db']['params']); $oldConfig['db'] = $dbParams; } 26 $phpConfig = include __DIR__ . '/config/module.config.php'; return array_merge($oldConfig, $phpConfig);
  27. 27. Reuse ZF1 Models - Autoloading // module/SomeModule/Module.php public function getAutoloaderConfig () { return array( 'ZendLoaderClassMapAutoloader' => array( __DIR__ . '/autoload_classmap.php' ), 'ZendLoaderStandardAutoloader' => array ( 'namespaces' => array( // if we're in a namespace deeper than one level we need to // fix the in the path __NAMESPACE__ => __DIR__ . '/src/' . str_replace('', '/', __NAMESPACE__) ), 'prefixes' => array(// This goes away in later phase 'Model' => __DIR__ .'/src/' . str_replace('', '/', __NAMESPACE__) . '/Model', ) ) ); } 27
  28. 28. Reuse ZF1 Models – Merge config with ZF2 config // module/SomeModule/Module.php public function getConfig () { include __DIR__ . '/config/config.php'; Opportunity $path = __DIR__ . '/config/config.ini'; $config = new Zend_Config_Ini($path, $section); $oldConfig = $config->toArray(); for refactoring if (defined('ZF1_COMPAT')) { $oldConfig['zf1-db'] = $oldConfig['db']; } // database options from db section of config.ini $dbParams = array('driver' => $oldConfig['db']['adapter']); $dbParams = array_merge($dbParams, $oldConfig['db']['params']); $oldConfig['db'] = $dbParams; } 28 $phpConfig = include __DIR__ . '/config/module.config.php'; return array_merge($oldConfig, $phpConfig);
  29. 29. Thank You! Please give constructive feedback at Email: Twitter: @clarkphp