Skip to content

Commit 6621b5a

Browse files
committed
docs: update docs
1 parent d88c6c2 commit 6621b5a

2 files changed

Lines changed: 18 additions & 1 deletion

File tree

user_guide_src/source/changelogs/v4.3.4.rst

Lines changed: 13 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -35,6 +35,19 @@ Redirect Status Code
3535
always be used when you don't specify a status code. In previous versions,
3636
302 might be changed.
3737

38+
Forge::modifyColumn()
39+
---------------------
40+
41+
- The :ref:`$forge->modifyColumn() <db-forge-modifyColumn>` has been fixed. Due
42+
to a bug, in previous versions, SQLite3/Postgres/SQLSRV might change
43+
``NULL``/``NOT NULL`` unpredictably.
44+
- In previous versions, the OCI8 driver did not change ``NULL``/``NOT NULL``
45+
when you don't specify ``null`` value.
46+
- Now in all database drivers ``$forge->modifyColumn()`` always sets ``NULL``
47+
when you don't specify ``null`` value.
48+
- The ``NULL``/``NOT NULL`` change may still be unexpectedly, it is recommended
49+
to always specifiy ``null`` value.
50+
3851
Message Changes
3952
***************
4053

user_guide_src/source/dbmgmt/forge.rst

Lines changed: 5 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -285,6 +285,8 @@ Used to remove multiple columns from a table.
285285
Modifying a Field in a Table
286286
============================
287287

288+
.. _db-forge-modifyColumn:
289+
288290
$forge->modifyColumn()
289291
----------------------
290292

@@ -295,7 +297,9 @@ change the name, you can add a "name" key into the field defining array.
295297
.. literalinclude:: forge/026.php
296298

297299
.. note:: The ``modifyColumn()`` may unexpectedly change ``NULL``/``NOT NULL``.
298-
So it is recommended to always specify ``null`` value.
300+
So it is recommended to always specify ``null`` value. Unlike when creating
301+
a table, if ``null`` is not specified, the column will be ``NULL``, not
302+
``NOT NULL``.
299303

300304
.. note:: Due to a bug, prior v4.3.3, SQLite3 may not set ``NOT NULL`` even if you
301305
specify ``'null' => false``.

0 commit comments

Comments
 (0)