Skip to content

docs(windows): correct PHP version requirements - #104

Open
nicdavidson wants to merge 1 commit into
mainfrom
docs/windows-php-version-fix
Open

docs(windows): correct PHP version requirements#104
nicdavidson wants to merge 1 commit into
mainfrom
docs/windows-php-version-fix

Conversation

@nicdavidson

@nicdavidson nicdavidson commented Aug 12, 2026

Copy link
Copy Markdown
Collaborator

The Windows install page gave two wrong PHP answers.

Prerequisites checklist said PHP 8.1 or 8.3.
PHP section said "the latest supported PHP version is 8.3.16" and linked a direct 8.3.16 download.

composer.json requires "php": "^8.3", which admits 8.3, 8.4 and 8.5. config.platform.php is 8.3. Our Linux installer sets DEFAULT_PHP_VERSION="php8.5" and centos.sh has an assert_php85_active check, so 8.5 is what we actually build and test against.

So the page excluded the version we ship and recommended one we do not support.

State of Vermont followed this page onto PHP 8.1 during a 7.7 install this week.

Changes

  • Prerequisites: PHP 8.3 or newer, note that 8.1 and 8.2 are unsupported
  • PHP section: state the ^8.3 constraint, note 8.5 is what the Linux installer provisions, point readers at the require block of their shipped composer.json as authoritative
  • Warn against --ignore-platform-reqs instead of leaving it as an undocumented escape hatch
  • Oracle section: stop pinning oci8 3.2.1 against a hardcoded "DreamFactory runs on PHP 8.3"; tell the reader to match their installed PHP

Paired with https://github.com/dreamfactorysoftware/df-wiki/pull/11, which fixes the same text on the wiki copy of this page.

The prerequisites checklist said 'PHP 8.1 or 8.3' and the PHP section pinned
8.3.16. composer.json requires php ^8.3, which admits 8.3, 8.4 and 8.5, and
our Linux installer provisions 8.5. Both statements were wrong, and 8.1 is not
supported at all.

State of Vermont followed this page onto 8.1 during a 7.7 install.

Also:
- warn against --ignore-platform-reqs rather than leaving it as an escape hatch
- stop pinning oci8 3.2.1 against a hardcoded 'DreamFactory runs on PHP 8.3';
  tell the reader to match their installed PHP instead
@netlify

netlify Bot commented Aug 12, 2026

Copy link
Copy Markdown

Deploy Preview for dreamfactory-docs ready!

Name Link
🔨 Latest commit 67ea45d
🔍 Latest deploy log https://app.netlify.com/projects/dreamfactory-docs/deploys/6a7ca2ebc610310008979bf3
😎 Deploy Preview https://deploy-preview-104--dreamfactory-docs.netlify.app
📱 Preview on mobile
Toggle QR Code...

QR Code

Use your smartphone camera to open QR code link.

To edit notification comments on pull requests, go to your Netlify project configuration.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant