This article applies to:
[ Zend Studio for Eclipse 6.x, Zend Studio 7.x, Zend Studio 8.x ]
[ All operating systems ]
- When upgrading to a newer version of Zend Studio for Eclipse without resetting the workspace, you might have issues - from missing configurations, up to not using the bug fixes and features introduced in the newer version. In the worst case Zend Studio may fail to start.
- Workspace corruption may occur due to unclean shutdown of Zend Studio for Eclipse or due to problems in the software.
Changes in the Workspace, GUI elements, Plugins and Features may fail to migrate automatically between different versions of Zend Studio. Conflicting settings or broken settings may have all kinds of side-effects.
Resolution / Workaround
Creating a New Workspace
In case Zend Studio does not start, you need to move/delete the old workspace:
- Find the workspace directory. The default location is:
- Zend Studio for Eclipse 6.x in GNU/Linux and MacOS X - ~/Zend/workspaces/DefaultWorkspace
- Zend Studio for Eclipse 6.x in MS Windows - %USERPROFILE%\Zend\workspaces\DefaultWorkspace
- Zend Studio 7.x and Zend Studio 8.x in GNU/Linux and MacOS X - ~/Zend/workspaces/DefaultWorkspace7
- Zend Studio 7.x and Zend Studio 8.x in MS Windows - %USERPROFILE%\Zend\workspaces\DefaultWorkspace7
- Rename this directory. For example: rename 'DefaultWorkspace' to 'DefaultWorkspace_Backup'.
- Start Zend Studio. On startup the software will recreate the workspace directory and populate it with default settings.
If Zend Studio is able to start, it is recommended to create the new workspace from within Zend Studio:
- Open Zend Studio for Eclipse.
- Go to File | Switch Workspace | Other.
- Enter the path for new workspace in the Workspace Launcher dialog and click OK.
- Zend Studio will restart and create a new workspace in the directory you specified (the directory itself will be created too, if it does not exist).
Importing Projects into the New Workspace
The new workspace will start empty. You will have to import your projects into it:
- Go to menu File | Import.
- In the Import wizard, choose General | Existing Projects into Workspace on the Select page and click Next.
- Specify the current location of your projects on the Import Projects page and select the projects you want to import.
If you want to copy the projects into the new workspace, please check the Copy projects into workspace checkbox. Otherwise the projects will remain in their original location.
- Click Finish. The import process will start and may take much time, depending on projects' size and complexity.