ob start(): Skillnad mellan sidversioner
Admin (diskussion | bidrag) (Skapade sidan med '= Sidslut = Orginalhemsidan på Engelska :https://www.php.net/manual/en/apcu.configuration.php PHP Funktioner Funktionsreferens <HR> 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/ <BR><BR>Tack till [https://datorhjalp.se Datorhjälp och Datorservice] som har sponsrat [https://www.linux.se Linux.se] med webserver...') |
Admin (diskussion | bidrag) |
||
(En mellanliggande sidversion av samma användare visas inte) | |||
Rad 1: | Rad 1: | ||
== ob_start == | |||
(PHP 4, PHP 5, PHP 7, PHP 8) | |||
'''ob_start''' — Slå på utdata-buffring | |||
=== Beskrivning === | |||
'''ob_start'''(?callable $callback = null, int $chunk_size = 0, int $flags = [[PHP_OUTPUT_HANDLER_STDFLAGS]]): bool | |||
Denna funktion slår på utdata-buffring. Medan utdata-buffring är aktiv skickas ingen utdata från skriptet; istället lagras utdatan i en intern buffert. Se [[What Output Is Buffered?]] för exakt vilken utdata som påverkas. | |||
Utdata-buffrar är stapelbara, det vill säga att '''ob_start()''' kan anropas medan en annan buffert är aktiv. Om flera utdata-buffrar är aktiva filtreras utdatan sekventiellt genom var och en i den ordning de är staplade. Se [[Nesting Output Buffers]] för mer information. | |||
För en detaljerad beskrivning av utdata-buffrar, se [[User-Level Output Buffers]]. | |||
=== Parametrar === | |||
; '''callback''' | |||
: En valfri callback kan specificeras. Det kan också utelämnas genom att ange null. | |||
callback anropas när utdata-bufferten rensas, skickas, eller när bufferten spolas i slutet av skriptet. | |||
Callback-signaturen är som följer: | |||
<pre> | |||
handler(string $buffer, int $phase = ?): string | |||
</pre> | |||
* '''buffer''' - Innehållet i utdata-bufferten. | |||
* '''phase''' - Bitmask av [[PHP_OUTPUT_HANDLER_*]]-konstanter. Se [[Flags Passed To Output Handlers]] för mer information. | |||
Om callback returnerar false returneras innehållet i bufferten. Se [[Output Handler Return Values]] för mer information. | |||
'''Varning''' | |||
Att anropa någon av följande funktioner från inom en utdata-hanterare resulterar i ett fatalt fel: [[ob_clean()]], [[ob_end_clean()]], [[ob_end_flush()]], [[ob_flush()]], [[ob_get_clean()]], [[ob_get_flush()]], [[ob_start()]]. | |||
Se [[Output Handlers]] och [[Working With Output Handlers]] för mer information om callbacks (utdata-hanterare). | |||
; '''chunk_size''' | |||
: Om den valfria parametern chunk_size anges, spolas bufferten efter att någon kod producerar utdata som gör att buffertens längd är lika med eller överstiger chunk_size. Standardvärdet 0 innebär att all utdata buffras tills bufferten stängs av. Se [[Buffer Size]] för mer information. | |||
; '''flags''' | |||
: Parametern flags är en bitmask som kontrollerar de operationer som kan utföras på utdata-bufferten. Standardvärdet tillåter utdata-buffertar att rensas, spolas och tas bort, vilket kan anges explicit via buffert-kontrollflaggor. Se [[Operations Allowed On Buffers]] för mer information. | |||
Varje flagga styr tillgången till en uppsättning funktioner enligt följande: | |||
{| class="wikitable" | |||
|+ Konstant || Funktioner | |||
|- | |||
| [[PHP_OUTPUT_HANDLER_CLEANABLE]] || [[ob_clean()]] | |||
|- | |||
| [[PHP_OUTPUT_HANDLER_FLUSHABLE]] || [[ob_flush()]] | |||
|- | |||
| [[PHP_OUTPUT_HANDLER_REMOVABLE]] || [[ob_end_clean()]], [[ob_end_flush()]], [[ob_get_clean()]], [[ob_get_flush()]] | |||
|} | |||
=== Returvärden === | |||
Returnerar true vid framgång eller false vid misslyckande. | |||
=== Exempel === | |||
'''Exempel #1 Användardefinierad callback-funktion exempel''' | |||
<pre> | |||
<?php | |||
function callback($buffer) { | |||
// Ersätter alla "äpplen" med "apelsiner" | |||
return (str_replace("apples", "oranges", $buffer)); | |||
} | |||
ob_start("callback"); | |||
?> | |||
<html> | |||
<body> | |||
<p>It's like comparing apples to oranges.</p> | |||
</body> | |||
</html> | |||
<?php | |||
ob_end_flush(); | |||
?> | |||
</pre> | |||
Det ovanstående exemplet ger följande utdata: | |||
<pre> | |||
<html> | |||
<body> | |||
<p>It's like comparing oranges to oranges.</p> | |||
</body> | |||
</html> | |||
</pre> | |||
'''Exempel #2 Skapa en icke-raderbar utdata-buffert''' | |||
<pre> | |||
<?php | |||
ob_start(null, 0, PHP_OUTPUT_HANDLER_STDFLAGS ^ PHP_OUTPUT_HANDLER_REMOVABLE); | |||
?> | |||
</pre> | |||
=== Se även === | |||
* [[ob_get_contents()]] - Returnera innehållet i utdata-bufferten | |||
* [[ob_end_clean()]] - Rensa (ta bort) innehållet i den aktiva utdata-bufferten och stäng av den | |||
* [[ob_end_flush()]] - Skicka returvärdet från den aktiva utdata-hanteraren och stäng av den aktiva utdata-bufferten | |||
* [[ob_implicit_flush()]] - Slå på/av implicit spolning | |||
* [[ob_gzhandler()]] - [[ob_start()]] callback-funktion för att gzip-komprimera utdata-buffert | |||
* [[ob_iconv_handler()]] - Konvertera teckenkodning som utdata-buffert hanterare | |||
* [[mb_output_handler()]] - Callback-funktion som konverterar teckenkodning i utdata-buffert | |||
* [[ob_tidyhandler()]] - [[ob_start()]] callback-funktion för att reparera bufferten | |||
= Sidslut = | = Sidslut = | ||
Orginalhemsidan på Engelska :https://www.php.net/manual/en/ | Orginalhemsidan på Engelska :https://www.php.net/manual/en/function.ob-start.php | ||
[[PHP]] | [[PHP]] |
Nuvarande version från 12 oktober 2024 kl. 14.25
ob_start
(PHP 4, PHP 5, PHP 7, PHP 8)
ob_start — Slå på utdata-buffring
Beskrivning
ob_start(?callable $callback = null, int $chunk_size = 0, int $flags = PHP_OUTPUT_HANDLER_STDFLAGS): bool Denna funktion slår på utdata-buffring. Medan utdata-buffring är aktiv skickas ingen utdata från skriptet; istället lagras utdatan i en intern buffert. Se What Output Is Buffered? för exakt vilken utdata som påverkas.
Utdata-buffrar är stapelbara, det vill säga att ob_start() kan anropas medan en annan buffert är aktiv. Om flera utdata-buffrar är aktiva filtreras utdatan sekventiellt genom var och en i den ordning de är staplade. Se Nesting Output Buffers för mer information.
För en detaljerad beskrivning av utdata-buffrar, se User-Level Output Buffers.
Parametrar
- callback
- En valfri callback kan specificeras. Det kan också utelämnas genom att ange null.
callback anropas när utdata-bufferten rensas, skickas, eller när bufferten spolas i slutet av skriptet.
Callback-signaturen är som följer:
handler(string $buffer, int $phase = ?): string
- buffer - Innehållet i utdata-bufferten.
- phase - Bitmask av PHP_OUTPUT_HANDLER_*-konstanter. Se Flags Passed To Output Handlers för mer information.
Om callback returnerar false returneras innehållet i bufferten. Se Output Handler Return Values för mer information.
Varning Att anropa någon av följande funktioner från inom en utdata-hanterare resulterar i ett fatalt fel: ob_clean(), ob_end_clean(), ob_end_flush(), ob_flush(), ob_get_clean(), ob_get_flush(), ob_start().
Se Output Handlers och Working With Output Handlers för mer information om callbacks (utdata-hanterare).
- chunk_size
- Om den valfria parametern chunk_size anges, spolas bufferten efter att någon kod producerar utdata som gör att buffertens längd är lika med eller överstiger chunk_size. Standardvärdet 0 innebär att all utdata buffras tills bufferten stängs av. Se Buffer Size för mer information.
- flags
- Parametern flags är en bitmask som kontrollerar de operationer som kan utföras på utdata-bufferten. Standardvärdet tillåter utdata-buffertar att rensas, spolas och tas bort, vilket kan anges explicit via buffert-kontrollflaggor. Se Operations Allowed On Buffers för mer information.
Varje flagga styr tillgången till en uppsättning funktioner enligt följande:
PHP_OUTPUT_HANDLER_CLEANABLE | ob_clean() |
PHP_OUTPUT_HANDLER_FLUSHABLE | ob_flush() |
PHP_OUTPUT_HANDLER_REMOVABLE | ob_end_clean(), ob_end_flush(), ob_get_clean(), ob_get_flush() |
Returvärden
Returnerar true vid framgång eller false vid misslyckande.
Exempel
Exempel #1 Användardefinierad callback-funktion exempel
<?php function callback($buffer) { // Ersätter alla "äpplen" med "apelsiner" return (str_replace("apples", "oranges", $buffer)); } ob_start("callback"); ?> <html> <body> <p>It's like comparing apples to oranges.</p> </body> </html> <?php ob_end_flush(); ?>
Det ovanstående exemplet ger följande utdata:
<html> <body> <p>It's like comparing oranges to oranges.</p> </body> </html>
Exempel #2 Skapa en icke-raderbar utdata-buffert
<?php ob_start(null, 0, PHP_OUTPUT_HANDLER_STDFLAGS ^ PHP_OUTPUT_HANDLER_REMOVABLE); ?>
Se även
- ob_get_contents() - Returnera innehållet i utdata-bufferten
- ob_end_clean() - Rensa (ta bort) innehållet i den aktiva utdata-bufferten och stäng av den
- ob_end_flush() - Skicka returvärdet från den aktiva utdata-hanteraren och stäng av den aktiva utdata-bufferten
- ob_implicit_flush() - Slå på/av implicit spolning
- ob_gzhandler() - ob_start() callback-funktion för att gzip-komprimera utdata-buffert
- ob_iconv_handler() - Konvertera teckenkodning som utdata-buffert hanterare
- mb_output_handler() - Callback-funktion som konverterar teckenkodning i utdata-buffert
- ob_tidyhandler() - ob_start() callback-funktion för att reparera bufferten
Sidslut
Orginalhemsidan på Engelska :https://www.php.net/manual/en/function.ob-start.php
PHP Funktioner Funktionsreferens
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 och Datorservice som har sponsrat Linux.se med webserver.