Instalasi Yii
  1. Menginstal melalui komposer
  2. Intalasi dari file Arsip
  3. Pilihan Instalasi lainnya
  4. Memverifikasi Instalasi
  5. Konfigurasi Web Server

Anda dapat menginstal Yii dengan dua cara, yang pertama menggunkan komposer manajer paket atau dengan men-download file arsip. Yang pertama adalah cara yang lebih disukai memungkinkan Anda untuk menginstal baru extensi atau memperbarui Yii dengan hanya menjalankan perintah tunggal.

Instalasi standar Yii hasil baik dalam kerangka kerja dan template proyek terunduh dan terpasang. Template proyek adalah proyek Yii bekerja menerapkan beberapa fitur dasar, seperti login, from kontak, dll kode Its di atur dalam cara yang direkomendasikan. Oleh karena itu, dapat berfungsi sebagai titik awal yang baik untuk proyek-proyek Anda.

Dalam hal ini dan beberapa bagian berikutnya, kita akan menjelaskan cara menginstal Yii denagn apa yang disebut Basic Template Proyek dan bagaimana menerapkan fitur baru diatas template ini. Yii juga menyediakan template lain yang disebut Proyek Lanjutan Template yang baik digunakan dalam lingkungan pengembangan tim untuk mengembangkan apilkasi dengan berberapa tingkatan.

Info: Dasar Template Proyek cocok untuk mengembangkan 90 persen dari aplikasi web. Ini berbeda dari Template Proyek Lanjutan terutama dalam bagaimana kode mereka diatur. Jika anda baru untuk Yii, kami sangat menyarankan anda tetap pada template dasar proyek untuk belum kesederhanaan fungsi yang cukup.

Menginstal melalui Komposer 

Jika Komposer sudah terinstal, Anda dapat melakukannya dengan mengikuti petunjuk
di getcomposer.org Pada Linux dan Mac OS X Anda  akan menjalankan perintah berikut.

 
curl -sS https://getcomposer.org/installer | php mv composer.phar /usr/local/bin/composer

Pada Windows, Anda akan men-download dan menjalankan Komposer-Setup.exe

 Silahkan merunjuk ke dokumentasi Composer jika Anda menemukan masalah atau ingin mempelajari lebih lanjut tentang penggunaan Composer.

 Jika Anda telah menginstal komposer sebelumnya, pastikan anda menggunakan versi date. Anda dapat memperbarui komposer dengan menjalankan composer self-update 

 Dengan Komposer diinstal, anda dapat menginstal Yii dengan menjalankan perintah berikut dibawah folder diakses Web.

 
composer global require "fxp/composer-asset-plugin:~1.0.3"
composer create-project --prefer-dist yiisoft/yii2-app-basic basic

Perintah pertama menginstal plugin yang aset komposer yang memungkinkan mengelola pondok dan paket NPM dipendensi melalui komposer. Anda hanya perlu menjalankan perintah ini sekali untuk semua. Perintah kedua menginstal  Yii dalam sebuah direktori bernama basic anda dapat memilih nama direktori yang berbeda jika anda ingin.
Catatan: Selama Composer instalasi dapat meminta login Github Anda. Ini normal karena Komposer perlu mendapatkan cukup API tingkat-batas untuk mengambil informasi paket tergantung dari Github. Untuk lebih jelasnya, silahkan merujuk ke dokumentasi Composer.

Tip: Jika Anda ingin menginstal versi pengembangan terbaru dari Yii, Anda dapat menggunakan perintah berikut sebagai gantinya, yang menambahkan opsi stabilitas:

 
 composer create-project --prefer-dist --stability=dev yiisoft/yii2-app-basic basic

Perhatikan bahwa versi pengembangan dari Yii tidak boleh digunakan untuk produksi karena dapat memecahkan kode Anda berjalan.

Instalasi dari file Arsip

Instalasi Yii dari file arsip melibatkan tiga langkah:
  1. Download file arsip dari yiiframework.com.
  2. Membongkar file yang didownload ke folder web diakses.
  3. Memodifikasi config/web.php berkas dengan memasukkan kunci rahasia untuk cookieValidationKey item konfigurasi (ini dilakukan secara otomatis jika Anda menginstal Yii menggunakan Composer)

  // !!! insert a secret key in the following (if it is empty) - this is required by cookie validation 
 'cookieValidationKey' => 'enter your secret key here' , 




Pilihan Instalasi lainnya



Petunjuk instalasi di atas menunjukkan cara menginstal Yii, yang juga menciptakan aplikasi Web dasar yang bekerja di luar kotak. Pendekatan ini adalah titik awal yang baik untuk sebagian besar proyek, baik kecil atau besar. Hal ini terutama cocok jika Anda hanya mulai belajar Yii.



Tapi ada pilihan instalasi lain yang tersedia:


    

  • Jika Anda hanya ingin menginstal kerangka inti dan ingin membangun sebuah aplikasi seluruh dari awal, Anda dapat mengikuti petunjuk seperti yang dijelaskan di Gedung Aplikasi dari Scratch.
    • 

  • Jika Anda ingin memulai dengan aplikasi yang lebih canggih, lebih cocok untuk tim lingkungan pengembangan, Anda dapat mempertimbangkan menginstal Template Proyek Lanjutan.
    • 




Memverifikasi Instalasi



Setelah instalasi, Anda dapat menggunakan browser untuk mengakses aplikasi Yii yang diinstal dengan URL berikut:


 http://localhost/basic/web/index.php 


