Yii2 framework backup

21 KiB

Raw Blame History Unescape Escape

Upgrade dari Versi 1.1

Ada banyak perbedaan antara versi 1.1 dan 2.0 karena Yii Framework benar-benar ditulis ulang di versi 2.0. Akibatnya, upgrade dari versi 1.1 tidak mudah seperti upgrade untuk versi minor. Dalam panduan ini Anda akan menemukan perbedaan utama antara dua versi.

Jika Anda belum pernah menggunakan Yii 1.1 sebelumnya, Anda dapat dengan aman melewati bagian ini dan menuju ke "Persiapan".

Harap dicatat bahwa Yii 2.0 memperkenalkan lebih banyak fitur baru dari yang tercakup dalam ringkasan ini. Sangat dianjurkan Anda membaca keseluruhan panduan definitif untuk mempelajari hal tersebut. Kemungkinannya adalah bahwa beberapa fitur yang sebelumnya harus anda kembangkan sendiri kini menjadi bagian dari kode inti.

Instalasi

Yii 2.0 sepenuhnya menggunakan composer, yaitu dependency manager yang sudah diakui oleh PHP. Instalasi dari kerangka inti serta ekstensi, ditangani melalui Composer. Silakan merujuk ke bagian Instalasi Yii untuk belajar cara menginstal Yii 2.0. Jika Anda menghendaki membuat ekstensi baru, atau mengubah ekstensi 1.1 yang sudah ke ekstensi 2.0 yang kompatibel, silakan merujuk panduan Membuat Ekstensi.

Persyaratan PHP

Yii 2.0 membutuhkan PHP 5.4 atau versi lebih tinggi, yang merupakan perbaikan besar atas PHP versi 5.2 yang dibutuhkan oleh Yii 1.1. Akibatnya, ada banyak perbedaan pada tingkat bahasa yang harus Anda perhatikan. Di bawah ini adalah ringkasan perubahan utama mengenai PHP:

Namespaces.
Anonymous fungsi.
Sintaks array pendek [... elemen ...] digunakan sebagai pengganti array (... elemen ...).
Tags echo pendek <= digunakan dalam tampilan file. Ini aman digunakan mulai dari PHP 5.4.
Class SPL dan interface.
Late Static Bindings.
Tanggal dan Waktu.
Traits.
Intl. Yii 2.0 menggunakan ekstensi PHP intl untuk mendukung fitur internasionalisasi.

Namespace

Perubahan yang paling jelas dalam Yii 2.0 adalah penggunaan namespace. Hampir setiap kelas inti menggunakan namespace, misalnya, yii\web\Request. Awalan "C" tidak lagi digunakan dalam nama kelas. Skema penamaan sekarang mengikuti struktur direktori. Misalnya, yii\web\Request menunjukkan bahwa file kelas yang sesuai adalah web/Request.php bawah folder framework Yii.

(Anda dapat menggunakan setiap kelas inti tanpa menyertakannya secara eksplisit berkat Yiiclass loader.)

Komponen dan Object

Yii 2.0 membagi kelas CComponent di 1.1 menjadi dua kelas: yii\base\Object dan yii\base\Component. Class yii\base\Object adalah class dasar ringan yang memungkinkan mendefinisikan objek properti melalui getter dan setter. Class yii\base\Component adalah perluasan dari yii\base\Object dengan dukungan Event dan behavior.

Jika class Anda tidak perlu fitur event atau behavior, Anda harus mempertimbangkan menggunakan yii\base\Object sebagai class dasar. Hal ini biasanya terjadi untuk class yang mewakili struktur data dasar.

Konfigurasi objek

Class yii\base\Object memperkenalkan cara seragam untuk mengkonfigurasi objek. Setiap class turunan dari yii\base\Object harus menyatakan konstruktor (jika diperlukan) dengan cara berikut agar dapat dikonfigurasi dengan benar:

class MyClass extends \yii\base\Object
{
    public function __construct($param1, $param2, $config = [])
    {
        // ... inisialisasi sebelum konfigurasi diterapkan

        parent::__construct($config);
    }

    public function init()
    {
        parent::init();

        // ... inisialisasi setelah konfigurasi diterapkan
    }
}

Dalam contoh di atas, parameter terakhir dari konstruktor harus mengambil array konfigurasi yang berisi pasangan nama-nilai untuk menginisialisasi properti pada akhir konstruktor. Anda dapat menimpa method yii\base\Object::init() untuk melakukan pekerjaan inisialisasi yang harus dilakukan setelah konfigurasi telah diterapkan.

