? ? Pending

User tests: Successful: 0 Unsuccessful: 0

avatar richard67
richard67
3 Oct 2019

Pull Request for Issue #24535 (part).

Summary of Changes

This PR fixes all datetime columns of com_fields tables so there will not be any Invalid value '0000-00-00 00:00:00' for datetime error anymore on MySQL 5.7 or later when strict mode is enabled, and the datetime (MySQL) or timestamp without time zone (PostgreSQL) columns will allow NULL values wherever useful/possible.

Following is changed:

  • Table #__fields's columns created_time and modified_time will be treated in the same way as e.g. columns created and modified of the #__banners table in PR #26372 , i.e. they will get no default value.
  • The same is done for table #__fields_groups's columns created and modified.
  • All other datetime columns of these 2 tables will allow null values and have null value as default, like e.g. columns publish_up and publish_down of the #__banners table in PR #26372 .

The default value is only used when inserting new records without specifying values for that particular column. Not having a default will enforce to insert new records with values for these columns being provided and throw an SQL error if some of these values is not specified, i.e. such errors will not be hidden anymore.

Old data will be updated as little as possible. The created and created_time columns will be not touched at all. We can assume that for core components there is no data with values '0000-00-00 00:00:00' on MySQL or '1970-01-01 00:00:00' on PostgreSQL, and data created by 3rd party components should not be modified. The modified and modified_time column will be set to the value of the created column only has value '0000-00-00 00:00:00' on MySQL or '1970-01-01 00:00:00' on '1970-01-01 00:00:00'. Our PHP already sets the modified time to the created time when saving new records, i.e. modified = created means never modified.

Testing Instructions

Testers please report back the database kind (MySQL or PostgreSQL) on which you have tested.

If you have both MySQL and PostgreSQL, please test on both if possible.

Test 1: New installation

  1. Apply the patch on a clean 4.0-dev branch using git or merging manually, or apply it on an installation of current 4.0-dev using patchtester.
  2. If used patchtester on an existing installation in step 1, delete file configuration.php and delete all Joomla database tables in PhpMyAdmin or PhpPgAdmin (depending on your database type).
  3. Do a new installation, login to backend, confirm the statistics dialog, go to global config and set error reporting to maximum or development in server settings.
  4. Play around with fields and field groups, create some, modify some, ...
  5. After any action, check in your database the relevant datetime/timestamp without timezone columns.

Result: See section "Expected result" below.

Test 2: Update sql script

  1. Install a clean clean 4.0-dev, login to backend, confirm the statistics dialog, go to global config and set error reporting to maximum or development in server settings.
  2. Apply the changes from this PR e.g. manually or with patch tester.
  3. Open PhpMyAdmin or PhpPgAdmin (depending on your database type), select your database and then go to the SQL command input.
  4. On MySQL copy the first line of file installation/sql/mysql/joomla.sql into the SQL command window but don't execute the commands yet:
SET SQL_MODE = "NO_AUTO_VALUE_ON_ZERO";

This switches off strict mode to the SQL will run on MySQL 5.7 or later.

  1. Copy the content of file administrator/components/com_admin/sql/updates/mysql/4.0.0-2019-09-25.sql or administrator/components/com_admin/sql/updates/postgresql/4.0.0-2019-09-25.sql (depending on your database type) into the SQL command window, in case of MySQL below the previously pasted commands, but don't execute the commands yet.
  2. Replace #__ by your database prefix in the SQL statements pasted before in the SQL input window.
  3. Put the cursor to the beginning of the 1st SQL statement in the SQL input window and now execute all SQL commands.
  4. Play around with fields and field groups, create some, modify some, ...
  5. After any action, check in your database the relevant datetime/timestamp without timezone columns.

Result: See section "Expected result" below.

Expected result

New Installation

Fields work as well as without this PR. In a MySQL database there are no columns of data type datetime having value '0000-00-00 00:00:00' in tables #__fields and #__fields_groups, and there is no invalid default value anymore in MySQL >= 5.7 with strict mode on. On PostgreSQL there are no columns of data type timestamp without time zone having value '0000-00-00 00:00:00' in these tables.

There is one exception: When checking in a field or a field group using com_checkin, the checked_out_time is set to '0000-00-00 00:00:00' on MySQL and '1970-01-01 00:00:00' on PosgreSQL. This will be changed with a separate, future PR for com_checkin. Checking in an item with the lock icon in list display works, i.e. there checked_out_time is set to NULL.

Update sql script

The statements are processed without error. The expected result is the same as for a new installation.

Actual result

New Installation

On MySQL same as expected, but the default value of database columns of data type datetime having value '0000-00-00 00:00:00' in tables #__fields and #__fields_groups is invalid in MySQL >= 5.7 with strict mode on, and there might be values '0000-00-00 00:00:00'. On postgreSQL same as expected, but there might be values '1970-01-01 00:00:00' in the datetime columns of tables #__fields and #__fields_groups.

Documentation Changes Required

Maybe core developer docs and extension developer docs should be updated to encourage them not to use '0000-00-00 00:00:00' on MySQL anymore but use real NULL and not abuse '1970-01-01 00:00:00' on PostgreSQL as a speudo null date anymore and use real NULL values also there.

avatar richard67 richard67 - open - 3 Oct 2019
avatar richard67 richard67 - change - 3 Oct 2019
Status New Pending
avatar joomla-cms-bot joomla-cms-bot - change - 3 Oct 2019
Category SQL Administration com_admin Postgresql com_fields Installation
avatar richard67 richard67 - change - 3 Oct 2019
Labels Added: ?
avatar richard67 richard67 - change - 3 Oct 2019
The description was changed
avatar richard67 richard67 - edited - 3 Oct 2019
avatar richard67 richard67 - change - 3 Oct 2019
The description was changed
avatar richard67 richard67 - edited - 3 Oct 2019
avatar richard67 richard67 - change - 3 Oct 2019
The description was changed
avatar richard67 richard67 - edited - 3 Oct 2019
avatar richard67 richard67 - change - 3 Oct 2019
The description was changed
avatar richard67 richard67 - edited - 3 Oct 2019
avatar richard67 richard67 - change - 3 Oct 2019
The description was changed
avatar richard67 richard67 - edited - 3 Oct 2019
avatar richard67 richard67 - change - 3 Oct 2019
The description was changed
avatar richard67 richard67 - edited - 3 Oct 2019
avatar richard67 richard67 - change - 3 Oct 2019
Title
[4.0] [WiP] [com_fields] Fix default value for not nullable datetime columns
[4.0] [com_fields] Fix default value for not nullable datetime columns
avatar richard67 richard67 - edited - 3 Oct 2019
avatar richard67 richard67 - change - 3 Oct 2019
The description was changed
avatar richard67 richard67 - edited - 3 Oct 2019
avatar richard67 richard67 - change - 3 Oct 2019
The description was changed
avatar richard67 richard67 - edited - 3 Oct 2019
avatar richard67 richard67 - change - 3 Oct 2019
Title
[4.0] [com_fields] Fix default value for not nullable datetime columns
[4.0] [com_fields] Fix default value for not nullable datetime columns and make some nullable
avatar richard67 richard67 - edited - 3 Oct 2019
avatar richard67 richard67 - change - 3 Oct 2019
The description was changed
avatar richard67 richard67 - edited - 3 Oct 2019
avatar richard67 richard67 - change - 3 Oct 2019
The description was changed
avatar richard67 richard67 - edited - 3 Oct 2019
avatar alikon alikon - test_item - 5 Oct 2019 - Tested successfully
avatar alikon
alikon - comment - 5 Oct 2019

I have tested this item successfully on 768b6a0

on linux
php 7.3.8-1 & pgsql 11.5 (Ubuntu 11.5-1)


This comment was created with the J!Tracker Application at issues.joomla.org/tracker/joomla-cms/26460.
avatar richard67
richard67 - comment - 6 Oct 2019

@alikon Could you just set again your testing result in the issue tracker? Last commit was only update to lates 4.0-dev, no need to re-test.

avatar richard67 richard67 - change - 6 Oct 2019
The description was changed
avatar richard67 richard67 - edited - 6 Oct 2019
avatar richard67 richard67 - change - 6 Oct 2019
The description was changed
avatar richard67 richard67 - edited - 6 Oct 2019
avatar richard67 richard67 - change - 6 Oct 2019
The description was changed
avatar richard67 richard67 - edited - 6 Oct 2019
avatar alikon alikon - test_item - 7 Oct 2019 - Tested successfully
avatar alikon
alikon - comment - 7 Oct 2019

I have tested this item successfully on 9bbd630


This comment was created with the J!Tracker Application at issues.joomla.org/tracker/joomla-cms/26460.

avatar travisrisner
travisrisner - comment - 14 Oct 2019

I have tested this item successfully on 9bbd630

avatar Quy Quy - change - 14 Oct 2019
Status Pending Ready to Commit
avatar Quy
Quy - comment - 14 Oct 2019

RTC


This comment was created with the J!Tracker Application at issues.joomla.org/tracker/joomla-cms/26460.

avatar Quy
Quy - comment - 14 Oct 2019

RTC


This comment was created with the J!Tracker Application at issues.joomla.org/tracker/joomla-cms/26460.

avatar wilsonge wilsonge - change - 16 Oct 2019
Status Ready to Commit Fixed in Code Base
Closed_Date 0000-00-00 00:00:00 2019-10-16 19:21:04
Closed_By wilsonge
Labels Added: ?
avatar wilsonge wilsonge - close - 16 Oct 2019
avatar wilsonge wilsonge - merge - 16 Oct 2019
avatar wilsonge
wilsonge - comment - 16 Oct 2019

Thanks!

Add a Comment

Login with GitHub to post a comment