Skip to content

Commit

Permalink
nette/application 3.2.1
Browse files Browse the repository at this point in the history
  • Loading branch information
dg committed Mar 11, 2024
1 parent 21424fc commit 1211c6d
Show file tree
Hide file tree
Showing 32 changed files with 236 additions and 108 deletions.
17 changes: 13 additions & 4 deletions application/bg/configuration.texy
Expand Up @@ -13,11 +13,12 @@ application:
# показва раздела "Nette Application" на синия екран на Tracy?
debugger: ... # (bool) по подразбиране е true

# ще бъде ли извикан презентаторът на грешки в случай на грешка?
catchExceptions: ... # (bool) по подразбиране е true на "battle" сървър
# Ще се извика ли error-presenter при грешка?
# има ефект само в режим за разработчици
catchExceptions: ... # (true|false|4xx) по подразбиране е 4xx

# име на водещ на грешка
errorPresenter: Error # (string) по подразбиране е 'Nette:Error'
errorPresenter: Error # (string|array) по подразбиране е 'Nette:Error'

# дефинира правила за съпоставяне на името на водещия с клас
mapping: ...
Expand All @@ -27,7 +28,15 @@ application:
silentLinks: ... # (bool) по подразбиране е false
```

Тъй като в режим на разработка презентаторите на грешки не се извикват по подразбиране, а грешките се показват от Tracy, промяната на стойността на `catchExceptions` на `true` помага да се провери дали презентаторите на грешки работят правилно по време на разработката.
От версия 3.2 на `nette/application` стойността по подразбиране за `catchExceptions` е `4xx`, което означава, че презентаторът на грешки се използва само за `Nette\Application\BadRequestException` изключения, представляващи HTTP грешки ''4xx''.
Освен това е възможно да се дефинира двойка error-presenters:

```neon
application:
errorPresenter:
4xx: Error4xx # за Nette\Application\BadRequestException
5xx: Error5xx # за други изключения
```

Опцията `silentLinks` определя как Nette да се държи в режим на разработчик, когато генерирането на връзки е неуспешно (например поради липса на презентатор и т.н.). Стойността по подразбиране `false` означава, че Nette работи `E_USER_WARNING`. Задаването на `true` потиска това съобщение за грешка. В производствена среда винаги се извиква `E_USER_WARNING`. Можем също така да повлияем на това поведение, като зададем променливата на водещия [$invalidLinkMode |creating-links#Invalid-Links].

Expand Down
5 changes: 2 additions & 3 deletions application/bg/modules.texy
Expand Up @@ -108,8 +108,7 @@ class DashboardPresenter extends Nette\Application\UI\Presenter

```neon
application:
mapping:
*: App\Presenters\*Presenter
mapping: App\Presenters\*Presenter
```

Името на водещия се заменя със звездичка и резултатът е името на класа. Лесно!
Expand Down Expand Up @@ -145,4 +144,4 @@ application:
*: [App\Modules, *, Presenters\*Presenter]
```

Стойността по подразбиране е `*: *Module\*Presenter`.
Стойността по подразбиране е `*Module\*Presenter`.
15 changes: 12 additions & 3 deletions application/cs/configuration.texy
Expand Up @@ -14,10 +14,11 @@ application:
debugger: ... # (bool) výchozí je true

# bude se při chybě volat error-presenter?
catchExceptions: ... # (bool) výchozí je true v produkčním režimu
# má efekt pouze ve vývojářském režimu
catchExceptions: ... # (true|false|4xx) výchozí je 4xx

# název error-presenteru
errorPresenter: Error # (string) výchozí je 'Nette:Error'
errorPresenter: Error # (string|array) výchozí je 'Nette:Error'

