Körningskonfiguration

Från Wiki.linux.se
Hoppa till navigering Hoppa till sök

Körningskonfiguration

Beteendet för dessa funktioner påverkas av inställningarna i php.ini.

Konfigurationsalternativ för Fel och Loggning

Namn Standardvärde Ändringsbar Ändringslogg
error_reporting NULL INI_ALL
display_errors "1" INI_ALL Före PHP 8.0.0 var standardvärdet "0".
display_startup_errors "1" INI_ALL Före PHP 8.0.0 var standardvärdet "0".
log_errors "0" INI_ALL
log_errors_max_len "1024" INI_ALL Påverkade ej från PHP 8.0.0, borttagen i PHP 8.1.0.
ignore_repeated_errors "0" INI_ALL
ignore_repeated_source "0" INI_ALL
report_memleaks "1" INI_ALL
track_errors "0" INI_ALL Avrådd från och med PHP 7.2.0, borttagen i PHP 8.0.0.
html_errors "1" INI_ALL
xmlrpc_errors "0" INI_SYSTEM
xmlrpc_error_number "0" INI_ALL
docref_root "" INI_ALL
docref_ext "" INI_ALL
error_prepend_string NULL INI_ALL
error_append_string NULL INI_ALL
error_log NULL INI_ALL
error_log_mode 0o644 INI_ALL Tillgänglig från PHP 8.2.0
syslog.facility "LOG_USER" INI_SYSTEM Tillgänglig från PHP 7.3.0.
syslog.filter "no-ctrl" INI_ALL Tillgänglig från PHP 7.3.0.
syslog.ident "php" INI_SYSTEM Tillgänglig från PHP 7.3.0.

För mer detaljer och definitioner av INI_* -lägen, se var en konfigurationsinställning kan anges.

Förklaringar av konfigurationsdirektiv

error_reporting int Ställer in felrapporteringsnivån. Parametern är antingen ett heltal som representerar ett bitfält eller namngivna konstanter. Felrapporteringsnivåer och konstanter beskrivs i Fördefinierade Konstanter och i php.ini. För att ställa in vid körning, använd funktionen error_reporting. Se även direktivet display_errors.

Standardvärdet är E_ALL.

Före PHP 8.0.0 var standardvärdet: E_ALL & ~E_NOTICE & ~E_STRICT & ~E_DEPRECATED, vilket innebär att diagnostik på nivåerna E_NOTICE, E_STRICT och E_DEPRECATED inte visades.

Notera: PHP-konstanter utanför PHP Att använda PHP-konstanter utanför PHP, som i httpd.conf, har ingen användbar betydelse, så i sådana fall krävs int-värden. Eftersom felkoder kan läggas till med tiden, kommer det maximala värdet för E_ALL sannolikt att ändras. Så istället för att använda E_ALL kan man överväga att använda ett högre värde för att täcka alla bitfält framöver, ett numeriskt värde som 2147483647 (inkluderar alla fel, inte bara E_ALL).

display_errors string Avgör om fel ska skrivas ut på skärmen som en del av utmatningen eller om de ska döljas för användaren.

Värdet "stderr" skickar felen till stderr istället för stdout.

Notera: Detta är en funktion för att stödja utveckling och bör aldrig användas i produktionssystem (t.ex. system anslutna till internet).

Notera: Även om display_errors kan ställas in vid körning (med ini_set()), kommer det inte att ha någon effekt om skriptet har fatala fel, eftersom den önskade åtgärden inte kan utföras.

display_startup_errors bool Även när display_errors är aktiverat visas inte fel som uppstår under PHP:s startsekvens. Det rekommenderas starkt att hålla display_startup_errors avstängt, utom för felsökning.

log_errors bool Anger om skriptfelmeddelanden ska loggas till serverns fellogg eller error_log. Detta alternativ är specifikt för servern.

Notera: Det rekommenderas starkt att använda felloggning istället för att visa fel i produktionswebbplatser.

log_errors_max_len int Anger maximal längd på log_errors i byte. I error_log tillförs information om källan. Standardvärdet är 1024, och 0 innebär ingen maximal längd alls.

Längden tillämpas på loggade och visade fel, men inte på explicita anrop till funktioner som error_log().

ignore_repeated_errors bool Logga inte upprepade meddelanden. Upprepade fel måste inträffa i samma fil på samma rad om inte ignore_repeated_source är inställt på true.

