Installing Drupal 11 on Shared Hosting: How to Overcome the web/ Directory Limitation

1️⃣ Prepara l'ambiente e ripulisci public_html

Prima di iniziare, assicurati che la cartella pubblica del tuo dominio sia completamente svuotata. Collega il terminale SSH ed esegui la pulizia profonda azzerando anche la cache utente di Composer per evitare conflitti con vecchi metadati orfani:

📋 Copy via SSH

# Move to the target public folder
cd ~/domains/tuodominio.it/public_html

# Purge all visible files and folders
rm -rf *

# Purge all hidden files and system dotfiles
rm -rf .[^.]* 2>/dev/null

# Clear Composer's physical global user cache to prevent metadata conflicts
rm -rf ~/.composer/cache
composer clear-cache

IMPORTANTE: sostituisci in tutta la guida "tuodominio.it" con il tuo dominio reale (es. "test26.sviluppo.host").

2️⃣ Scarica la struttura di Drupal con installazione congelata (--no-install)

Generiamo una sandbox temporanea protetta direttamente all'interno della cartella pubblica. Utilizzando il flag --no-install scaricheremo solo i file di configurazione iniziali di Drupal (blueprint), congelando il download del core per permetterci di impostare i percorsi flat nel passaggio successivo:

2️⃣ Step 2

📋 Copy via SSH

# Download the initial Drupal configuration files into a nested sandbox directory
composer create-project drupal/recommended-project drupal11tmp --no-install

# Enter the newly generated sandbox directory
cd drupal11tmp

3️⃣ Sposta i file per la struttura FLAT

Spostiamo tutto il contenuto strutturale ereditato dalla cartella predefinita web/ direttamente nella radice corrente della nostra sandbox, rimuovendo poi la vecchia directory vuota:

3️⃣ Step 3

📋 Copy via SSH

# Copy all visible contents from the web folder to the current directory (silencing empty warnings)
cp -R web/* . 2>/dev/null

# Copy all hidden files (dotfiles) from the web folder to the current directory
cp -R web/.[^.]* . 2>/dev/null

# Remove the empty web directory
rm -rf web

🔍 Nota di trasparenza (Cosa sta succedendo?): Se controlli la cartella adesso tramite il File Manager, vedrai solo tre file (tra cui composer.json). È del tutto normale! Avendo congelato l'installazione al Punto 2, i veri file fisici del core di Drupal verranno calcolati e scritti solo tra poco.

4️⃣ Modifica il file composer.json per la struttura FLAT

//* Open the composer.json file located in the temporary folder (using your hosting provider's editor or a text editor via SSH, such as nano composer.json) and configure it for the FLAT structure.

We need to make three precise changes: set the web root to ./, remove the web/ prefix from all entries in installer-paths, and—most importantly—add the directive to disable symbolic links. The file must look exactly like this: *//

📋 Copy via composer.json

{
    "name": "drupal/recommended-project",
    "type": "project",
    "repositories": {
        "drupal": {
            "type": "composer",
            "url": "https://packages.drupal.org/8"
        }
    },
    "require": {
        "composer/installers": "^2.3",
        "drupal/core-composer-scaffold": "^11.4",
        "drupal/core-recipe-unpack": "^11.4",
        "drupal/core-project-message": "^11.4",
        "drupal/core-recommended": "^11.4",
        "drupal/metatag": "^2.2"
    },
    "config": {
        "allow-plugins": {
            "composer/installers": true,
            "drupal/core-composer-scaffold": true,
            "drupal/core-recipe-unpack": true,
            "drupal/core-project-message": true,
            "symfony/runtime": true
        }
    },
    "extra": {
        "drupal-scaffold": {
            "//2": "Force core entry scripts (index.php, .htaccess) to populate directly on current root",
            "locations": {
                "web-root": "./"
            },
            "//3": "Disable symbolic links generation to bypass restricted hosting server rules",
            "symlinks": false,
            "//3b": "Authorize scaffold plugin to generate files safely on the root folder",
            "allowed-packages": [
                "*"
            ]
        },
        "installer-paths": {
            "core": ["type:drupal-core"],
            "libraries/{$name}": ["type:drupal-library"],
            "modules/contrib/{$name}": ["type:drupal-module"],
            "profiles/contrib/{$name}": ["type:drupal-profile"],
            "themes/contrib/{$name}": ["type:drupal-theme"],
            "drush/Commands/contrib/{$name}": ["type:drupal-drush"],
            "modules/custom/{$name}": ["type:drupal-custom-module"],
            "profiles/custom/{$name}": ["type:drupal-custom-profile"],
            "themes/custom/{$name}": ["type:drupal-custom-theme"],
            "recipes/{$name}": ["type:drupal-recipe"]
        }
    }
}

5️⃣ Abilita i plugin ed esegui lo Scaffold nella Sandbox

Autorizziamo il plugin dello Scaffold, avviamo il download dei pacchetti ed eseguiamo la generazione dei file di avvio direttamente all'interno della sandbox temporanea:

📋 Copy via SSH

# Step 1: Whitelist and authorize the core composer scaffold plugin explicitly
composer config allow-plugins.drupal/core-composer-scaffold true

# Step 2: Trigger the layout codebase package download
composer install --no-plugins

# Step 3: Run the scaffold with native plugins enabled to generate core files
composer drupal:scaffold

# Step 4: Build a clean mapping file for the PHP class loader
composer dump-autoload

6️⃣ Svuota la sandbox a "imbuto" nella cartella pubblica principale

Ora che l'installazione FLAT è pronta nella sandbox ed è completa di tutti i file vitali generati (come index.php, .htaccess, la cartella core/ e la cartella vendor/), dobbiamo portare tutto fuori e riversarlo nella directory pubblica finale del dominio.

Rimani all'interno della cartella drupal11tmp ed esegui il comando di spostamento a imbuto verso la cartella superiore (..):

📋 Copy via SSH

# Move all visible deployment files and folders up to public_html
mv * ..

# Move all hidden configuration files and dotfiles up to public_html
mv .[^.]* .. 2>/dev/null

Nota: Il secondo comando serve a spostare i file nascosti fondamentali (come il file .htaccess o i file di configurazione con il punto iniziale). L'errore finale restituito dal terminale è del tutto normale, poiché il sistema ti avviserà che non può spostare la cartella corrente in sé stessa o la cartella superiore.

8️⃣ Step 8

📋 Copy via SSH

# Step back up into your main web document root (public_html / httpdocs)
cd ..

# Remove the empty sandbox directory safely
rmdir drupal11tmp

# Provision the system uploads folder and set directory permissions for shared hosting
mkdir -p sites/default/files
chmod 775 sites/default/files

9️⃣ Step 9

📋 Copy via SSH

# Regenerate the autoloader configuration targeting the final FLAT filesystem map
composer dump-autoload

🔟 Installa Drupal dal browser

🌐 Website URL

https://website.com

Installing Drupal 11 on Shared Hosting: How to Overcome the web/ Directory Limitation

1️⃣ Prepara l'ambiente e ripulisci public_html

2️⃣ Scarica la struttura di Drupal con installazione congelata (--no-install)

2️⃣ Step 2

3️⃣ Sposta i file per la struttura FLAT

3️⃣ Step 3

4️⃣ Modifica il file composer.json per la struttura FLAT

5️⃣ Abilita i plugin ed esegui lo Scaffold nella Sandbox

6️⃣ Svuota la sandbox a "imbuto" nella cartella pubblica principale

8️⃣ Step 8

9️⃣ Step 9

🔟 Installa Drupal dal browser

Contatti e supporto tecnico