URL ini mengasumsikan Anda telah menginstal Yii dalam sebuah direktori bernama basic langsung di bawah direktori root dokumen server Web, dan bahwa server Web berjalan pada komputer lokal Anda localhost Anda mungkin perlu untuk menyesuaikan dengan lingkungan instalasi anda.







Anda harus melihat di atas "Selamat!" Halaman di browser Anda. Jika tidak, periksa apakah instalasi PHP Anda memenuhi persyaratan Yii. Anda dapat memeriksa apakah persyaratan minimum yang bertemu dengan salah satu pendekatan berikut:


    

  • Gunakan browser untuk mengakses URLhttp://localhost/basic/requirements.php
    • 

  • 
Jalankan perintah berikut:
    

    • 





cd basic php requirements.php 











Anda harus mengkonfigurasi instalasi PHP Anda sehingga memenuhi persyaratan minimal Yii. Yang paling penting, Anda harus memiliki PHP 5.4 atau di atas. Anda juga harus menginstal PDO PHP Ekstensi dan driver database yang sesuai (seperti pdo_mysql untuk database MySQL), jika aplikasi Anda perlu database.







Konfigurasi Web Server





Info: Anda mungkin melewati seksi ini untuk saat ini jika Anda hanya menguji mengemudi Yii dengan tidak berniat menyebarkan ke server produksi.





Aplikasi yang diinstal sesuai dengan petunjuk di atas harus bekerja di luar kotak dengan baik sebagai server Apache HTTP atau server HTTP Nginx,pada Windows, Mac OS X, atau Linux menjalankan PHP 5.4 atau lebih tinggi. Yii 2.0 juga kompatibel dengan facebook HHVM. Namun, ada beberapa kasus di mana tepi HHVM berperilaku berbeda dari PHP asli, sehingga Anda harus mengambil beberapa perawatan ekstra ketika menggunakan HHVM.



Pada server produksi, Anda mungkin ingin mengkonfigurasi server Web Anda sehingga aplikasi dapat diakses melalui URLhttp://www.example.com/index.php bukanhttp://www.example.com/basic/web/index.php Konfigurasi tersebut membutuhkan menunjuk root dokumen server Web Anda ke basic/webfolder. Anda juga mungkin ingin menyembunyikan index.php dari URL, seperti yang dijelaskan dalam Penciptaan Routing dan URL bagian. Dalam ayat ini, Anda akan belajar bagaimana untuk mengkonfigurasi server Apache atau Nginx Anda untuk mencapai tujuan tersebut.





Info: Dengan menetapkan basic/web sebagai akar dokumen, Anda juga mencegah pengguna akhir mengakses kode aplikasi pribadi Anda dan file data sensitif yang disimpan dalam direktori saudara daribasic/web Menolak akses ke folder tersebut lainnya adalah peningkatan keamanan.







Info: Jika aplikasi Anda akan berjalan di lingkungan shared hosting di mana Anda tidak memiliki izin untuk memodifikasi konfigurasi server Web-nya, Anda mungkin masih menyesuaikan struktur aplikasi Anda untuk keamanan yang lebih baik. Silakan lihat Lingkungan Hosting Bersama bagian untuk lebih jelasnya.










Konfigurasi Apache direkomendasikan



Menggunakan konfigurasi berikut di Apache httpd.conf file atau dalam konfigurasi virtual host. Perhatikan bahwa Anda harus menggantipath/to/basic/web dengan jalan yang sebenarnya untuk basic/web

# Set document root to be "basic/web"
DocumentRoot "path/to/basic/web"


    # use mod_rewrite for pretty URL support
    RewriteEngine on
    # If a directory or a file exists, use the request directly
    RewriteCond %{REQUEST_FILENAME} !-f
    RewriteCond %{REQUEST_FILENAME} !-d
    # Otherwise forward the request to index.php
    RewriteRule . index.php

    # ...other settings...








Konfigurasi Nginx direkomendasikan



Untuk menggunakan Nginx, Anda harus menginstal PHP sebagai FPM SAPI.Anda dapat menggunakan konfigurasi Nginx berikut, menggantikanpath/to/basic/web dengan jalan yang sebenarnya untuk basic/web danmysite.local dengan hostname yang sebenarnya untuk melayani.








server {
    charset utf-8;
    client_max_body_size 128M;

    listen 80; ## listen for ipv4
    #listen [::]:80 default_server ipv6only=on; ## listen for ipv6

    server_name mysite.local;
    root        /path/to/basic/web;
    index       index.php;

    access_log  /path/to/basic/log/access.log;
    error_log   /path/to/basic/log/error.log;

    location / {
        # Redirect everything that isn't a real file to index.php
        try_files $uri $uri/ /index.php?$args;
    }

    # uncomment to avoid processing of calls to non-existing static files by Yii
    #location ~ \.(js|css|png|jpg|gif|swf|ico|pdf|mov|fla|zip|rar)$ {
    #    try_files $uri =404;
    #}
    #error_page 404 /404.html;

    location ~ \.php$ {
        include fastcgi_params;
        fastcgi_param SCRIPT_FILENAME $document_root/$fastcgi_script_name;
        fastcgi_pass   127.0.0.1:9000;
        #fastcgi_pass unix:/var/run/php5-fpm.sock;
        try_files $uri =404;
    }

    location ~ /\.(ht|svn|git) {
        deny all;
    }
}











Bila menggunakan konfigurasi ini, Anda juga harus menetapkancgi.fix_pathinfo=0 dalam php.ini file untuk menghindari banyak sistem yang tidak perlu stat() panggilan.



Juga mencatat bahwa ketika menjalankan server HTTPS, Anda perlu menambahkan fastcgi_param HTTPS on; sehingga Yii benar dapat mendeteksi jika sambungan aman.