Problem/Motivation

Currently the installer has:

if (version_compare(PHP_VERSION, '7.3.0') < 0) {
+  print 'Your PHP installation is too old. Drupal requires at least PHP 7.3.0. See <a href="http://php.net/supported-versions.php">PHP\'s version support documentation</a> and the <a href="https://www.drupal.org/docs/system-requirements/php-requirements">Drupal PHP requirements</a> page for more information.';
   exit;
 }

However, once #2917655: [9.4.x only] Drop official PHP 7.3 support in Drupal 9.4, it could be bad user experience for them to then upgrade to PHP 7.4, then get a nearly identical message that PHP 7.4 is too old.

If they read the second link in detail, they'd know not to pick PHP 7.4 either. But a lot of people don't read docs.

Proposed resolution

'Your PHP installation is too old. Refer to the Drupal PHP requirements for the currently recommended PHP version for this release. See PHP\'s version support documentation for more information on PHP's own support schedule.';

User interface changes

Before

After

API changes

N/A

Data model changes

N/A

Release notes snippet

N/A

Issue fork drupal-3272275

Command icon Show commands

Start within a Git clone of the project using the version control instructions.

Or, if you do not have SSH keys set up on git.drupalcode.org:

Comments

xjm created an issue. See original summary.

eelkeblok’s picture

Title: Decide what to stay very early in the installer if the site is below the absolute minimum » Decide what to say very early in the installer if the site is below the absolute minimum
Issue summary: View changes

Fixed some typos.

eelkeblok’s picture

How about we drop the "Drupal requires at least PHP 7.3.0." to stop any confusion arising and make it (even) more obvious the links contain the information needed:

Your PHP installation is too old. Please refer to the Drupal PHP requirements page for the currently recommended version and PHP\'s version support documentation for more information.

The documentation page also says PHP 7.3 is supported, but with a warning icon indicating it is nit *recommended*, so I guess that's the nuance that is needed.

xjm’s picture

Issue tags: +Drupal 9.4 target

 

xjm’s picture

@eelkeblok, that's a worthwhile idea. 👍 Next step then is to create an MR and demo it for UX review, I think.

eelkeblok’s picture

Status: Active » Needs review

OK, step 1. I bet there are one or two tests that will not like this.

FWIW, I have no idea how to demo it for UX review...

xjm’s picture

Thanks @eelkeblok!

FWIW, I have no idea how to demo it for UX review...

I do one of two things:

  1. Actually install an old PHP version locally.
  2. Edit the PHP version in the if statement around this to be a higher PHP version than the one I have installed.

And then run the installer.

xjm’s picture

Status: Needs review » Needs work

NW for points on the MR review, thanks!

eelkeblok’s picture

Sorry, I meant the "soft" part of that, how to get it in front of the UX team. I actually tested the code much like you suggested :)

ravi.shankar made their first commit to this issue’s fork.

eelkeblok’s picture

Thanks. I pushed another commit that restores the "Your PHP version is too old.", I think that was removed unintentionally. Without it, I think the message is not explicit enough.

eelkeblok’s picture

Status: Needs work » Needs review

Version: 9.4.x-dev » 9.5.x-dev

Drupal 9.4.0-alpha1 was released on May 6, 2022, which means new developments and disruptive changes should now be targeted for the 9.5.x-dev branch. For more information see the Drupal core minor version schedule and the Allowed changes during the Drupal core release cycle.

quietone made their first commit to this issue’s fork.

quietone’s picture

StatusFileSize
new14.16 KB
new18.25 KB

Just making the recommended change and updating the IS.

quietone’s picture

Issue summary: View changes

My changes to the IS were lost - trying again.

Version: 9.5.x-dev » 10.1.x-dev

Drupal 9.5.0-beta2 and Drupal 10.0.0-beta2 were released on September 29, 2022, which means new developments and disruptive changes should now be targeted for the 10.1.x-dev branch. For more information see the Drupal core minor version schedule and the Allowed changes during the Drupal core release cycle.

smustgrave’s picture

The change looks good to me and make sense +1

Think we missed the 9.4 target. Should this go into 9.5 or be pushed to 10.1? If pushed @quietone can you update the MR please?

xjm’s picture

UI changes like this are minor-only, so the issue is correctly filed against 10.1.x. Thanks!

smustgrave’s picture

Status: Needs review » Needs work

Moving to NW to open a new MR for 10.1

Finding quickly updating an MR from 9.x to 10.x is causing a headache so disregard #19 comment.

smustgrave’s picture

Status: Needs work » Needs review

Opened up a D10 branch but think that takes me out of the review process.

xjm’s picture

I closed the old 9.5.x MR.

xjm’s picture

Issue tags: -Drupal 9.4 target
sergiogsanchez’s picture

Status: Needs review » Reviewed & tested by the community
Issue tags: +Drupal 9.4 target
StatusFileSize
new80.76 KB

I tested patch #3120 on a PHP 7.3 environment; it works as expected, and the links are correctly pointed to the Drupal and PHP documentation.

I checked the root path, disabling the composer platform check and going directly to /core/install.php

  • xjm committed 393596dc on 10.1.x
    Issue #3272275 by eelkeblok, smustgrave, xjm, ravi.shankar, quietone,...

  • xjm committed ced9990e on 10.0.x
    Issue #3272275 by eelkeblok, smustgrave, xjm, ravi.shankar, quietone,...

  • xjm committed f90f7ff6 on 9.5.x
    Issue #3272275 by eelkeblok, smustgrave, xjm, ravi.shankar, quietone,...
xjm’s picture

Version: 10.1.x-dev » 9.5.x-dev
Status: Reviewed & tested by the community » Fixed

Thanks @sergiogsanchez!

I provided some review that resulted in the current text, but it was based off @eelkeblok's suggestion, and has been reviewed by several other people since, so I feel comfortable committing this. Committed to 10.1.x.

As I indicated in #20, this is a UI change. It won't affect existing sites, because it's the installer. Sometimes, changes to the installer can be disruptive; however, in this case, someone reaching this page wouldn't get anywhere anyway. Furthermore, we're not even breaking translated strings. So, contrary to my previous statement, I did also go ahead and backport this to 10.0.x with a cherry-pick, and to 9.5.x using the old MR for the backport version.

Thanks everyone!

Status: Fixed » Closed (fixed)

Automatically closed - issue fixed for 2 weeks with no activity.