Hacktoberfest 2026: le issue che i maintainer hanno segnato per ottobre, aperte e adatte ai principianti. Sfoglia le issue Hacktoberfest

Make native filesystem directory permissions configurable to support shared POSIX ACL access

Aperta Adatta ai principianti
  • Qualcosa non va?
#15,566 0 commenti 0 reazioni 0 assegnatari Vedi su GitHub

I maintainer di solito rispondono entro 1 giorno

Nessuno ha ancora preso questa issue.

Valutazione

Difficoltà
2/5
Tempo stimato
1-3 ore
Idoneità per principianti
74/100
Tipo di issue
Funzionalità
Chiarezza
Specificata chiaramente
Stato di attività
Attiva
Stack tecnologico
laravel, php
Ambito
backend

Direzione di ricerca

Parti da src/Filesystem/AbstractAdapter.php::makeDirectory(), dove la modalità 0755 è inserita in modo fisso, e da src/Providers/ViewServiceProvider.php::boot(), che durante l'avvio fa creare le directory storage/statamic/tmp/nocache. Aggiungi un'impostazione directory_permissions con valore predefinito 0755 in config/statamic/system.php e leggila dove makeDirectory passa la modalità, senza toccare la configurazione del writer di pagine statiche e senza applicare chmod a directory esistenti. Si è completati quando un 0775/0770 configurato viene usato per le directory appena create (coperto da un test sull'adaptatore nativo) mentre il comportamento predefinito resta invariato.

Scritto dal modello di indicizzazione a partire dal testo della issue.

Descrizione

Bug description

Statamic’s native filesystem adapter creates directories with a hardcoded 0755 mode. On Linux deployments where CLI and web processes use different Unix accounts and share write access through POSIX ACLs, this restricts the inherited access ACL mask to r-x.

The named user entries are inherited, but their effective write permission is removed. This can prevent Blade nocache fragments from being written:

file_put_contents(.../storage/statamic/tmp/nocache/_nocache….blade.php):
Failed to open stream: Permission denied

The permission mechanism was reproduced locally using Statamic’s native filesystem adapter.

Relevant code

This path uses the native filesystem adapter, so Laravel disk permissions configured in config/filesystems.php do not affect it. The static page writer’s configurable permissions also do not cover these temporary Blade views.

Reproduction
Proposed change

Expose the native filesystem directory creation mode through configuration, preserving 0755 as the default for backwards compatibility.

For example, introduce a setting in config/statamic/system.php:

'directory_permissions' => 0755,

The native adapter would use that configured mode instead of the hardcoded value. Deployments using shared group or ACL access could choose 0775 or 0770.

This should affect newly created directories only, without recursively changing existing permissions or altering the separate static page writer configuration.

Expected behavior

With a configured mode of 0775 or 0770, inherited ACL write permissions remain effective for the other account, allowing CLI and web processes to share Statamic’s temporary directories.

Changing the process umask alone cannot solve this: it cannot add the group-class write bit missing from the explicitly requested 0755 mode.

How to reproduce

In a disposable application checkout:

  1. Use different Unix accounts for CLI commands and web requests.
  2. Grant both accounts write access to storage/statamic through access and default ACLs, with a default mask of rwx.
  3. Start with storage/statamic/tmp/nocache absent.
  4. Boot the application through a CLI command.
  5. Render a Blade template containing a nocache region through the web account.

Directories created by the CLI account inherit ACLs like:

user::rwx
user:web_account:rwx       #effective:r-x
group::rwx                #effective:r-x
mask::r-x
default:user:web_account:rwx
default:mask::rwx

The web account cannot create the fragment. The directory owner retains write access; the failure affects the other account accessing it through the masked ACL entries.

Restoring the access mask allows writing again:

setfacl -R -m m::rwX storage/statamic/tmp
Logs
Environment
- Statamic: 6.34.1
- Laravel: 12.69.3
Installation

Fresh statamic/statamic site via CLI

Additional details

No response

Lingua principale
PHP
Stelle
4.9k
Fork
647
Merge medio
1g 7h
PR unite (30g)
103

Preparare l'ambiente

Questo progetto non fornisce container di sviluppo, Dockerfile né guida per i contributori, quindi l'ambiente è a tuo carico: parti dal suo README e consulta la nostra guida al primo contributo per i passaggi generali.

Come iniziare

  1. Leggi tutta la issue e poi la guida ai contributi del progetto.
  2. Commenta sulla issue per dire che te ne occupi tu — evita che due persone facciano lo stesso lavoro.
  3. Fai un fork del repository e lavora su un branch.
  4. Apri una pull request che faccia riferimento al numero della issue.

Altre issue di statamic/cms

Tutte le issue di statamic/cms

Issue simili

Altre issue su PHP

Ricevi le nuove issue nella tua casella

Un breve riepilogo di issue GitHub adatte ai principianti.