Der Operator expinfo #

expinfo beantwortet in einem Template die Fragen "Welche Erweiterungen sind installiert, welche sind aktiv, und welche Version ist das?". Er wird von eZTemplateExpInfoOperator (lib/eztemplate/classes/eztemplateexpinfooperator.php) über lib/eztemplate/classes/eztemplateautoload.php registriert und liest alles über die Klasse expInfo (lib/ezutils/classes/expinfo.php).

Inhalt #

1. expinfo
2. Eine Erweiterung
3. Listen von Erweiterungen
4. Der Kernel
5. Verwandte Seiten

expinfo #

expinfo #

Der Modus ist der erste Parameter oder, wenn es keinen Parameter gibt, die gepipte Zeichenkette:

Es gibt keine benannten Parameter. Generierte Referenz: expinfo.

Eine Erweiterung #

Die Info einer Erweiterung wird aus ihrer extension.xml und ihrer ezinfo.php (dem Array <extension>Info::info()) gebildet, ergänzt um mtime, mtime_formatted, extension_name und active. Schlüssel, die eine ezinfo.php hinzufügt, etwa die Hinweise zu Software von Drittanbietern bei ezjscore, erscheinen unter ihren eigenen Namen:

{def $ext = expinfo( 'ezjscore' )}
{if $ext}keys: {foreach $ext as $key => $value}{$key}{delimiter}, {/delimiter}{/foreach}

ezjscore {$ext.version}, license: {$ext.license|wash}, active: {$ext.active|choose( 'no', 'yes' )}{/if}

expinfo( 'no_such_extension' ) = [{expinfo( 'no_such_extension' )|choose( 'false', 'true' )}]

Ausgabe:

keys: name, version, copyright, license, info_url, Includes the following third-party software, Includes the following third-party software (2), Includes the following third-party software (3), mtime, mtime_formatted, extension_name, description, summary, author, meta, active
ezjscore 1.8.5, license: GNU General Public License v2.0 (or any later version), active: yes
expinfo( 'no_such_extension' ) = [false]

{if expinfo( 'name' )} ist ein sicherer Weg, einen Teil eines Templates davon abhängig zu machen, dass eine Erweiterung installiert ist; prüfen Sie zusätzlich .active, wenn die Erweiterung auch eingeschaltet sein muss.

Listen von Erweiterungen #

{def $active = expinfo()
     $all = expinfo( 'all' )
     $piped = 'ezjscore'|expinfo
     $inactive = 0}
{foreach $all as $name => $info}{if $info.active|not}{set $inactive = $inactive|inc}{/if}{/foreach}
expinfo() returns {$active|count} active extensions; expinfo( 'all' ) returns {$all|count}, of which {$inactive} are not active.
'ezjscore'|expinfo works too: {$piped.name|wash}

Ausgabe:

expinfo() returns 62 active extensions; expinfo( 'all' ) returns 87, of which 25 are not active.
'ezjscore'|expinfo works too: eZ JSCore LS

Der Zugriff auf Attribute des Ergebnisses funktioniert bei einer Variablen ($piped.name), aber nicht direkt nach einem Operator, der auf ein Literal angewendet wird: {'ezjscore'|expinfo.name} ist ein Parserfehler ("Extra characters found in expression"). Weisen Sie das Ergebnis zuerst zu, wie oben.

Der Kernel #

expinfo( 'kernel' ) gibt einen großen Hash zurück, der einmal pro Anfrage gebildet wird (buildKernelInfo()):

{def $k = expinfo( 'kernel' )}
sections: {foreach $k as $section => $value}{$section}{delimiter}, {/delimiter}{/foreach}

version keys: {foreach $k.version as $key => $value}{$key}{delimiter}, {/delimiter}{/foreach}

PHP sapi in this run: {$k.php.sapi}

Ausgabe:

sections: version, php, memory, server, database, ini, user, extensions, cache, filesystem, timestamps, git, composer
version keys: major, minor, release, state, development, alias, edition, full, full_alias
PHP sapi in this run: cli

Der Abschnitt version ist für Templates gedacht: $k.version.full ist das Release als Zeichenkette. Die anderen Abschnitte beschreiben den Server: server enthält den Hostnamen, das Document Root und die Installationspfade, php enthält uname und die geladenen Erweiterungen, database enthält Datenbankname, Server und Benutzer (das Passwort wird durch *** ersetzt), und git und composer den Zustand des Checkouts. Geben Sie diese Abschnitte nie auf einer Seite aus, die Besucher sehen können; sie sind für Verwaltungsseiten hinter einer Anmeldung bestimmt. Die Beispiele auf dieser Seite geben nur Abschnitts- und Schlüsselnamen sowie die PHP-SAPI des Kommandozeilenlaufs aus.

Alle Beispiele lieferten auf einer Entwicklungsinstallation interpretiert und kompiliert dieselbe Ausgabe.

Verwandte Seiten #

• Aufbau einer Erweiterung: ezinfo.php und extension.xml
• Was eine Erweiterung ist
• Die Erweiterungen Ihrer Website finden
• Alle Template-Operatoren (generiert)
• Freie Dokumentation: Diese Seite darf unter der GNU FDL 1.3 frei kopiert, übersetzt und verbessert werden.