Skip to content

Commit 963d0a6

Browse files
committed
Added mentions to some popular (and useful) Symfony bundles
1 parent 5c0f8fb commit 963d0a6

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 in users 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`: http://knpbundles.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+
integratd with Doctrine ORm, 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,
@@ -557,3 +564,4 @@ order to remove the file. Before it's removed, you must store the file path
557564
from the database, you can safely delete the file (in ``PostRemove``).
558565

559566
.. _`preUpdate`: http://docs.doctrine-project.org/projects/doctrine-orm/en/latest/reference/events.html#preupdate
567+
.. _`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)