# definuje pravidla pro překlad názvu presenteru na třídu
mapping: ...
Expand All @@ -27,7 +28,15 @@ application:
silentLinks: ... # (bool) výchozí je false
```

Protože ve vývojovém režimu se error-presentery standardně nevolají a chybu zobrazí až Tracy, změnou hodnoty `catchExceptions` na `true` můžeme při vývoji ověřit jejich správnou funkčnost.
Od `nette/application` verze 3.2 má `catchExceptions` výchozí hodnotou `4xx`, což znamená, že se error-presenter použije pouze u výjimek `Nette\Application\BadRequestException` reprezentujících HTTP chyby ''4xx''.
A dále lze definovat dvojici error-presenterů:

```neon
application:
errorPresenter:
4xx: Error4xx # pro výjimku Nette\Application\BadRequestException
5xx: Error5xx # pro ostatní výjimky
```

Volba `silentLinks` určuje, jak se Nette zachová ve vývojářském režimu, když selže generování odkazu (třeba proto, že neexistuje presenter, atd). Výchozí hodnota `false` znamená, že Nette vyhodí `E_USER_WARNING` chybu. Nastavením na `true` dojde k potlačení této chybové hlášky. V produkčním prostředí se `E_USER_WARNING` vyvolá vždy. Toto chování můžeme také ovlivnit nastavením proměnné presenteru [$invalidLinkMode|creating-links#neplatne-odkazy].

Expand Down
5 changes: 2 additions & 3 deletions application/cs/modules.texy
Expand Up @@ -108,8 +108,7 @@ Začněme ukázkou, která moduly nepoužívá. Budeme jen chtít, aby třídy p

```neon
application:
mapping:
*: App\Presenters\*Presenter
mapping: App\Presenters\*Presenter
```

Název presenteru se nahradí za hvezdičku v masce třídy a výsledkem je název třídy. Snadné!
Expand Down Expand Up @@ -145,4 +144,4 @@ application:
*: [App\Modules, *, Presenters\*Presenter]
```

Výchozí hodnotou je `*: *Module\*Presenter`.
Výchozí hodnotou je `*Module\*Presenter`.
17 changes: 13 additions & 4 deletions application/de/configuration.texy
Expand Up @@ -13,11 +13,12 @@ Anwendung:
# zeigt das Feld "Nette Anwendung" in Tracy BlueScreen?
debugger: ... # (bool) standardmäßig true

# wird der error-presenter im Fehlerfall aufgerufen?
catchExceptions: ... # (bool) steht im Produktionsmodus standardmäßig auf true
# wird error-presenter im Fehlerfall aufgerufen?
# hat nur im Entwicklermodus Auswirkungen
catchExceptions: ... # (true|false|4xx) ist standardmäßig auf 4xx eingestellt

# Name des Fehlermelders
errorPresenter: Error # (string) Standardwert ist 'Nette:Error'
errorPresenter: Error # (string|array) Standardwert ist 'Nette:Error'

# definiert die Regeln für die Auflösung des Presenter-Namens in eine Klasse
mapping: ...
Expand All @@ -27,7 +28,15 @@ Anwendung:
silentLinks: ... # (bool) ist standardmäßig auf false eingestellt
```

Da Fehlerpräsenter im Entwicklungsmodus standardmäßig nicht aufgerufen werden und die Fehler von Tracy angezeigt werden, hilft das Ändern des Wertes `catchExceptions` in `true` dabei, zu überprüfen, ob die Fehlerpräsenter während der Entwicklung korrekt funktionieren.
Ab `nette/application` Version 3.2 ist der Standardwert für `catchExceptions` `4xx` , was bedeutet, dass der Fehlerpräsenter nur für `Nette\Application\BadRequestException` Ausnahmen verwendet wird, die HTTP-Fehler ''4xx'' darstellen.
Außerdem ist es möglich, ein Paar von Fehlerpräsentatoren zu definieren:

```neon
application:
errorPresenter:
4xx: Error4xx # für Nette\Application\BadRequestException
5xx: Error5xx # für andere Ausnahmen
```

Die Option `silentLinks` legt fest, wie sich Nette im Entwicklermodus verhält, wenn die Link-Generierung fehlschlägt (z. B. weil kein Presenter vorhanden ist usw.). Der Standardwert `false` bedeutet, dass Nette `E_USER_WARNING` auslöst. Die Einstellung `true` unterdrückt diese Fehlermeldung. In einer Produktionsumgebung wird immer `E_USER_WARNING` aufgerufen. Wir können dieses Verhalten auch beeinflussen, indem wir die Presenter-Variable [$invalidLinkMode |creating-links#Invalid Links] setzen.

Expand Down
5 changes: 2 additions & 3 deletions application/de/modules.texy
Expand Up @@ -108,8 +108,7 @@ Beginnen wir mit einem Beispiel, das keine Module verwendet. Wir wollen nur, das

```neon
application:
mapping:
*: App\Presenters\*Presenter
mapping: App\Presenters\*Presenter
```

Der Name des Presenters wird durch das Sternchen in der Klassenmaske ersetzt und das Ergebnis ist der Klassenname. Einfach!
Expand Down Expand Up @@ -145,4 +144,4 @@ application:
*: [App\Modules, *, Presenters\*Presenter]
```

