Browse Source

Replaced `::className()` in PHPDocs and some classes

tags/3.0.0-alpha1
SilverFire - Dmitry Naumenko 8 years ago
parent
commit
e45f5c3b4f
  1. 20
      docs/guide-fr/concept-behaviors.md
  2. 2
      docs/guide-fr/concept-components.md
  3. 12
      docs/guide-fr/concept-events.md
  4. 30
      docs/guide-fr/db-active-record.md
  5. 2
      docs/guide-fr/input-validation.md
  6. 4
      docs/guide-fr/output-client-scripts.md
  7. 8
      docs/guide-fr/security-authorization.md
  8. 2
      docs/guide-pl/db-active-record.md
  9. 4
      docs/guide-ru/db-active-record.md
  10. 2
      docs/guide-ru/security-authorization.md
  11. 2
      docs/guide-zh-CN/concept-events.md
  12. 4
      docs/guide/db-active-record.md
  13. 2
      framework/CHANGELOG.md
  14. 2
      tests/data/views/widgets/ListView/item.php
  15. 2
      tests/framework/widgets/ListViewTest.php

20
docs/guide-fr/concept-behaviors.md

@ -106,21 +106,21 @@ class User extends ActiveRecord
{ {
return [ return [
// comportement anonyme, nom de la classe de comportement seulement // comportement anonyme, nom de la classe de comportement seulement
MyBehavior::className(), MyBehavior::class,
// comportement nommé, nom de classe de comportement seulement // comportement nommé, nom de classe de comportement seulement
'myBehavior2' => MyBehavior::className(), 'myBehavior2' => MyBehavior::class,
// comportement anonyme, tableau de configuration // comportement anonyme, tableau de configuration
[ [
'class' => MyBehavior::className(), 'class' => MyBehavior::class,
'prop1' => 'value1', 'prop1' => 'value1',
'prop2' => 'value2', 'prop2' => 'value2',
], ],
// comportement nommé, tableau de configuration // comportement nommé, tableau de configuration
'myBehavior4' => [ 'myBehavior4' => [
'class' => MyBehavior::className(), 'class' => MyBehavior::class,
'prop1' => 'value1', 'prop1' => 'value1',
'prop2' => 'value2', 'prop2' => 'value2',
] ]
@ -141,11 +141,11 @@ use app\components\MyBehavior;
$component->attachBehavior('myBehavior1', new MyBehavior); $component->attachBehavior('myBehavior1', new MyBehavior);
// attache un classe de comportement // attache un classe de comportement
$component->attachBehavior('myBehavior2', MyBehavior::className()); $component->attachBehavior('myBehavior2', MyBehavior::class);
// attache un tableau de configuration // attache un tableau de configuration
$component->attachBehavior('myBehavior3', [ $component->attachBehavior('myBehavior3', [
'class' => MyBehavior::className(), 'class' => MyBehavior::class,
'prop1' => 'value1', 'prop1' => 'value1',
'prop2' => 'value2', 'prop2' => 'value2',
]); ]);
@ -156,7 +156,7 @@ Vous pouvez attacher plusieurs comportements à la fois en utilisant la méthode
```php ```php
$component->attachBehaviors([ $component->attachBehaviors([
'myBehavior1' => new MyBehavior, // un comportement nommé 'myBehavior1' => new MyBehavior, // un comportement nommé
MyBehavior::className(), // un comportement anonyme MyBehavior::class, // un comportement anonyme
]); ]);
``` ```
@ -164,10 +164,10 @@ Vous pouvez aussi attacher des comportements via les [configurations](concept-co
```php ```php
[ [
'as myBehavior2' => MyBehavior::className(), 'as myBehavior2' => MyBehavior::class,
'as myBehavior3' => [ 'as myBehavior3' => [
'class' => MyBehavior::className(), 'class' => MyBehavior::class,
'prop1' => 'value1', 'prop1' => 'value1',
'prop2' => 'value2', 'prop2' => 'value2',
], ],
@ -250,7 +250,7 @@ class User extends ActiveRecord
{ {
return [ return [
[ [
'class' => TimestampBehavior::className(), 'class' => TimestampBehavior::class,
'attributes' => [ 'attributes' => [
ActiveRecord::EVENT_BEFORE_INSERT => ['created_at', 'updated_at'], ActiveRecord::EVENT_BEFORE_INSERT => ['created_at', 'updated_at'],
ActiveRecord::EVENT_BEFORE_UPDATE => ['updated_at'], ActiveRecord::EVENT_BEFORE_UPDATE => ['updated_at'],

2
docs/guide-fr/concept-components.md

@ -67,7 +67,7 @@ Le respect de ces conseils rend vos composants [configurables](concept-configur
$component = new MyClass(1, 2, ['prop1' => 3, 'prop2' => 4]); $component = new MyClass(1, 2, ['prop1' => 3, 'prop2' => 4]);
// alternatively // alternatively
$component = \Yii::createObject([ $component = \Yii::createObject([
'class' => MyClass::className(), 'class' => MyClass::class,
'prop1' => 3, 'prop1' => 3,
'prop2' => 4, 'prop2' => 4,
], [1, 2]); ], [1, 2]);

12
docs/guide-fr/concept-events.md

@ -185,7 +185,7 @@ use Yii;
use yii\base\Event; use yii\base\Event;
use yii\db\ActiveRecord; use yii\db\ActiveRecord;
Event::on(ActiveRecord::className(), ActiveRecord::EVENT_AFTER_INSERT, function ($event) { Event::on(ActiveRecord::class, ActiveRecord::EVENT_AFTER_INSERT, function ($event) {
Yii::trace(get_class($event->sender) . ' is inserted'); Yii::trace(get_class($event->sender) . ' is inserted');
}); });
``` ```
@ -199,11 +199,11 @@ Vous pouvez déclencher un événement au *niveau de la classe* en appelant la m
```php ```php
use yii\base\Event; use yii\base\Event;
Event::on(Foo::className(), Foo::EVENT_HELLO, function ($event) { Event::on(Foo::class, Foo::EVENT_HELLO, function ($event) {
var_dump($event->sender); // displays "null" var_dump($event->sender); // displays "null"
}); });
Event::trigger(Foo::className(), Foo::EVENT_HELLO); Event::trigger(Foo::class, Foo::EVENT_HELLO);
``` ```
Notez que, dans ce cas, `$event->sender` fait référence au nom de la classe qui a déclenché l'événement plutôt qu'à une instance de classe. Notez que, dans ce cas, `$event->sender` fait référence au nom de la classe qui a déclenché l'événement plutôt qu'à une instance de classe.
@ -214,10 +214,10 @@ Pour détacher un gestionnaire attaché au niveau de la classe, appelez [[yii\b
```php ```php
// détache $handler // détache $handler
Event::off(Foo::className(), Foo::EVENT_HELLO, $handler); Event::off(Foo::class, Foo::EVENT_HELLO, $handler);
// détache tous les gestionnaires de Foo::EVENT_HELLO // détache tous les gestionnaires de Foo::EVENT_HELLO
Event::off(Foo::className(), Foo::EVENT_HELLO); Event::off(Foo::class, Foo::EVENT_HELLO);
``` ```
@ -268,7 +268,7 @@ Event::on('DanceEventInterface', DanceEventInterface::EVENT_DANCE, function ($ev
Vous pouvez déclencher l'événement de ces classes : Vous pouvez déclencher l'événement de ces classes :
```php ```php
Event::trigger(DanceEventInterface::className(), DanceEventInterface::EVENT_DANCE); Event::trigger(DanceEventInterface::class, DanceEventInterface::EVENT_DANCE);
``` ```
Notez bien que vous ne pouvez pas déclencher l'événement de toutes les classes qui implémentent l'interface :, Notez bien que vous ne pouvez pas déclencher l'événement de toutes les classes qui implémentent l'interface :,

30
docs/guide-fr/db-active-record.md

@ -584,7 +584,7 @@ class Customer extends ActiveRecord
public function getOrders() public function getOrders()
{ {
return $this->hasMany(Order::className(), ['customer_id' => 'id']); return $this->hasMany(Order::class, ['customer_id' => 'id']);
} }
} }
@ -594,7 +594,7 @@ class Order extends ActiveRecord
public function getCustomer() public function getCustomer()
{ {
return $this->hasOne(Customer::className(), ['id' => 'customer_id']); return $this->hasOne(Customer::class, ['id' => 'customer_id']);
} }
} }
``` ```
@ -606,7 +606,7 @@ Chacune des méthodes de relation doit être nommée sous la forme `getXyz`. Nou
En déclarant une relation, vous devez spécifier les informations suivantes : En déclarant une relation, vous devez spécifier les informations suivantes :
- la multiplicité de la relation : spécifiée en appelant soit la méthode [[yii\db\ActiveRecord::hasMany()|hasMany()]], soit la méthode [[yii\db\ActiveRecord::hasOne()|hasOne()]]. Dans l'exemple ci-dessus vous pouvez facilement déduire en lisant la déclaration des relations qu'un client a beaucoup de commandes, tandis qu'une commande n'a qu'un client. - la multiplicité de la relation : spécifiée en appelant soit la méthode [[yii\db\ActiveRecord::hasMany()|hasMany()]], soit la méthode [[yii\db\ActiveRecord::hasOne()|hasOne()]]. Dans l'exemple ci-dessus vous pouvez facilement déduire en lisant la déclaration des relations qu'un client a beaucoup de commandes, tandis qu'une commande n'a qu'un client.
- le nom de la classe d'enregistrement actif : spécifié comme le premier paramètre de [[yii\db\ActiveRecord::hasMany()|hasMany()]] ou de [[yii\db\ActiveRecord::hasOne()|hasOne()]]. Une pratique conseillée est d'appeler `Xyz::className()` pour obtenir la chaîne de caractères représentant le nom de la classe de manière à bénéficier de l'auto-complètement de l'EDI et de la détection d'erreur dans l'étape de compilation. - le nom de la classe d'enregistrement actif : spécifié comme le premier paramètre de [[yii\db\ActiveRecord::hasMany()|hasMany()]] ou de [[yii\db\ActiveRecord::hasOne()|hasOne()]]. Une pratique conseillée est d'appeler `Xyz::class` pour obtenir la chaîne de caractères représentant le nom de la classe de manière à bénéficier de l'auto-complètement de l'EDI et de la détection d'erreur dans l'étape de compilation.
- Le lien entre les deux types de données : spécifie le(s) colonne(s) via lesquelles les deux types de données sont en relation. Les valeurs du tableau sont les colonnes des données primaires (représentées par la classe d'enregistrement actif dont vous déclarez les relations), tandis que les clés sont les colonnes des données en relation. - Le lien entre les deux types de données : spécifie le(s) colonne(s) via lesquelles les deux types de données sont en relation. Les valeurs du tableau sont les colonnes des données primaires (représentées par la classe d'enregistrement actif dont vous déclarez les relations), tandis que les clés sont les colonnes des données en relation.
Une règle simple pour vous rappeler cela est, comme vous le voyez dans l'exemple ci-dessus, d'écrire la colonne qui appartient à l'enregistrement actif en relation juste à coté de lui. Vous voyez là que l'identifiant du client (`customer_id`) est une propriété de `Order` et `id` est une propriété de `Customer`. Une règle simple pour vous rappeler cela est, comme vous le voyez dans l'exemple ci-dessus, d'écrire la colonne qui appartient à l'enregistrement actif en relation juste à coté de lui. Vous voyez là que l'identifiant du client (`customer_id`) est une propriété de `Order` et `id` est une propriété de `Customer`.
@ -663,7 +663,7 @@ class Customer extends ActiveRecord
{ {
public function getBigOrders($threshold = 100) public function getBigOrders($threshold = 100)
{ {
return $this->hasMany(Order::className(), ['customer_id' => 'id']) return $this->hasMany(Order::class, ['customer_id' => 'id'])
->where('subtotal > :threshold', [':threshold' => $threshold]) ->where('subtotal > :threshold', [':threshold' => $threshold])
->orderBy('id'); ->orderBy('id');
} }
@ -692,7 +692,7 @@ class Order extends ActiveRecord
{ {
public function getItems() public function getItems()
{ {
return $this->hasMany(Item::className(), ['id' => 'item_id']) return $this->hasMany(Item::class, ['id' => 'item_id'])
->viaTable('order_item', ['order_id' => 'id']); ->viaTable('order_item', ['order_id' => 'id']);
} }
} }
@ -705,12 +705,12 @@ class Order extends ActiveRecord
{ {
public function getOrderItems() public function getOrderItems()
{ {
return $this->hasMany(OrderItem::className(), ['order_id' => 'id']); return $this->hasMany(OrderItem::class, ['order_id' => 'id']);
} }
public function getItems() public function getItems()
{ {
return $this->hasMany(Item::className(), ['id' => 'item_id']) return $this->hasMany(Item::class, ['id' => 'item_id'])
->via('orderItems'); ->via('orderItems');
} }
} }
@ -921,7 +921,7 @@ class Customer extends ActiveRecord
{ {
public function getOrders() public function getOrders()
{ {
return $this->hasMany(Order::className(), ['customer_id' => 'id']); return $this->hasMany(Order::class, ['customer_id' => 'id']);
} }
} }
@ -929,7 +929,7 @@ class Order extends ActiveRecord
{ {
public function getCustomer() public function getCustomer()
{ {
return $this->hasOne(Customer::className(), ['id' => 'customer_id']); return $this->hasOne(Customer::class, ['id' => 'customer_id']);
} }
} }
``` ```
@ -960,7 +960,7 @@ class Customer extends ActiveRecord
{ {
public function getOrders() public function getOrders()
{ {
return $this->hasMany(Order::className(), ['customer_id' => 'id'])->inverseOf('customer'); return $this->hasMany(Order::class, ['customer_id' => 'id'])->inverseOf('customer');
} }
} }
``` ```
@ -1052,7 +1052,7 @@ class Customer extends \yii\db\ActiveRecord
public function getComments() public function getComments()
{ {
// a customer has many comments // a customer has many comments
return $this->hasMany(Comment::className(), ['customer_id' => 'id']); return $this->hasMany(Comment::class, ['customer_id' => 'id']);
} }
} }
@ -1067,7 +1067,7 @@ class Comment extends \yii\mongodb\ActiveRecord
public function getCustomer() public function getCustomer()
{ {
// un commentaire (comment) a un client (customer) // un commentaire (comment) a un client (customer)
return $this->hasOne(Customer::className(), ['id' => 'customer_id']); return $this->hasOne(Customer::class, ['id' => 'customer_id']);
} }
} }
@ -1135,7 +1135,7 @@ class Customer extends \yii\db\ActiveRecord
{ {
public function getActiveComments() public function getActiveComments()
{ {
return $this->hasMany(Comment::className(), ['customer_id' => 'id'])->active(); return $this->hasMany(Comment::class, ['customer_id' => 'id'])->active();
} }
} }
@ -1196,7 +1196,7 @@ class Customer extends \yii\db\ActiveRecord
public function getOrders() public function getOrders()
{ {
return $this->hasMany(Order::className(), ['customer_id' => 'id']); return $this->hasMany(Order::class, ['customer_id' => 'id']);
} }
} }
``` ```
@ -1287,7 +1287,7 @@ class Customer extends \yii\db\ActiveRecord
public function getOrders() public function getOrders()
{ {
return $this->hasMany(Order::className(), ['customer_id' => 'id']); return $this->hasMany(Order::class, ['customer_id' => 'id']);
} }
} }
``` ```

2
docs/guide-fr/input-validation.md

@ -370,7 +370,7 @@ class EntryForm extends Model
{ {
return [ return [
[['name', 'email'], 'required'], [['name', 'email'], 'required'],
['country', CountryValidator::className()], ['country', CountryValidator::class],
['email', 'email'], ['email', 'email'],
]; ];
} }

4
docs/guide-fr/output-client-scripts.md

@ -28,7 +28,7 @@ Le dernier argument est un identifiant unique du script utilisé pour identifier
Un script externe peut être ajouté comme expliqué ci-dessous : Un script externe peut être ajouté comme expliqué ci-dessous :
```php ```php
$this->registerJsFile('http://example.com/js/main.js', ['depends' => [\yii\web\JqueryAsset::className()]]); $this->registerJsFile('http://example.com/js/main.js', ['depends' => [\yii\web\JqueryAsset::class]]);
``` ```
Les arguments pour [[yii\web\View::registerJsFile()|registerJsFile()]] sont semblables à ceux utilisés pour [[yii\web\View::registerCssFile()|registerCssFile()]]. Dans l'exemple précédent, nous enregistrons le fichier `main.js` avec une dépendance sur `JqueryAsset`. Cela siginifie que le fichier `main.js` sera ajouté APRÈS `jquery.js`. Sans la spécification de cette dépendance, l'ordre relatif entre `main.js` et `jquery.js` resterait indéfini. Les arguments pour [[yii\web\View::registerJsFile()|registerJsFile()]] sont semblables à ceux utilisés pour [[yii\web\View::registerCssFile()|registerCssFile()]]. Dans l'exemple précédent, nous enregistrons le fichier `main.js` avec une dépendance sur `JqueryAsset`. Cela siginifie que le fichier `main.js` sera ajouté APRÈS `jquery.js`. Sans la spécification de cette dépendance, l'ordre relatif entre `main.js` et `jquery.js` resterait indéfini.
@ -65,7 +65,7 @@ Si vous désirez spécifier des propriétés additionnelles du style balise, pas
```php ```php
$this->registerCssFile("http://example.com/css/themes/black-and-white.css", [ $this->registerCssFile("http://example.com/css/themes/black-and-white.css", [
'depends' => [BootstrapAsset::className()], 'depends' => [BootstrapAsset::class],
'media' => 'print', 'media' => 'print',
], 'css-print-theme'); ], 'css-print-theme');
``` ```

8
docs/guide-fr/security-authorization.md

@ -20,7 +20,7 @@ class SiteController extends Controller
{ {
return [ return [
'access' => [ 'access' => [
'class' => AccessControl::className(), 'class' => AccessControl::class,
'only' => ['login', 'logout', 'signup'], 'only' => ['login', 'logout', 'signup'],
'rules' => [ 'rules' => [
[ [
@ -57,7 +57,7 @@ Vous pouvez personnaliser ce comportement en configurant la propriété [[yii\fi
```php ```php
[ [
'class' => AccessControl::className(), 'class' => AccessControl::class,
... ...
'denyCallback' => function ($rule, $action) { 'denyCallback' => function ($rule, $action) {
throw new \Exception('You are not allowed to access this page'); throw new \Exception('You are not allowed to access this page');
@ -99,7 +99,7 @@ class SiteController extends Controller
{ {
return [ return [
'access' => [ 'access' => [
'class' => AccessControl::className(), 'class' => AccessControl::class,
'only' => ['special-callback'], 'only' => ['special-callback'],
'rules' => [ 'rules' => [
[ [
@ -390,7 +390,7 @@ public function behaviors()
{ {
return [ return [
'access' => [ 'access' => [
'class' => AccessControl::className(), 'class' => AccessControl::class,
'rules' => [ 'rules' => [
[ [
'allow' => true, 'allow' => true,

2
docs/guide-pl/db-active-record.md

@ -1469,7 +1469,7 @@ class Customer extends \yii\db\ActiveRecord
public function getOrders() public function getOrders()
{ {
return $this->hasMany(Order::className(), ['customer_id' => 'id']); return $this->hasMany(Order::class, ['customer_id' => 'id']);
} }
} }
``` ```

4
docs/guide-ru/db-active-record.md

@ -1563,7 +1563,7 @@ class Customer extends \yii\db\ActiveRecord
public function getOrders() public function getOrders()
{ {
return $this->hasMany(Order::className(), ['customer_id' => 'id']); return $this->hasMany(Order::class, ['customer_id' => 'id']);
} }
} }
``` ```
@ -1594,7 +1594,7 @@ class Customer extends \yii\db\ActiveRecord
*/ */
public function getOrders() public function getOrders()
{ {
return $this->hasMany(Order::className(), ['customer_id' => 'id']); return $this->hasMany(Order::class, ['customer_id' => 'id']);
} }
/** /**

2
docs/guide-ru/security-authorization.md

@ -443,7 +443,7 @@ public function behaviors()
{ {
return [ return [
'access' => [ 'access' => [
'class' => AccessControl::className(), 'class' => AccessControl::class,
'rules' => [ 'rules' => [
[ [
'allow' => true, 'allow' => true,

2
docs/guide-zh-CN/concept-events.md

@ -197,7 +197,7 @@ use yii\base\Event;
Event::on(Foo::class, Foo::EVENT_HELLO, function ($event) { Event::on(Foo::class, Foo::EVENT_HELLO, function ($event) {
var_dump($event->sender); // 显示 "null" var_dump($event->sender); // 显示 "null"
Event::on(Foo::className(), Foo::EVENT_HELLO, function ($event) { Event::on(Foo::class, Foo::EVENT_HELLO, function ($event) {
}); });
Event::trigger(Foo::class, Foo::EVENT_HELLO); Event::trigger(Foo::class, Foo::EVENT_HELLO);

4
docs/guide/db-active-record.md

@ -1423,7 +1423,7 @@ class Customer extends \yii\db\ActiveRecord
{ {
public function getComments() public function getComments()
{ {
return $this->hasMany(Comment::className(), ['customer_id' => 'id']); return $this->hasMany(Comment::class, ['customer_id' => 'id']);
} }
} }
@ -1615,7 +1615,7 @@ class Customer extends \yii\db\ActiveRecord
*/ */
public function getOrders() public function getOrders()
{ {
return $this->hasMany(Order::className(), ['customer_id' => 'id']); return $this->hasMany(Order::class, ['customer_id' => 'id']);
} }
/** /**

2
framework/CHANGELOG.md

@ -10,7 +10,7 @@ Yii Framework 2 Change Log
- Removed methods marked as deprected in 2.0.x (samdark) - Removed methods marked as deprected in 2.0.x (samdark)
- Chg #10771: Consistent behavior of `run()` method in all framework widgets. All return the result now for better extensibility (pkirill99, cebe) - Chg #10771: Consistent behavior of `run()` method in all framework widgets. All return the result now for better extensibility (pkirill99, cebe)
- Chg #11397: Minimum required version of PHP is 5.5.0 now (samdark) - Chg #11397: Minimum required version of PHP is 5.5.0 now (samdark)
- Chg: Removed `yii\base\Object::className()` in favor of native PHP syntax `::class`, which does not trigger autoloading (cebe) - Chg: Removed `yii\base\Object::class` in favor of native PHP syntax `::class`, which does not trigger autoloading (cebe)
- Chg #12074: Updated `yii\widgets\ActiveField::hint()` method signature to match `label()` (PowerGamer1, samdark) - Chg #12074: Updated `yii\widgets\ActiveField::hint()` method signature to match `label()` (PowerGamer1, samdark)
- Chg #11560: Removed XCache and Zend data cache support as caching backends (samdark) - Chg #11560: Removed XCache and Zend data cache support as caching backends (samdark)

2
tests/data/views/widgets/ListView/item.php

@ -7,4 +7,4 @@
* @var \yii\widgets\ListView $widget * @var \yii\widgets\ListView $widget
*/ */
echo "Item #{$index}: {$model['login']} - Widget: " . $widget->className(); echo "Item #{$index}: {$model['login']} - Widget: " . get_class($widget);

2
tests/framework/widgets/ListViewTest.php

@ -78,7 +78,7 @@ HTML
], ],
[ [
function ($model, $key, $index, $widget) { function ($model, $key, $index, $widget) {
return "Item #{$index}: {$model['login']} - Widget: " . $widget->className(); return "Item #{$index}: {$model['login']} - Widget: " . get_class($widget);
}, },
'<div id="w0" class="list-view"><div class="summary">Showing <b>1-3</b> of <b>3</b> items.</div> '<div id="w0" class="list-view"><div class="summary">Showing <b>1-3</b> of <b>3</b> items.</div>
<div data-key="0">Item #0: silverfire - Widget: yii\widgets\ListView</div> <div data-key="0">Item #0: silverfire - Widget: yii\widgets\ListView</div>

Loading…
Cancel
Save