Skip to content

[DX] Cookbook Article for Upgrading Symfony #4172

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Closed
weaverryan opened this issue Aug 23, 2014 · 6 comments
Closed

[DX] Cookbook Article for Upgrading Symfony #4172

weaverryan opened this issue Aug 23, 2014 · 6 comments
Labels
actionable Clear and specific issues ready for anyone to take them. DX

Comments

@weaverryan
Copy link
Member

Upgrading Symfony is easy, but I'm not sure everyone realizes this.

http://symfony.com/blog/upgrading-your-symfony-projects-the-easy-way

I propose a quick (because it's easy!) cookbook article about upgrading Symfony:

A) How to upgrade a patch release e.g. 2.5.1 to 2.5.2 (e.g. composer update symfony/symfony).

B) How to upgrade a minor release e.g. 2.5.1 to 2.6.0

C) Details on how to handle dependency issues - i.e. if you try to upgrade to a new version of Symfony, but some other dependency you have is tied to the older version.

D) Other changes you'll need to make - i.e. check the UPGRADE file.... but really, nothing needs to be changed between versions.

@javiereguiluz
Copy link
Member

Upgrading the Symfony version is really easy ... but maintaining a fully working application after an upgrade it's another story. To be more precise, was another story when new Symfony versions included lots of BC breaks. Maybe that's the origin of the misconception that makes some developers think that upgrading Symfony is still difficult.

@wouterj
Copy link
Member

wouterj commented Aug 23, 2014

@javiereguiluz sometimes, there are still changes in the SE that you want to include in your SE. What about also publishing a patch with all changes when bumping the minor version?

@Nicofuma
Copy link
Contributor

By the way, a cookbook entry for upgrading Symfony from 2.3 to 2.4+ could be useful.

@carlos-granados
Copy link

Really love this. I never know how to upgrade

@weaverryan
Copy link
Member Author

See #4611!

weaverryan added a commit that referenced this issue Jan 3, 2015
This PR was submitted for the 2.6 branch but it was merged into the 2.3 branch instead (closes #4611).

Discussion
----------

Adding a guide about upgrading

| Q             | A
| ------------- | ---
| Doc fix?      | no
| New docs?     | yes
| Applies to    | 2.6+
| Fixed tickets | #4172

Hi guys!

First, the plan is to merge this into 2.6, then backport it to 2.3 (just remove the 2.5 and 2.6 sections about upgrading).

I put this together fairly quickly, and I would really like comments. I've been in front of the computer for awhile, so I'm not convinced this is quite as smooth yet as I'd like it to be!

Overall, I want to fix the issue of "How to I upgrade". We'll say - just go to this page, and it'll walk you through the steps, and even reassure you that you don't need to make any changes to your code (or, you only need to make these very specific changes).

Thanks!

Commits
-------

9701e46 Adding missing index/map documents
ca1e7df [#4611] A few more tweaks and fixes
e6b3f13 Basically copying a section about upgrading other libraries down into the minor version section
8195a66 [#4611] Removing a few entries I meant to remove before
92b4310 [#4611] Making many tweaks thanks to guys like Javier, Wouter, Christian (xabbuh) and Stof
f86b9c9 Adding a guide about upgrading
@weaverryan
Copy link
Member Author

Done! @javiereguiluz we could include a link to the new document on release blog posts ;).

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
actionable Clear and specific issues ready for anyone to take them. DX
Projects
None yet
Development

No branches or pull requests

5 participants