ignore_repeated_source bool Ignorera källan till meddelandet när upprepade meddelanden ignoreras. När denna inställning är aktiverad loggas inte fel med upprepade meddelanden från olika filer eller rader.

report_memleaks bool Om detta parameter är påslaget (standard) kommer denna parameter att visa en rapport över minnesläckor som upptäckts av Zend Memory Manager. Denna rapport skickas till stderr på Posix-plattformar. På Windows skickas den till debuggern med OutputDebugString() och kan ses med verktyg som DbgView. Denna parameter har bara effekt i en debug-build och om error_reporting inkluderar E_WARNING i den tillåtna listan.

track_errors bool Om aktiverad, kommer det senaste felmeddelandet alltid att vara tillgängligt i variabeln $php_errormsg.

html_errors bool Om aktiverad, kommer felmeddelanden att innehålla HTML-taggar. HTML-fel formatet skapar klickbara meddelanden som leder användaren till en sida med beskrivning av felet eller funktionen som orsakade felet. Dessa referenser påverkas av docref_root och docref_ext.

Om inaktiverad, är felmeddelandet enbart i vanlig text.

xmlrpc_errors bool Om aktiverad, stängs normal felrapportering av och formaterar fel som XML-RPC-felmeddelande.

xmlrpc_error_number int Används som värdet på XML-RPC faultCode-elementet.

docref_root string Det nya felformatet innehåller en referens till en sida som beskriver felet eller funktionen som orsakade felet. För manual-sidor kan du ladda ner manualen på ditt språk och ställa in denna ini-direktiv till URL för din lokala kopia. Om din lokala kopia av manualen kan nås via "/manual/" kan du helt enkelt använda docref_root=/manual/. Ytterligare behöver du ställa in docref_ext för att matcha filändelsen på din kopia, till exempel docref_ext=.html.

Notera: Detta är en funktion för att stödja din utveckling eftersom den gör det enkelt att slå upp en funktionsbeskrivning. Den bör dock aldrig användas på produktionssystem (t.ex. system anslutna till internet).

docref_ext string Se docref_root.

Notera: Värdet för docref_ext måste börja med en punkt "."

error_prepend_string string Sträng att skriva ut före ett felmeddelande. Används endast när felmeddelandet visas på skärmen. Huvudsyftet är att kunna lägga till ytterligare HTML-markering till felmeddelandet.

error_append_string string Sträng att skriva ut efter ett felmeddelande. Används endast när felmeddelandet visas på skärmen. Huvudsyftet är att kunna lägga till ytterligare HTML-markering till felmeddelandet.

error_log string Namn på filen där skriptfel ska loggas. Filen bör vara skrivbar för webbserverns användare. Om det speciella värdet syslog används, skickas felen till systemloggaren istället. På Unix betyder det syslog(3) och på Windows betyder det händelseloggen. Om denna direktiv inte är satt, skickas fel till SAPI-felloggen, som i Apache eller stderr i CLI. Se också error_log().

error_log_mode int Filrättigheter för den fil som beskrivs i error_log.

syslog.facility string Anger vilken typ av program som loggar meddelandet. Gäller endast om error_log är inställt på "syslog".

syslog.filter string Anger filtertypen för att filtrera de loggade meddelandena. Tillåtna tecken skickas oförändrade; alla andra skrivs i hexadecimal representation med prefixet \x.

  • all – Loggsträngen delas vid radbrytning, alla tecken skickas oförändrade.
  • ascii – Loggsträngen delas vid radbrytning, och alla icke utskrivbara 7-bit ASCII-tecken undantas.
  • no-ctrl – Loggsträngen delas vid radbrytning, och alla icke utskrivbara tecken undantas.
  • raw – Alla tecken skickas till systemloggaren utan att delas vid radbrytning (identisk med PHP före 7.3).

Denna inställning påverkar loggning via error_log inställd på "syslog" och anrop till syslog().

Notera: Filtertypen raw är tillgänglig från och med PHP 7.3.8 och PHP 7.4.0.

Detta direktiv stöds inte på Windows.

syslog.ident string Anger ident-strängen som är förspeglad till varje meddelande. Gäller endast om error_log är inställd på "syslog".

Sidslut

Orginalhemsidan på Engelska :https://www.php.net/manual/en/errorfunc.configuration.php

PHP

Funktioner Funktionsreferens phpdbg_—_Interaktiv_PHP_Debugger



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.se som har sponsrat Linux.se med webserver.