Added a caution note about UploadedFile and insulated tests

javiereguiluz · javiereguiluz · commit eacd84406e72 · 2017-07-17T11:11:36.000+02:00
diff --git a/testing/insulating_clients.rst b/testing/insulating_clients.rst
@@ -43,3 +43,11 @@ clean PHP process, thus avoiding any side-effects.
 
     As an insulated client is slower, you can keep one client in the main
     process, and insulate the other ones.
+
+.. caution::
+
+    Insulating tests requires some serializing and unserializing operations. If
+    your test includes data that can't be serialized, such as file streams when
+    using the ``UploadedFile`` class, you'll see an exception about
+    *"serialization is not allowed"*. This is a technical limitation of PHP, so
+    the only solution is to disable insulation for those tests.
