10000 Added a new article about using/installing unstable Symfony versions by javiereguiluz · Pull Request #5186 · symfony/symfony-docs · GitHub
[go: up one dir, main page]
Skip to content

Added a new article about using/installing unstable Symfony versions #5186

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.

Sign up for GitHub

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

Merged
merged 15 commits into from
Jun 27, 2015
Merged

Added a new article about using/installing unstable Symfony versions #5186

Changes from 1 commit
Commits
Show all changes
15 commits
Select commit Hold shift + click to select a range
402f5d4
Added a new articule about using/installing inestable Symfony versions
javiereguiluz Apr 17, 2015
df22b75
Fixed typo: "inestable" -> "unstable"
javiereguiluz Apr 17, 2015
2722933
Fixed articles links
javiereguiluz Apr 17, 2015
719e52c
Added the missing file extension
javiereguiluz Apr 17, 2015
6d6303c
Fixed a minor error in some index file
javiereguiluz Apr 17, 2015
724c17f
Simplified instructions
javiereguiluz Apr 17, 2015
e1f621e
Added a new entry in the redirection_map
javiereguiluz Apr 17, 2015
caff8d2
Minor rewording
javiereguiluz Apr 17, 2015
a9fee2f
Fixed a link to an internal document
javiereguiluz Apr 17, 2015
bae8043
Fixed the beta version constraints
javiereguiluz Apr 17, 2015
038caa5
Fixed minor issues
javiereguiluz Apr 17, 2015
d5f3d82
Minor improvement in a command
javiereguiluz Apr 19, 2015
224c380
Fixed a lot of issues pointed by Ryan
javiereguiluz May 23, 2015
1378ec9
Added a note about the Symfony Upgrading Guide
javiereguiluz May 23, 2015
8e8fad2
Removed some wrong labels
javiereguiluz Jun 23, 2015
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
Prev Previous commit
Next Next commit
Simplified instructions
  • Loading branch information
@javiereguiluz
javiereguiluz committed May 30, 2015
commit 724c17ff1dfaca92f410700675ed78c966b59cea
30 changes: 8 additions & 22 deletions cookbook/install/unstable_versions.rst
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -41,41 +41,27 @@ Symfony application to an unstable framework version. Suppose again that Symfony

First, open the ``composer.json`` file located in the root directory of your
project. Then, edit the value of the version defined for the ``symfony/symfony``
dependency:
dependency as follows:

.. code-block:: json

{
"require": {
// ...
"symfony/symfony" : "2.7.*"
"symfony/symfony" : "2.7.*@dev"
}
}

Then, before updating your dependencies, make sure that the project configuration
allows to install unstable versions. If the ``composer.json`` file contains a
``minimum-stability`` option, change its value to ``dev``. If that option doesn't
exist, add it as follows:

.. code-block:: json

{
"require": {
// ...
"symfony/symfony" : "2.7.*"
},
"minimum-stability": "dev"
}

If you prefer to test a Symfony beta version, replace the ``dev`` value of the
``minimum-stability`` option by ``beta``.

Then, open a command console, enter your project directory and execute the following command to update your project dependencies:
Then, open a command console, enter your project directory and execute the following
Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Then -> Finally, because we just used Then in the previous sentence

command to update your project dependencies:

.. code-block:: bash

$ composer update
Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Do we really want to update all packages? What about running composer update symfony/symfony instead?

Copy link
Member Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Much better!!! Thanks.


If you prefer to test a Symfony beta version, replace the ``"2.7.*@dev"`` constraint
by ``"2.7.*@beta1"`` (or any other beta number).
Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

you cannot put a beta number in the stability flag. It is either 2.7.0-beta1 (i.e. explicit version constraint for a single version, which automatically adds a stability flag for thet package given it is a root requirement involving a beta version), or 2.7.*@beta (getting the most recent version of Symfony being at least in beta stability)

Copy link
Member Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Thanks for the explanation. I've reworded as:

If you prefer to test a Symfony beta version, replace the ``"2.7.*@dev"`` constraint
by ``"2.7.0-beta1"`` to install a specific beta number or ``2.7.*@beta`` to get
the most recent beta version.


.. tip::

If you use Git to manage the project's code, it's a good practice to create
Expand All @@ -87,7 +73,7 @@ Then, open a command console, enter your project directory and execute the follo

$ cd projects/my_project/
$ git checkout -b testing_new_symfony
// update composer.json configuration
// ... update composer.json configuration
Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more. 

# ... update composer.json configuration

$ composer update
Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

You can then use composer update symfony/symfony here too.


// ... after testing the new Symfony version
Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more. 

# ... after testing the new Symfony version

Expand Down
0