Dengan mengikuti konvensi ini, Anda akan dapat membuat dan mengkonfigurasi objek baru menggunakan array konfigurasi:

$object = Yii::createObject([
    'class' => 'MyClass',
    'property1' => 'abc',
    'property2' => 'cde',
], [$param1, $param2]);

Rincian lebih lanjut tentang konfigurasi dapat ditemukan di bagian Konfigurasi.

Event

Di Yii 1, event dibuat dengan mendefinisikan method on (misalnya,onBeforeSave). Di Yii 2, Anda sekarang dapat menggunakan semua nama sebagai event. Anda memicu suatu event dengan memanggil method yii\base\Component::trigger():

$event = new \yii\base\Event;
$component->trigger($eventName, $event);

Untuk melampirkan penanganan event, mengunakan method yii\base\Component::on():

$component->on($eventName, $handler);
// To detach the handler, use:
// $component->off($eventName, $handler);

Ada banyak pengembangan dari fitur event. Untuk lebih jelasnya, silakan lihat bagian Event.

Path Alias

Yii 2.0 memperluas penggunaan alias path baik untuk file/direktori maupun URL. Yii 2.0 juga sekarang mensyaratkan nama alias dimulai dengan karakter @. Misalnya, alias @yii mengacu pada direktori instalasi Yii. Alias path didukung di sebagian besar tempat di kode inti Yii. Misalnya, yii\caching\FileCache::cachePath dapat mengambil baik alias path maupun direktori normal.

Sebuah alias juga terkait erat dengan namespace kelas. Disarankan alias didefinisikan untuk setiap akar namespace, sehingga memungkinkan Anda untuk menggunakan autoloader class Yii tanpa konfigurasi lebih lanjut. Misalnya, karena @yii mengacu pada direktori instalasi Yii, class seperti yii\web\Request dapat otomatis diambil. Jika Anda menggunakan librari pihak ketiga seperti Zend Framework. Anda dapat menentukan alias path @Zend yang mengacu pada direktori instalasi framework direktori. Setelah Anda selesai melakukannya, Yii akan dapat menload setiap class dalam librari Zend Framework.

Lebih jauh tentang alias path dapat ditemukan di bagian Alias.

View

Perubahan yang paling signifikan tentang view di Yii 2 adalah bahwa variabel khusus $this dalam sebuah view tidak lagi mengacu controller saat ini atau widget. Sebaliknya, $this sekarang mengacu pada objek view, konsep baru yang diperkenalkan di 2.0. Objek view adalah yii\web\View, yang merupakan bagian view dari pola MVC. Jika Anda ingin mengakses controller atau widget di tampilan, Anda dapat menggunakan $this->context.

Untuk membuat tampilan parsial dalam view lain, Anda menggunakan $this->render(), tidak lagi $this->renderPartial(). Panggilan untuk render juga sekarang harus secara eksplisit di-echo), mengingat method render() sekarang mengembalikan nilai yang dirender, bukan langsung menampilkannya. Sebagai contoh:

echo $this->render('_item', ['item' => $item]);

Selain menggunakan PHP sebagai bahasa template utama, Yii 2.0 juga dilengkapi dengan dukungan resmi dua mesin template populer: Smarty dan Twig. Mesin template Prado tidak lagi didukung. Untuk menggunakan mesin template ini, Anda perlu mengkonfigurasi komponen aplikasi view dengan menetapkan properti yii\base\View::$renderers. Silakan merujuk ke bagian Template Engine untuk lebih jelasnya.

Model

Yii 2.0 menggunakan yii\base\Model sebagai model dasar, mirip dengan CModel di 1.1. class CFormModel telah dibuang seluruhnya. Sebaliknya, di Yii 2 Anda harus memperluas yii\base\Model untuk membuat class model formulir.

Yii 2.0 memperkenalkan metode baru yang disebut yii\base\Model::scenario() untuk menyatakan skenario yang didukung, dan untuk menunjukkan di mana skenario atribut perlu divalidasi serta atribut yang dapat dianggap sebagai aman atau tidak dll Sebagai contoh:

public function scenarios()
{
    return [
        'backend' => ['email', 'role'],
        'frontend' => ['email', '!role'],
    ];
}

