How to migrate a Craft 2 project to Craft 3?
Craft 3 update changed a lot of things. Added functionalities aside, the process of installing and maintaining the CMS also changed with this breakpoint release.
Craft 3 almost makes it necessary to migrate your website from Craft 2. It is better in every aspect, including security and the extended plugin store. The store comes with plugin trials and 30-day license return policy.
For the incremental updates, you just had to click on a button. But with the breakpoint release, Craft CMS tweaked its ways of handling things.
It is advised to get an expert’s help for the migration because there are a lot of things that can go wrong with the migration, for instance:
- Control panel prompting to install Craft instead of the update database dialogue.
- Database configuration settings which are no longer needed
Also, to avoid errors, you have to follow the same naming schemes that were used in your old database; like using same prefixes with the new database connection settings.
There are two steps involved in the migration process of a Craft 2 project.
- Craft 3 Installation
- Manual Migration
Step 1: Craft 3 Installation
To install Craft 3, follow the same steps as mentioned in ‘How to setup a new Craft CMS project’ and then proceed with the migration.
You need to take care of the following requirements before proceeding with the installation:
- Craft 3 requires PHP 7+ and at least 256 MB of memory for PHP
- The installation requires Craft 2.6.2788
- Make sure that your plugins are ported to Craft 3 (check the status at the bottom of the update page)
- Keep a backup of your old database.
After the installation, proceed with the migration process. According to the Craft 3 upgrade documentation following are the steps you need to follow to migrate your Craft 2 project to Craft 3.
Step 2: Manual Migration
Import your database connection settings from your old database file craft/config/db.php to your .env file in the Craft 3 directory.
Now copy the following settings and configuration files from the old Craft 2 directory to the new Craft 3 directory.
- Copy settings from craft/config/general.php to config/general.php
- Copy craft/config/license.key file to config/
- Copy configuration files from craft/config/redactor/ to config/redactor/
- Copy files from craft/storage/rebrand/ to storage/rebrand/
- Copy photos from craft/storage/userphotos/ to storage/userphotos/
- Copy templates from craft/templates/ to templates/
- Copy the changes made, if any, from public/index.php file to web/index.php file
- Copy other files from old public/ to web/ directory.
After copying the files to the web/directory, update the web server to point to it. Enter the Craft’s control panel URL in the browser. It should prompt you to update your database.
Known problems with the migration from Craft 2 to Craft 3
If all goes well you will be able to run the latest Craft 3 with your old database intact. If not then you might be facing the following problems.
Craft installer pops up when accessing the control panel
Your old database connection settings are not matching with the new .env file. It is most likely happening because of a wrong DB_TABLE_PREFIX.
“Setting unknown property: craft\config\DbConfig::initSQLs” error.
The initSQLs database configuration setting was used in Craft 2 to fix MySQL 5.7 support. It is redundant in Craft 3. Remove the line beginning with ‘initSQLs’ in the config/db.php file to delete the setting.
To avoid major hassles and loss of database, it is recommended that you get a Craft partner onboard. In case you have further queries, you can connect with our Craft CMS experts here.
By Evnisha Malani
About Galaxy WeblinksWe specialize in human-centric user experience design services to our clients across the globe. Our innovative ideas, creative designs, industry best practices, and processes help us improve user satisfaction and solve complex design problems. Contact us for a free consultation!
Craft is a mature and tested content management system. Airbnb, W3C, Netflix, PBS, Salesforce, Moz, and countless other brands switched to Craft CMS for redesigning…CMS Frontend Website Development
At Galaxy Weblinks, we build high-performing software solutions that help teams scale. And write about it in the process. You may have spotted us on…Best Practices Design Ecommerce Web
This article is an assessment and comparison of the popular content management systems WordPress, Drupal, and Craft. We’ll dig into each CMS platform’s features, ease…CMS
Developers use Text Editors, also known as code editors, for editing programming code. These editors basically contain features like quick navigation, syntax highlighting, automatic indenting,…App Developement Web
Your business is growing and your team is doing their best to meet the tight deadlines and increased workload. You may be exploring the idea…App Developement Web
Voice search is at its peak in popularity among millions of users. According to an OC&C Strategy Consultants market research, Voice Shopping is projected grow…Ecommerce Web
Hello (Inserts your First name), All of us have received emails/ sms notifications, social media ads, that are sharing offers and discounts on the products…Ecommerce Web
The recently released WordPress 5.4 ‘Adderley’ update has got a lot to look forward to! Since this highly popular CMS ditched its classic editor for…CMS Web
Today, websites are more than just a ‘set-it-and-forget-it’ proposition. They are marketing machines that help you get new customers and leads. You might be planning…CMS
Modern technology has two problems: Devices have too many integrated features and everything is smaller. A good implementation of more-than-what’s-necessary features can give some users…App Developement Others Web
What is common between Pinterest, Tinder, Uber, Trivago, and Airbnb? All these companies experienced a surge in their product’s performance, user-engagement, and conversions by going…Mobile PWA Web
Kotlin has emerged as both substitute and supplement to C++ and Java. In 2018, the language had over 96,000 repositories on GitHub and had already…App Developement Galaxy Apps Others Web
When you think of hotspots for tech, don’t zero in on Silicon Valley just yet. According to Expert Market, Boston is one of the top…Galaxy Apps Internet Marketing Others Web
The experience of Disneyland is always an awe-inspiring one. No matter how many miles you have walked, you are always up for another Pirates of…Galaxy Apps Others Product Development Web
Google Play set out many criteria in their app guidelines that you need to follow. These changes may cause some issues as you try to…Galaxy Apps Mobile Others Web
Leading the AR revolution, industrial enterprises are experiencing improved ROI through AR-optimized supply chain. Enterprise sector is using AR across other functions such as product design…AR Galaxy Apps Others Web
Apple in its annual WWDC made some game changing announcements like a new Mac Pro, an exclusive OS for iPad, iOS 13 release, new Apple…Apple Galaxy Apps Others Web
At the time of an unsuccessful product deployment, you might ask yourself. “What went wrong with the product delivery?” The simple answer lies in configuration…Galaxy Apps Others Product Development Web
You might be familiar with Murphy’s law which says ‘Anything that can go wrong, will go wrong’. Software isn’t immune to that. But that’s often…Galaxy Apps Others QA Web
When you look at the respective market share of both the CMSs, WordPress has a clear edge over Craft CMS with 81.9% market share to a…CMS Galaxy Apps Others Web
Angular 6, released earlier in May 2018 didn’t offer much improvements on the performance part. It was mainly focused on making Angular migration-friendly. Google dropped…Frontend Galaxy Apps Others Web
Magento announced that it is pulling the plug on Magento 1 in April 2017 at the ‘Meet Magento’ conference in Prague. The announcement caused a…Ecommerce Galaxy Apps Others Web
Building a WordPress website? The WordPress community provides you with plenty of options. You can either make an easy one using WordPress themes or a…Galaxy Apps Others Web Website Development
Facebook has finally decided to monetize WhatsApp. Earlier this month, on August 1, Facebook rolled its long-in-development WhatsApp Business API for medium to large businesses.…Galaxy Apps Others Web
Craft CMS’s consistency can be seen in its regular updates & latest features. Matrix is one of those early features that helped Craft dominate the…CMS Galaxy Apps Others Web
Before introducing the Debug Tool in Craft 3, Craft CMS made you install a separate web-based application, Web-Console. You could run shell commands on your…CMS Galaxy Apps Others Web
Investors have the money, you have the idea, and the right pitch is the only thing that stands between you and them. But, pitches are…Galaxy Apps Others Product Development Web
“Personal data shall be processed in a manner that ensures appropriate security of the personal data, including protection against unauthorized or unlawful processing and against…Galaxy Apps Others Web
Google recently announced Mobile-First Indexing after a year and half of extensive experimenting and testing. The search engine giant will start migrating sites that follow…App Developement Galaxy Apps Others Web
Social media networks are mode of social interaction. It is a platform of sharing and discussing information among human beings. Social media can include text,…Internet Marketing Social Media Web