/php//
php:// — Åtkomst till olika I/O-strömmar
Beskrivning
PHP erbjuder ett antal olika I/O-strömmar som tillåter åtkomst till PHP:s egna in- och utgångsströmmar, standard in-, ut- och fel-fildeskriptorer, minnes- och diskbaserade tillfälliga filströmmar samt filter som kan manipulera andra filresurser när de läses eller skrivs.
php://stdin, php://stdout och php://stderr
php://stdin, php://stdout och php://stderr tillåter direkt åtkomst till motsvarande in- eller utgångsström för PHP-processen. Strömmen refererar till en duplicerad fildeskriptor, så om du öppnar php://stdin och senare stänger den, stänger du endast din kopia av deskriptorn – själva strömmen som refereras av STDIN påverkas inte. Det rekommenderas att du istället använder konstanterna STDIN, STDOUT och STDERR istället för att manuellt öppna strömmar med dessa omslag.
php://stdin är skrivskyddad, medan php://stdout och php://stderr är skrivbara.
php://input
php://input är en skrivskyddad ström som tillåter dig att läsa rådata från begärans kropp. php://input är inte tillgänglig i POST-begäranden med enctype="multipart/form-data" om alternativet enable_post_data_reading är aktiverat.
php://output
php://output är en skrivbar ström som tillåter dig att skriva till utmatningsbuffertmekanismen på samma sätt som print och echo.
php://fd
php://fd tillåter direkt åtkomst till den angivna fildeskriptorn. Till exempel refererar php://fd/3 till fildeskriptorn 3.
php://memory och php://temp
php://memory och php://temp är skrivbara strömmar som tillåter temporär data att lagras i ett fil-liknande omslag. En skillnad mellan de två är att php://memory alltid lagrar sin data i minnet, medan php://temp kommer att använda en temporär fil när mängden lagrad data når en fördefinierad gräns (standard är 2 MB). Platsen för denna temporära fil bestäms på samma sätt som funktionen sys_get_temp_dir().
Minnesgränsen för php://temp kan styras genom att lägga till /maxmemory:NN, där NN är den maximala mängden data som ska hållas i minnet innan en temporär fil används, i byte.
Varning: Vissa PHP-tillägg kan kräva en standard IO-ström och kan försöka kasta en given ström till en standard IO-ström. Denna kastning kan misslyckas för minnesströmmar eftersom den kräver att C-funktionen fopencookie() är tillgänglig. Denna C-funktion är inte tillgänglig på Windows.
php://filter
php://filter är ett slags meta-omslag som är utformat för att tillåta tillämpning av filter på en ström vid öppning. Detta är användbart med all-in-one-filfunktioner som readfile(), file() och file_get_contents() där det annars inte finns någon möjlighet att tillämpa ett filter på strömmen innan innehållet läses.
php://filter-målet tar följande parametrar som en del av sin sökväg. Flera filterkedjor kan specificeras på en sökväg. Se exemplen för specifika användningar av dessa parametrar.
php://filter parametrar
| Namn | Beskrivning |
|---|---|
| resource=<stream to be filtered> | Denna parameter är obligatorisk. Den specificerar strömmen som du vill filtrera. |
| read=<filter list to apply to read chain> | ). |
| write=<filter list to apply to write chain> | ). |
| <filter list to apply to both chains> | Alla filterlistor som inte är föregångna av read= eller write= kommer att tillämpas på både läs- och skrivkedjorna som är lämpliga. |
Alternativ
| Omslagsöversikt (för php://filter, se sammanfattningen av omslaget som filtreras) | Attribut | Stöd |
|---|---|---|
| Begränsad av allow_url_fopen | Nej | |
| Begränsad av allow_url_include | Endast php://input, php://stdin, php://memory och php://temp. | |
| Tillåter läsning | Endast php://stdin, php://input, php://fd, php://memory och php://temp. | |
| Tillåter skrivning | Endast php://stdout, php://stderr, php://output, php://fd, php://memory och php://temp. | |
| Tillåter tillägg | Endast php://stdout, php://stderr, php://output, php://fd, php://memory och php://temp. (Motsvarar skrivning) | |
| Tillåter samtidig läsning och skrivning | Endast php://fd, php://memory och php://temp. | |
| Stödjer stat() | Nej. Dock stödjer php://memory och php://temp fstat(). | |
| Stödjer unlink() | Nej | |
| Stödjer rename() | Nej | |
| Stödjer mkdir() | Nej | |
| Stödjer rmdir() | Nej | |
| Stödjer stream_select() | Endast php://stdin, php://stdout, php://stderr, php://fd och php://temp. |
Exempel
Exempel #1 php://temp/maxmemory
Denna valfria parameter tillåter att minnesgränsen ställs in innan php://temp börjar använda en temporär fil.
<?php
// Ställ in gränsen till 5 MB.
$fiveMBs = 5 * 1024 * 1024;
$fp = fopen("php://temp/maxmemory:$fiveMBs", 'r+');
fputs($fp, "hello\n");
// Läs vad vi har skrivit.
rewind($fp);
echo stream_get_contents($fp);
?>
Exempel #2 php://filter/resource=<stream to be filtered>
Denna parameter måste vara placerad i slutet av din php://filter-specifikation och ska peka på den ström som du vill filtrera.
<?php
/* Detta motsvarar helt enkelt:
readfile("http://www.example.com");
eftersom inga filter faktiskt anges */
readfile("php://filter/resource=http://www.example.com");
?>
Exempel #3 php://filter/read=<filter list to apply to read chain>
Denna parameter tar ett eller flera filternamn separerade av pipe-tecknet |.
<?php
/* Detta kommer att skriva ut innehållet på
www.example.com helt i versaler */
readfile("php://filter/read=string.toupper/resource=http://www.example.com");
/* Detta kommer att göra samma sak som ovan
men kommer också att ROT13-koda det */
readfile("php://filter/read=string.toupper|string.rot13/resource=http://www.example.com");
?>
Exempel #4 php://filter/write=<filter list to apply to write chain>
Denna parameter tar ett eller flera filternamn separerade av pipe-tecknet |.
<?php
/* Detta kommer att filtrera strängen "Hello World"
genom ROT13-filtret och sedan skriva till
example.txt i den nuvarande katalogen */
file_put_contents("php://filter/write=string.rot13/resource=example.txt","Hello World");
?>
Exempel #5 php://memory och php://temp är inte återanvändbara
php://memory och php://temp är inte återanvändbara, det vill säga efter att strömmarna har stängts finns det inget sätt att hänvisa till dem igen.
<?php
file_put_contents('php://memory', 'PHP');
echo file_get_contents('php://memory'); // skriver ut inget
?>
Sidslut
Orginalhemsidan på Engelska :https://www.php.net/manual/en/wrappers.http.php
PHP
Språkreferens
Stödda Protokoll och Inslagningar
Det här är en maskinöversättning av PHP-manualen till svenska. Om du hittar fel är vi tacksamma om du rapporterar dem via formuläret som finns på
https://www.linux.se/kontaka-linux-se/
Tack till Datorhjälp som har sponsrat Linux.se med webserver.