Benutzer haben uns darauf aufmerksam gemacht das Zend_Controller_Action_Helper_ViewRenderer Methoden auf der abstrakten Dispatcher Klasse verwendet hat die nicht im Dispatcher Interface waren. Die folgenden Methoden wurden hinzugefügt um sicherzustellen das eigene Dispatcher weiterhin mit den ausgelieferten Implementierungen funktionieren:

Wie von Benutzern erwähnt, arbeiteten die Prüfungen von Zend_File_Transfer nicht in Verbindung mit Zend_Config zusammen, durch den Fakt das Sie keine benannten Arrays verwendet haben.

Deswegen wurden alle Filter und Prüfungen für Zend_File_Transfer überarbeitet. Wärend die alten Signaturen weiterhin funktionieren, wurden sie als veraltet markiert, und werfen eine PHP Notiz mit der Aufforderung das zu beheben.

Die folgende Liste zeigt die Änderungen und was für die richtige Verwendung der Parameter getan werden muß.

// Beispiel für 1.6
$upload = new Zend_File_Transfer_Adapter_Http();
$upload->addFilter('Rename',
                   array('/path/to/oldfile', '/path/to/newfile', true));

// Gleiches Beispiel für 1.7
$upload = new Zend_File_Transfer_Adapter_Http();
$upload->addFilter('Rename',
                   array('source' => '/path/to/oldfile',
                         'target' => '/path/to/newfile',
                         'overwrite' => true));

// Beispiel für 1.6
$upload = new Zend_File_Transfer_Adapter_Http();
$upload->addValidator('Count',
                      array(2, 3));

// Gleiches Beispiel für 1.7
$upload = new Zend_File_Transfer_Adapter_Http();
$upload->addValidator('Count',
                      false,
                      array('min' => 2,
                            'max' => 3));

// Beispiel für 1.6
$upload = new Zend_File_Transfer_Adapter_Http();
$upload->addValidator('Extension',
                      array('jpg,gif,bmp', true));

// Gleiches Beispiel für 1.7
$upload = new Zend_File_Transfer_Adapter_Http();
$upload->addValidator('Extension',
                      false,
                      array('extension1' => 'jpg,gif,bmp',
                            'case' => true));

// Beispiel für 1.6
$upload = new Zend_File_Transfer_Adapter_Http();
$upload->addValidator('FilesSize',
                      array(100, 10000, true));

// Gleiches Beispiel für 1.7
$upload = new Zend_File_Transfer_Adapter_Http();
$upload->addValidator('FilesSize',
                      false,
                      array('min' => 100,
                            'max' => 10000,
                            'bytestring' => true));

// Beispiel für 1.6
$upload->useByteString(true); // Flag setzen

// Gleiches Beispiel für 1.7
$upload->setUseByteSting(true); // Flag setzen

// Beispiel für 1.6
$upload = new Zend_File_Transfer_Adapter_Http();
$upload->addValidator('Hash',
                      array('12345', 'md5'));

// Gleiches Beispiel für 1.7
$upload = new Zend_File_Transfer_Adapter_Http();
$upload->addValidator('Hash',
                      false,
                      array('hash1' => '12345',
                            'algorithm' => 'md5'));

// Beispiel für 1.6
$upload = new Zend_File_Transfer_Adapter_Http();
$upload->addValidator('ImageSize',
                      array(10, 10, 100, 100));

// Gleiches Beispiel für 1.7
$upload = new Zend_File_Transfer_Adapter_Http();
$upload->addValidator('ImageSize',
                      false,
                      array('minwidth' => 10,
                            'minheight' => 10,
                            'maxwidth' => 100,
                            'maxheight' => 100));

// Beispiel für 1.6
$upload = new Zend_File_Transfer_Adapter_Http();
$upload->addValidator('Size',
                      array(100, 10000, true));

// Gleiches Beispiel für 1.7
$upload = new Zend_File_Transfer_Adapter_Http();
$upload->addValidator('Size',
                      false,
                      array('min' => 100,
                            'max' => 10000,
                            'bytestring' => true));

Bezugnehmend auf den Codingstandard mußte isLocale() so geändert werden das es ein Boolean zurückgibt. In vorhergehenden Releases wurde im Erfolgsfall ein String zurückgegeben. Für das Release 1.7 wurde ein Kompatibilitätsmodus hinzugefügt der es erlaubt das alte Verhalten, das ein String zurückgegeben wird, zu verwenden, aber das triggert auch eine User Warning die darauf hinweist das man auf das neue Verhalten wechseln sollte. Das Rerouting welches das alte Verhalten von isLocale() durchgeführt hätte ist nicht länger notwendig, da alle I18n Komponenten jetzt das Rerouting selbst durchführen.

