Skip to content

[Setup] Add some missing items and hints about migrating from standard edition to Flex #9523

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 1 commit into from
Apr 16, 2018
Merged

[Setup] Add some missing items and hints about migrating from standard edition to Flex #9523

Changes from all commits
Commits
Show all changes
1 commit
Select commit
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
19 changes: 17 additions & 2 deletions setup/flex.rst
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -228,6 +228,12 @@ manual steps:
:doc:`autowiring feature </service_container/3.3-di-changes>` you can remove
most of the service configuration.

.. note::

Make sure your previous configuration files don't have ``imports`` declarations
pointing to same resources already loaded by ``Kernel::configureContainer()``
or ``Kernel::configureRoutes()`` methods.

#. Move the rest of the ``app/`` contents as follows (and after that, remove the
``app/`` directory):

Expand All @@ -236,8 +242,9 @@ manual steps:
* ``app/Resources/<BundleName>/views/`` -> ``templates/bundles/<BundleName>/``
* rest of ``app/Resources/`` files -> ``src/Resources/``

#. Move the original PHP source code from ``src/AppBundle/*`` to ``src/``. In
addition to moving the files, update the ``autoload`` and ``autoload-dev``
#. Move the original PHP source code from ``src/AppBundle/*``, except bundle specific
files (like ``AppBundle``, ``DependencyInjection\``), to ``src/``. Remove ``src/AppBundle/``.
In addition to moving the files, update the ``autoload`` and ``autoload-dev``
values of the ``composer.json`` file as `shown in this example`_ to use
``App\`` and ``App\Tests\`` as the application namespaces (advanced IDEs can
do this automatically).
Expand All @@ -261,6 +268,13 @@ manual steps:
#. Update the ``bin/console`` script `copying Symfony's bin/console source`_
and changing anything according to your original console script.

#. Remove ``bin/symfony_requirements`` script. If you need a replacement for the
task performed by this script, use `Symfony Requirements Checker`_:

.. code-block:: terminal

$ composer require symfony/requirements-checker

.. _`Symfony Flex`: https://github.com/symfony/flex
.. _`Symfony Installer`: https://github.com/symfony/symfony-installer
.. _`Symfony Standard Edition`: https://github.com/symfony/symfony-standard
Expand All @@ -272,3 +286,4 @@ manual steps:
.. _`shown in this example of the skeleton-project`: https://github.com/symfony/skeleton/blob/8e33fe617629f283a12bbe0a6578bd6e6af417af/composer.json#L44-L46
.. _`copying Symfony's index.php source`: https://github.com/symfony/recipes/blob/master/symfony/framework-bundle/3.3/public/index.php
.. _`copying Symfony's bin/console source`: https://github.com/symfony/recipes/blob/master/symfony/console/3.3/bin/console
.. _`Symfony Requirements Checker`: https://github.com/symfony/requirements-checker