Der Standardwert ist `*: *Module\*Presenter`.
Der Standardwert ist `*Module\*Presenter`.
17 changes: 13 additions & 4 deletions application/el/configuration.texy
Expand Up @@ -13,11 +13,12 @@ application:
# δείχνει τον πίνακα "Nette Application" στο Tracy BlueScreen?
debugger: ... # (bool) προεπιλογή true

# θα καλείται ο παρουσιαστής σφαλμάτων σε περίπτωση σφάλματος;
catchExceptions: ... # (bool) προεπιλεγμένη τιμή true σε κατάσταση παραγωγής
# θα κληθεί ο παρουσιαστής σφαλμάτων στο σφάλμα;
# έχει αποτέλεσμα μόνο σε λειτουργία προγραμματιστή
catchExceptions: ... # (true|false|4xx) προεπιλογή 4xx

# όνομα του error-presenter
errorPresenter: Error # (string) προεπιλογή 'Nette:Error'
errorPresenter: Error # (string|array) προεπιλογή 'Nette:Error'

# ορίζει τους κανόνες για την επίλυση του ονόματος του παρουσιαστή σε μια κλάση
mapping: ...
Expand All @@ -27,7 +28,15 @@ application:
silentLinks: ... # (bool) προεπιλογή σε false
```

Επειδή οι παρουσιαστές σφαλμάτων δεν καλούνται εξ ορισμού σε κατάσταση ανάπτυξης και τα σφάλματα εμφανίζονται από το Tracy, η αλλαγή της τιμής `catchExceptions` σε `true` βοηθάει στην επαλήθευση της σωστής λειτουργίας των παρουσιαστών σφαλμάτων κατά την ανάπτυξη.
Από την έκδοση 3.2 του `nette/application`, η προεπιλεγμένη τιμή για το `catchExceptions` είναι `4xx`, πράγμα που σημαίνει ότι ο παρουσιαστής σφάλματος χρησιμοποιείται μόνο για εξαιρέσεις `Nette\Application\BadRequestException` που αντιπροσωπεύουν σφάλματα HTTP ''4xx''.
Επιπλέον, είναι δυνατόν να οριστεί ένα ζεύγος παρουσιαστών σφαλμάτων:

```neon
application:
errorPresenter:
4xx: Error4xx # για την εξαίρεση Nette\Application\BadRequestException
5xx: Error5xx # για άλλες εξαιρέσεις
```

Η επιλογή `silentLinks` καθορίζει τον τρόπο με τον οποίο η Nette συμπεριφέρεται στη λειτουργία ανάπτυξης όταν η δημιουργία συνδέσμων αποτυγχάνει (για παράδειγμα, επειδή δεν υπάρχει παρουσιαστής κ.λπ.). Η προεπιλεγμένη τιμή `false` σημαίνει ότι η Nette ενεργοποιεί το `E_USER_WARNING`. Η ρύθμιση σε `true` καταστέλλει αυτό το μήνυμα σφάλματος. Σε περιβάλλον παραγωγής, το `E_USER_WARNING` ενεργοποιείται πάντα. Μπορούμε επίσης να επηρεάσουμε αυτή τη συμπεριφορά θέτοντας τη μεταβλητή του παρουσιαστή [$invalidLinkMode |creating-links#Invalid Links].

Expand Down
5 changes: 2 additions & 3 deletions application/el/modules.texy
Expand Up @@ -108,8 +108,7 @@ class DashboardPresenter extends Nette\Application\UI\Presenter

```neon
application:
mapping:
*: App\Presenters\*Presenter
mapping: App\Presenters\*Presenter
```

Το όνομα του παρουσιαστή αντικαθίσταται με τον αστερίσκο στη μάσκα κλάσης και το αποτέλεσμα είναι το όνομα της κλάσης. Εύκολο!
Expand Down Expand Up @@ -145,4 +144,4 @@ application:
*: [App\Modules, *, Presenters\*Presenter]
```