Um die Skripte auf die neue API zu migrieren muß die Methode einfach wie anbei gezeigt verwendet werden.

// Beispiel für 1.6
if ($locale = Zend_Locale::isLocale($locale)) {
    // mach was
}

// Selbes Beispiel für 1.7

// Man sollte den Kompatibilitätsmodus ändern um User Warnings zu verhindern
// Aber man kann das in der Bootstrap tun
Zend_Locale::$compatibilityMode = false;

if (Zend_Locale::isLocale($locale)) {
}

// Beispiel für 1.6
if ($locale = Zend_Locale::isLocale($locale, false)) {
    // mach was
}

// Selbes Beispiel für 1.7

// Man sollte den Kompatibilitätsmodus ändern um User Warnings zu verhindern
// Aber man kann das in der Bootstrap tun
Zend_Locale::$compatibilityMode = false;

if (Zend_Locale::isLocale($locale, false)) {
    if (Zend_Locale::isLocale($locale, true)) {
        // gar kein Gebietsschema
    }

    // Original String ist kein Gebietsschema, kann aber Reroutet werden
}

Die Bedeutung der getDefault() Methode wurde verändert durch den Fakt das Framework-weite Gebietsschemata integriert wurden welche mit setDefault() gesetzt werden können. Deswegen gibe es nicht mehr die Kette der Gebietsschemata zurück sondern nur die gesetzten Framework-weiten Gebietsschemata.

Um die eigenen Skripte auf die neue API zu migrieren, muß einfach die Methode wie unten gezeigt verwendet werden.

// Beispiel für 1.6
$locales = $locale->getDefault(Zend_Locale::BROWSER);

// Selbes Beispiel für 1.7

// Man sollte den Compatibility Mode setzen um User Notices zu verhindern
// Das kann in der Bootstrap Datei getan werden
Zend_Locale::$compatibilityMode = false;

$locale = Zend_Locale::getOrder(Zend_Locale::BROWSER);

Wenn man die automatische Erkennung von Sprachen verwendet, oder Sprachen manuell auf Zend_Translate setzt kann es sein das man von Zeit zu Zeit eine Notiz geworfen bekommen die über nicht hinzugefügte oder leere Übersetzungen schreibt. In einigen vorhergehenden Releases wurde in einigen Fällen auch eine Exception geworfen.

Der Grund ist, das wenn ein Benutzer eine nicht existierende Sprache anfragt, man einfach keinen Weg hat um festzustellen was falsch ist. Deswegen haben wir diese Notizen hinzugefügt die einem in den eigenen Logs zeigen das der Benutzer eine Sprache angefragt hat die man nicht unterstützt. Es ist zu beachten das der Code, selbst wenn eine Notiz getriggert wird, weiterhin ohne Probleme arbeitet.

Aber wenn man einen eigenen Fehler oder Exception Handler, wie XDebug, verwendet wird man alle Notizen zurückerhalten, selbst wenn man das nicht gewollt hat. Das ist der Fall, weil diese Handler alle Einstellungen von PHP selbst überschreiben.

Um diese Notizen wegzubekommen kann man einfach die neue Option 'disableNotices' auf TRUE setzen. Der Standardwert ist FALSE.

$language = new Zend_Translate('gettext',
                               '/path/to/translations',
                               'auto');

$language = new Zend_Translate('gettext',
                               '/path/to/translations',
                               'auto',
                               array('disableNotices' => true));

Da viele Entwickler gemeldet haben das Sie so eine Schreibweise in Ihren Anwendungen verwenden die nicht das Ergebnis einer Benutzereingabe sind, wurde ein spezielles Flag erstellt um das Deaktivieren des standardmäßigen Schutzes zu erlauben. Es gibt 2 Methoden um das Durchzuführen: Indem der 'lfiProtectionOn' Schlüssel in den Konstruktor-Optionen übergeben wird, oder durch den expliziten Aufruf der setLfiProtection() Methode.

// Ausschalten über den Konstruktor
$view = new Zend_View(array('lfiProtectionOn' => false));

// Ausschalten über expliziten Aufruf der Methode:
$view = new Zend_View();
$view->setLfiProtection(false);