HowToUpgradeToLatestBeta (diff)

You must first sign up to be able to contribute.

Changes between Version 25 and Version 26 of HowToUpgradeToLatestBeta

GaryFx (IP:
11/04/08 19:23:20 (9 years ago)

Make this page into an orphan


  • HowToUpgradeToLatestBeta

    v25 v26  
    1 = How to upgrade your project
     1= How to upgrade the latest Beta
    3 == Latest beta or release candidate == 
    4 All documentation resources on 1.1 can be found at: 
    5  * [wiki:Symfony11 symfony 1.1 resources] 
     3This page is orphaned, partly because it would need to be totally rewritten for every new beta, and partly because the upgrade instructions are now being done in the installation documentation, not the wiki.  The links below are left for convenience. 
    7 The following upgrade instructions are under construction.  They're essentially a wikified version of the UPGRADE file in the repository.  They're here a) to make them easier to read (monospaced fonts are harder to read), and b) to have a  one page checklist that's easier to use for managing the upgrade process.  '''''Always''''' check the UPGRADE file as well, in case any changes there didn't not get carried over here. 
    9 === New Prerequisites === 
    11 * PHP 5.1 or greater is required for symfony 1.1 
    13 === Upgrade Steps === 
    15  1. Check your current plugins to see if they have 1.1 versions available.  If not, you may wish to defer upgrading. 
    16  1. Backup your project. 
    17   a. Some files, such as the front controllers, are likely to need merges, so a backup is critical. 
    18   a. To be really safe, consider backing up your database as well as the project. 
    19   a. If you keep your project in Subversion or other source code management system, you may not a separate backup, but you should make sure all of your files are checked in before starting an upgrade. 
    20  1. Download or install the [ latest release candidate] using whichever mechanism you currently use.  
    21    a. '''Note:''' If you use a source download (i.e., tar file), you don't need to unpack it on top of your previous symfony tree.  Just configure symfony to use it from wherever you unpacked it, as described in the next two steps. 
    22    a. '''Note:''' If you checkout directly from the symfony subversion repository, then you can use a new working copy or simply [ switch] your current one.  If you switch your current working copy, first check to see if there are any modified or new files. 
    23  1. Manually [wiki:Upgrade1.1-PatchSymfonyFile patch your symfony] file 
    24  1. Manually create a [wiki:Upgrade1.1-CreateProjectConfig ProjectConfiguration.class.php] file, customizing it to point to your symfony 1.1 installation. 
    25   a. WARNING: If you're an early adopter and already have a {{{ProjectConfiguration.class.php}}} file, you may need to manually upgrade it anyway due to later changes during 1.1 development. 
    26  1. Run the [wiki:Upgrade1.1-ProjectUpgradeTask project:upgrade1.1 task] 
    27  1. [wiki:Upgrade1.1-ReviewLog Review the log] of your project:upgrade1.1 task, to see if you need to make manual edits.  Some of these are discussed below. 
    28  1. Check and upgrade your configuration: 
    29     a. Migrate any [wiki:Upgrade1.1-ConfigPHP config.php settings].  The {{{config.php}}} files are no longer used in 1.1, but must be deleted manually.  These will be mentioned in the log of the upgrade1.1 task. 
    30     a. Confirm that the [wiki:Upgrade1.1-RoutingModule new routing configuration], found in {{{factories.yml}}}, is what you want.  (This is the configuration of the ''routing module'', not the individual routing rules in your {{{routing.yml}}} files.) 
    31     a. Confirm that the logging configuration, now found in factories.yml, is what you want. 
    32     a. Upgrade your i18n configuration.  The i18n.yml file is obsolete, so you'll need to make changes in factories.yml and/or settings.yml. 
    33     a. Upgrade your [wiki:Upgrade1.1-SessionTimeout session timeout] setting if necessary. 
    34     a. Check your php configuration using check_configuration.php, preferably from the web.  The php.yml file has been removed. 
    35  1. Turn on [wiki:Upgrade1.1-CompatibilityMode compatibility mode] if you're not planning on upgrading the validation or mailing systems. 
    36  1. Review your code for incompatibilities. 
    37    a. Upgrade your batch scripts manually if you still wish to use them.  The initial lines of batch scripts must be changed. 
    38      i. Review your batch scripts for subframeworks whose configuration and loading mechanisms have changed: 
    39         * sfDatabaseManager 
    40         * sfI18N 
    41         * sfPatternRouting 
    42    a. Double check your custom php files.  In addition to your modules and model files, don't forget your shared files (i.e., in {{{apps/*/lib}}}), and any custom generator templates (in {{{data/generator}}}). 
    43    a. Here are the documented incompatibilities: 
    44      i. Upgrade your use of [wiki:Upgrade1.1-NewFactories sfI18N, sfRouting, and sfLogger]. 
    45      i. If you referred to the VERSION file in code, you'll need to use the SYMFONY_VERSION constant instead. 
    46      i. Review your code for changes in routing that may be needed. 
    47      i. Core classes don't return internationalized strings anymore.  Review your code to see if you need to add explcit i18n calls. 
    48      i. If you're not using compatibility mode, review your code for [wiki:Upgrade1.1-DeprecatedMethods deprecated methods]: 
    49        * sfAction 
    50        * sfRequest 
    51        * sfWebRequest 
    52      i. The initialize method is now called automatically from {{{__construct}}} methods.  Review your code for any calls on initialize that need to be removed or changed. 
    53      i. Check your code for references to $sf_symfony_data_dir that need to be fixed.  That variable has been removed, and the files relocated to the lib directory. 
    54      i. Check your usage of sfLoader and sfCore. 
    55      i. Upgrade your front controllers (index.php, backend.php, etc.) 
    56      i. Check your usage of sfConfig constants that end with _dir_name.  These have been removed. 
    57      i. Check your usage of cache keys. 
    58      i. Manually upgrade your layout.php files. 
    59      i. If you've scripted the use of any symfony command line tasks, you'll need to [wiki:NewTaskNames1.1 upgrade the task names]. 
    62 == outdated information == 
     5 * [ Upgrade symfony from 1.1 to 1.2] 
     6 * [wiki:HowToUpgradeToVersion1.1 Upgrade symfony from 1.0 to 1.1].  See also the [ installation section upgrade instructions.] 
    647 * [wiki:HowToUpgradeToVersion1 Upgrade symfony 0.7.1914 to 1.0beta-1] 
    65  * [wiki:HowToUpgradeToVersion1.1 Upgrade symfony from 1.0 to 1.1]