declare

Declare

(PHP 4, PHP 5, PHP 7, PHP 8)

Konstruktionen `declare` används för att ange exekveringsdirektiv för en kodblock. Syntaxen för `declare` liknar andra kontrollstrukturers syntax:

declare (direktiv)
    uttalande

Direktivsektionen tillåter inställning av beteendet för `declare`-blocket. För närvarande erkänns endast tre direktiv: ticks-direktivet (se nedan för mer information om ticks-direktivet), encoding-direktivet (se nedan för mer information om encoding-direktivet) och strict_types-direktivet (se mer information i avsnittet om strikt typning på sidan om typanmälningar).

Eftersom direktiv hanteras när filen kompileras, kan endast literaler ges som direktivvärden. Variabler och konstanter kan inte användas. För att illustrera:

<?php
// Detta är giltigt:
declare(ticks=1);

// Detta är ogiltigt:
const TICK_VALUE = 1;
declare(ticks=TICK_VALUE);
?>

Uttalandedelen av `declare`-blocket kommer att exekveras - hur det utförs och vilka sidoeffekter som uppstår under exekveringen kan bero på det direktiv som anges i direktivblocket.

Konstruktionen `declare` kan också användas i globalt omfång, vilket påverkar all kod som följer efter den (om filen med `declare` inkluderades så påverkar den inte den överordnade filen).

<?php
// dessa är samma:

// du kan använda detta:
declare(ticks=1) {
    // hela skriptet här
}

// eller du kan använda detta:
declare(ticks=1);
// hela skriptet här
?>

Ticks

En "tick" är en händelse som inträffar för varje N lågnivå tickable-uttalanden som utförs av parsern inom `declare`-blocket. Värdet för N anges med ticks=N inom direktivsektionen för `declare`-blocket.

Inte alla uttalanden är tickable. Typiskt sett är villkorsuttryck och argumentuttryck inte tickable.

Händelsen (eller händelserna) som inträffar vid varje tick specificeras med hjälp av `register_tick_function()`. Se exemplet nedan för mer detaljer. Notera att mer än en händelse kan inträffa för varje tick.

Exempel #1 Användning av tick

<?php

declare(ticks=1);

// En funktion som anropas vid varje tick-händelse
function tick_handler()
{
    echo "tick_handler() called\n";
}

register_tick_function('tick_handler'); // orsakar en tick-händelse

$a = 1; // orsakar en tick-händelse

if ($a > 0) {
    $a += 2; // orsakar en tick-händelse
    print $a; // orsakar en tick-händelse
}

?>

Se även `register_tick_function()` och `unregister_tick_function()`.

Encoding

En skripts kodning kan specificeras per skript med hjälp av encoding-direktivet.

Exempel #2 Deklarera en kodning för skriptet.

<?php
declare(encoding='ISO-8859-1');
// kod här
?>

Varning

När den kombineras med namnrymder är den enda lagliga syntaxen för `declare` `declare(encoding='...');` där ... är kodningsvärdet. `declare(encoding='...') {}` kommer att resultera i ett parse-fel när den kombineras med namnrymder.

Se även `zend.script_encoding`.