diff --git a/language/wrappers/compression.xml b/language/wrappers/compression.xml new file mode 100644 index 00000000..8de0ab94 --- /dev/null +++ b/language/wrappers/compression.xml @@ -0,0 +1,141 @@ + + + + + + zlib:// + bzip2:// + zip:// + Flussi di compressione + + + + &reftitle.description; + compress.zlib:// e compress.bzip2:// + + + zlib: funziona come gzopen, tranne che il + flusso può essere utilizzato con fread e le altre + funzioni del filesystem. Questo è deprecato a causa di + ambiguità con i nomi di file contenenti il carattere ':'; utilizzare + compress.zlib:// al suo posto. + + + + compress.zlib:// e + compress.bzip2:// sono equivalenti a + gzopen e bzopen + rispettivamente, e funzionano anche su sistemi che non supportano + fopencookie. + + + + L'estensione ZIP registra il wrapper zip:. A partire da + PHP 7.2.0 e libzip 1.2.0+, è stato aggiunto il supporto per le password degli archivi crittografati, + permettendo di fornire le password tramite i contesti di flusso. Le password possono essere impostate utilizzando + l'opzione di contesto di flusso 'password'. + + + + + &reftitle.usage; + + compress.zlib://file.gz + compress.bzip2://file.bz2 + zip://archive.zip#dir/file.txt + + + + + &reftitle.options; + + + Riepilogo del wrapper + + + + Attributo + Supportato + + + + + Limitato da allow_url_fopen + No + + + Permette la lettura + + + + Permette la scrittura + Sì (tranne zip://) + + + Permette l'aggiunta + Sì (tranne zip://) + + + Permette la lettura e la scrittura simultanee + No + + + Supporta stat + + No, utilizzare il wrapper normale file:// + per ottenere le informazioni sui file compressi. + + + + Supporta unlink + + No, utilizzare il wrapper normale file:// + per eliminare i file compressi. + + + + Supporta rename + No + + + Supporta mkdir + No + + + Supporta rmdir + No + + + +
+
+
+ + + &reftitle.seealso; + + + + +
+ + diff --git a/language/wrappers/data.xml b/language/wrappers/data.xml new file mode 100644 index 00000000..add4bbc6 --- /dev/null +++ b/language/wrappers/data.xml @@ -0,0 +1,140 @@ + + + + + + data:// + Dati (RFC 2397) + + + + &reftitle.description; + + + Il wrapper di flusso data: (RFC + 2397). + + + + + &reftitle.usage; + + data://text/plain;base64, + + + + + &reftitle.options; + + + Riepilogo del wrapper + + + + Attributo + Supportato + + + + + Limitato da allow_url_fopen + + + + Limitato da allow_url_include + + + + Permette la lettura + + + + Permette la scrittura + No + + + Permette l'aggiunta + No + + + Permette la lettura e la scrittura simultanee + No + + + Supporta stat + No + + + Supporta unlink + No + + + Supporta rename + No + + + Supporta mkdir + No + + + Supporta rmdir + No + + + +
+
+
+ + + &reftitle.examples; + + Stampare il contenuto di data:// + + +]]> + + + + + Recuperare il tipo di media + + +]]> + + + + +
+ + diff --git a/language/wrappers/http.xml b/language/wrappers/http.xml new file mode 100644 index 00000000..7de6ad0c --- /dev/null +++ b/language/wrappers/http.xml @@ -0,0 +1,187 @@ + + + + + + http:// + https:// + Accesso a URL HTTP(s) + + + + &reftitle.description; + + Permette l'accesso in sola lettura a file/risorse tramite HTTP. + Per impostazione predefinita, viene utilizzata una richiesta HTTP 1.0 GET. Un'intestazione Host: viene inviata con la richiesta + per gestire gli host virtuali basati sul nome. Se è stata configurata + una stringa user_agent utilizzando + il file &php.ini; o il contesto dello stream, essa verrà inclusa + nella richiesta. + + + Lo stream permette l'accesso al corpo della + risorsa; le intestazioni sono memorizzate nella + variabile $http_response_header. + + + Se è importante conoscere l'URL della risorsa da cui + proviene il documento (dopo che tutti i reindirizzamenti sono stati elaborati), + è necessario elaborare la serie di intestazioni di risposta restituite dallo + stream. + + + La direttiva from verrà utilizzata per l'intestazione + From: se impostata e non sovrascritta dal + . + + + + + &reftitle.usage; + + http://example.com + http://example.com/file.php?var1=val1&var2=val2 + http://user:password@example.com + https://example.com + https://example.com/file.php?var1=val1&var2=val2 + https://user:password@example.com + + + + + &reftitle.options; + + + Riepilogo del wrapper + + + + Attributo + Supportato + + + + + Limitato da allow_url_fopen + + + + Permette la lettura + + + + Permette la scrittura + No + + + Permette l'aggiunta + No + + + Permette la lettura e la scrittura simultanee + N/A + + + Supporta stat + No + + + Supporta unlink + No + + + Supporta rename + No + + + Supporta mkdir + No + + + Supporta rmdir + No + + + +
+
+
+ + + &reftitle.examples; + + Rilevare l'URL finale dopo i reindirizzamenti + + +]]> + + + + + + &reftitle.notes; + + + HTTPS è supportato solo quando l'estensione openssl + è abilitata. + + + + Le connessioni HTTP sono in sola lettura; la scrittura di dati o la copia + di file verso una risorsa HTTP non è supportata. + + + L'invio di richieste POST e PUT, ad esempio, + può essere effettuato con l'aiuto dei contesti HTTP. + + + + + &reftitle.seealso; + + + $http_response_header + stream_get_meta_data + + + +
+ + diff --git a/language/wrappers/php.xml b/language/wrappers/php.xml new file mode 100644 index 00000000..a2c42f69 --- /dev/null +++ b/language/wrappers/php.xml @@ -0,0 +1,418 @@ + + + + + + php:// + Accesso a vari flussi di I/O + + + + &reftitle.description; + + PHP fornisce una serie di flussi di I/O che permettono l'accesso ai + flussi di input e output di PHP stesso, ai descrittori di file standard di + input, output e errore, a flussi di file temporanei in memoria e su disco, e + a filtri che possono manipolare altre risorse di file durante la lettura e + la scrittura. + + + + php://stdin, php://stdout e php://stderr + + php://stdin, php://stdout e + php://stderr permettono l'accesso diretto al + flusso di input o output corrispondente del processo PHP. Lo stream fa + riferimento a un descrittore di file duplicato, quindi se si apre + php://stdin e successivamente lo si chiude, viene chiusa + solo la copia del descrittore - il flusso effettivo referenziato da + STDIN non viene influenzato. + Si raccomanda di utilizzare semplicemente le costanti STDIN, + STDOUT e STDERR invece di + aprire manualmente gli stream utilizzando questi wrapper. + + + php://stdin è in sola lettura, mentre + php://stdout e php://stderr sono + in sola scrittura. + + + + + php://input + + php://input è un flusso in sola lettura che permette + di leggere i dati grezzi dal corpo della richiesta. + php://input non è disponibile nelle richieste POST con + enctype="multipart/form-data" se l'opzione + enable_post_data_reading + è abilitata. + + + + + php://output + + php://output è un flusso in sola scrittura che permette + di scrivere nel meccanismo del buffer di output allo stesso modo di + print e echo. + + + + + php://fd + + php://fd permette l'accesso diretto al descrittore + di file specificato. Ad esempio, php://fd/3 fa riferimento + al descrittore di file 3. + + + + + php://memory e php://temp + + php://memory e php://temp sono + flussi in lettura-scrittura che permettono di memorizzare dati temporanei + in un wrapper simile a un file. La differenza tra i due è che + php://memory memorizzerà sempre i suoi dati in memoria, + mentre php://temp utilizzerà un file temporaneo una volta + che la quantità di dati memorizzati raggiunge un limite predefinito (il valore + predefinito è 2 MB). La posizione di questo file temporaneo è determinata + nello stesso modo della funzione sys_get_temp_dir. + + + Il limite di memoria di php://temp può essere controllato + aggiungendo /maxmemory:NN, dove NN è + la quantità massima di dati da conservare in memoria prima di utilizzare un + file temporaneo, in byte. + + + + Alcune estensioni PHP potrebbero richiedere un flusso di IO standard, + e potrebbero tentare di convertire un dato flusso in un flusso di IO standard. + Questa conversione può fallire per i flussi in memoria poiché richiede la + funzione C fopencookie. + Questa funzione C non è disponibile su Windows. + + + + + + php://filter + + php://filter è una sorta di meta-wrapper progettato per + consentire l'applicazione di filtri a un + flusso al momento dell'apertura. Questo è utile con le funzioni di file + tutto-in-uno come readfile, + file e file_get_contents + dove non c'è altrimenti l'opportunità di applicare un filtro al flusso + prima che il contenuto venga letto. + + + Il target php://filter accetta i seguenti parametri + come parte del suo percorso. È possibile specificare più catene di filtri su un percorso. + Fare riferimento agli esempi per i dettagli sull'utilizzo di questi parametri. + + + + Parametri di php://filter + + + + Nome + Descrizione + + + + + + resource=<flusso da filtrare> + + + Questo parametro è obbligatorio. Specifica il flusso che si + desidera filtrare. + + + + + read=<elenco dei filtri da applicare alla catena di lettura> + + + Questo parametro è opzionale. È possibile fornire uno o più nomi di filtri + qui, separati dal carattere pipe (|). + + + + + write=<elenco dei filtri da applicare alla catena di scrittura> + + + Questo parametro è opzionale. È possibile fornire uno o più nomi di filtri + qui, separati dal carattere pipe (|). + + + + + <elenco dei filtri da applicare a entrambe le catene> + + + Qualsiasi elenco di filtri non preceduto da read= + o write= verrà applicato sia alla catena di lettura + che a quella di scrittura, secondo il caso. + + + + +
+
+
+
+ + + &reftitle.options; + + + + Riepilogo del wrapper (per <literal>php://filter</literal>, fare riferimento al + riepilogo del wrapper filtrato) + + + + + Attributo + Supportato + + + + + Limitato da allow_url_fopen + No + + + Limitato da allow_url_include + + Solo php://input, + php://stdin, + php://memory e + php://temp. + + + + Permette la lettura + + Solo php://stdin, + php://input, + php://fd, + php://memory e + php://temp. + + + + Permette la scrittura + + Solo php://stdout, + php://stderr, + php://output, + php://fd, + php://memory e + php://temp. + + + + Permette l'aggiunta + + Solo php://stdout, + php://stderr, + php://output, + php://fd, + php://memory e + php://temp. (Equivalente alla scrittura) + + + + Permette la lettura e la scrittura simultanee + + Solo php://fd, + php://memory e + php://temp. + + + + Supporta stat + + No. Tuttavia, php://memory e + php://temp supportano fstat. + + + + Supporta unlink + No + + + Supporta rename + No + + + Supporta mkdir + No + + + Supporta rmdir + No + + + Supporta stream_select + + Solo php://stdin, + php://stdout, + php://stderr, + php://fd e + php://temp. + + + + +
+
+
+ + + &reftitle.examples; + + php://temp/maxmemory + + Questo parametro opzionale permette di impostare il limite di memoria prima che + php://temp inizi a utilizzare un file temporaneo. + + + +]]> + + + + php://filter/resource=<flusso da filtrare> + + Questo parametro deve essere posizionato + alla fine della specifica php://filter e + deve puntare al flusso che si desidera filtrare. + + + +]]> + + + + php://filter/read=<elenco dei filtri da applicare alla catena di lettura> + + Questo parametro accetta uno o più + nomi di filtri separati dal carattere pipe |. + + + +]]> + + + + php://filter/write=<elenco dei filtri da applicare alla catena di scrittura> + + Questo parametro accetta uno o più + nomi di filtri separati dal carattere pipe |. + + + +]]> + + + + php://memory e php://temp non sono riutilizzabili + + php://memory e php://temp + non sono riutilizzabili, ovvero dopo che i flussi sono stati chiusi non c'è modo + di farvi riferimento nuovamente. + + + + + + + php://input per leggere dati JSON dal corpo della richiesta + + Questo esempio mostra come leggere dati JSON grezzi dalle richieste POST, PUT e + PATCH utilizzando php://input. + + + +]]> + + + +
+ +