Docs: PHP 8.4 is required, `--tag=wp-config` does not exist, and multisite config keys are absent

[ogorzalka]

Three documentation mismatches met while setting up a multisite project. Grouping them since they were all hit in the same session; happy to split.

1. PHP 8.3 is announced but 8.4 is required

getting-started.md states:

• PHP 8.3 or higher

composer create-project pollora/pollora on PHP 8.3 fails with 18 resolution problems, all of the same shape:

symfony/routing v8.0.9 requires php >=8.4 -> your php version (8.3.30) does not satisfy that requirement.

The shipped composer.lock pins Symfony 8, which requires PHP 8.4. Either the docs should say 8.4, or the lock should allow Symfony 7.

2. vendor:publish --tag=wp-config publishes nothing

installation.md documents:

php artisan vendor:publish --tag=wp-config

Actual result:

INFO  No publishable resources for tag [wp-config].

The tag is not registered anywhere. The config has to be copied by hand:

cp vendor/pollora/framework/config/wordpress.php config/wordpress.php

3. The documented multisite config keys do not exist

installation.md shows:

// config/wordpress.php
return [
    'wp_allow_multisite' => env('WP_ALLOW_MULTISITE'),
    'multisite' => env('MULTISITE'),
    'subdomain_install' => env('SUBDOMAIN_INSTALL'),
];

The shipped config/wordpress.php has only conditions, use_default_wp_theme_directory, enable_mail_handling, plugin_conditions, constants and cache. None of the multisite keys are present, and adding them at the top level has no effect.

They work when nested inside constants, where the snake_case key is mapped to the matching WordPress constant:

'constants' => [
    // ...
    'wp_allow_multisite'   => env('WP_ALLOW_MULTISITE', false),
    'multisite'            => env('MULTISITE', false),
    'subdomain_install'    => env('SUBDOMAIN_INSTALL', false),
    'domain_current_site'  => env('DOMAIN_CURRENT_SITE'),
    'path_current_site'    => env('PATH_CURRENT_SITE', '/'),
    'site_id_current_site' => env('SITE_ID_CURRENT_SITE', 1),
    'blog_id_current_site' => env('BLOG_ID_CURRENT_SITE', 1),
],

Worth documenting, since multisite has no usage guide beyond this config snippet.

Environment

Pollora v13.4.3 · WordPress 6.9.4 · PHP 8.4.20 · Laravel 13.8.0

https://claude.ai/code/session_01CtKVtFGujknnYGtcEEJD3x