search

owncloud / docs-server

ownCloud Server Documentation
https://doc.owncloud.com
GNU Affero General Public License v3.0
12 stars 31 forks source link

Add php. warnings #77

Open cdamken opened 2 years ago

cdamken commented 2 years ago

WHAT Needs to be Documented?

While upgrading the owncloud, should be consider the php versions too.

WHERE Does This Need To Be Documented (Link)?

https://github.com/owncloud/docs-server/blob/10.9/modules/admin_manual/partials/maintenance/major_release_note.adoc

WHY Should This Change Be Made?

Because the users will upgrade but not know that not all versions from oC works with all versions from php, specially when comming from 7 , 8 and 9

(Optional) What Type Of Content Change Is This?

(Optional) Which Manual Does This Relate To?

cdamken commented 2 years ago

I see the comment:

For details see the [Server Release Notes](https://doc.owncloud.com/docs/next/server_release_notes.html) and the [System Requirements](https://doc.owncloud.com/server/10.9/admin_manual/maintenance/upgrading/upgrade.html#10.9@server:installation/system_requirements.adoc) for the latest Release.

In both pages, there is actually not a well-described text which ownCloud works with min and max versions of PHP

Should the user read between lines or am I missing something?

cdamken commented 2 years ago

Probably adding this table:

Version Can Upgrade to 10.9.1 ? Requirements
10.9.1 PHP 7.2 to 7.4
10.X.Y Yes PHP 7.0 to 7.4
9.1.8 Yes PHP 7.0
9.1.0 Yes PHP 7.0
9.0.9 Yes PHP 7.0
9.0.8 No Must upgrade to 9.0.9 first. PHP 7.0
8.2.11 Yes PHP 5.6 or 7.0
8.2.10 No Must upgrade to 8.2.11 first.- PHP 5.6
7.0.15 No Must upgrade to 8.0.16, then to 8.1.12, and then to 8.2.11 first. - PHP 5.6
7.0.10 No Must upgrade to 7.0.15, then to 8.0.16, then to 8.1.12, and then to 8.2.11 first. - PHP 5.6
cdamken commented 2 years ago

From the 7.0 versions, I'm not sure 100% I couldn't find the information in the pages.

mmattel commented 2 years ago

Should the user read between lines or am I missing something?

The reader is clearly directed to the release notes and other stuff in the upgrade document where these things are described. (Before beginning an upgrade, please keep the following points in mind: and the following list)

But the add on info you provided in the table is helpful and I will add it asap.

cdamken commented 2 years ago

Thanks a lot!

mmattel commented 2 years ago

closing via #95

enbrnz commented 2 years ago

PHP 7.2 support was deprecated with ownCloud 10.8.0 I would recommend to update the table (see below) to show only PHP 7.3 & 7.4 as compatible versions.

Probably adding this table: Version Can Upgrade to 10.9.1 ? Requirements 10.9.1 PHP 7.2 to 7.4 10.X.Y Yes PHP 7.0 to 7.4 9.1.8 Yes PHP 7.0 9.1.0 Yes PHP 7.0 9.0.9 Yes PHP 7.0 9.0.8 No Must upgrade to 9.0.9 first. PHP 7.0 8.2.11 Yes PHP 5.6 or 7.0 8.2.10 No Must upgrade to 8.2.11 first.- PHP 5.6 7.0.15 No Must upgrade to 8.0.16, then to 8.1.12, and then to 8.2.11 first. - PHP 5.6 7.0.10 No Must upgrade to 7.0.15, then to 8.0.16, then to 8.1.12, and then to 8.2.11 first. - PHP 5.6