ezinfo.php: wer sie gemacht hat und welche Version #

Teil 3, Kapitel 2. ezinfo.php sagt dem System und seinen Benutzern, was eine Erweiterung ist: ihr Name, ihre Version, ihr Copyright, ihre Lizenz und ihre Website. Setup > Über, Setup > Extensions und die Upgrade-Prüfungen lesen sie. Die Referenz ist Metadaten von Erweiterungen; dieses Kapitel zeigt, wie Sie eine solche Datei schreiben und welche Fehler Sie vermeiden.

Die Datei #

extension/mysite_hello/ezinfo.php:

<?php
class mysite_helloInfo
{
    public static function info()
    {
        return array(
            'Name'      => "My Site Hello",
            'Version'   => "1.0.0",
            'Copyright' => "Copyright (C) 2026 Your Organization",
            'License'   => "GNU General Public License v2.0 (or any later version)",
            'Info_url'  => "https://github.com/your-organization/mysite_hello"
        );
    }
}

Schlüssel werden ohne Beachtung der Groß- und Kleinschreibung verglichen, daher funktionieren ältere Erweiterungen, die info_url schreiben, weiterhin; neue schreiben Info_url.

Wer sie liest, und in welcher Reihenfolge #

Der Leser ist expInfo (lib/ezutils/classes/expinfo.php): expInfo::extensionInfo( 'mysite_hello' ) gibt die normalisierten Felder name, description, summary, version, copyright, author, license und info_url zurück. Er liest:

1. zuerst extension.xml; nicht leere Werte gewinnen,
2. dann ezinfo.php, für jedes Feld, das extension.xml nicht geliefert hat,
3. dann composer.json und den Git-Origin, für das, was dann noch fehlt.

Beide Dateien sollten also vorhanden sein und übereinstimmen. Eine schnelle Prüfung bei geladenem Kernel:

<?php
// php bin/php/ezexec.php extension/mysite_hello/scripts/info.php
$info = expInfo::extensionInfo( 'mysite_hello' );
eZCLI::instance()->output( $info === false ? 'not found' : $info['name'] . ' ' . $info['version'] );

Die Falle unter PHP 8: unquotierte Schlüssel #

Ältere Erweiterungen schrieben die Schlüssel ohne Anführungszeichen. In PHP 5 wurde eine nicht definierte Konstante mit einem Hinweis zu ihrem eigenen Namen; in PHP 8 ist sie ein Error, und die Seite, die die Metadaten liest, bricht ab. Eine echte Korrektur aus se7enxweb/expsite_installer (Commit 0c771fe, "Fixed ezinfo.php, whose keys were bare words that PHP 8 reads as undefined constants and stops on"):

// before
return array( Name => "expsite_installer",
              Version => "1.0.1",
              info_url => "https://github.com/se7enxweb/expsite_installer" );

// after
return array( 'Name' => "expsite_installer",
              'Version' => "1.0.1",
              'Info_url' => "https://github.com/se7enxweb/expsite_installer" );

php -l erkennt das nicht (die Datei ist syntaktisch gültig); nur das Ausführen zeigt es. Teil 4 enthält weitere solche Fälle: ezinfo.php und extension.xml modernisieren.

HTML in den Werten #

Einige ältere Erweiterungen setzen HTML-Links in Name oder Copyright (<a href='...'>). expInfo entfernt die Tags (strip_tags()), wenn es die Felder normalisiert; angezeigt wird also nur der Text, und der Link geht verloren. Schreiben Sie reinen Text und verwenden Sie Info_url für den Link.

Mehrere Urheberrechtsinhaber #

Behalten Sie jeden früheren Inhaber bei, wenn Sie eine Erweiterung übernehmen oder forken, und fügen Sie sich selbst hinzu:

'Copyright' => "Copyright (C) 2011 - 2014 Original Author Organization, 2026 Your Organization",

Siehe Namensnennung und Urheberrechtsvermerke.

Prüfen #

php -l extension/mysite_hello/ezinfo.php
php bin/php/ezexec.php extension/mysite_hello/scripts/info.php

Öffnen Sie dann Setup > Extensions: Die Karte zeigt Ihren Namen, Ihre Version, Lizenz und Website.

Bei jedem Release #

Die Version in ezinfo.php und in extension.xml entspricht der Release-Version und wird in dem Commit geändert, auf den der Tag zeigt; siehe ezinfo.php und extension.xml hochzählen.

Verwandte Seiten #

• Zurück: Der Verzeichnisaufbau einer Erweiterung
• Weiter: extension.xml: Metadaten und Abhängigkeiten
• Metadaten von Erweiterungen (Spezifikation)
• Freie Dokumentation: Diese Seite darf unter der GNU FDL 1.3 frei kopiert, übersetzt und verbessert werden.

Urheberrecht und Copyleft #

Seit dem 29. Oktober 2026 halten die Exponential Foundation und 7x das Copyright an Exponential gemeinsam, die Foundation zuerst genannt: „Exponential Copyright © 1998-2026 Exponential Foundation and 7x“, in Dateien „Copyright (C) 1998 - 2026 Exponential Foundation and 7x. All rights reserved.“ Wer es hält und warum, was die GPL Ihnen erlaubt, welche Hinweise Dritter bleiben und wie der Hinweis in neue Dateien und Erweiterungen kommt: Urheberrecht und Copyleft.