-
-
Couldn't load subscription status.
- Fork 5.3k
[Cache] Document "framework.cache" nodes #7245
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
[Cache] Document "framework.cache" nodes #7245
Conversation
3364073 to be1404b Compare 75a1819 to 492250f Compare | This needs to be fixed, it appears that the first few changed lines are broken. Status: needs work |
| Al cache settings should be documented instead of documenting only one of them. |
| * :ref:`cache <reference-serializer-cache>` | ||
| * :ref:`enable_annotations <reference-serializer-enable_annotations>` | ||
| * :ref:`name_converter <reference-serializer-name_converter>` | ||
| * `cache`_ |
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
Maybe here is why it's failing? It's misaligned...
492250f to 716f826 Compare 206ccc7 to fdd3b98 Compare | * `storage_id`_ | ||
| * `handler_id`_ | ||
| * `name`_ | ||
| * :ref:`name <session-name>` |
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
What was the reason for this change?
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
Because I added another name reference. As this leads to a warning (considered as an error by the build), I figured out that you have rename all your references this way.
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
Isn't it enough to only do that for the other added label with the same name?
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
Tested it and it failed ^^
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
Too bad, this means that the anchor used currently (http://symfony.com/doc/current/reference/configuration/framework.html#name) won't work in the future. Maybe @wouterj has an idea how we can prevent the loss.
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
@xabbuh adding the .. _name: label manually before the existing name option wouldn't work?
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
@javiereguiluz Might cause conflicts as these labels are global and not limited to the current document.
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
@javiereguiluz sounds like your solution worked :)
fdd3b98 to c1525c0 Compare 86f93e9 to cdf1046 Compare cdf1046 to 03d3e35 Compare | | ||
| **type**: ``string`` **default**: ``cache.app`` | ||
| | ||
| A cache adapter. |
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
This description should be improved to explain the purpose of this option. Thanks!
05dcff7 to ff46950 Compare ff46950 to 9cb31b2 Compare | @javiereguiluz Any idea why the deployment to platform.sh fails ? In any case, the PR is good for another review :) |
| @geoffrey-brier all the builds are failing ... but our friends at Platform.sh have already fixed the issue and provided two possible solutions. We're deciding which one to use. |
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
Looks good! Left a few minor comments that can be fixed during the merge.
| .. note:: | ||
| | ||
| The framework bundle ships with multiple adapters: apcu, doctrine, system, | ||
| filesystem, psr6, and redis. |
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
This note content should be added to the setting description imo
| default_psr6_provider | ||
| ..................... | ||
| | ||
| **type**: ``string`` **default**: ``%kernel.cache_dir%/pools`` |
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
default should be removed
| | ||
| **type**: ``string`` | ||
| | ||
| The service name to use as your default Doctrine provider. |
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
Maybe add the service name of this "default provider": "This is available as cache.doctrine service."
| | ||
| **type**: ``string`` **default**: ``%kernel.cache_dir%/pools`` | ||
| | ||
| The service name to use as your default PSR-6 provider. |
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
Same here: "This is available as cache.psr6 service"
| | ||
| **type**: ``string`` **default**: ``redis://localhost`` | ||
| | ||
| The dsn to use by the Redis provider. |
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
...and here: "This is available as cache.redis service"
| Your pool name must differ from ``cache.app`` or ``cache.system``. | ||
| | ||
| adapter | ||
| ####### |
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
These should be " as well
| Thank you very much for this great PR @geoffrey-brier and congratulations for your first contribution to the Symfony documentation. I have merged your PR into the |
| @xabbuh Thank you, very glad I could help ;) |
No description provided.