Added uz language (#243)

(O'zbek tili qo'shildi)

Author: mrmuminov

docs/guide-uz/README.md

@@ -0,0 +1,21 @@
+Yii 2 Kesh, Sessiya va ActiveRecord uchun Redis
+===============================================
+
+Bu kengaytma key-value(kalit-qiymat) ma'lumotlarni Yii2 [Redis](http://redis.io/) saqlash uchun yordam beradi.
+
+Ishni boshlash
+---------------
+
+* [O'rnatish](installation.md)
+
+Foydalanish
+----- 
+
+* [ActiveRecord orqali foydalanish](usage-ar.md)
+* [To'g'ridan-to'g'ri buyruqlar orqali foydalanish](usage-commands.md)
+
+Qo'shimcha
+-----------------
+
+* [Kesh uchun foydalanish](topics-cache.md)
+* [Sessiya uchun foydalanish](topics-session.md)

docs/guide-uz/installation.md

@@ -0,0 +1,51 @@
+O'rnatish
+============
+
+## Talablar
+
+Barcha komponentlar to'g'ri ishlashi uchun kamida [Redis](http://redis.io/) 2.6.12 versiyasi talab qilinadi.
+
+## Composer orqali o'rnatish
+
+[Composer](http://getcomposer.org/download/) orqali o'rnatish eng yaxshi usuldir.
+
+Quyidagi buyruq orqali o'rnatish mumkin:
+
+```
+php composer.phar require --prefer-dist yiisoft/yii2-redis
+```
+
+yoki `composer.json` fayliga `require` bo'limiga quyidagilarni qo'shish orqali
+
+```json
+"yiisoft/yii2-redis": "~2.0.0"
+```
+
+o'rnatish mumkin.
+
+## Sozlash
+
+Kengaytmadan foydalanish uchun Yii2 sozlamalaridan `[[yii\redis\Connection|Connection]]` sinfini quyidagicha sozlashingiz kerak
+
+```php
+return [
+ //....
+ 'components' => [
+ 'redis' => [
+ 'class' => 'yii\redis\Connection',
+ 'hostname' => 'localhost',
+ 'port' => 6379,
+ 'database' => 0,
+ ],
+ ]
+];
+```
+
+Quyidagi kodlar orqali redis'ga ma'lumot kiritish va o'qishning eng oddiy holatini ko'rish mumkin
+ 
+```php
+Yii::$app->redis->set('mykey', 'some value');
+echo Yii::$app->redis->get('mykey');
+```
+
+Boshqa metodlarni ko'rish uchun `[[yii\redis\Connection]]` sinfiga qarang.

docs/guide-uz/topics-cache.md

@@ -0,0 +1,50 @@
+Kesh uchun foydalanish
+=========================
+
+Redis'dan keshda foydalanish uchun [O'rnatish](installation.md) bo'limida tavsiflanganidek sozlashdan tashqari, 
+[[yii\redis\Cache]] sinfi ham sozlashingiz kerak:
+
+```php
+return [
+ //....
+ 'components' => [
+ // ...
+ 'cache' => [
+ 'class' => 'yii\redis\Cache',
+ ],
+ ]
+];
+```
+
+Agar siz faqat redis keshidan foydalansangiz (ya'ni, ActiveRecord yoki Sessiya uchun foydalanmasangiz), 
+kesh komponentini o'zida ulanish sozlamalarini ham kiritishingiz mumkin 
+(bu holda [O'rnatish](installation.md) bo'limidagi sozlashni bajarish shart emas):
+
+```php
+return [
+ //....
+ 'components' => [
+ // ...
+ 'cache' => [
+ 'class' => 'yii\redis\Cache',
+ 'redis' => [
+ 'hostname' => 'localhost',
+ 'port' => 6379,
+ 'database' => 0,
+ ],
+ ],
+ ]
+];
+```
+
+Kesh `[[yii\caching\CacheInterface]]` interfeysidagi barcha metodlardan foydalanish imkonini beradi.
+Interfeysga kiritilmagan Redis maxsus metodlaridan foydalanmoqchi bo'lsangiz, [[yii\redis\Cache::$redis]] orqali foydalanishingiz mumkin, 
+bu [[yii\redis\Connection]] holatidagi namuna:
+
+```php
+Yii::$app->cache->redis->hset('mykey', 'somefield', 'somevalue');
+Yii::$app->cache->redis->hget('mykey', 'somefield');
+...
+```
+
+Boshqa metodlarni ko'rish uchun `[[yii\redis\Cache]]` sinfiga qarang.

docs/guide-uz/topics-session.md

@@ -0,0 +1,40 @@
+Sessiya uchun foydalanish
+===========================
+
+Redis'dan sessiyada foydalanish uchun [O'rnatish](installation.md) bo'limida tavsiflanganidek sozlashdan tashqari,
+[[yii\redis\Session]] sinfi ham sozlashingiz kerak:
+
+```php
+return [
+ //....
+ 'components' => [
+ // ...
+ 'session' => [
+ 'class' => 'yii\redis\Session',
+ ],
+ ]
+];
+```
+
+Agar siz faqat redis sessiyaidan foydalansangiz (ya'ni, ActiveRecord yoki Kesh uchun foydalanmasangiz),
+sessiya komponentini o'zida ulanish sozlamalarini ham kiritishingiz mumkin
+(bu holda [O'rnatish](installation.md) bo'limidagi sozlashni bajarish shart emas):
+
+```php
+return [
+ //....
+ 'components' => [
+ // ...
+ 'session' => [
+ 'class' => 'yii\redis\Session',
+ 'redis' => [
+ 'hostname' => 'localhost',
+ 'port' => 6379,
+ 'database' => 0,
+ ],
+ ],
+ ]
+];
+```
+
+Boshqa metodlarni ko'rish uchun `[[yii\redis\Session]]` sinfiga qarang.

docs/guide-uz/usage-ar.md

@@ -0,0 +1,75 @@
+ActiveRecord orqali foydalanish
+======================
+
+Avvalo Yii2'da ActiveRecord'dan qanday foydalanish haqida umumiy ma'lumot olish uchun [qo'llanma](https://github.com/yiisoft/yii2/blob/master/docs/guide/db-active-record.md) ga qarang.
+
+Redis'dan ActiveRecord orqali foydalanish uchun sizning sinfingiz [[yii\redis\ActiveRecord]] vorisi bo'lish va 
+sinfingizda kamida `attributes()` metodi bo'lishi kerak.
+
+
+
+PrimaryKey'ni `[[yii\redis\ActiveRecord::primaryKey()]]` orqali tanitish mumkin, agar berilmagan bo'lsa, `id` PrimaryKey sifatida tanitiladi.
+PrimaryKey'ni ko'rsatmagan bo'lsangiz, PrimaryKey sifatida `id` olinganligini tekshiring.
+
+Quyida `Customer` nomli namunaviy model keltirilgan:
+
+```php
+class Customer extends \yii\redis\ActiveRecord
+{
+ /**
+ * @return array the list of attributes for this record
+ */
+ public function attributes()
+ {
+ return ['id', 'name', 'address', 'registration_date'];
+ }
+
+ /**
+ * @return ActiveQuery defines a relation to the Order record (can be in other database, e.g. elasticsearch or sql)
+ */
+ public function getOrders()
+ {
+ return $this->hasMany(Order::className(), ['customer_id' => 'id']);
+ }
+
+ public static function find()
+ {
+ return new CustomerQuery(get_called_class());
+ }
+}
+
+class CustomerQuery extends \yii\redis\ActiveQuery
+{
+ /**
+ * Defines a scope that modifies the `$query` to return only active(status = 1) customers
+ */
+ public function active()
+ {
+ return $this->andWhere(['status' => 1]);
+ }
+}
+```
+
+Общее использование redis ActiveRecord очень похоже на БД ActiveRecord как описано в [руководстве](https://github.com/yiisoft/yii2/blob/master/docs/guide/db-active-record.md).
+Он поддерживает тот же интерфейс и функции, за исключением следующих ограничений:
+
+Redis'dan ActiveRecord'da foydalanish, ma'lumotlar bazasi bilan ishlashga juda o'xshaydi.
+Faqat u quyidagi cheklovlardan tashqari bir xil interfeys va xususiyatlarni qo'llab-quvvatlaydi:
+
+- Redis SQL'ni qo'llab-quvvatlamagani uchun quidagi metodlardan foydalanib bo'lmaydi
+ `where()`, `limit()`, `offset()`, `orderBy()` va `indexBy()`.
+- `via` - jadval via orqali aniqlab (bog'lanib) bo'lmaydi, chunki redisda jadvallar mavjud emas. Siz bog'lanishlarni boshqa ma'lumotlar orqali belgilashingiz mumkin.
+
+Redis ActiveRecords dan oddiy ActiveRecord sinflariga va aksincha bog'lanishlarni aniqlashingiz mumkin.
+
+Masalan:
+
+```php
+$customer = new Customer();
+$customer->attributes = ['name' => 'test'];
+$customer->save();
+echo $customer->id; // id will automatically be incremented if not set explicitly
+
+$customer = Customer::find()->where(['name' => 'test'])->one(); // find by query
+$customer = Customer::find()->active()->all(); // find all by query (using the `active` scope)
+```

docs/guide-uz/usage-commands.md

@@ -0,0 +1,22 @@
+To'g'ridan-to'g'ri buyruqlar orqali foydalanish
+=======================
+
+Redis'da to'g'ridan-to'g'ri ulanishdan foydalanishda, juda ko'p buyruqlar mavjud. 
+Ilovani [O'rnatish](installation.md)da ko'rsatilganidek sozlaganingizdan so'ng, quyidagi kabi ulanishga erishish mumkin
+```php
+$redis = Yii::$app->redis;
+```
+
+Sozlab bo'lganingizdan so'ng, to'g'ridan to'g'ri buyruq berish uchun executeCommand metodi asosiy hisoblanadi.
+
+```php
+$result = $redis->executeCommand('hmset', ['test_collection', 'key1', 'val1', 'key2', 'val2']);
+```
+
+Qo'llab quvvatlanadigan barcha buyruqlarni quyidagicha bajarish ham mumkin:
+
+```php
+$result = $redis->hmset('test_collection', 'key1', 'val1', 'key2', 'val2');
+```
+
+Redis'ning mavjud buyruqlari haqida <http://redis.io/commands> sahifasida o'rganib chiqishingiz mumkin.