Anda dapat menginstal Yii dalam dua cara, menggunakan Composer paket manager atau dengan mengunduh file arsip. Yang pertama adalah cara yang lebih disukai, karena memungkinkan Anda untuk menginstal ekstensi baru atau memperbarui Yii dengan hanya menjalankan command line.
Hasil instalasi standar Yii baik framework maupun template proyek keduanya akan terunduh dan terpasang. Sebuah template proyek adalah proyek Yii yang menerapkan beberapa fitur dasar, seperti login, formulir kontak, dll. Kode diatur 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 dengan apa yang disebut Template Proyek Dasar dan bagaimana menerapkan fitur baru di atas template ini. Yii juga menyediakan template lain yang disebut yang Template Proyek Lanjutan yang lebih baik digunakan dalam lingkungan pengembangan tim untuk mengembangkan aplikasi dengan beberapa tingkatan.
Info: Template Proyek Dasar ini 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 merekomendasikan Anda tetap pada Template Proyek Dasar untuk kesederhanaan dan fungsi yang cukup.
Jika Anda belum memiliki Composer terinstal, Anda dapat melakukannya dengan mengikuti petunjuk di [getcomposer.org] (https://getcomposer.org/download/). 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 mengunduh dan menjalankan Composer-Setup.exe.
Silakan merujuk ke Dokumentasi Composer jika Anda menemukan masalah atau ingin mempelajari lebih lanjut tentang penggunaan Composer.
Jika Composer sudah terinstal sebelumnya, pastikan Anda menggunakan versi terbaru. Anda dapat memperbarui Komposer
dengan menjalankan composer self-update
.
Dengan Komposer diinstal, Anda dapat menginstal Yii dengan menjalankan perintah berikut di bawah folder yang terakses web:
composer global require "fxp/composer-asset-plugin:^1.4.1"
composer create-project --prefer-dist yiisoft/yii2-app-basic basic
Perintah pertama menginstal komposer aset Plugin
yang memungkinkan mengelola bower dan paket npm melalui Composer. 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 instalasi, Composer dapat meminta login Github Anda. Ini normal karena Komposer Perlu mendapatkan cukup API rate-limit untuk mengambil informasi paket dari Github. Untuk lebih jelasnya, Silahkan lihat Documentation Composer.
Tips: 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 kemungkinan dapat merusak kode Anda yang sedang berjalan.
Instalasi Yii dari file arsip melibatkan tiga langkah:
Memodifikasi config/web.php
dengan memasukkan kunci rahasia untuk cookieValidationKey
.
(Ini dilakukan secara otomatis jika Anda menginstal Yii menggunakan Composer):
// !!! Isikan nilai key jika kosong - ini diperlukan oleh cookie validation
'cookieValidationKey' => 'enter your secret key here',
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.
Tetapi ada pilihan instalasi lain yang tersedia:
Setelah instalasi selesai, baik mengkonfigurasi web server Anda (lihat bagian berikutnya) atau menggunakan
[Built-in web server PHP] (https://secure.php.net/manual/en/features.commandline.webserver.php) dengan menjalankan berikut
konsol perintah sementara dalam proyek web
direktori:
php yii serve
Catatan: Secara default HTTP-server akan mendengarkan port 8080. Namun jika port yang sudah digunakan atau Anda ingin melayani beberapa aplikasi dengan cara ini, Anda mungkin ingin menentukan port apa yang harus digunakan. Cukup tambahkan argumen --port:
php yii serve --port = 8888
Anda dapat menggunakan browser untuk mengakses aplikasi Yii yang diinstal dengan URL berikut:
http://localhost:8080/
Anda seharusnya melihat halaman "Congratulations!" di browser Anda. Jika tidak, periksa apakah instalasi PHP Anda memenuhi persyaratan Yii. Anda dapat memeriksa apakah persyaratan minimumnya cocok dengan menggunakan salah satu pendekatan berikut:
/requirements.php
ke /web/requirements.php
kemudian gunakan browser untuk mengakses melalui http://localhost/requirements.php
`
bash
cd basic
php requirements.php
`
Anda harus mengkonfigurasi instalasi PHP Anda sehingga memenuhi persyaratan minimal Yii. Yang paling penting, Anda
harus memiliki PHP versi 5.4 atau lebih. Anda juga harus menginstal PDO PHP Ekstensi
dan driver database yang sesuai (seperti pdo_mysql
untuk database MySQL), jika aplikasi Anda membutuhkan database.
Info: Anda dapat melewati seksi ini untuk saat ini jika Anda hanya menguji sebuah Yii dengan niat penggelaran itu untuk server produksi.
Aplikasi yang diinstal sesuai dengan petunjuk di atas seharusnya bekerja dengan baik pada Apache HTTP server atau Nginx HTTP server, pada Windows, Mac OS X, atau Linux yang menjalankan PHP 5.4 atau lebih tinggi. Yii 2.0 juga kompatibel dengan facebook HHVM. Namun, ada beberapa kasus di mana HHVM berperilaku berbeda dari PHP asli, sehingga Anda harus mengambil beberapa perlakuan ekstra ketika menggunakan HHVM.
Pada server produksi, Anda mungkin ingin mengkonfigurasi server Web Anda sehingga aplikasi dapat diakses
melalui URL http://www.example.com/index.php
bukannya http://www.example.com/dasar/web/index.php
. konfigurasi seperti itu
membutuhkan root dokumen server Web Anda menunjuk ke folder basic/web
. Anda mungkin juga
ingin menyembunyikan index.php
dari URL, seperti yang dijelaskan pada bagian Routing dan Penciptaan URL.
Dalam bagian ini, Anda akan belajar bagaimana untuk mengkonfigurasi Apache atau Nginx server Anda untuk mencapai tujuan tersebut.
Info: Dengan menetapkan
basic/web
sebagai akar dokumen, Anda juga mencegah pengguna akhir mengakses kode private aplikasi Anda dan file data sensitif yang disimpan dalam direktori sejajar daribasic/web
. Mencegah akses ke folder lainnya adalah sebuah 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 merujuk ke yang lebih baik. Lihat bagian Shared Hosting Lingkungan untuk rincian lebih lanjut.
Gunakan konfigurasi berikut di file httpd.conf
Apache atau dalam konfigurasi virtual host. Perhatikan bahwa Anda
harus mengganti path/to/basic/web
dengan path dasar/web
yang sebenarnya.
# Set document root to be "basic/web"
DocumentRoot "path/to/basic/web"
<Directory "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...
</Directory>
Untuk menggunakan Nginx, Anda harus menginstal PHP sebagai FPM SAPI.
Anda dapat menggunakan konfigurasi Nginx berikut, menggantikan path/to/basic/web
dengan path yang sebenarnya untuk
basic/web
dan mysite.test
dengan hostname yang sebenarnya untuk server.
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.test;
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$is_args$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 menetapkan cgi.fix_pathinfo=0
di file php.ini
untuk menghindari banyak panggilan stat()
sistem yang tidak perlu.
Sekalian catat bahwa ketika menjalankan server HTTPS, Anda perlu menambahkan fastcgi_param HTTPS on;
sehingga Yii
benar dapat mendeteksi jika sambungan aman.
Found a typo or you think this page needs improvement?
Edit it on github !
Signup or Login in order to comment.