Η προεπιλεγμένη τιμή είναι `*: *Module\*Presenter`.
Η προεπιλεγμένη τιμή είναι `*Module\*Presenter`.
15 changes: 12 additions & 3 deletions application/en/configuration.texy
Expand Up @@ -14,10 +14,11 @@ application:
debugger: ... # (bool) defaults to true

# will error-presenter be called on error?
catchExceptions: ... # (bool) defaults to true in production mode
# has effect only in developer mode
catchExceptions: ... # (true|false|4xx) defaults to 4xx

# name of error-presenter
errorPresenter: Error # (string) defaults to 'Nette:Error'
errorPresenter: Error # (string|array) defaults to 'Nette:Error'

# defines the rules for resolving the presenter name to a class
mapping: ...
Expand All @@ -27,7 +28,15 @@ application:
silentLinks: ... # (bool) defaults to false
```

Because error-presenters are not called by default in development mode and the errors are displayed by Tracy, changing the value `catchExceptions` to `true` helps to verify that error-presenters works correct during development.
As of `nette/application` version 3.2, the default value for `catchExceptions` is `4xx`, which means that the error-presenter is used only for `Nette\Application\BadRequestException` exceptions representing HTTP errors ''4xx''.
Furthermore, it is possible to define a pair of error-presenters:

```neon
application:
errorPresenter:
4xx: Error4xx # for Nette\Application\BadRequestException
5xx: Error5xx # for other exceptions
```

Option `silentLinks` determines how Nette behaves in developer mode when link generation fails (for example, because there is no presenter, etc). The default value `false` means that Nette triggers `E_USER_WARNING`. Setting to `true` suppresses this error message. In a production environment, `E_USER_WARNING` is always invoked. We can also influence this behavior by setting the presenter variable [$invalidLinkMode |creating-links#Invalid Links].

Expand Down
5 changes: 2 additions & 3 deletions application/en/modules.texy
Expand Up @@ -108,8 +108,7 @@ Let's start with a sample that doesn't use modules. We'll just want the presente

```neon
application:
mapping:
*: App\Presenters\*Presenter
mapping: App\Presenters\*Presenter
```

The presenter name is replaced with the asterisk in the class mask and the result is the class name. Easy!
Expand Down Expand Up @@ -145,4 +144,4 @@ application:
*: [App\Modules, *, Presenters\*Presenter]
```

The default value is `*: *Module\*Presenter`.
The default value is `*Module\*Presenter`.
15 changes: 12 additions & 3 deletions application/es/configuration.texy
Expand Up @@ -14,10 +14,11 @@ application:
debugger: ... # (bool) por defecto true

# ¿se llamará al presentador de errores en caso de error?
catchExceptions: ... # (bool) por defecto a true en modo producción
# sólo tiene efecto en modo desarrollador
catchExceptions: ... # (true|false|4xx) por defecto 4xx

# nombre del presentador de errores
errorPresenter: Error # (string) por defecto 'Nette:Error'
errorPresenter: Error # (string|array) por defecto 'Nette:Error'

