<commit_before>Upgrading Instructions for Yii Framework v2
===========================================

!!!IMPORTANT!!!

The following upgrading instructions are cumulative. That is,
if you want to upgrade from version A to version C and there is
version B between A and C, you need to follow the instructions
for both A and B.

Make sure you have global install of latest version of composer asset plugin:

```
php composer.phar global require "fxp/composer-asset-plugin:~1.1.1"
```

Upgrade from Yii 2.0.6
----------------------

* Added new requirement: ICU Data version >= 49.1. Please, ensure that your environment has ICU data installed and
up to date to prevent unexpected behavior or crashes.

 > Tip: Use Yii2 Requirements checker for easy and fast check. Look for `requirements.php` in root of Basic and Advanced
 templates (howto-comment is in head of the script).
* The signature of `yii\helpers\BaseInflector::transliterate()` was changed. The method is now public and has an
extra optional parameter `$transliterator`.
* In `yii\web\UrlRule` the `pattern` matching group names are being replaced with the placeholders on class
initialization to support wider range of allowed characters. Because of this change:
  - You are required to flush your application cache to remove outdated `UrlRule` serialized objects.
  See the [Cache Flushing Guide](http://www.yiiframework.com/doc-2.0/guide-caching-data.html#cache-flushing)
  - If you implement `parseRequest()` or `createUrl()` and rely on parameter names, call `substitutePlaceholderNames()`
  in order to replace temporary IDs with parameter names after doing matching.
* The context of `yii.confirm` JavaScript function was changed from `yii` object to the DOM element which triggered
the event.
  - If you overrode the `yii.confirm` function and accessed the `yii` object through `this`, you must access it
with global variable `yii` instead.
* Traversable objects are now formatted as arrays in XML response to support SPL objects and Generators. Previous
  behavior could be turned on by setting `XmlResponseFormatter::$useTraversableAsArray` to `false`.

Upgrade from Yii 2.0.5<commit_msg>Added note for upgrade guide<commit_after>Upgrading Instructions for Yii Framework v2
===========================================

!!!IMPORTANT!!!

The following upgrading instructions are cumulative. That is,
if you want to upgrade from version A to version C and there is
version B between A and C, you need to follow the instructions
for both A and B.

Make sure you have global install of latest version of composer asset plugin:

```
php composer.phar global require "fxp/composer-asset-plugin:~1.1.1"
```

Upgrade from Yii 2.0.6
----------------------

* Added new requirement: ICU Data version >= 49.1. Please, ensure that your environment has ICU data installed and
up to date to prevent unexpected behavior or crashes.

 > Tip: Use Yii2 Requirements checker for easy and fast check. Look for `requirements.php` in root of Basic and Advanced
 templates (howto-comment is in head of the script).
* The signature of `yii\helpers\BaseInflector::transliterate()` was changed. The method is now public and has an
extra optional parameter `$transliterator`.
* In `yii\web\UrlRule` the `pattern` matching group names are being replaced with the placeholders on class
initialization to support wider range of allowed characters. Because of this change:
  - You are required to flush your application cache to remove outdated `UrlRule` serialized objects.
  See the [Cache Flushing Guide](http://www.yiiframework.com/doc-2.0/guide-caching-data.html#cache-flushing)
  - If you implement `parseRequest()` or `createUrl()` and rely on parameter names, call `substitutePlaceholderNames()`
  in order to replace temporary IDs with parameter names after doing matching.
* The context of `yii.confirm` JavaScript function was changed from `yii` object to the DOM element which triggered
the event.
  - If you overrode the `yii.confirm` function and accessed the `yii` object through `this`, you must access it
with global variable `yii` instead.
* Traversable objects are now formatted as arrays in XML response to support SPL objects and Generators. Previous
  behavior could be turned on by setting `XmlResponseFormatter::$useTraversableAsArray` to `false`.
* If you've implemented `yii\rbac\ManagerInterface` you need to implement additional method `getUserIDsByRole($roleName)`.

Upgrade from Yii 2.0.5
{'fraction_non_alphanumeric': 0.09510991475998205, 'fraction_numerical': 0.007178106774338268, 'mean_word_length': 4.601758793969849, 'pattern_counts': {'":': 0, '<': 3, '<?xml version=': 0, '>': 7, 'https://': 0, 'lorem ipsum': 0, 'www.': 2, 'xml': 0}, 'pii_count': 0, 'substrings_counts': 0, 'word_list_counts': {'cursed_substrings.json': 0, 'profanity_word_list.json': 0, 'sexual_word_list.json': 0, 'zh_pornsignals.json': 0}}
{'dir': 'git-commits-cleaned', 'id': '1736524', 'n_tokens_mistral': 1183, 'n_tokens_neox': 1129, 'n_words': 578}