Dalam contoh di atas, dua skenario dinyatakan: backend dan frontend. Untuk skenario backend, baik atribut email maupun role aman dan dapat diassign secara masal. Untuk skenario frontend, email dapat diassign secara masal sementara role tidak bisa. Kedua email dan role harus divalidasi sesuai aturan.

Method yii\base\Model::rules() ini masih digunakan untuk menyatakan aturan validasi. Perhatikan bahwa dengan dikenalkannya yii\base\Model::scenario() sekarang tidak ada lagi validator unsafe.

Dalam kebanyakan kasus, Anda tidak perlu menimpa yii\base\Model::scenario() jika method yii\base\Model::rules() sepenuhnya telah menentukan skenario yang akan ada dan jika tidak ada kebutuhan untuk menyatakan atribut unsafe.

Untuk mempelajari lebih lanjut tentang model, silakan merujuk ke bagian Model.

Controller

Yii 2.0 menggunakan yii\web\Controller sebagai kelas dasar controller, yang mirip dengan CController di Yii 1.1. Yii\base\Action adalah kelas dasar untuk kelas action.

Dampak paling nyata dari perubahan ini pada kode Anda adalah bahwa aksi kontroler harus mengembalikan nilai konten alih-alih menampilkannya:

public function actionView($id)
{
    $model = \app\models\Post::findOne($id);
    if ($model) {
        return $this->render('view', ['model' => $model]);
    } else {
        throw new \yii\web\NotFoundHttpException;
    }
}

Silakan merujuk ke bagian Controller untuk rincian lebih lanjut tentang controller.

Yii 2.0 menggunakan yii\base\Widget sebagai kelas dasar widget, mirip dengan CWidget di Yii 1.1.

Untuk mendapatkan dukungan yang lebih baik untuk kerangka di IDE, Yii 2.0 memperkenalkan sintaks baru untuk menggunakan widget. Metode statis yii\base\Widget::begin(), yii\base\Widget::end(), dan yii\base\Widget::widget() mulai diperkenalkan, yang akan digunakan seperti:

use yii\widgets\Menu;
use yii\widgets\ActiveForm;

// Note that you have to "echo" the result to display it
echo Menu::widget(['items' => $items]);

// Passing an array to initialize the object properties
$form = ActiveForm::begin([
    'options' => ['class' => 'form-horizontal'],
    'fieldConfig' => ['inputOptions' => ['class' => 'input-xlarge']],
]);
... form input fields here ...
ActiveForm::end();

Silakan merujuk ke bagian Widget untuk lebih jelasnya.

Tema

Tema bekerja benar-benar berbeda di 2.0. Mereka sekarang berdasarkan mekanisme pemetaan path yang memetakan file sumber ke file tema. Misalnya, jika peta path untuk tema adalah ['/web/views' => '/web/themes/basic'], maka versi tema dari file view /web/views/site/index.php akan menjadi /web/themes/basic/site/index.php. Untuk alasan ini, tema sekarang bisa diterapkan untuk setiap file view, bahkan view diberikan di luar controller atau widget.

Juga, tidak ada lagi komponen CThemeManager. Sebaliknya, theme adalah properti dikonfigurasi dari komponen view aplikasi.

Silakan merujuk ke bagian Theming untuk lebih jelasnya.

Aplikasi konsol

Aplikasi konsol sekarang diatur sebagai controller seperti pada aplikasi Web. kontroler konsol harus diperluas dari yii\console\Controller, mirip dengan CConsoleCommand di 1.1.

Untuk menjalankan perintah konsol, menggunakan yii <route>, di mana <route> adalah rute kontroler (Misalnya sitemap/index). Argumen anonim tambahan dilewatkan sebagai parameter ke action controller yang sesuai, sedangkan argumen bernama diurai menurut deklarasi pada yii\console\Controller::options().

Yii 2.0 mendukung pembuatan informasi bantuan command secara otomatis berdasarkan blok komentar.

Silakan lihat bagian Console Commands untuk lebih jelasnya.

I18N

Yii 2,0 menghilangkan formater tanggal dan angka terpasang bagian dari PECL modul intl PHP.

Penterjemahan pesan sekarang dilakukan melalui komponen aplikasi i18n. Komponen ini mengelola satu set sumber pesan, yang memungkinkan Anda untuk menggunakan pesan yang berbeda sumber berdasarkan kategori pesan.

Silakan merujuk ke bagian Internasionalisasi untuk rincian lebih lanjut.

Action Filter

