Skip to content

Commit b17cf6b

Browse files
committed
Merge branch '4.2.x' into 4.3.x
* 4.2.x: Remove documentation of legacy types (#6688)
2 parents 0d7087f + bac0898 commit b17cf6b

File tree

1 file changed

+3
-87
lines changed

1 file changed

+3
-87
lines changed

docs/en/reference/types.rst

Lines changed: 3 additions & 87 deletions
Original file line numberDiff line numberDiff line change
@@ -397,30 +397,6 @@ Array types
397397
Types that map array data in different variations such as simple arrays,
398398
real arrays or JSON format arrays.
399399

400-
array
401-
^^^^^
402-
403-
Maps and converts array data based on PHP serialization.
404-
If you need to store an exact representation of your array data,
405-
you should consider using this type as it uses serialization
406-
to represent an exact copy of your array as string in the database.
407-
Values retrieved from the database are always converted to PHP's ``array`` type
408-
using deserialization or ``null`` if no data is present.
409-
410-
.. note::
411-
412-
This type will always be mapped to the database vendor's ``text`` type
413-
internally as there is no way of storing a PHP array representation
414-
natively in the database.
415-
Furthermore this type requires an SQL column comment hint so that it can be
416-
reverse engineered from the database. Doctrine cannot map back this type
417-
properly on vendors not supporting column comments and will fall back to
418-
``text`` type instead.
419-
420-
.. warning::
421-
422-
This type is deprecated since 3.4.0, use :ref:`json` instead.
423-
424400
simple_array
425401
^^^^^^^^^^^^
426402

@@ -486,50 +462,6 @@ JSON objects are always converted to PHP associative arrays.
486462
like MySQL sort the keys of its native JSON type using an internal order
487463
which is also subject to change.
488464

489-
Object types
490-
~~~~~~~~~~~~
491-
492-
Types that map to objects such as POPOs.
493-
494-
object
495-
^^^^^^
496-
497-
Maps and converts object data based on PHP serialization.
498-
If you need to store an exact representation of your object data,
499-
you should consider using this type as it uses serialization
500-
to represent an exact copy of your object as string in the database.
501-
Values retrieved from the database are always converted to PHP's ``object`` type
502-
using deserialization or ``null`` if no data is present.
503-
504-
.. note::
505-
506-
This type will always be mapped to the database vendor's ``text`` type
507-
internally as there is no way of storing a PHP object representation
508-
natively in the database.
509-
Furthermore this type requires an SQL column comment hint so that it can be
510-
reverse engineered from the database. Doctrine cannot map back this type
511-
properly on vendors not supporting column comments and will fall back to
512-
``text`` type instead.
513-
514-
.. warning::
515-
516-
While the built-in ``text`` type of MySQL and MariaDB can store binary data,
517-
``mysqldump`` cannot properly export ``text`` fields containing binary data.
518-
This will cause creating and restoring of backups fail silently. A workaround is
519-
to ``serialize()``/``unserialize()`` and ``base64_encode()``/``base64_decode()``
520-
PHP objects and store them into a ``text`` field manually.
521-
522-
.. warning::
523-
524-
Because the built-in ``text`` type of PostgreSQL does not support NULL bytes,
525-
the object type will cause deserialization errors on PostgreSQL. A workaround is
526-
to ``serialize()``/``unserialize()`` and ``base64_encode()``/``base64_decode()`` PHP objects and store
527-
them into a ``text`` field manually.
528-
529-
.. warning::
530-
531-
This type is deprecated since 3.4.0, use :ref:`json` instead.
532-
533465
.. _mappingMatrix:
534466

535467
Mapping Matrix
@@ -729,10 +661,10 @@ Please also notice the mapping specific footnotes for additional information.
729661
| | +--------------------------+---------+----------------------------------------------------------+
730662
| | | **SQL Server** | "all" | ``TIME(0)`` |
731663
+-------------------+---------------+--------------------------+---------+----------------------------------------------------------+
732-
| **array** [1] | ``array`` | **MySQL** | *all* | ``TINYTEXT`` [16] |
733-
+-------------------+ | | +----------------------------------------------------------+
734-
| **simple array** | | | | ``TEXT`` [17] |
664+
| **simple array** | ``array`` | **MySQL** | *all* | ``TINYTEXT`` [16] |
735665
| [1] | | | +----------------------------------------------------------+
666+
| | | | | ``TEXT`` [17] |
667+
| | | | +----------------------------------------------------------+
736668
| | | | | ``MEDIUMTEXT`` [18] |
737669
| | | | +----------------------------------------------------------+
738670
| | | | | ``LONGTEXT`` [19] |
@@ -757,22 +689,6 @@ Please also notice the mapping specific footnotes for additional information.
757689
| | +--------------------------+---------+----------------------------------------------------------+
758690
| | | **SQL Server** | *all* | ``VARCHAR(MAX)`` [1] |
759691
+-------------------+---------------+--------------------------+---------+----------------------------------------------------------+
760-
| **object** [1] | ``object`` | **MySQL** | *all* | ``TINYTEXT`` [16] |
761-
| | | | +----------------------------------------------------------+
762-
| | | | | ``TEXT`` [17] |
763-
| | | | +----------------------------------------------------------+
764-
| | | | | ``MEDIUMTEXT`` [18] |
765-
| | | | +----------------------------------------------------------+
766-
| | | | | ``LONGTEXT`` [19] |
767-
| | +--------------------------+---------+----------------------------------------------------------+
768-
| | | **PostgreSQL** | *all* | ``TEXT`` |
769-
| | +--------------------------+ | |
770-
| | | **Oracle** | *all* | ``CLOB`` |
771-
| | +--------------------------+ | |
772-
| | | **SQLite** | | |
773-
| | +--------------------------+---------+----------------------------------------------------------+
774-
| | | **SQL Server** | *all* | ``VARCHAR(MAX)`` |
775-
+-------------------+---------------+--------------------------+---------+----------------------------------------------------------+
776692

777693
**Notes**
778694

0 commit comments

Comments
 (0)