Symfonylla on yksi hilpeä erityispiirre. Se on välillä aivan kammottavan omituinen ja takaperoinen dokumentaatio.
Version 1.2 uusimman betan uusien ominaisuuksien innostamana lähdin nimittäin sitä nyt päivittämään projektiin.
To upgrade a project:
* If you don't use a SCM tool, please make a backup of your project.
* Upgrade symfony to 1.2
* Launch the `project:upgrade1.2` task from your project directory
to perform an automatic upgrade:$ php symfony project:upgrade1.2
Tästähän voisi laiskempi päätellä, että homma hoituu antamalla tuo yllä mainittu komento. Vaan sepäs tuottaa ilmoituksen "task not defined" hienolla kirkkaan punaisella pohjalla.
Pienen äimistelyn ja googlauksen jälkeen selviää, että itseasiassa ylläoleva koskee toimintaa siinä vaiheessa kun Symfony on jo päivitetty versioon 1.2. Toiselta sivulta löytyykin informaatiota, että komennolla: pear install symfony/symfony-1.2.0BETA2 pitäisi uuden version asentua. Vaan eipäs menekään niin, PEAR toteaa, että sullahan on jo, että mitäs siinä asentelet. Myöskään upgrade-komento ei tuota tuloksia (varmaankin siksi, että kyseessä on beta).
Lopulta lottonumerot selviävät: pear uninstall symfony/symfony -> pear install symfony/symfony-1.2.0BETA2.
Osa hupailusta mene toki varmasti PEARinkin piikkiin, mutta ehkä tästä kaikesta olisi silti jotenkin voinut mainita myös Symfonyn omissa asennusohjeissa
Nyt sitten päästäänkin itse asiaan, eli tuon sovellusprojektin päivittämiseen 1.2 kelpoiseksi. Tätä prosessia kuvaileva .txt on 765 linea pitkä, joista toivottavasti ihan jokaisella ei ole mitään huipputärkeää asiaa. Mutta rämmitään eteenpäin, toisella puolella odottavat helpommat form-embeddaukset ja muutakin kivaa.