Skip to content
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

Jump to bottom

Modernize documentation #618

Merged
merged 16 commits into from
Mar 21, 2020
Merged

Modernize documentation #618

Changes from 1 commit
Commits
Show all changes
16 commits
Select commit Hold shift + click to select a range
b695fc4
Update links
SzymonKaminski Feb 17, 2020
0326f26
Reword sentences to avoid belittling words
SzymonKaminski Feb 17, 2020
ec3a593
Fix typos, reword unclear sentences
SzymonKaminski Feb 17, 2020
ea2c867
Remove usage of bundles
SzymonKaminski Feb 17, 2020
78c0f86
Adjust code blocks to Symfony Flex
SzymonKaminski Feb 17, 2020
f0e6b82
Adjust code blocks to coding standard
SzymonKaminski Feb 17, 2020
1ff2aba
Add notes about using environment variables
SzymonKaminski Feb 17, 2020
3114e3f
Update links to Form, Security components
SzymonKaminski Feb 17, 2020
6a056cc
Add `replicaSet` option explicitly with link to driver's manual page
SzymonKaminski Feb 17, 2020
71e4b28
Remove blank line after twig comment with name of file
SzymonKaminski Feb 28, 2020
cf02003
Add missing articles
SzymonKaminski Feb 28, 2020
f9515a4
Add backticks around %kernel.project_dir%
SzymonKaminski Feb 28, 2020
b04df6b
Restore code-block with mongodb_server parameter
SzymonKaminski Feb 28, 2020
d3c7e93
Add missing hyphens for 'An Introductory Example: A Product' heading
SzymonKaminski Feb 28, 2020
0c00884
Add missing code-block definition and comma in authentication section
SzymonKaminski Feb 28, 2020
8d72c38
Restore 'easiest' and remove redundant 'of course'
SzymonKaminski Feb 28, 2020
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
15 changes: 12 additions & 3 deletions Resources/doc/config.rst
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -363,7 +363,7 @@ Connecting to a pool of mongodb servers on 1 connection

It is possible to connect to several mongodb servers on one connection if
you are using a replica set by listing all of the servers within the connection
string as a comma separated list.
string as a comma separated list and using ``replicaSet`` option.

.. configuration-block::

Expand All @@ -373,7 +373,7 @@ string as a comma separated list.
# ...
connections:
default:
server: "mongodb://mongodb-01:27017,mongodb-02:27017,mongodb-03:27017"
server: "mongodb://mongodb-01:27017,mongodb-02:27017,mongodb-03:27017/?replicaSet=replSetName"
malarzm marked this conversation as resolved.
Show resolved Hide resolved

.. code-block:: xml

Expand All @@ -386,13 +386,18 @@ string as a comma separated list.
http://symfony.com/schema/dic/doctrine/odm/mongodb https://symfony.com/schema/dic/doctrine/odm/mongodb/mongodb-1.0.xsd">

<doctrine:mongodb>
<doctrine:connection id="default" server="mongodb://mongodb-01:27017,mongodb-02:27017,mongodb-03:27017" />
<doctrine:connection id="default" server="mongodb://mongodb-01:27017,mongodb-02:27017,mongodb-03:27017/?replicaSet=replSetName" />
</doctrine:mongodb>
</container>

Where mongodb-01, mongodb-02 and mongodb-03 are the machine hostnames. You
can also use IP addresses if you prefer.

.. tip::

Please refer to `Replica Sets`_ manual of MongoDB PHP Driver for futher details.


Using Authentication on a Database Level
----------------------------------------

Expand Down Expand Up @@ -636,3 +641,7 @@ Full Default Configuration
</doctrine:connection>
</doctrine:config>
</container>

.. _`define it as environment variable`: https://symfony.com/doc/current/configuration.html#configuration-based-on-environment-variables
.. _`connection string`: https://docs.mongodb.com/manual/reference/connection-string/#urioption.authSource
.. _`Replica Sets`: https://www.php.net/manual/en/mongo.connecting.rs.php