# define las reglas para resolver el nombre del presentador a una clase
mapping: ...
Expand All @@ -27,7 +28,15 @@ application:
silentLinks: ... # (bool) por defecto false
```

Debido a que los presentadores de errores no son llamados por defecto en modo desarrollo y los errores son mostrados por Tracy, cambiar el valor `catchExceptions` a `true` ayuda a verificar que los presentadores de errores funcionan correctamente durante el desarrollo.
A partir de la versión 3.2 de `nette/application`, el valor por defecto para `catchExceptions` es `4xx`, lo que significa que el presentador de errores sólo se utiliza para las excepciones `Nette\Application\BadRequestException` que representan errores HTTP ''4xx''.
Además, es posible definir un par de presentadores de errores:

```neon
application:
errorPresenter:
4xx: Error4xx # para Nette\Application\BadRequestException
5xx: Error5xx # para otras excepciones
```

La opción `silentLinks` determina cómo se comporta Nette en modo desarrollo cuando falla la generación de enlaces (por ejemplo, porque no hay presentador, etc). El valor por defecto `false` significa que Nette activa `E_USER_WARNING`. El valor `true` suprime este mensaje de error. En un entorno de producción, siempre se invoca `E_USER_WARNING`. También podemos influir en este comportamiento configurando la variable del presentador [$invalidLinkMode |creating-links#Invalid Links].

Expand Down
5 changes: 2 additions & 3 deletions application/es/modules.texy
Expand Up @@ -108,8 +108,7 @@ Empecemos con un ejemplo que no utiliza módulos. Sólo querremos que las clases

```neon
application:
mapping:
*: App\Presenters\*Presenter
mapping: App\Presenters\*Presenter
```

El nombre del presentador se sustituye por el asterisco en la máscara de clase y el resultado es el nombre de la clase. Muy fácil.
Expand Down Expand Up @@ -145,4 +144,4 @@ application:
*: [App\Modules, *, Presenters\*Presenter]
```

El valor por defecto es `*: *Module\*Presenter`.
El valor por defecto es `*Module\*Presenter`.
17 changes: 13 additions & 4 deletions application/fr/configuration.texy
Expand Up @@ -13,11 +13,12 @@ application:
# affiche le panneau "Nette Application" dans Tracy BlueScreen ?
debugger: ... # (bool) par défaut à true

# le présentateur d'erreur sera-t-il appelé en cas d'erreur ?
catchExceptions: ... # (bool) vaut true par défaut en mode production
# le présentateur d'erreurs sera-t-il appelé en cas d'erreur ?
# n'a d'effet qu'en mode développeur
catchExceptions : ... # (true|false|4xx) par défaut 4xx

# nom du présentateur d'erreur
errorPresenter: Error # (string) vaut par défaut 'Nette:Error'.
errorPresenter: Error # (string|array) vaut par défaut 'Nette:Error'.

# définit les règles pour résoudre le nom du présentateur vers une classe
mapping: ...
Expand All @@ -27,7 +28,15 @@ application:
silentLinks: ... # (bool) valeur par défaut: false
```

Comme les présentateurs d'erreurs ne sont pas appelés par défaut en mode développement et que les erreurs sont affichées par Tracy, le fait de changer la valeur `catchExceptions` en `true` permet de vérifier que les présentateurs d'erreurs fonctionnent correctement pendant le développement.
Depuis la version 3.2 de `nette/application`, la valeur par défaut de `catchExceptions` est `4xx`, ce qui signifie que le présentateur d'erreurs n'est utilisé que pour les exceptions `Nette\Application\BadRequestException` représentant les erreurs HTTP ''4xx''.
En outre, il est possible de définir une paire de présentateurs d'erreurs :

```neon
application:
errorPresenter:
4xx: Error4xx # pour NetteApplicationBadRequestException
5xx: Error5xx # pour les autres exceptions
```

L'option `silentLinks` détermine comment Nette se comporte en mode développeur lorsque la génération de liens échoue (par exemple, parce qu'il n'y a pas de présentateur, etc). La valeur par défaut `false` signifie que Nette déclenche `E_USER_WARNING`. Le réglage sur `true` supprime ce message d'erreur. Dans un environnement de production, `E_USER_WARNING` est toujours invoqué. Nous pouvons également influencer ce comportement en définissant la variable du présentateur [$invalidLinkMode |creating-links#Invalid Links].

Expand Down
5 changes: 2 additions & 3 deletions application/fr/modules.texy
Expand Up @@ -108,8 +108,7 @@ Commençons par un exemple qui n'utilise pas de modules. Nous voulons simplement

```neon
application:
mapping:
*: App\Presenters\*Presenter
mapping: App\Presenters\*Presenter
```

Le nom du présentateur est remplacé par l'astérisque dans le masque de classe et le résultat est le nom de la classe. Facile !
Expand Down Expand Up @@ -145,4 +144,4 @@ application:
*: [App\Modules, *, Presenters\*Presenter]
```

La valeur par défaut est `*: *Module\*Presenter`.
La valeur par défaut est `*Module\*Presenter`.

0 comments on commit 1211c6d

Please sign in to comment.