Skip to content

Commit 5ae7f27

Browse files
committed
feature #5373 Added mentions to some popular (and useful) Symfony bundles (javiereguiluz)
This PR was merged into the 2.3 branch. Discussion ---------- Added mentions to some popular (and useful) Symfony bundles | Q | A | ------------- | --- | Doc fix? | no | New docs? | yes | Applies to | all | Fixed tickets | - Commits ------- 9dc8b8f Fixed a minor grammar issue 7370433 Fixed typos bf4f3d6 Link to the official repository of the bundle. 963d0a6 Added mentions to some popular (and useful) Symfony bundles
2 parents 31e613a + 9dc8b8f commit 5ae7f27

File tree

5 files changed

+38
-2
lines changed

5 files changed

+38
-2
lines changed

book/security.rst

+7-1
Original file line numberDiff line numberDiff line change
@@ -275,6 +275,11 @@ But who can you login as? Where do users come from?
275275
What other methods are supported? See the :doc:`Configuration Reference </reference/configuration/security>`
276276
or :doc:`build your own </cookbook/security/custom_authentication_provider>`.
277277

278+
.. tip::
279+
280+
If your application logs users in via a third-party service such as Google,
281+
Facebook or Twitter, check out the `HWIOAuthBundle`_ community bundle.
282+
278283
.. _security-user-providers:
279284
.. _where-do-users-come-from-user-providers:
280285

@@ -480,7 +485,7 @@ else, you'll want to encode their passwords. The best algorithm to use is
480485
<encoder class="Symfony\Component\Security\Core\User\User"
481486
algorithm="bcrypt"
482487
cost="12" />
483-
488+
484489
<!-- ... -->
485490
</config>
486491
</srv:container>
@@ -1283,3 +1288,4 @@ Learn More from the Cookbook
12831288

12841289
.. _`online tool`: https://www.dailycred.com/blog/12/bcrypt-calculator
12851290
.. _`frameworkextrabundle documentation`: http://symfony.com/doc/current/bundles/SensioFrameworkExtraBundle/index.html
1291+
.. _`HWIOAuthBundle`: https://github.com/hwi/HWIOAuthBundle

cookbook/assetic/asset_management.rst

+8
Original file line numberDiff line numberDiff line change
@@ -183,6 +183,12 @@ To include an image you can use the ``image`` tag.
183183
You can also use Assetic for image optimization. More information in
184184
:doc:`/cookbook/assetic/jpeg_optimize`.
185185

186+
.. tip::
187+
188+
Instead of using Assetic to include images, you may consider using the
189+
`LiipImagineBundle`_ community bundle, which allows to compress and
190+
manipulate images (rotate, resize, watermark, etc.) before serving them.
191+
186192
.. _cookbook-assetic-cssrewrite:
187193

188194
Fixing CSS Paths with the ``cssrewrite`` Filter
@@ -572,3 +578,5 @@ some isolated directory (e.g. ``/js/compiled``), to keep things organized:
572578
) as $url): ?>
573579
<script src="<?php echo $view->escape($url) ?>"></script>
574580
<?php endforeach ?>
581+
582+
.. _`LiipImagineBundle`: https://github.com/liip/LiipImagineBundle

cookbook/assetic/jpeg_optimize.rst

+6
Original file line numberDiff line numberDiff line change
@@ -250,4 +250,10 @@ file:
250250
),
251251
));
252252
253+
.. tip::
254+
255+
Instead of using Assetic and Jpegoptim, you can also compress and manipulate
256+
images before serving them using the `LiipImagineBundle`_ community bundle.
257+
253258
.. _`Jpegoptim`: http://www.kokkonen.net/tjko/projects.html
259+
.. _`LiipImagineBundle`: http://knpbundles.com/liip/LiipImagineBundle

cookbook/doctrine/file_uploads.rst

+8
Original file line numberDiff line numberDiff line change
@@ -4,6 +4,13 @@
44
How to Handle File Uploads with Doctrine
55
========================================
66

7+
.. note::
8+
9+
Instead of handling file uploading yourself, you may consider using the
10+
`VichUploaderBundle`_ community bundle. This bundle provides all the common
11+
operations (such as file renaming, saving and deleting) and it's tightly
12+
integrated with Doctrine ORM, MongoDB ODM, PHPCR ODM and Propel.
13+
714
Handling file uploads with Doctrine entities is no different than handling
815
any other file upload. In other words, you're free to move the file in your
916
controller after handling a form submission. For examples of how to do this,
@@ -564,3 +571,4 @@ order to remove the file. Before it's removed, you must store the file path
564571
from the database, you can safely delete the file (in ``PostRemove``).
565572

566573
.. _`preUpdate`: http://docs.doctrine-project.org/projects/doctrine-orm/en/latest/reference/events.html#preupdate
574+
.. _`VichUploaderBundle`: https://github.com/dustin10/VichUploaderBundle

cookbook/security/custom_authentication_provider.rst

+9-1
Original file line numberDiff line numberDiff line change
@@ -4,6 +4,13 @@
44
How to Create a custom Authentication Provider
55
==============================================
66

7+
.. note::
8+
9+
If you want to authenticate users via OAuth using a third-party service
10+
such as Google, Facebook or Twitter, there is no need to create your own
11+
authentication provider. In those cases, use the `HWIOAuthBundle`_ community
12+
bundle.
13+
714
If you have read the chapter on :doc:`/book/security`, you understand the
815
distinction Symfony makes between authentication and authorization in the
916
implementation of security. This chapter discusses the core classes involved
@@ -280,7 +287,7 @@ the ``PasswordDigest`` header value matches with the user's password.
280287

281288
.. note::
282289

283-
The comparsion of the expected and the provided digests uses a constant
290+
The comparison of the expected and the provided digests uses a constant
284291
time comparison provided by the
285292
:method:`Symfony\\Component\\Security\\Core\\Util\\StringUtils::equals`
286293
method of the ``StringUtils`` class. It is used to mitigate possible
@@ -615,6 +622,7 @@ set to any desirable value per firewall.
615622
The rest is up to you! Any relevant configuration items can be defined
616623
in the factory and consumed or passed to the other classes in the container.
617624

625+
.. _`HWIOAuthBundle`: https://github.com/hwi/HWIOAuthBundle
618626
.. _`WSSE`: http://www.xml.com/pub/a/2003/12/17/dive.html
619627
.. _`nonce`: http://en.wikipedia.org/wiki/Cryptographic_nonce
620628
.. _`timing attacks`: http://en.wikipedia.org/wiki/Timing_attack

0 commit comments

Comments
 (0)