Changes for developers & admins for Nextcloud 26

[nickvergessen]

Continuation of #32117

Readme

📝 Please always leave a comment when editing, so subscribed developers and admins are notified.

Front-end

• The "app icons" background https://github.com/nextcloud/server/blob/stable25/core/img/background.png and https://github.com/nextcloud/server/blob/stable25/core/img/background.svg is not used anymore and will be removed (was only used on login page, where we now use the "clouds" background.
• Bootstrap removed: The shipped bootstrap was only used for tooltips since ages but shipped and therefore available globally. Because the version we shipped is now EOL, we decided to remove it instead of bringing in a breaking update. For any tootltip it is recommended to just switch to the native title= HTML attribute.
  Pull request by nickvergessen: Drop bootstrap #36434

Backend

• Dropped support for PHP 7.4
• Added support for PHP 8.2. See release notes from PHP about new deprecations.
• Moved ICreateFromString::handleIMipMessage(string $name, string $calendarData): void; to its own Interface IHandleImipMessage
  Pull request by miaulalala: Move iMIP to its own interface #34893
• New OCP\Authentication\Token\IProvider for authentication providers: Created a new public interface OCP\Authentication\Token\IProvider with a method invalidateTokensOfUser to invalidate all tokens of a specific user. OC\Authentication\Token\Manager implements OCP\Authentication\Token\IProvider.
  Pull request by individual-it: [master] invalidate existing tokens when deleting an oauth client #36033
• Auto-Submitted header for emails: There now is a new method on the OCP\Mail\IMessage interface IMessage::setAutoSubmitted(). With this method you can specify that an email was an automatic email or response, to allow mail servers to better detect if an out-of-office reply should be sent, better store/filter the emails and so on. Possible values are documented in the OCP\Mail\Headers\AutoSubmitted interface.
  Pull request by bennet0496: Adding option to set Auto-Submitted email header #35876
• OCP\BackgroundJob\IJobList::getJobs method was deprecated Use a Generator for job list to fix background-job:list command #36073
• OCP\BackgroundJob\IJobList::getJobsIterator method was added Use a Generator for job list to fix background-job:list command #36073
• New OCP\BeforeSabrePubliclyLoadedEvent event dispatched on public webdav endpoints (it can be used just like OCP\SabrePluginEvent to inject additional Sabre plugins in apps for example) Rename SabrePublicPluginEvent to BeforeSabrePubliclyLoadedEvent #35789
• Signatures of methods of OCP\AppFramework\Db\Entity changed as follows: (ref: e91457d)
  • public static function fromParams(array $params) -> public static function fromParams(array $params): static
  • public static function fromRow(array $row) -> public static function fromRow(array $row): static
  • protected function setter($name, $args) -> protected function setter(string $name, array $args): void
  • protected function getter($name) -> protected function getter(string $name): mixed
  • protected function markFieldUpdated($attribute) -> protected function markFieldUpdated(string $attribute): void
• Deprecated OCP\AppFramework\Db\Mapper was removed. You can easily migrate to OCP\AppFramework\Db\QBMapper, which is doing the same thing using the query builder instead of string based queries.
  PR by rullzer at Remove long depreated AppFramework/Db/Mapper #34490
• Middlewares can be registered globally: feat(app-framework): Add support for global middlewares #36310 https://docs.nextcloud.com/server/latest/developer_manual/basics/middlewares.html#global-middlewares
• Controller action annotation @UseSession is deprecated. Use new UseSession attribute instead: feat(app-framework): Add UseSession attribute to replace annotation #36363 https://docs.nextcloud.com/server/latest/developer_manual/app_publishing_maintenance/app_upgrade_guide/upgrade_to_26.html#migration-from-phpdoc-annotations-to-native-php-attributes
• OCP\Files\SimpleFS\ISimpleFile::getSize() may now return a float (to support sizes >2G on 32bit systems)
• OCP\Files\SimpleFS\InMemoryFile::getSize() may now return a float (to support sizes >2G on 32bit systems)
• It is not required anymore to call setParsedSubject and setParsedMessage on notifications and activity events when setRichSubject and setRichMessage are used a parsed version is computed automatically. Compute notification parsed subject from rich subject when possible #34807
• A new OCP API OCP\Translation was introduced allowing to register translation providers and providing a central API to translate text, as well as OCS API endpoints: feat(translations): Add translation provider API #36584

Removed from public namespace:

• OCP\BackgroundJob\IJobList::getAll method was removed Use a Generator for job list to fix background-job:list command #36073
• 3rdparty dependency php-ds/php-ds was removed chore: drop dependency php-ds #36198
• OCP\Contacts\IManager::getAddressBooks method was removed Remove some constants and functions which have been long deprecated #34329
• OCP\Util loglevel constants were removed Remove some constants and functions which have been long deprecated #34329
• 3rdparty dependency nikic/php-parser was removed chore: drop depedency php-parser #36393
• Deprecated classes of OCP\Dashboard were removed chore(OCP): Remove deprecated dashboard interfaces and classes #35966

Removed from private namespace:

• …

Deprecations

• Planned removal of PSR-0 class loading: Nextcloud is still loading classes that follow the long deprecated and replaced PSR-0 standard. Nextcloud 26 is the last version that register a generic PSR-0 class loader. From Nextcloud 27 on apps have to either change class file names to match PSR-4 or ship their own (composer) class loader for PSR-0 files or.
  Pull request by ChristophWurst: perf(autoloader): Drop legacy class autoloader #36114

Deprecations of Events & Hooks

• Notifications jQuery event deprecated: The OCA.Notification.Action event of the notifications app is deprecated in favor of a notifications:action:executed event-bus event with Trigger a proper event-bus event notifications#728

Behavorial changes

• …

Changes for admins