Action Filter sekarang diimplementasikan melalui behavior. Untuk membuat baru, filter diperluas dari yii\base\ActionFilter. Untuk menggunakan filter, pasang Kelas filter untuk controller sebagai behavior. Misalnya, untuk menggunakan filter yii\filters\AccessControl, Anda harus mengikuti kode berikut di kontroler:

public function behaviors()
{
    return [
        'access' => [
            'class' => 'yii\filters\AccessControl',
            'rules' => [
                ['allow' => true, 'actions' => ['admin'], 'roles' => ['@']],
            ],
        ],
    ];
}

Silakan merujuk ke bagian Filtering untuk lebih jelasnya.

Aset

Yii 2.0 memperkenalkan konsep baru yang disebut bundel aset yang menggantikan konsep paket script di Yii 1.1.

Bundel aset adalah kumpulan file asset (misalnya file JavaScript, file CSS, file gambar, dll) dalam direktori. Setiap bundel aset direpresentasikan sebagai kelas turunan dari yii\web\AssetBundle. Dengan mendaftarkan bundel aset melalui yii\web\AssetBundle::register(), Anda membuat aset dalam bundel diakses melalui Web. Tidak seperti di Yii 1, halaman yang mendaftarkan bundel akan secara otomatis berisi referensi ke JavaScript dan file CSS yang ditentukan dalam bundel itu.

Silakan merujuk ke bagian Managing Aset untuk lebih jelasnya.

Helper

Yii 2.0 memperkenalkan banyak helper umum untuk digunakan, termasuk.

Silakan lihat bagian Tinjauan Helper untuk lebih jelasnya.

Formulir

Yii 2.0 memperkenalkan konsep field untuk membangun formulir menggunakan yii\widgets\ActiveForm. Field adalah wadah yang terdiri dari label, masukan, pesan kesalahan, dan atau teks petunjuk. Field diwakili sebagai objek yii\widgets\ActiveField. Menggunakan field, Anda dapat membangun formulir yang lebih bersih dari sebelumnya:

<?php $form = yii\widgets\ActiveForm::begin(); ?>
    <?= $form->field($model, 'username') ?>
    <?= $form->field($model, 'password')->passwordInput() ?>
    <div class="form-group">
        <?= Html::submitButton('Login') ?>
    </div>
<?php yii\widgets\ActiveForm::end(); ?>

Silakan merujuk ke bagian Membuat Formulir untuk lebih jelasnya.

Query Builder

Dalam 1.1, query builder itu tersebar di antara beberapa kelas, termasuk CDbCommand, CDbCriteria, dan CDbCommandBuilder. Yii 2.0 merepresentasikan sebuah query DB sebagai objek yii\db\Query yang dapat berubah menjadi sebuah pernyataan SQL dengan bantuan yii\db\QueryBuilder. Sebagai contoh:

$query = new \yii\db\Query();
$query->select('id, name')
      ->from('user')
      ->limit(10);

$command = $query->createCommand();
$sql = $command->sql;
$rows = $command->queryAll();

Yang terbaik dari semua itu adalah, query builder juga dapat digunakan ketika bekerja dengan Active Record.

Silakan lihat bagian Query Builder untuk lebih jelasnya.

Active Record

Yii 2.0 memperkenalkan banyak perubahan Active Record. Dua yang paling jelas melibatkan query builder dan penanganan permintaan relasional.

Kelas CDbCriteria di 1.1 digantikan oleh yii\db\ActiveQuery di Yii 2. Karena kelas tersebut adalah perluasan dari yii\db\Query, dengan demikian mewarisi semua metode query builder. Anda bisa memanggil yii\db\ActiveRecord::find() untuk mulai membangun query:

// Untuk mengambil semua customer yang *active* diurutkan sesuai ID:
$customers = Customer::find()
    ->where(['status' => $active])
    ->orderBy('id')
    ->all();

Untuk menyatakan suatu relasi, hanya dengan menentukan metod getter yang mengembalikan sebuah objek yii\db\ActiveQuery. Nama properti yang didefinisikan oleh getter akan menjadi nama relasi. Misalnya, kode berikut mendeklarasikan sebuah relasi orders (di 1.1, Anda akan harus menyatakan relasi di tempat relations()):

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

Sekarang Anda dapat menggunakan $customer->orders untuk mengakses pesanan pelanggan dari tabel terkait. Anda juga dapat menggunakan kode berikut untuk melakukan permintaan relasi secara cepat dengan kondisi permintaan yang disesuaikan:

$orders = $customer->getOrders()->andWhere('status=1')->all();

Ketika ingin memuat relasi, Yii 2.0 melakukannya secara berbeda dari 1.1. Secara khusus, di 1.1 query JOIN akan dibuat untuk memilih data utama dan data relasi. Di Yii 2.0, dua pernyataan SQL dijalankan tanpa menggunakan JOIN: pernyataan pertama membawa kembali data utama dan yang kedua membawa kembali data relasi dengan menyaring sesuai kunci primer dari data utama.

Alih-alih mengembalikan objek yii\db\ActiveRecord, Anda mungkin ingin menyambung dengan yii\db\ActiveQuery::asArray() ketika membangun query untuk mendapatkan sejumlah besar data. Hal ini akan menyebabkan hasil query dikembalikan sebagai array, yang dapat secara signifikan mengurangi waktu CPU yang dibutuhkan dan memori jika terdapat sejumlah besar data. Sebagai contoh:

$customers = Customer::find()->asArray()->all();

Perubahan lain adalah bahwa Anda tidak dapat menentukan nilai default atribut melalui properti publik lagi. Jika Anda membutuhkan mereka, Anda harus mengatur mereka dalam metode init kelas record Anda.

public function init()
{
    parent::init();
    $this->status = self::STATUS_NEW;
}

Ada beberapa masalah dengan override konstruktor dari kelas ActiveRecord di 1.1. Ini tidak lagi hadir di versi 2.0. Perhatikan bahwa ketika menambahkan parameter ke constructor Anda mungkin harus mengganti yii\db\ActiveRecord::instantiate().

Ada banyak perubahan lain dan perangkat tambahan untuk Rekaman Aktif. Silakan merujuk ke bagian Rekaman Aktif untuk rincian lebih lanjut.

Active Record Behaviors

Dalam 2.0, kami telah membuang kelas behavior dasar CActiveRecordBehavior. Jika Anda ingin membuat behavior Active Record, Anda akan harus memperluasnya langsung dari yii\base\Behavior. Jika kelas behavior perlu menanggapi beberapa event dari pemilik, Anda harus mengganti method events() seperti berikut ini,

namespace app\components;

use yii\db\ActiveRecord;
use yii\base\Behavior;

class MyBehavior extends Behavior
{
    // ...

    public function events()
    {
        return [
            ActiveRecord::EVENT_BEFORE_VALIDATE => 'beforeValidate',
        ];
    }

    public function beforeValidate($event)
    {
        // ...
    }
}

Pengguna dan IdentityInterface

Kelas CWebUser di 1.1 kini digantikan oleh yii\web\User, dan sekarang tidak ada lagi Kelas CUserIdentity. Sebaliknya, Anda harus menerapkan yii\web\IdentityInterface yang jauh lebih mudah untuk digunakan. Template proyek lanjutan memberikan contoh seperti itu.

Silakan merujuk ke bagian Otentikasi, Otorisasi, dan [Template Proyek Lanjutan](https://github.com/yiisoft/yii2-app-advanced/blob /master/docs/guide/README.md) untuk lebih jelasnya.

Manajemen URL

Manajemen URL di Yii 2 mirip dengan yang di 1.1. Tambahan utamanya adalah, sekarang manajemen URL mendukung opsional parameter. Misalnya, jika Anda memiliki aturan dinyatakan sebagai berikut, maka akan cocok baik dengan post/popular maupun post/1/popular. Dalam 1.1, Anda akan harus menggunakan dua aturan untuk mencapai tujuan yang sama.

[
    'pattern' => 'post/<page:\d+>/<tag>',
    'route' => 'post/index',
    'defaults' => ['page' => 1],
]

Silakan merujuk ke bagian docs manajer Url untuk lebih jelasnya.

Perubahan penting dalam konvensi penamaan untuk rute adalah bahwa nama-nama camelcase dari controller dan action sekarang dikonversi menjadi huruf kecil di mana setiap kata dipisahkan oleh hypen, misal controller id untuk CamelCaseController akan menjadi camel-case. Lihat bagian tentang Kontroler ID dan Action ID untuk lebih jelasnya.

Menggunakan Yii 1.1 dan 2.x bersama-sama

Jika Anda memiliki warisan kode Yii 1.1 yang ingin Anda gunakan bersama-sama dengan Yii 2.0, silakan lihat bagian Menggunakan Yii 1.1 dan 2.0 Bersama.

21 KiB Raw Blame History Unescape Escape