3363-doctrine-file-upload-example-uses-dir

cordoval · cordoval · commit 1620ed8992f6 · 2014-01-19T21:17:06.000-07:00
diff --git a/cookbook/doctrine/file_uploads.rst b/cookbook/doctrine/file_uploads.rst
@@ -300,6 +300,15 @@ object, which is what's returned after a ``file`` field is submitted::
 Using Lifecycle Callbacks
 -------------------------
 
+.. caution::
+
+    Using lifecycle callbacks is a limited technique that has some drawbacks.
+    If you want to remove the hard coded ``__DIR__`` reference inside
+    the ``Document::getUploadRootDir()`` method, the best way is to start
+    using explicit :doc:`doctrine listeners </cookbook/doctrine/event_listeners_subscribers>`
+    where you will be able to inject kernel parameters such as
+    ``kernel.root_dir`` to be able to build absolute paths.
+
 Even if this implementation works, it suffers from a major flaw: What if there
 is a problem when the entity is persisted? The file would have already moved
 to its final location even though the entity's ``path`` property didn't