• PHP 7.4 is not supported anymore
• PHP 8.2 is now supported
• The recommended webserver configuration has changed to no longer include a default redirect to the login page
  • For Apache this change will automatically come with the .htaccess file provided by the release
  • for nginx administrators should ensure that their config is up to date with the documentation
    • The relevant lines to remove are error_page 403 /core/templates/403.php; and error_page 404 /core/templates/404.php;
• The admin panel setup checks do now expect the X-Robots-Tag header to be set to noindex, nofollow, instead of none. While both are equivalent for Google, for other search engines, e.g. Bing, they are not. The value none hence does not prevent your Nextcloud pages from being index by and presented as Bing search results: Change X-Robots-Tag header from "none" to "noindex, nofollow" #36689

[jancborchardt]

Added

The "app icons" background https://github.com/nextcloud/server/blob/stable25/core/img/background.png and https://github.com/nextcloud/server/blob/stable25/core/img/background.svg is not used anymore and will be removed (was only used on login page, where we now use the "clouds" background.

[szaimen]

Added

Changes for admins

• 32-bit compatibility got removed and updates will get blocked:

  • remove 32-bit workarounds #34907
  • update 64-bit check wording #34906
  • 64-bit is required for NC26 documentation#9274
  • disable upgrades to 26 for 32-bit #34908
  • disable upgrades to 26 on 32-bit updater#446

[miaulalala]

Breaking change backend:

#34893

move ICreateFromString::handleIMipMessage(string $name, string $calendarData): void; to its own Interface

Added

• Moved ICreateFromString::handleIMipMessage(string $name, string $calendarData): void; to its own Interface IHandleImipMessage

[szaimen]

@miaulalala can you also edit the first post?

[enoch85]

When will PHP 7.4 be deprecated?

[nickvergessen]

See https://help.nextcloud.com/t/on-the-roadmap-deprecation-of-php-7-4/149848 for more information

TLDR: deprecation in 26, removal might be as well or later depending on our dependencies

[nickvergessen]

Added

Backend

• Auto-Submitted header for emails: There now is a new method on the OCP\Mail\IMessage interface IMessage::setAutoSubmitted(). With this method you can specify that an email was an automatic email or response, to allow mail servers to better detect if an out-of-office reply should be sent, better store/filter the emails and so on. Possible values are documented in the OCP\Mail\Headers\AutoSubmitted interface.
  Pull request by bennet0496: Adding option to set Auto-Submitted email header #35876

[nickvergessen]

@individual-it please always leave a comment, so people are notified.

Added

Backend

• Created a new public interface \OCP\Authentication\Token\IProvider with a method invalidateTokensOfUser to invalidate all tokens of a specific user. \OC\Authentication\Token\Manager implements \OCP\Authentication\Token\IProvider.
  Pull request by individual-it: [master] invalidate existing tokens when deleting an oauth client #36033

[nickvergessen]

Backend

Deprecations

• Planned removal of PSR-0 class loading: Nextcloud is still loading classes that follow the long deprecated and replaced PSR-0 standard. Nextcloud 26 is the last version that register a generic PSR-0 class loader. From Nextcloud 27 on apps have to either change class file names to match PSR-4 or ship their own (composer) class loader for PSR-0 files or.
  Pull request by ChristophWurst: perf(autoloader): Drop legacy class autoloader #36114

[come-nc]

Added:

Backend

• OCP\BackgroundJob\IJobList::getJobs method was deprecated Use a Generator for job list to fix background-job:list command #36073
• OCP\BackgroundJob\IJobList::getJobsIterator method was added Use a Generator for job list to fix background-job:list command #36073

Removed from public namespace:

• OCP\BackgroundJob\IJobList::getAll method was removed Use a Generator for job list to fix background-job:list command #36073

[come-nc]

Added:

Backend

• Signatures of methods of OCP\AppFramework\Db\Entity changed as follows:
  • public static function fromParams(array $params) -> public static function fromParams(array $params): static
  • public static function fromRow(array $row) -> public static function fromRow(array $row): static
  • protected function setter($name, $args) -> protected function setter(string $name, array $args): void
  • protected function getter($name) -> protected function getter(string $name): mixed
  • protected function markFieldUpdated($attribute) -> protected function markFieldUpdated(string $attribute): void

[nickvergessen]

Added by @julien-nc

Backend

• New OCP\BeforeSabrePubliclyLoadedEvent event dispatched on public webdav endpoints (it can be used just like OCP\SabrePluginEvent to inject additional Sabre plugins in apps for example) Rename SabrePublicPluginEvent to BeforeSabrePubliclyLoadedEvent #35789

[nickvergessen]

Added by rullzer

Backend

• Deprecated OCP\AppFramework\Db\Mapper was removed. You can easily migrate to OCP\AppFramework\Db\QBMapper, which is doing the same thing using the query builder instead of string based queries.
  PR by rullzer at Remove long depreated AppFramework/Db/Mapper #34490

[nickvergessen]

Added by @ChristophWurst

Backend

• Middlewares can be registered globally: feat(app-framework): Add support for global middlewares #36310

[nickvergessen]

27 follow up in #37039

[MichaIng]

Added

Changes for admins

• The admin panel setup checks do now expect the X-Robots-Tag header to be set to noindex, nofollow, instead of none. While both are equivalent for Google, for other search engines, e.g. Bing, they are not. The value none hence does not prevent your Nextcloud pages from being index by and presented as Bing search results: Change X-Robots-Tag header from "none" to "noindex, nofollow" #36689

[marcelklehr]

Added

Backend

• A new OCP API OCP\Translation was introduced allowing to register translation providers and providing a central API to translate text, as well as OCS API endpoints: feat(translations): Add translation provider API #36584

[skjnldsv]

27 changes: #37039