Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
4 changes: 2 additions & 2 deletions README.md
Original file line number Diff line number Diff line change
Expand Up @@ -72,8 +72,8 @@ Monitoring remains disabled until you configure and enable Basicrum below.

## Compatibility

Tested with **Magento Open Source 2.4.7-p10**, **PHP 8.3**, Luma, and built-in
full-page cache. Other Magento/PHP combinations, Adobe Commerce, Hyvä,
Tested with **Magento Open Source 2.4.7-p10 and 2.4.8-p5**, **PHP 8.3**, Luma,
and built-in full-page cache. Native CI targets 2.4.8-p5. Other Magento/PHP combinations, Adobe Commerce, Hyvä,
headless/PWA storefronts, Varnish, and third-party optimizers are not verified.

## Configuration
Expand Down
25 changes: 25 additions & 0 deletions docs/QUALITY-AND-RELEASE-READINESS.md
Original file line number Diff line number Diff line change
Expand Up @@ -202,10 +202,35 @@ CI has not run for these uncommitted changes. This run reused the dedicated
disposable installation; it did not reprovision fresh volumes. No release or
push was performed.

## Native CI baseline update (2026-11-12)

Fresh Magento 2.4.7-p10 provisioning was blocked by
[GHSA-cxf4-7mrp-vvpr](https://github.com/thephpleague/flysystem/security/advisories/GHSA-cxf4-7mrp-vvpr):
its Flysystem 2 constraint cannot select a patched version. The baseline now uses
Magento 2.4.8-p5, PHP 8.3, Composer 2.10, MariaDB 11.4, OpenSearch 3.4.0, and
nginx 1.30.6. Composer security blocking remains enabled without exceptions.
Fresh dependency resolution selected Flysystem 3.36.0; the installed production
dependencies passed `composer audit --no-dev --abandoned=ignore` with no security
advisories. Abandoned-package notices remain separate from security findings.

The new `basicrum-release-baseline-248` Compose project uses fresh application
and database volumes, leaving the previous 2.4.7/10.11 volumes untouched. The
disposable Braintree exclusions also include the two additional 2.4.8 modules.

Local validation on committed candidate `ac1fd21934751a5de6d1dab36630d2d9dc3fb052`
passed the full archive/install/native gate: baseline checks, upgrade, DI
compilation, static deployment, native configuration saves, and 21 browser tests.
The four existing sample-data/order-creating tests remain explicitly skipped.
The focused PHP suite passed all 18 groups. Logs are retained locally in
`.test-results/native-baseline-248/`; remote checks are attached to
[PR #21](https://github.com/basicrum/basicrum-magento-2/pull/21).
This validates the test baseline, not a new package release or native PHP 8.5.

## Tested compatibility, not inferred compatibility

| Combination | Evidence in this follow-up |
| --- | --- |
| Magento Open Source 2.4.8-p5, PHP CLI/FPM 8.3.31, Composer 2.10.3, MariaDB 11.4, OpenSearch 3.4.0, nginx 1.30.6 | Fresh isolated installation and full native gate on the committed candidate above |
| Magento Open Source 2.4.7-p10, PHP CLI/FPM 8.3.31, Composer 2.10, MariaDB 10.11, OpenSearch 2.19.4 | Actual isolated installation, native configuration and browser checks |
| Luma, en_US, built-in FPC, deployed static files | Actual Admin/storefront, enforcing checkout CSP, consent/beacon/cookie/redaction and two-visitor HIT checks |
| PHP 8.2 / 8.4 | Focused PHP checks only; not native Magento runs |
Expand Down
21 changes: 14 additions & 7 deletions tests/integration/README.md
Original file line number Diff line number Diff line change
@@ -1,23 +1,30 @@
# Disposable Magento integration check

The declared Phase 1 baseline is pinned in `baseline.env`: Magento Open Source
2.4.7-p10 on PHP 8.3, with the listed Composer, MariaDB, and OpenSearch lines.
Adobe's current system-requirements table lists PHP 8.2 and 8.3 for the 2.4.7
release line. This is a baseline, not a claim that every patch or platform
combination has been verified.
The baseline is pinned in `baseline.env`: Magento Open Source 2.4.8-p5 on PHP
8.3, Composer 2.10, MariaDB 11.4, and OpenSearch 3.4. The web server is nginx
1.30. These versions follow [Adobe's system requirements](https://experienceleague.adobe.com/en/docs/commerce-operations/installation-guide/system-requirements).
This is a baseline, not a claim that every patch or platform combination has
been verified. Magento 2.4.7-p10 requires Flysystem 2, which cannot resolve past
[GHSA-cxf4-7mrp-vvpr](https://github.com/thephpleague/flysystem/security/advisories/GHSA-cxf4-7mrp-vvpr).
The 2.4.8 line permits the patched Flysystem 3 versions; Composer's security
blocking remains enabled without advisory exceptions.

## Magento-version/image-pinned local/CI stack

`sh tests/integration/docker/start.sh` creates the dedicated Compose project
`basicrum-release-baseline` using pinned image digests and the anonymous Mage-OS
mirror. It provisions exactly 2.4.7-p10, installs the pinned Playwright runner,
`basicrum-release-baseline-248` using pinned image digests and the anonymous Mage-OS
mirror. It provisions exactly 2.4.8-p5, installs the pinned Playwright runner,
and leaves existing Magento stacks alone. Docker, Compose, OpenSSL and several
GB of disk/RAM are required. Provisioning refuses to overwrite an installed
application; reuse it with the commands below, not `start.sh` again.
The full Magento Composer dependency closure is **not** locked in this repository.
Fresh provisioning resolves transitive dependencies from the mirror; upstream
releases/advisories can change that resolution or make installation fail. Image
digests and the Magento version pin do not promise bit-for-bit reproducibility.
The new Compose project name also gives this baseline fresh application/database
volumes. Existing `basicrum-release-baseline` volumes from 2.4.7 are retained and
never opened by the new MariaDB image; stop any old baseline containers before
using the shared localhost port.

The test browser runs inside the PHP container at `https://web:8443/`; the host
binding is loopback-only port **9443**, never 443 or the existing local shop's
Expand Down
8 changes: 4 additions & 4 deletions tests/integration/baseline.env
Original file line number Diff line number Diff line change
@@ -1,6 +1,6 @@
# Declared Phase 1 disposable-store integration baseline.
MAGENTO_VERSION=2.4.7-p10
# Declared disposable-store integration baseline.
MAGENTO_VERSION=2.4.8-p5
PHP_VERSION=8.3
COMPOSER_VERSION=2.10
MARIADB_VERSION=10.11
OPENSEARCH_VERSION=2.19
MARIADB_VERSION=11.4
OPENSEARCH_VERSION=3.4
9 changes: 5 additions & 4 deletions tests/integration/docker/compose.yaml
Original file line number Diff line number Diff line change
@@ -1,4 +1,5 @@
name: basicrum-release-baseline
# Keep the previous Magento 2.4.7/MariaDB 10.11 volumes untouched.
name: basicrum-release-baseline-248
services:
php:
build: .
Expand All @@ -19,7 +20,7 @@ services:
search:
condition: service_healthy
web:
image: markoshust/magento-nginx:1.28-0@sha256:12d211176a5800ef1ebdc909865a0a5ebc691d282a6df438b082ac5587f275de
image: nginx:1.30.6-alpine@sha256:583b7f2fce1cdb8da5ad5c39ebd3c33b98b87d493190e548bdee1fa8c619c311
ports:
- '127.0.0.1:9443:8443'
volumes:
Expand All @@ -29,7 +30,7 @@ services:
depends_on:
- php
db:
image: mariadb:10.11@sha256:07c0aaff7396b74cb7975cba78257178d188e30f531a5db2b617c48beef13c41
image: mariadb:11.4@sha256:5e73baf8179b29f115101bb102763a47a017361f3e9792daccba6646c3ab1532
environment:
MARIADB_DATABASE: magento
MARIADB_USER: magento
Expand All @@ -42,7 +43,7 @@ services:
interval: 5s
retries: 30
search:
image: opensearchproject/opensearch:2.19.4@sha256:9e0b3b3b6805811bd63d9b9503ffe34a58ba33d03cc346000e318c6ff5c05bd9
image: opensearchproject/opensearch:3.4.0@sha256:1647ce2e07371f1ac8bbad28890a64ef77c5a694a61f656120f0ace09e66bf48
environment:
discovery.type: single-node
DISABLE_SECURITY_PLUGIN: 'true'
Expand Down
5 changes: 3 additions & 2 deletions tests/integration/docker/provision.sh
Original file line number Diff line number Diff line change
Expand Up @@ -11,7 +11,7 @@ if [ -f app/etc/env.php ]; then
fi

composer create-project --repository-url=https://mirror.mage-os.org/ \
--no-install --no-interaction magento/project-community-edition . 2.4.7-p10
--no-install --no-interaction magento/project-community-edition . 2.4.8-p5
composer config repositories.magento composer https://mirror.mage-os.org/
composer config --unset repositories.0
composer install --no-dev --prefer-dist --no-interaction
Expand All @@ -27,7 +27,8 @@ php bin/magento setup:install --base-url="$MAGENTO_STOREFRONT_URL" \
# adds external scripts even without checkout; keep Magento_Paypal for CSP checks.
php bin/magento module:disable Magento_AdminAdobeImsTwoFactorAuth Magento_TwoFactorAuth \
Magento_AdminAnalytics PayPal_Braintree PayPal_BraintreeGraphQl \
PayPal_BraintreeCustomerBalance PayPal_BraintreeGiftCardAccount PayPal_BraintreeGiftWrapping
PayPal_BraintreeCustomerBalance PayPal_BraintreeGiftCardAccount PayPal_BraintreeGiftWrapping \
PayPal_BraintreeGiftCard PayPal_BraintreeReward
php bin/magento deploy:mode:set developer
php bin/magento config:set system/smtp/disable 1
# Admin Analytics is already disabled; its admin/usage/enabled field no longer exists.
Expand Down
10 changes: 5 additions & 5 deletions tests/php/run.php
Original file line number Diff line number Diff line change
Expand Up @@ -40,19 +40,19 @@
$tests['release baseline rejects wrong or missing platform versions'] = function () use ($root): void {
$expected = parse_ini_file($root . '/tests/integration/baseline.env', false, INI_SCANNER_RAW);
$matching = [
'MAGENTO_VERSION' => '2.4.7-p10',
'MAGENTO_VERSION' => '2.4.8-p5',
'PHP_VERSION' => '8.3.30',
'COMPOSER_VERSION' => '2.10.0',
'MARIADB_VERSION' => '10.11.14-MariaDB',
'OPENSEARCH_VERSION' => '2.19.4',
'MARIADB_VERSION' => '11.4.10-MariaDB',
'OPENSEARCH_VERSION' => '3.4.0',
];
basicrum_assert_same([], basicrum_baseline_errors($expected, $matching), 'declared platform passes');
foreach ([
'MAGENTO_VERSION' => '2.4.9',
'PHP_VERSION' => '8.5.6',
'COMPOSER_VERSION' => '2.1.0',
'MARIADB_VERSION' => '11.4.0-MariaDB',
'OPENSEARCH_VERSION' => '2.190.0',
'MARIADB_VERSION' => '10.11.14-MariaDB',
'OPENSEARCH_VERSION' => '3.40.0',
] as $key => $version) {
$wrong = array_replace($matching, [$key => $version]);
basicrum_assert_same([$key], array_keys(basicrum_baseline_errors($expected, $wrong)), $key . ' mismatch');
Expand Down
Loading