Critical changes for developers & admins for Nextcloud 14

[MorrisJobke]

This ticket is to collect the critical changes for developers for Nextcloud 14.

• PHP 7.0, 7.1 and 7.2 is supported (PHP 7.0+ for Nextcloud 14 #7368)
• we will introduce type hinting for scalar types to our public API and fix according to the PHPDoc:
  • AppFramework\Http\Request::getHeader now really only returns string (and not null) anymore (Request->getHeader() should always return a string #7813)
  • Security\ICrypto::decrypt now accepts strings only and also returns string only (Adds type hinting for scalar types in ICrypto->decrypt #7825)
  • OCP\AppFramework\Utility\ITimeFactory is strictly typed now (Make the ITimeFactory strict + return types #7838)
  • OCP\IL10N is strickly types which means that the t function expects an array (Make OCP\IL10N strict #8476) - see also Relax what t accepts so we don't break it all #8497 for a relaxed version

Removed from public interface

• several deprecated functions from OCP\AppFramework/IAppContainer (Remove deprecated functions from DI Container #7839)
• OCP\Config (Remove deprecated \OCP\Config #7840)
• search function from OCP\ISearch (Removed deprecated search function from ISearch #7842)
• formatDate and generateRandomBytes from OCP\Util (Remove deprecated functions for OCP\Util #7843)
• deprecated OCP constantes (Remove deprecated constants #7844)
• remove deprecated template functions from OCP directly (Remove deprecated template functions from OCP directly #7857)
• several deprecated functions from OCP\Util (Remove unused and deprecated methods from OCP\Util #8783) - sendMail, encryptedFiles, getServerHost, getServerProtocol, getRequestUri, getScriptName
• remove deprecated interface OCP\IHelper (Remove unused and deprecated class and interface AppHelper #8784)
• remove deprecated insertIfNotExist from OCP\DB (Use insertIfNotExist of the new interface #8786)
• remove more deprecated methods of OCP\DB(Remove deprecated and unsused methods of OCP\DB #8787) - insertid, rollback, isError
• remove some deprecated methods of OCP\Response (Remove unused methods of OC_Response #8792)
• removed deprecated HTTPHelper (Remove deprecated HTTPHelper #8804)
• removed urlgenerator functions form OCP\Util (Remove deprecated URL functions for OCP\Util #8811)
• removed deprecated OCP\Contacts (Remove deprecated OCP\Contacts #8816)
• removed deprecated OCP\BackgroundJob::registerJob (Remove old deprecated function from the BackgroundJob #8877)
• removed deprecated OCP\Files::tmpFile and OCP\Files::tmpFolder (Remove deprecated tmpFile/tmpFolder #8878)
• removed deprecated OCP\JSON (Remove unused deprecated functions from OCP\JSON #8879 & Remove \OCP\JSON #8943)
• remove deprecated beginTransaction, commit and getErrorMessage from OCP\DB (Remove unused and deprecated methods of OCP\DB #8914)
• remove deprecated OCP\Response (Remove deprecated and unused OCP\Response #8918)
• remove deprecated method OCP\User::getDisplayNames (Remove deprecated and unused method OCP\User::getDisplayNames #8919)
• remove OCP\Share::resolveReshare (Remove unused resolveReshare of old sharing code #8853)
• removed deprecated OCP\DB (Cleanup ocp db #8985)

Changed occ command interface:

• occ upgrade does not have the option --no-app-disable anymore (it is used for PHP 7+ anyways already) (Remove not needed 3rdparty app disabling during upgrade for PHP 5.x #7955)

Changed available dependencies:

• $fromMailAddress will not be available anymore - just define it in your apps dependency container if you need it (Cleanup unused parameter #8336)

Changed public interfaces (that could be implemented by an app):

• \OCP\Mail and the email templates got proper type hints: Make \OCP\Mail strict #8614
• OCP\Authentication\TwoFactorAuth got typehints and return types: Strict 2FA #8981
• OCP\Migration\IMigrationStep has two new methods Add human readable description to migration steps #9167 (covered if the apps use the abstract class SimpleMigrationStep which is the default)
• OCA.Search is now OCA.Search.Core. New standard for global search New search standard and user search #9912
• EMailTemplate child classes should use the %$1s notation for replacements to be future compatible and be able to reuse parameters EMailTemplate: Fix button background in Lotus Notes #10291

Structural changes:

• Structure of the whole nextcloud instance has been revised: Cleanup structure #9982
• with-app-sidebar not required anymore to open the sidebar only use disappear on the sidebar
• svg classe not required anymore
• with-settings, with-icon not needed anymore

Changed behaviour:

• apps that are enabled for groups can now provide public pages, that are available even if a user is not logged in - see Allow public page access to apps with group restrictions #8593
• OCS API method AddUser POST:/users now allow empty password iff email is set and valid Allow admin to create users without password by sending mail automatic… #8856
• email texts are not automatically escaped anymore in all cases Allow custom HTML in HTML Emails #8026

Changed config:

• When using Swift Objectstore as home storage make sure that to set the bucket/container parameter. See Swift uses containter not bucket #8793
• mail_smtpmode can no longer be set to php. As this option is lost with the upgrade of phpmailer Upgrade to swiftmailer-6 #9791

Internals stuff:

• cleanup of OC_* namespace - we removed quite some classes, methods and constants from our internal namespace. If it was used by any app in the App Store we notified the owner of that app. Keep in mind that using the OC_ namespace is not official supported and can break any time without notice. So better not use it in your app.
• OC_Group_Backend got removed: Remove deprecated OC_Group_Backend #8988
• OC_Response::setStatus and the constants for status codes have been removed Replace hard coded HTTP status codes with proper calls to http_response_code #10009

Added APIs:

• OCS API got a details endpoint for the user list Add userdetails to ocs api #8847
• OCS API got a details endpoint for the groups list Return groups displayname in provisioning api #8865

Deprecated APIs:

• OCP\Files is deprecated Deprecated some methods of OCP\Files #8922
• Setting custom client URLs in a custom OC_Theme class is deprecated, settings in config.php should be used Deprecate theme sync clients #8994
• OCS API getGroup method replaced by getGroupUsers Api: return users details by groups #8904
• log levels in OCP\Util are deprecated and moved to the ILogger interface Move log constants to ILogger #9308
• OCP\AppFramework\Db\Mapper is deprecated move to OCP\AppFramework\Db\QBMapper Add a QueryBuilder based Mapper #9444

Changed outside facing stuff:

• log format for exception was improved (no double nested JSON anymore) Log exceptions as nested array instead of encoded json #8946

Admin:

• updated Nginx config: Use $request_uri instead of $uri in nginx config documentation#786
• syslog tag was changed from ownCloud to Nextcloud: Systemd Logger #10048
• when running occ maintenance:mode --on/--off and it was already in this state if will print Maintenance mode already enabled instead of the Maintenance mode enabled which was printed always before this change Updates the maintenance command output #10070

[jospoortvliet]

I put this on our forum so app devs can give input:
https://help.nextcloud.com/t/changes-coming-in-nc-14-time-to-prepare/27790/2

[nickvergessen]

@jospoortvliet mind removing the actual changes, so we have only one place where we need to update stuff?

[MorrisJobke]

@jospoortvliet mind removing the actual changes, so we have only one place where we need to update stuff?

Fixed it in the forums.

[MorrisJobke]

We just added:

OCP\IL10N is strickly types which means that the t function expects an array (#8476) - see also #8497 for a relaxed version

But also check the OP to have the full list of changes we made so far.

[MorrisJobke]

\OCP\Mail and the email templates got proper type hints: #8614

@MariusBluem We also need to update the "theme email template docs" then for 14 😉

[MorrisJobke]

apps that are enabled for groups can now provide public pages, that are available even if a user is not logged in - see #8593

@jospoortvliet Also something for the release notes.

[MorrisJobke]

• several deprecated functions from OCP\Util (Remove unused and deprecated methods from OCP\Util #8783) - sendMail, encryptedFiles, getServerHost, getServerProtocol, getRequestUri, getScriptName
• remove deprecated interface OCP\IHelper (Remove unused and deprecated class and interface AppHelper #8784)
• remove deprecated insertIfNotExist from OCP\DB (Use insertIfNotExist of the new interface #8786)
• remove more deprecated methods of OCP\DB(Remove deprecated and unsused methods of OCP\DB #8787) - insertid, rollback, isError

Latest changes.

[MorrisJobke]

cleanup of OC_* namespace - we removed quite some classes, methods and constants from our internal namespace. If it was used by any app in the App Store we notified the owner of that app. Keep in mind that using the OC_ namespace is not official supported and can break any time without notice. So better not use it in your app.

Added a note about the private namespace

[MorrisJobke]

remove some deprecated methods of OCP\Response (#8792)

[MorrisJobke]

removed urlgenerator functions form OCP\Util (#8811)

[Fmstrat]

Blog posts about this right when 14 hit would have been great. I caught the one that just came out recently, and am just now realizing the OCP/DB's prepare is gone, meaning a rewrite of DB interactions. Can we start a process for blog posts on this early in the first beta?

[MorrisJobke]

Can we start a process for blog posts on this early in the first beta?

That was the plan, but somehow slipped through and was done quite late. Also as you can see we tried to reach out to people early if we found their projects on some hosting platform (we check GitHub and Gitlab and even emailed some).

Also the prepare statement was annotated with the deprecation text for 3 years now. Typically IDEs show this to you inline so that you are aware of this.

[MorrisJobke]

But sorry, that we missed to reach out to you :/ We try our best in the future.

[MorrisJobke]

@Fmstrat Also the plan is to have such an overview ticket for every major release to which developer could subscribe and get the information as soon as possible.

[Fmstrat]

@MorrisJobke That all sounds excellent! As for IDEs, I'm old school with vim in a terminal, so no real assistance there. 😉

It would also be great if there was one ticket for all releases that was locked down, then when you open a new ticket for the next release place a link in the master one. That way developers can subscribe to the master issue and not miss when the new one is created. Thanks!

[MorrisJobke]

It would also be great if there was one ticket for all releases that was locked down, then when you open a new ticket for the next release place a link in the master one. That way developers can subscribe to the master issue and not miss when the new one is created. Thanks!

We will have a look at this. Thanks for this valuable feedback.

[MorrisJobke]

For 14 this one is done. I will post here also the overview ticket that is planned and then we continue with this kind of ticket in 15.

[Fmstrat]

@MorrisJobke Awesome, thank you! Posting the overview ticket here would be very helpful. I'll subscribe to that when it comes.

[MorrisJobke]

The Nextcloud 16 version of this is in #12915